Server-to-Server (S2S)
Postback Tracking Guide
To track CPA leads, sales, or deposits accurately without relying on fragile cookies, implement our S2S Postback URL. This guarantees 100% conversion tracking accuracy.
Your Global Postback URL
https://ads.viralnex.com/postback.php?click_id={click_id}&payout={payout}
The {click_id} is dynamically generated when a user clicks your ad.
Available URL Macros
When creating your campaign destination URL in the ViralNex dashboard, you can append any of the following macros. Our system will dynamically replace them with actual user data when a click occurs.
| Macro Parameter | Status | Description |
|---|---|---|
{click_id} |
Required | Unique 32-character tracking ID generated for every click. Mandatory for postbacks. |
{campaign_id} |
Optional | The numerical ID of your specific advertising campaign. |
{pricing_model} |
Optional | Returns 'cpm' or 'cpc' depending on campaign settings. |
{website_id} |
Optional | The ID of the publisher's website where the click originated. |
{country} |
Optional | 2-letter ISO Country Code of the visitor (e.g., US, UK, PK). |
{device} |
Optional | Visitor's device type: 'desktop', 'mobile', or 'tablet'. |
{os} |
Optional | Visitor's operating system (windows, ios, android, macos, linux). |
3rd-Party Trackers Setup
If you use a tracker (like Voluum, BeMob, or Binom), you do not need to edit any code on your website. Simply add ViralNex as a "Traffic Source" in your tracker and paste the corresponding Global Postback URL.
BeMob
Voluum
Keitaro
Binom
RedTrack
PeerClick
Everflow
AdsBridge
Prosper202
FunnelFlux
CPAGrip
MaxBounty
CrakRevenue
ClickBank
Cake
TrackWill
Affise
ClickerVolt
Tune (HasOffers)
Kintura
JavaScript Pixel (No Tracker)
If you send traffic directly to your website without a 3rd-party tracker, you can use our JavaScript pixel. It saves the click_id in the user's browser memory (localStorage) and fires it upon conversion.
Step 1: Landing Page (Inside <head>)
Ensure your campaign URL in our panel looks like: https://yoursite.com/?click_id={click_id}
<script>
// Automatically detect ViralNex Click ID and save it locally
const urlParams = new URLSearchParams(window.location.search);
if (urlParams.has('click_id')) {
localStorage.setItem('vnex_tracking_id', urlParams.get('click_id'));
}
</script>
Step 2: Thank You / Success Page (Inside <body>)
Place this script on the page users see after purchasing or signing up.
<script>
// Fire conversion back to ViralNexlet vnexId = localStorage.getItem('vnex_tracking_id');
if (vnexId) {
let trackingPixel = new Image();
trackingPixel.src = "https://ads.viralnex.com/postback.php?click_id=" + vnexId + "&payout=0";
document.body.appendChild(trackingPixel);
// Clear storage so it doesn't fire twice
localStorage.removeItem('vnex_tracking_id');
}
</script>
Custom Backend Integration (PHP / cURL)
For absolute 100% accuracy—bypassing all ad-blockers and Safari's strict cookie restrictions—use Server-to-Server (S2S) tracking directly from your backend framework.
Step 1: Catch & Save ID via Session
<?php
session_start();
// Note: We use click_id to match the ViralNex standard macro
if (isset($_GET['click_id'])) {
// Save the tracking ID in a session securely on your server
$_SESSION['vnex_click'] = $_GET['click_id'];
}
?>
Step 2: Fire Postback via cURL (After Payment/Lead)
<?php
if (isset($_SESSION['vnex_click'])) {
$click_id = $_SESSION['vnex_click'];
$payout = 2.50; // Set your dynamic or fixed commission amount here
$url = "https://ads.viralnex.com/postback.php?click_id=" . $click_id . "&payout=" . $payout;
// Send signal silently via cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 5); // 5 sec timeout
$response = curl_exec($ch);
curl_close($ch);
// Clear session after firing to prevent duplicate payouts
unset($_SESSION['vnex_click']);
}
?>
Ready to track conversions?
Log into your dashboard, generate your postback, and launch your first performance campaign.