August 23, 2024

Tracker integration process

General instructions for setting up a traffic source

Setting up the transfer of additional parameters

When setting up additional parameters, you can use any names, such as sub1, subid1, token1.

The only parameter required for the correct operation of our platform's postback is the unique identifier {exid}. It must be placed in the first parameter. You can use the remaining parameters at your discretion.

Setting up a postback

To correctly send registration and deposit events to the traffic source, you need to configure the postback for our platform in s specified way

The postback URL for our platform looks like this:

https://tools.zm.app/pb/?exid={token}&action={status}

  • the exid parameter accepts the visitor' ID in our platform. {token} must be replaced with the macro of the parameter to which exid will be passed
  • the action parameter accepts the conversion status. At the moment we accept the reg status for registration and the dep status for a deposit


You can specify the postback URL in the traffic source settings or in the campaign settings, depending on your tracker.

Examples of integration with different trackers

Binom

Create a new traffic source and configure the tokens you need.
It is important that the exid token is used in the first parameter.

Setting up tokens in the Traffic source tracker

Next, in "Postback URL" we put https://tools.zm.app/pb/?exid={token}&action={status}.

Then go to Advanced Settings and check the "Status-postback relation" box.


Specify two postbacks:

for registration - https://tools.zm.app/pb/?exid={t1}&action=reg

for deposit - https://tools.zm.app/pb/?exid={t1}&action=dep


Important! In the "Conversion status" field for postbacks, you must specify the text values ​​of the registration and deposit statuses that you receive from the advertiser. If there are several such values, you must create a separate postback for each.


Change the "S2S postback mode" value to "Send all"

Example of setting up Traffic source in Binom tracker

Keitaro

Create a new traffic source and configure the tokens you need.

It is important that the exid token is passed in the first parameter.

Example of setting up Traffic source in Keitaro tracker

Next, when creating a new campaign for this Traffic source in the tracker, you need to go to the "S2S postbacks" tab and add two postbacks, as shown in the screenshot below:

For Lead status: https://tools.zm.app/pb/?action=reg&exid={sub_id_1}

For Sale status: https://tools.zm.app/pb/?action=dep&exid={sub_id_1}

Example of postback setup in a campaign for the Keitaro tracker

Voluum

To create a traffic source, go to the Traffic sources section and click the Create button. Then select the Create custom traffic source option.

Specify the name of the traffic source. In the Parameters section for the External ID parameter, specify the name exid and the macro {exid}, as shown in the screenshot below

Setting up tokens in the Traffic source tracker

In the Passing conversion info to traffic source section, select the Traffic source postback URL per event type option and configure postbacks for registration and deposit events


For the registration event: https://tools.zm.app/pb/?exid={externalid}&action=reg

For the deposit event: https://tools.zm.app/pb/?exid={externalid}&action=dep

Example of postback setup in a campaign for the Voluum tracker