Postback Integration Guide
Configure server-to-server (S2S) postbacks to track conversions in real-time from our system to your tracking software or database.
Step 1
Set Up Global Postback URL
Configure your primary postback endpoint where all conversion data will be sent.
- Navigate to Global Postback section in Settings.
- Enter your postback URL with placeholders:
https://yourdomain.com/postback?click_id={aff_click_id}&goal={goal} - Whitelist our server IP (82.25.105.112) to allow incoming requests.
- Click Save to activate the postback.
Step 2
Understand Available Placeholders
Use these dynamic variables in your postback URL to capture comprehensive conversion data.
- {aff_click_id} - Primary click identifier for tracking
- {sub_aff_id} - Secondary tracking value for sub-affiliate or custom parameter
- {goal} - Conversion goal name (e.g., 'registration', 'purchase')
- {payout} - Conversion payout amount in your selected currency
- {currency} - Currency code (INR, USD, EUR)
- {ip} - Click IP address of the user
- {user_agent} - Browser user agent string
- {source} - Traffic source identifier
- {click_time} - Timestamp when click occurred
- {conversion_time} - Timestamp when conversion was recorded
- {gaid} - Google Advertising ID (for mobile traffic)
Tip: You can also use custom sub IDs like {sub2}, {sub3} through {sub8} for additional tracking parameters.
Step 3
Monitor Postback Logs
Track the delivery status of your postbacks and troubleshoot any issues.
- Check Postback Logs section for recent delivery attempts.
- Verify HTTP response codes (200 = success, 4xx/5xx = failure).
- Monitor for any patterns of failed deliveries.
Step 4
Integrate with Meta Ads (Optional)
Send conversion events directly to your Meta Ads account for optimized ad targeting.
- Enable Meta Integration in General Settings.
- Enter your Pixel ID (found in Meta Events Manager).
- Add your Access Token with necessary permissions.
- Click Test to verify the connection.
- Use Event Mapping to map your goals to Meta standard events.
Security: Access tokens are encrypted and never shown again after saving. Store your token securely elsewhere.
Step 5
Use Tracking Links
Generate and use tracking links with dynamic parameters for comprehensive click tracking.
- Copy your base tracking URL from the Tracking Link section.
- Append additional parameters as needed for your traffic sources.
- Use available parameters: aff_click_id, sub_aff_id, source, gaid, and sub2-sub8.