Traffic Source Postback URLs

  • Some Traffic Sources offer the option to pass back conversion details to their system using a Postback URL (also called a Server-2-Server pixel or S2S pixel) in order to see details about costs and conversions in their interface.

  • Because you are already defining the CPV Lab Pro Tracking Pixel or Postback URL at your Affiliate Network, it is not possible to enter the Traffic Source Postback URL at the Affiliate Network level.

The Traffic Source Postback URL can contain 2 parts that should be replaced with the dedicated macros from CPV Lab Pro:

  • 1. The unique code for the converting visitor – needs to be replaced by the {!tscode!} macro.
  • 2. The optional revenue (payout) – needs to be replaced by the {!revenue!} macro.

Flow between CPV Lab Pro and the Traffic Source

traffic source postback url flow

The flow will be like this:

  • Traffic Source passes a unique code for each visitor as a parameter in the Campaign URL – this is the “External ID Token” defined in the campaign setup page.
  • CPV Lab Pro captures this unique code and stores it in the database
  • An additional Pixel is defined in the campaign setup page with the Traffic Source Postback URL (with the {!tscode!} macro in the place of the unique code).
  • When a conversion happens, the Affiliate Network will fire the CPV Lab Pro Tracking Pixel or the CPV Lab Pro Postback URL and a conversion will be marked in CPV Lab Pro.
  • CPV Lab Pro (opens new window) will fire the Additional Pixel (Traffic Source Postback URL) and will replace the {!tscode!} part with the actual unique code for the visitor that converted.
  • The Traffic Source receives the Postback URL call and they mark the conversion in their system

TIP

NOTE: The Traffic Sources imported in CPV Lab Pro from the Catalog in the Traffic Sources page come with the Postback URL already defined and with the correct macros included.

Predefined Traffic Sources

Loaded Traffic Sources

All you need to do when you setup your campaign with such a Traffic Source is:

  • to check the option to use this Postback URL
  • and to enter your actual accountID in the URL (in place of 123456):

Traffic source postback url in campaign setup

Example:

  • If using PopCash as a Traffic Source, then the Traffic Source Postback URL would be like this (make sure that you use your PopCash accountID provided by them in place of 123456):

https://ct.popcash.net/click?aid=123456&clickid={!tscode!}&payout={!revenue!}

  • When a conversion happens in your campaign, CPV Lab will automatically replace {!tscode!} with the actual unique ID for the visitor and {!revenue!} with the actual amount of the conversion, then fire the Traffic Source Postback URL.
  • Let’s say that your visitor had the unique code 'abcdefgh' and that the revenue was '$20'.
    • Then CPV Lab will fire the above Postback URL as:

https://ct.popcash.net/click?aid=123456&clickid=abcdefgh&payout=20

  • You will then see the $20 conversion appearing both in CPV Lab Pro and PopCash reports.
Last Updated: 10/11/2023, 10:35:00 AM