Technical Documentation

Conversion Tracking API
& S2S Postback Setup

The Vrume Conversion Tracking API enables advertisers to track conversions, monitor performance, and optimize campaigns using dynamic tokens and server-to-server (S2S) postbacks. Proper tracking ensures accurate reporting, clean attribution, and scalable growth.

Dynamic Parameters

Supported Dynamic Tracking Tokens

Our tracking system supports advanced parameters that allow granular optimization at the campaign, placement, and device level.

Campaign & Placement Identifiers

{campaign_id} Campaign ID
{zone_id} Placement / Zone ID
{variation_id} Creative variation
{site_id} Publisher site ID
{category_id} Traffic category
{tags} Placement tags
{sub} Sub ID parameter
{keyword} Targeted keyword

Cost & Revenue Data

{cost} Click cost
{actual_cost} Final billed cost
{currency} Currency type
{pricing_model} CPC / CPM model
{conversions_tracking} Unique conversion ID

User & Device Targeting

{country} User country
{language} Browser language
{user_agent} Device / browser string
{format} Ad format
{email_encoded} Encoded email
💡
Pro Tip: For most advertisers, optimizing by {zone_id} provides the fastest path to scalable performance.
Integration Guide

How Server-to-Server Tracking Works

Server-to-server tracking eliminates browser-based tracking issues by sending conversion data directly between servers. This increases reliability, improves attribution accuracy, and reduces data loss caused by ad blockers or browser restrictions.

1

Create a Conversion Goal in the Dashboard

Log in to your advertiser panel and configure your conversion goals:

Configure Conversion Goals →
2

Append the Tracking Token to Your Landing Page

When a user clicks your ad, a unique tracking ID is generated and passed to your page.

Landing Page URL
https://yourdomain.com/?tracker={conversions_tracking}
3

Store the Unique Conversion ID

Save the token in a session variable, cookie, or database so it can be used when the conversion occurs.

4

Send the Postback Request

Fire the postback URL when a conversion event occurs on your server:

S2S Postback URL
https://YOUR_TRACKING_DOMAIN/tag.php?goal=GOAL_ID&tag={conversions_tracking}&value={conversion_value}

For dynamic CPA campaigns, append:

Dynamic CPA Parameter
&CPA={CPA_value}
Why It Matters

Benefits of Accurate Conversion Attribution

📊

More Reliable Reporting

Eliminate discrepancies between your tracker and the ad platform with direct server communication.

💰

Improved ROI Calculations

Know exactly what you're spending and earning per zone, campaign, and creative variation.

Faster Optimization Decisions

Real-time postback data means you can cut losers and scale winners the same day you launch.

🔗

Reduced Data Discrepancies

S2S tracking bypasses ad blockers and browser restrictions that kill pixel-based attribution.

📈

Stronger Long-Term Scaling

Clean data compounds. Better attribution today means smarter scaling decisions tomorrow.

Need Help?

Questions About Tracking Setup?

Our team can help you configure postbacks, verify token passing, and troubleshoot attribution issues.