This guide provides detailed guidelines on how to configure integration and conversion tracking between Addiliate and Voluum.

Table of contents:

  1. Adding Addiliate as an Affiliate Network in VoluumAffiliate Network: Additional settings ( OPTIONAL)
    1. 1.1.  Append click ID to offer URLs
    2. 1.2.  Accept duplicate Postbacks
    3. 1.3.  Only accept postbacks from whitelisted IPs
  2. Obtaining your Voluum Postback URL
  3. Get the Addiliate tracking URL and implement the VoluumPostback URL in Addiliate
  4. Set up the Addiliate tracking URL in Voluum and start sending traffic

Adding Addiliate as an Affiliate Network in Voluum

Step 1: Select the tab in the main dashboard.

Step 2: Now click the  button.

Step 3: Define a Name for your affiliate network. Addiliate is used in this example;

Step 4: (Optional): Toggle the desired additional settings for your network (explained below):

Affiliate Network: Additional settings (Optional)

There are several optional settings available within the affiliate network configuration.

Below is an overview of each option:

Append click ID to offer URLs

With this option active (ticked ), all offers created and grouped with the related affiliate network have Voluum’s click ID automatically passed in the offer’s URL.

Note: With this active, the {clickid} macro is not visible in the offer URL itself.
Instead it will be passed dynamically by Voluum when a visitor (click) is redirected to an offer.

This option is intended to save time when adding offer URLs to offer elements created in Voluum.

This mainly applies to networks supplying offers with a subid parameter already mapped to the end of the offer URL’s query string.

Example offer URL as supplied by Addiliate network:

https://www.addiliate.com/redirect.html?ad=XXXXXXX&add1=

Example offer URL with a click ID passed:

https://www.addiliate.com/redirect.html?ad=XXXXXXX&add1=c384EFV6JHQODRN70575OK6UG5

Note: It’s important that the parameter used to pass the click ID is at the end of the offer URL’s query string when this option is active.

Tips & Tricks: Addiliate have their own dedicated subid parameters and tokens to receive and relay third party data. We therefore recommend that you always check with Addiliate’s documentation which parameters are supported to pass data correctly within offer/postback URL strings.

Accept duplicate Postbacks

By default, Voluum will not accept a duplicate postback request (conversion) if another postback request with the same click ID value was previously registered without a unique transaction ID.

This avoids registering duplicate postback requests as unique conversions and therefore skewing your reporting.

Selecting the Accept Duplicate postbacks option will override this default setting and, as a result, each postback request with an undefined txid value will be recorded as new, even if another postback for the same cid was previously recorded.

Note: We don’t recommend using the Accept duplicate postbacks option unless you are sure the network processes outbound postback requests reliably. This is because some requests are sent twice simultaneously, and this could otherwise result in false positives – especially with client­side postbacks (pixels).

Tips & Tricks: If an offer’s funnel has multiple sequential conversion steps – or “upsells” – you should assign a unique txid (transaction ID) value to each unique postback URL/pixel applied for each step.

Click here to find out more about using txid to track multiple conversion steps per visitor.

Only accept postbacks from whitelisted IPs

With this option active, you can whitelist a selection of IPs for inbound postback requests. To add a list of IPs, enter a single IP per line.

 

 

 

 

 

 

 

Tips & Tricks: The IPs used for outbound postback requests on the network side can usually be provided by your affiliate account manager.

Any inbound postback requests (conversions) originating from IPs that aren’t whitelisted will be discarded by Voluum.

Step 5: A fter all the options have been set for your affiliate network in Voluum, click on  to add it to your list of active affiliate networks.

Obtaining your Voluum Postback URL

Follow these steps to obtain and set your Voluum postback URL for Addiliate conversion tracking:

Navigate to your Voluum panel’s general settings by clicking on the gear icon ­

Then click on the set­ up tab and scroll down to the server to server postback URL section ­example below;

Copy ‘ Clipboard’ your Voluum postback URL and set it as the global postback URL in your Addiliate account ­ details below.

Example Postback URL to be placed:

http://demo1.voluumtrk3.com/postback?cid=%add1%&payout=%amount%

The addiliate macro used within the postback URL for click ID, will correspond to the

parameter used within the offer URL supplied by addiliate.

I.e. https://www.addiliate.com/redirect.html?ad=XXXXXXX&add1={clickid}

Get the Addiliate tracking URL and implement the Voluum Postback URL in Addiliate

Important note: T his first time when you setup a pixel or postback tracking your Account Manager will have to add you to Addiliate, so please contact your AM the first time. Afterwards you can do it yourself like described below:

  • Go the campaign you want to run
  • Click on ‘Get URL’In case you already have access to the campaign you can proceed directly but otherwise:
      • Click on ‘Get URL’ to activate the campaign OR
      • Click on ‘Apply to Run’ in order to get access to the campaign. Your AM will review your application ASAP.
  • Click on the ‘+’ under ‘Tracking Pixel’
    • If this is your first pixel setup you will get a message to contact your AM.
  • If you have set up pixels before you will see the screen below with your default variables prefilled. In case you need to edit something you can do this and if not, just click on Save.

  • Now copy (clipboard) the ‘Tracking URL’ that you will have to implement in Voluum in order to send the traffic there.

Set up the Addiliate tracking URL in Voluum and start sending traffic

Now you are ready to setup the tracking in Voluum and start sending traffic to the campaigns.

Important note: V oluum’s predefined postback URL for Addiliate uses their ‘%add1%’ token. As such, it’s important to use the corresponding parameter ‘add1’ to pass Voluum’s {clickid} at the end of and offers’ query string.

 

 

 

 

 

 

 

 

Example Addiliate offer URL with ‘ A ppend clickID to offer URLs’ o ption inactive: https://www.addiliate.com/redirect.html?ad=XXXXXXX&add1={ clickid}