{"id":438,"date":"2023-04-06T17:10:30","date_gmt":"2023-04-06T17:10:30","guid":{"rendered":"https:\/\/www.trafficmanager.com\/blog\/?p=438"},"modified":"2023-05-19T12:27:02","modified_gmt":"2023-05-19T12:27:02","slug":"s2s-postback-integration-for-beginners-a-step-by-step-guide","status":"publish","type":"post","link":"https:\/\/www.trafficmanager.com\/blog\/2023\/04\/s2s-postback-integration-for-beginners-a-step-by-step-guide\/","title":{"rendered":"S2S Postback Integration for Beginners: A Step-by-Step Guide"},"content":{"rendered":"\n

What is Server-to-Server (S2S) Postback, and how do you implement S2S Postback integration between two tracking platforms?<\/p>\n\n\n\n

Server-to-server (S2S) postback integration is a method used to track and transfer data between two systems or tracking platforms. Over the past few years, S2S postback has emerged as an unofficial “standard tracking and communication channel” in the affiliate marketing industry, outperforming the traditional pixel tracking due to its superior security, tracking accuracy, and reliability.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

To briefly compare, both S2S postback and pixels are utilized to track and share data, such as conversion events, sales, leads, or actions, between two different systems. The primary difference between the two is that S2S postback operates without relying on the user’s device, unlike pixel tracking. This attribute makes it more accurate and reliable than client-side tracking (pixel tracking), which can be impacted by browser restrictions, ad blockers, and other factors.<\/p>\n\n\n\n

Setting up an S2S postback can be challenging and confusing, particularly when compared to traditional pixel integration but, if you plan to run an affiliate program<\/a> or affiliate network, it’s important to have someone on your team who understands how to implement it.<\/p>\n\n\n\n

Even some of the most experienced marketers in the industry may find it difficult because of the misunderstandings surrounding the variables that one system needs to pass to another. However, there’s no need to worry because we have created a beginner-friendly guide that will walk you through the process of establishing a basic S2S postback integration between two tracking platforms.<\/p>\n\n\n\n

First of all, we will need to understand the structure of the S2S postback URL and how data is exchanged through it, so let\u2019s see some Postback URL examples:<\/p>\n\n\n\n

<\/p>\n\n\n\n

TrafficManager Postback URL:<\/strong><\/p>\n\n\n\n

https:\/\/postback.trafficmanager.com\/?clickid=__REPLACE__<\/b>&amount=__REPLACE__<\/b>&currency=__REPLACE__<\/b>&transaction_id=__REPLACE__<\/b>&key=06c9a03a47b2f37543222310cd84599345c92956ad8 <\/p><\/code><\/pre>\n\n\n\n
Other tracking platforms Postback URL:<\/strong><\/p>\n\n\n\n
https:\/\/trackingplatform1.com\/postback\/?subid={subid}<\/b>&amount={amount}<\/b>&currency={currency}<\/b>&transaction_id={trans_id}<\/b>&key=01234567890abcdefgh<\/p><\/code><\/pre>\n\n\n\n
https:\/\/trackingplatform2.com\/pb\/?aff_id=%%aff_if%%<\/b>&commission=%%commission %%<\/b>&transaction_id=%%transaction_id%%<\/b>&key=11223344556aabbccdd<\/p><\/code><\/pre>\n\n\n\n
https:\/\/postback.trackingplatform3.com\/?s1=#s1#<\/b>&sum=#sum#<\/b>&transaction_id=#trans_id#<\/b>&key=01234567890abcdefgh<\/p><\/code><\/pre>\n\n\n\n
As you can see, different trackers, and different postback URL formats, no wonder is confusing. However, once we understand their structure and what we need to modify in a postback URL, it will become clearer. <\/p>\n\n\n\n
Please pay attention to the parts highlighted with yellow from the section \u201cOther tracking platform postback URL\u201d above and the TrafficManager Postback URL. Those are called dynamic parameters<\/strong> and are used to exchange data.<\/p>\n\n\n\n
The golden rule when integrating a postback URL is that: Those and only those dynamic parameters (the section highlighted with yellow) of YOUR postback must be modified with the other side parameters, or fixed values you want to receive in YOUR platform.<\/u><\/strong><\/p>\n\n\n\n
As you can see, In the TrafficManager postback URLs, we use __REPLACE__instead of a dynamic parameter like {subid} to make it more intuitive for people to understand which part of the postback URL should be replaced with the other side (tracking platform) parameters.<\/em><\/p>\n\n\n\n
Now, if we should integrate ANY of the postbacks URL listed above into a 3rd<\/sup> party tracking platform that supports the following parameters (or tokens):<\/p>\n\n\n\n
\n
\n
#s1#             – clickid 1<\/p>\n\n\n\n
#s2#             – clickid 2<\/p>\n\n\n\n
#s3#             – clickid 3<\/p>\n\n\n\n
#pay#           – payout<\/p>\n\n\n\n
#aff_id#       – affiliate ID<\/p>\n\n\n\n
#tid#             – Transaction ID<\/p>\n\n\n\n
The postback URL that we need to integrate on the other side should have the variables from the list above (instead of the yellow-highlighted variables) that we want to pass back to our tracking platform.<\/p>\n<\/div>\n<\/div>\n\n\n\n
For example, let’s say we need to integrate the postback URL above highlighted in blue, and we choose the variable #s3#<\/strong> to pass back and forth the unique ID of the affiliate clicks from your tracking platform (Note: check with your partner which variable to use before integrating if their documentation is not clear)<\/em><\/p>\n\n\n\n
Instead of this: <\/strong><\/p>\n\n\n\n
https:\/\/trackingplatform2.com\/pb\/?aff_id=%%aff_if%%<\/b>&commission=%%commission %%<\/b>&transaction_id=%%transaction_id%%<\/b>&key=11223344556aabbccdd<\/p><\/code><\/pre>\n\n\n\n
It will look like this:<\/strong><\/p>\n\n\n\n
https:\/\/trackingplatform2.com\/pb\/?aff_id=#s3#<\/b>&commission=#pay#<\/b>&transaction_id=#tid#<\/b>&key=11223344556aabbccdd<\/p><\/code><\/pre>\n\n\n\n
Same for the grey postback URL, instead of this:<\/strong><\/p>\n\n\n\n
https:\/\/trackingplatform1.com\/postback\/?subid={subid}<\/b>&amount={amount}<\/b>&currency={currency}<\/b>&transaction_id={trans_id}<\/b>&key=01234567890abcdefgh<\/p><\/code><\/pre>\n\n\n\n
It will look like this:<\/strong><\/p>\n\n\n\n
https:\/\/trackingplatform1.com\/postback\/?subid=#s3#<\/b>&amount=#pay#<\/b>&currency=USD<\/b>&transaction_id=#tid#<\/b>&key=01234567890abcdefgh<\/p><\/code><\/pre>\n\n\n\n
As you can see, nothing changes in our Postback URL besides the variables. In the second example (the grey postback above), we also set a fixed value for the currency because we don’t have a dynamic parameter for it in the list above. Assuming that we will receive payouts in USD, we can directly \u201ccommunicate\u201d the symbol to our tracking platform or remove the parameter from the postback URL, of our choice. <\/p>\n\n\n\n
The same can be done when passing the payout amount of the conversion. For example, we can use a fixed sum such as amount=1.<\/em><\/p>\n\n\n\n
Here’s an example with the currency removed and a fixed payout:<\/strong><\/p>\n\n\n\n
https:\/\/trackingplatform1.com\/postback\/?subid=#s3#<\/b>&amount=1<\/b>&currency=USD<\/b>&transaction_id=#tid#<\/b>&key=01234567890abcdefgh<\/p><\/code><\/pre>\n\n\n\n
Note: The only parameter in our case which must always be dynamic is the #s3#<\/strong> parameter because we will pass that from our tracking platform later.<\/p>\n\n\n\n
Now, once you have placed your postback in the 3rd<\/sup> party tracking platform, you will need to create an offer\/campaign in your tracking platform and in your offer destination URL, to add the partner offer\/campaign tracking link you want to integrate into your system, with THEIR parameter used to pass the unique ID\u2019s of your affiliate clicks ( #s3#<\/strong> from the example above).<\/p>\n\n\n\n
For example:<\/p>\n\n\n\n
Imagine that the tracking link of your partner looks like this: https:\/\/track.myoffer100.com\/?aff=87&lp=21<\/strong><\/p>\n\n\n\n
And your tracking platform parameter that passes the unique IDs of your affiliate clicks is [subid]<\/strong><\/p>\n\n\n\n
Then your final destination URL will be: https:\/\/track.myoffer100.com\/?aff=87&lp=21&s3=[subid]<\/strong><\/p>\n\n\n\n
Set it as the destination URL in your tracking platform and let\u2019s test the Postback Integration.<\/p>\n\n\n\n
    \n
  1. Open the tracking link resulting from your side (the one that redirects to the destination URL above) and check that both tracking platforms report the click you just made;<\/li>\n\n\n\n
  2. Perform together with your partner a conversion test by using the tracking link from your platform.<\/li>\n\n\n\n
  3. Check if the conversion was registered on both platforms and if you received the correct amount.<\/li>\n<\/ol>\n\n\n\n
    Troubleshooting. If the integration isn’t working, consider the following:<\/strong><\/p>\n\n\n\n
    Ensure that you’ve correctly set up the “unique IDs of your affiliate clicks” parameter on both platforms (in our example we used the variable #s3# for that).<\/p>\n\n\n\n
    Ensure that you have used YOUR platform tracking link for the conversion test and not the destination URL received from your partner.<\/p>\n\n\n\n
    Double-check the postback URL for typos or incorrect placeholders.<\/p>\n\n\n\n
    Double-check the postback URL for empty spaces, including the beginning or the end of the link, some platforms don\u2019t recognize and remove the empty spaces.<\/p>\n\n\n\n
    HTTP over HTTPS requests \u2013 double check if both platforms send the traffic in the same format, HTTPS is highly recommended.<\/p>\n\n\n\n
    Now, to provide some context and help you better understand, let\u2019s imagine that you have just set up an affiliate program<\/a> or an affiliate network using our affiliate tracking platform, TrafficManager<\/a>, and you need to integrate another tracking platform operated by a 3rd<\/sup> party Advertiser, affiliate program, casino or betting operator<\/a>, or any other similar entity.<\/p>\n\n\n\n
    Step 1: Make sure that the other tracking platform supports S2S postback tracking.<\/span><\/p>\n\n\n\n
    This may seem obvious at this point, but in some industries, many trackers still rely on pixel tracking. If this is the case, you can still integrate pixel tracking with TrafficManager, but you don’t need this guide to do it as it’s a simple copy-and-paste operation.<\/p>\n\n\n\n
    Step 2: Find your TrafficManager global Postback URL<\/span><\/p>\n\n\n\n
    Click on “Manage offers” then on New Offer (or edit any existing offer from your Marketplace)<\/strong><\/p>\n\n\n
    \n
    \"\"<\/figure>\n<\/div>\n\n\n
    <\/div>\n\n\n\n
    Scroll down until you find “Conversions tracking” then “S2S Postback” and Copy the Postback URL<\/strong><\/strong><\/p>\n\n\n
    \n
    \"\"<\/figure>\n<\/div>\n\n\n
    <\/div>\n\n\n\n
    Note: The postback URL provided by TrafficManager will be your global postback URL, which means that you can use the same URL to integrate all your third-party partners, regardless of how many offers\/campaigns you create in your TrafficManager platform.<\/em><\/p>\n\n\n\n
    Step 3: Identify the 3rd<\/sup> party affiliate tracking platform dynamic parameters.<\/span><\/p>\n\n\n\n
    For our example we will use the same parameters we used in the examples provided above:<\/p>\n\n\n\n
    \n\n        \n            \n            \n            \n            \n            \n            
    #s1#<\/th>\n            clickid 1<\/td>\n        <\/tr>\n        
    #s2#<\/th>\n            clickid 2<\/td>\n        <\/tr>\n        
    #s3#<\/th>\n            clickid 3<\/td>\n        <\/tr>\n        
    #pay#<\/th>\n            payout<\/td>\n        <\/tr>\n        
    #aff_id#<\/th>\n            affiliate ID<\/td>\n        <\/tr>\n        
    #tid#<\/th>\n            Transaction ID<\/td>\n        <\/tr>\n<\/tbody><\/table><\/code><\/pre>\n\n\n\n
    <\/div>\n\n\n\n
    Step 4: Paste your modified S2S postback URL in the other platform as follows:<\/span><\/p>\n\n\n\n
    https:\/\/postback.trafficmanager.com\/?clickid=#s1#<\/b>&amount=#pay#<\/b>&currency=EUR&transaction_id=#tid#<\/b>&key=06c9a03a47b2f37543222310cd84599345c92956ad8<\/p><\/code><\/pre>\n\n\n
    \n
    \"\"<\/figure>\n<\/div>\n\n\n
    <\/div>\n\n\n\n
    Step 5: Retrieve your partner offer\/campaign tracking URL:<\/span><\/p>\n\n\n\n
    For example https:\/\/track.myoffer100.com\/?aff=87&lp=21<\/strong><\/p>\n\n\n\n
    <\/div>\n\n\n\n
    Step 6: Create a new offer\/campaign in your TrafficManager tracking platform and add it as a destination URL<\/span><\/p>\n\n\n
    \n
    \"\"<\/figure>\n<\/div>\n\n\n
    <\/div>\n\n\n\n
    Step 7: Add the variable we use to generate unique ID\u2019s for the affiliate clicks {clickid}<\/strong> in the destination URL together with your partner parameter used to receive it on their end which usually is the same you place in the postback URL, but is not a rule:<\/span><\/p>\n\n\n\n
    This is the postback URL:<\/p>\n\n\n\n
    https:\/\/postback.trafficmanager.com\/?clickid<\/b>=#s1#<\/b>&amount=#pay#<\/b>&currency=EUR&transaction_id=#tid#<\/b>&key=06c9a03a47b2f37543222310cd84599345c92956ad8<\/p><\/code><\/pre>\n\n\n\n
    This is the complete tracking link for TrafficManager:<\/p>\n\n\n\n
    https:\/\/track.myoffer100.com\/?aff=87&lp=21&s1<\/b>={clickid<\/b>}<\/p><\/code><\/pre>\n\n\n
    \n
    \"\"<\/figure>\n<\/div>\n\n\n
    <\/div>\n\n\n\n
    Step 8: Click first on the Create button<\/span><\/p>\n\n\n
    \n
    \"\"<\/figure>\n<\/div>\n\n\n
    <\/div>\n\n\n\n
    Step 9: Then save the offer in your TrafficManager platform<\/span><\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    <\/div>\n\n\n\n
    IMPORTANT: For testing purpose, do not activate any of the following filters when you will create the offer in your TrafficManager platform until after the test is done:<\/p>\n\n\n\n
    Countries, Exclude Countries, Connection type<\/strong>, or, if you already have them activated, check the \u201cIgnore targeting restrictions\u201d box under the offer settings and save the offers.<\/p>\n\n\n\n
    Don\u2019t forget to remove that once you\u2019re done if you want to activate the filters again.<\/p>\n\n\n
    \n
    \"\"<\/figure>\n<\/div>\n\n\n
    <\/div>\n\n\n\n
    Step 10: Test your integration using the tracking link generated by your TrafficManager platform<\/span><\/p>\n\n\n
    \n
    \"\"<\/figure>\n<\/div>\n\n\n
    <\/div>\n\n\n\n
    First, open the link in your browser and check if the click you just made is visible on both tracking platforms.  If not ask the account\/affiliate manager managing the other tracking platform if the statistics are live in their system, otherwise check the Troubleshooting <\/strong>section of this page.<\/p>\n\n\n\n
    The last step, simulate a conversion by clicking the same tracking link and completing the desired action. (You may need your account\/affiliate manager help for this)<\/p>\n\n\n\n
    If the conversion is not reported correctly, please check the Invalid Conversions <\/strong>section of your TrafficManager platform, and seek the reason for the failed reported conversion:<\/p>\n\n\n
    \n
    \"\"<\/figure>\n<\/div>\n\n\n
    <\/div>\n\n\n\n
    Hopefully, this guide made your life easier. Thank you for your trust and support and remember to keep an eye on our blog and social media pages for more content like this.<\/strong><\/p>\n\n\n\n
    <\/p>\n\n\n\n
    With love,<\/p>\n\n\n\n
    The TrafficManager Team!<\/p>\n\n\n\n
    \n