Track Conversions Using S2S Postback URL

If you want to track conversions using a redirect method of tracking with a postback URL, then it is necessary to pass a click ID value to an affiliate network.

V-Set-your-campaign-for-first-party-cookies-OG-2021-11-21.jpg

In Voluum, where the conversions are registered, a unique click ID value is generated for the click. This unique click ID will be sent to your affiliate network platform and then, the affiliate network captures and passes this click ID back to Voluum after the conversion is recorded on their end.

Server-to-server postback URL is a method of communication between different platforms. The technical method itself is similar to a regular API request, where a modified postback URL is an endpoint to make a request to. It might be triggered either automatically, based on set up triggers or even manually, by simply putting it into a browser's address bar.

The names comes from the POST method it uses to send information BACK. Postback i an industry-specific terms and developers from outside this industry may better understand this solution when it is called:

Webhook
Callback URL
Conversion URL
Endpoint URL

Each postback URL contains 2 parts:

Tracking domain (prefix) - which is unique for each user/account.
parameters(keys) + values - which are fixed values providing specific information.

Exemplary postback URL template looks like below:

https://track.radantus.com/postback?cid={}&payout={}&txid={}&currency={}&et={}&param1={}&param2={}&param3={}&param4={}&param5={}

where:

tracking domain (prefix/endpoint) is: https://track.radantus.com/postback
predefined parameters(keys) are: cid, payout, txid, currency, et, param1-param5.

Key’s values must be provided in place of {}.

What is necessary in order to record an S2S postback URL?

The only parameter (key) mandatory for Voluum postback is the correct value of “cid”, which stands for the click ID. This value is generated by Voluum dynamically for each visitor and needs to be passed to an offer owner through a visit URL as a URL query under a parameter predefined by the offer owner and then returned in a postback URL.

Track conversions with postback URL

In order to track conversions with postback URL , you need to:

Pass Voluum click ID value in an offer URL in a {clickid} token to an offer owner. Example: the offer page is hosted at https://www.great-offer.com/ and the offer owner supports a specified URL query parameter “aff_sub”, which they store in a database under {aff_sub} variable/token/macro. In such case offer URL in Voluum must be modified to:
```
https://www.great-offer.com/?aff_sub={clickid}
```
Now, for each visitor going through Voluum servers, the URL will be dynamically replaced with click ID value and exemplary vistor’s URL would look like this:
```
https://www.great-offer.com/aff_sub=w7hay1g4begs52g2b1nywh2
```
Submit postback URL to an offer owner to receive Voluums click ID passed in a dedicated parameter. For the time of visit, offer owner must store the value of “w7hay1g4begs52g2b1nywh2” in their database and whenever a desired event happens (sales, lead, registration etc.), a postback URL will be fired, for example:
```
https://track.radantus.com/postback?cid=w7hay1g4begs52g2b1nywh2
```

V_Documentation-Knowladgebase_Conversion_Tracking_18_11_19_1.jpg

You can include additional tracking parameters in a postback URL. These are listed in the Parameters in Postback URLs article.

Passing a click ID to an affiliate network platform in an offer URL
An example of the offer URL:
```
https://www.offer_link.com?s2={clickid}
```
When that offer URL is clicked, the {clickid} token is replaced with a unique value, for example, c384EFV6JHQODRN70575OK6UG5. Below you can take a look at the offer URL sample with the unique click ID value:
```
https://www.offer_link.com?s2=c384EFV6JHQODRN70575OK6UG5
```
Passing a click ID back to Voluum in a postback URL
This click ID is then submitted to an affiliate network platform. Then, the postback URL that Voluum provides is used to send back the recorded click ID from an affiliate network platform and it looks as follows:
```
https://your_Voluum_domain_name.com/postback?cid=#s2#
```
In the postback URL you might find also other parameters that are used to pass additional information about the registered tracking event:
- The example of the postback URL configured to pass the payout information automatically with a dynamic token:
```
https://your_Voluum_domain_name.com/postback?cid=#s2#&payout=#price#
```
- The example of the postback URL configured to pass the payout information with a fixed static payout value:
```
https://your_Voluum_domain_name.com/postback?cid=#s2#&payout=0.6
```

In order to test a postback URL, you need to get a correct click ID from Voluum, put it into a postback URL template and activate it to generate a test conversion.

Caution

Voluum Note: Parameters used in the offer URL such as s2 and placeholders used in the postback URL such as #s2# or #price# need to be in compliance to those ones which are supported by your network.

In this section:

Track Conversions Using S2S Postback URL

What is necessary in order to record an S2S postback URL?

Track conversions with postback URL

Caution

Frequently Asked Questions

Search results