JuicyAds and NATS Integration
JuicyAds and NATS Integration
NATS (Next-Generation Administration and Tracking System,) has been the industry standard for affiliate tracking for years. The software allows users to build their own affiliate programs, integrate with billing solutions, create a variety of advertising tools and a slate of other features. But did you know that you can integrate JuicyAds into your NATS links to track various advertising events?
The first step with any integration with JuicyAds is to generate S2S (Server to Server) postbacks.
Get S2S Postback Link from JuicyAds (Banners)
To obtain the S2S postback URL for your campaign, go to your banner campaign and click on the “Performance Tracking” tab, and then click the “S2S Postbacks” option from the menu. You will be provided with both a Campaign Specific Postback URL as well as a Global Postback URL that you can use for all campaigns.
S2S Postbacks work by passing the JuicyAds {dynamicS2S} tag through your Ad URL and back to JuicyAds when a specific event is triggered (free registration, conversion, sign-up, etc).
Basic Example
SAMPLE Campaign-Specific Banner S2S Postback:
https://ck.juicyads.com/ilikeitjuicy.php?c=17654&s2s={dynamicS2S}&amount={Amount}&token=694b2304935830102f1115&data=e5110aca90f14c5d1948ef01846a673e
SAMPLE Global Banner S2S Postback:
https://ck.juicyads.com/ilikeitjuicy.php?u=48&s2s={dynamicS2S}&amount={Amount}&token=991c2eb18054f04a6b6c87&data=e5110aca90f14c5d1948ef01846a673e
{dynamicS2S} is the JuicyAds S2S unique identifier to identify the origin click. {Amount} is the amount or value of the event ($, etc). There are additional optional fields available.
For more information, see our help file: https://help.juicyads.com/hc/en-us/articles/115000243174-S2S-Postbacks-Banners
Get S2S Postback Link from JuicyAds (Pops)
Popunder postbacks are similar to banner postbacks. Simply select the campaign you want to generate the postback for and select ‘Performance Tracking’ from the top menu, then ‘S2S Postbacks.’
SAMPLE Campaign-Specific Pops S2S Postback:
https://xapi.juicyads.com/service_s2s.php?c=27465&s2s={dynamicS2S}&amount={Amount}&token=41dc4f1d0885dc4190054907b593
SAMPLE Global Pops S2S Postback
https://xapi.juicyads.com/service_s2s.php?u=48&s2s={dynamicS2S}&amount={Amount}&token=b29ac4f1cd574831837ab849b3d
NATS Settings
Type (Most common)
- Postback on Join
- Postback on Rebill
Amount Format: Decimal
URL: Insert Postback link provided by JuicyAds (“JuicyAds Postback”)
Replace Macros
The most difficult part of integrating S2S is properly anticipating and replacing macros inside the postbacks to ensure the correct data is passed in through your original link, and then passed back to the JuicyAds Postback.
https://tmmwiki.com/index.php/NATS_For_Networks_Replacement_Variables
Below is the full list of available Replacement Tokens that can be used with your Landing Page URLs:
- %%decimal_commission%% – The commission related to the conversion in decimal format.
- %%_ocid%% – The affiliate’s external click ID. To use this on postbacks, they must add “&_ocid=<external_clickid>” to their tracking links where <external_clickid> gets replaced with their own click ID.
- %%aff_id%% – Your affiliate ID.
- %%offer_id%% – The ID of the offer.
- %%aff_campaign%% – The campaign used.
- %%ref_url%% – The Referring URL for the event being reported
- %%transaction_hash%% – The transaction ID of the conversion.
- %%commission%% – The commission related to the conversion.
- %%aff_approved%% – Your auto-pending status.
- %%orderid%% – The transaction identifier from the advertiser.
- %%country_code%% – The 2-letter ISO Country code for the surfer
- %%cust_custom1%%– Customer Custom1 Field
- %%cust_custom2%%– Customer Custom2 Field
- %%cust_custom3%%– Customer Custom3 Field
- %%cust_custom4%%– Customer Custom4 Field
- %%cust_custom5%%– Customer Custom5 Field
- %%cust_username%% – Customer Username
- %%cust_email%% – Customer Email
- %%cust_name%% – Customer First and Last Name
- %%cust_ip%% – The customer record’s IP address in IPv4 format
- %%cust_ip_long%% – The customer record’s IP address converted from IPv4 to a long integer using PHP’s “ip2long” function
- %%subaff%% – Subaff Field
- %%subaff2%% – Subaff2 Field
- %%subaff3%% – Subaff3 Field
- %%subaff4%% – Subaff4 Field
- %%subaff5%% – Subaff5 Field
- %%device_type_name%% – Device type name
- %%device_brand_name%% – Device brand name
- %%device_browser_name%% – Device browser name
- %%device_carrier_name%% – Device carrier name
- %%device_model_name%% – Device model name
- %%device_os_name%% – Device OS name
- %%device_os_version_name%% – Device OS version
Using these macros from the provider, we have to replace them in the JuicyAds Postback URL
https://xapi.juicyads.com/service_s2s.php?u=50792&s2s=%%_ocid%%&amount=%%decimal_commission%%&token=2c0838694320f7fa9f95234a5fe1b55
Confirm Origin URL Accuracy
The most important part of linking from JuicyAds to your offer is ensuring the {dynamicS2S} tag is properly passed from JuicyAds, because that is the token that will contain the unique Click ID for each click from JuicyAds. It needs to be passed on the appropriate variable also. This variable is determined by NATS and is &_ocid the proper link is below;
https://assist.lifeselector.com/track/NDIwMS40NjEuMy4xMDkyMS41MS4wLjAuMC4w
https://assist.lifeselector.com/track/NDIwMS40NjEuMy4xMDkyMS41MS4wLjAuMC4w&_ocid={dynamicS2S}
If you need assistance with the NATS side, please contact them at https://clients.toomuchmedia.com/
If you need assistance with JuicyAds postbacks, contact our support team at https://help.juicyads.com/ . Additionally, you can view our Knowledgebase article on NATS integration here: https://help.juicyads.com/hc/en-us/articles/4508251923860-S2S-NATS .
