Time to read: 7 min.
The article covers the following topics:
Integration with Advertiser
Step 1. Advertiser Tracking URL
Once a tracking link is received from the Advertiser, it should be placed in the 'Offers' section -> 'Offers edit' page -> 'Tracking' tab -> 'Tracking URL' field:
Advertiser gives their link with the parameters of the tracking platform they use; after all, you should add Affise macros to the link. To get an accurate list of Advertiser’s parameters, you should contact the Advertiser directly.
Affise macros for tracking URL of Advertiser can be found in the same section ('Offers' section - > 'Offer edit' page - > 'Tracking' tab - > ‘Tracking URL’ field - > ‘Show macro’ button).
Affise macros for offer's tracking links:
| {clickid} or {click_id} | Click ID: a required macro |
| {pid} | Affiliate ID |
| {ip} | IP-address |
| {geo} | Country code (ISO 3166-1 alpha-2) |
| {sub1} - {sub8} | SubId #1 - SubId #8 |
| {deeplink} | Deeplink |
| {device_ua} | Device User Agent |
| {offer_id} | Offer ID |
| {rand} | Unique number (UUID format, eg: 9cdf32d5-124e-4e06-b25b-4c92d3cec9dc) |
| {time} | Unix time |
| {city} | City |
| {time_petty} | Time of click committing in format H:i:s |
| {date_only} | Date of click committing in format Y-m-d |
| {affiliate_name} | Company name of affiliate |
| {advertiser_id} | ID of Advertiser |
| {offer_name} | Offer Title |
| {referrer} | Click referrer |
| {impression_id} |
Impression ID |
| {language} | Device language |
| {fbclid} | Facebook click ID |
Step 2. Affise Postback URL
Postback generated in Affise system should be placed in the tracking system of Advertiser.
Affise postback template can be found in the 'Offers' section - > 'Offer edit' page - > 'Postbacks' tab - > ‘Integration pixels’ - > ‘S2S’ (Postbacks):
Or in ‘Advertisers’ section - > ‘Edit Advertiser’ - > ‘S2S’ (Postback):
The postback should have Affise parameters and advertiser’s macros that should be added to them accordingly.
The list of Affise parameters for a postback is as follows:
| clickid | A required parameter: should be replaced with advertiser’s macro for click id |
| action_id | Unique conversion ID in the advertiser's system |
| goal | Goal number or goal value |
| sum | Conversion revenue |
| ip | IP address of visitor who made a request (partially hidden by GDPR policy) |
| status |
Conversion status*: Approved - 1 Pending - 2 Declined - 3 Hold - 5 |
| referrer | Referrer (additional information on traffic and deeplinks) |
| comment | Comment |
| secure | The hash password generated on offer, advertiser level |
| fbclid | Facebook click ID |
| custom_field1 - custom_field7 | Additional parameters |
* - read more about conversions' statuses and how to change postback's status here.
To get an accurate list of Advertiser’s macros for the postback, you should contact Advertiser directly.
Macros are framed with brackets; the type of brackets of the advertiser’s macros depends on the tracking system.
Affise macros: {}
Other tracking solutions: {}, [ ], [[ ]], # #, % % and etc.
In the majority of cases we pass info and get it back through the same parameters & macros:
Tracking link: &aff_sub={clickid}
Postback URL: clickid={aff_sub}
& is used to add different parameters to the link.
Once you have updated your Offer's Tracking URL and have shared with Advertiser your Postback URL, you can move further with Integration Test with Advertiser. To find out more, feel free to check this article.
You may also find helpful the following Articles:
- How to take the Integration Test with Advertiser?
- Where can I find my Postback URL?
- Where can I find a test Tracking URL?
Should you have any further doubts or questions on S2S integration with Advertiser, feel free to address them to Affise Support Team via support@affise.com or your internal live-chat as long as to contact your dedicated Account Manager.
Updated by Anastasia Dziaruhina
0 Comments