How to Integrate Voluum With Adivity

Home / help / How to Integrate Voluum With Adivity

How to Integrate Voluum With Adivity

Voluum is a third-party tracking platform, allowing for easy campaign monitoring and optimization. In this article, we’re going to correctly integrate Voluum to ensure conversions are displayed in our Adivity dashboard.

Let’s get started:

STEP 1: ADD NEW TRAFFIC SOURCE

Log into your Voluum Dashboard, under the “Traffic source” tab click the “New Traffic Source” button to add Adivity as your traffic source.

Your postback URL should be set as: http://api.adivity.com/conv.json?tid={externalid}

The {externalid} variable is unique to Voluum and other tracking platforms may use a different variable.

Set the External ID as {CONVERSION_ID} – this is important, as this is provides a unique Click ID. The parameter can be set to what ever you want, in this example, we choose EXTERNALID.

From here, you have the option to add additional variables, we strongly recommend you include these to help improve your optimization. A full list is available at the bottom of this post as well as in your Adivity Dashboard by clicking on the Resources > Macros tab.

If you’re confused by this step, refer to the image below.

adivity-integration

 STEP 2: ADD NEW OFFER

Inside your Voluum Dashboard, under the “Offers” tab, click “New Offer”. You may need to add an Affiliate Network first.

Here, you want to enter your click URL. It should look like this:

http://clickurl.com/?a=12494&c=56427&s1={trafficsource.id}&s2={clickid}

{trafficsource.id} – this will post an ID to your network. This will make it easier for you to determine which traffic source generated the conversion.

{clickid} – this will create a unique id, which will be used to determine if a conversion has occurred. Don’t set the click id as sub id 1 as the Cake Marketing Platform limits the number of unique variables that can be set as S1.

Please refer to the image below if you’re having difficulty with this step.

Finally, don’t include an of Adivity’s variables here, they won’t work. This section is only for Voluum’s variables.

Screenshot_5

STEP 3: ADDING THE POSTBACK

Inside of Voluum, go to the Settings Tab (located in the top right hand corner) and then click on the “Setup” Tab. Locate your postback url which will look like this:

http://42141.trackvoluum.com/postback?cid=REPLACE&payout=OPTIONAL

You want to change the REPLACE and OPTIONAL tokens to your affiliate network’s unique variables. In this example, we will use Cake Marketing. It will look like this:

http://42141.trackvoluum.com/postback?cid=#s2#&payout=#price#

Note: We need to postback the click id that generated the conversion, in Step 2 we listed the click id as sub id 2 ( s2={clickid} ). This will posted back the click id to Voluum, which will then post it back to Adivity displaying the conversion in both dashboards.

We also have the option to automatically postback the payout or commission that is earned. This is a feature that exists within voluum and is quite useful.

If you have any trouble with this section, refer to the images below!

gallery-size-2

CONGRATULATIONS!

That’s all you needed to do – conversions should be accurately tracked in both Voluum and in Adivity.

If you need any help, please contact [email protected] or add us on skype with the username: adivity

How the process works (just in case you’re wondering):

Phase 1: The user clicks on your banner and is forwarded through Adivity, which appends a unique Conversion ID to your Voluum tracking link.

Phase 2: The user is then passed through Voluum, which stores the Conversion ID and forwards a unique Click ID to your affiliate link or click URL. This Click ID is passed to your third party software. In this example, we are using the Cake Marketing Platform.

Phase 3: If a conversion is generated, the third party software sends a notification back to Voluum via your postback URL showing which Click ID generated the conversion.

Phase 4: Voluum then cross references the Click ID with the Conversion ID. If there is a match, it sends the Adivity Postback URL and displays a conversion on your Adivity Dashboard.

 

Supported Macros:

  • {CONVERSION_ID} – Passes the unique conversion tracking ID # of the click received.
  • {CAMPAIGN} – Passes the campaign name that received the click.
  • {CREATIVE} – Passes the creative name that received the click.
  • {APP_NAME} – Passes the app name that received the click.
  • {EXCHANGE_NAME} – Passes the exchange name that received the click.
  • {MANUFACTURER_NAME} – Passes the Device Manufacturer name that received the click.
  • {MODEL_NAME} – Passes the Device Model Name that received the click.
  • {DEVICE_ID} – Passes the unique ID # of the Device ID that received the click.
  • {CARRIER_NAME} – Passes the carrier name of the people that click your ads.(mobile only)
  • {DEVICE_OS_NAME} – Passes the Device Operating System name that received the click.
  • {COUNTRY_NAME} – Passes the Country name that received the click.
  • {STATE_NAME} – Passes the State name that received the click.
  • {TIMESTAMP} – Passes the Timestamp that received the click.
  • {USER_IP} – Passes the User’s IP Address that received the click.
  • {COUNTRY_CODE} – Passes the Country Code that received the click.
  • {GPS_LAT} – Latitude cordinates of the device.
  • {GPS_LON} – Longitude cordinates of the device.
  • {DEVICE_PLATFORM_ID} – Platform specific id of the device.
  • {APP_ID} – Passes a numeric ID (for Apple) or bundle name (for Google) specific to the mobile app responsible for generating the click. [Example values: “383763″ (Apple) or “com.google.mygoogleapp” (Google)] (mobile only)

 

Recommended Posts

Leave a Comment

Contact Us

We're not around right now. But you can send us an email and we'll get back to you, asap.

Start typing and press Enter to search

How much does mobile advertising costimg-box-04