Time to read: 7 min.
The article covers the following topics:
Integration with Affiliate
Step 1. Affise Tracking URL
Integration process with Affiliate starts with Affise tracking link generation on offer’s preview page:
The link can be updated with Affise parameters and Affiliate’s macros.
Affise parameters for Affise tracking URL are as follows:
sub1-sub8 | Parameters for all kinds of information |
os_id | An additional parameter |
ext1-ext3 | Additional parameters |
ref_id | An additional parameter |
Values passed via ext1 - ext3, os_id and ref_id parameters are not depicted in Statistics, but it is possible to get them via API by using Statistics method for clicks. See our guide on using API methods related with Statistics.
Step 2. Affiliate Postback URL
The affiliate should share with you his/her postback URL to get information about conversions.
It can be set by the Affiliate in the Affiliate panel: ‘Affiliates’ section - > Affiliate Management - > Sign in - > Offers - > All offers - > A certain offer
Or set by you in ‘Affiliates’ section - > Affiliate Management - > ‘Edit’ affiliate - > ‘Affiliate postbacks’:
The last place where a postback can be installed is a certain offer: a certain offer -> 'Postbacks' tab -> Affiliate postbacks. Click on '+' button, choose a certain affiliate and insert a link. This postback will be depicted also on the edit page of this affiliate on the Admin panel.
Affiliate’s postback should have an Affiliate’s parameters and Affise macros.
A complete Affise macro list for affiliate’s postback can be found in the Affiliate’s panel - > Profile - > Global postbacks - > ‘Postback information’.
The list of the macros is as follows:
{uagent} |
UserAgent of user browser |
{ip} |
User IP-address |
{sub1} - {sub8} |
Subaccount 1 - Subaccount 8 |
{ref_id} |
An additional macro for postback URL |
{os_id} |
An additional macro for postback URL |
{user_id} |
An additional macro for postback URL |
{ext1} - {ext3} |
Additional macros for postback URL |
{transactionid} |
Conversion identificator of the advertiser |
{date} |
Date and time of conversion committing in format y-m-d h:i:s |
{click_date} |
Date and time of click committing in format y-m-d h:i:s |
{offerid} |
Offer identificator in the System |
{offer_name} |
Offer title in the System |
{status} |
Conversion status, available values*: 1 – conversion is "Approved" 2 – conversion is "Pending" 3 – conversion is "Declined" 5 – action is approved and put on "Hold" |
{sum} |
Conversion payout |
{city} |
City |
{geo} |
Country |
{goal} |
Goal |
{currency} |
Currency |
{comment} |
Comment |
{time} |
Time of conversion committing in format H:i:s |
{date_only} |
Date of conversion committing in format Y-m-d |
{rand} |
Unique number (UUID format, eg: 9cdf32d5-124e-4e06-b25b-4c92d3cec9dc) |
{referrer} |
Click referrer |
{custom_field1} - {custom_field7} or {custom_field_1} - {custom_field_7} |
Additional macros |
{os} |
OS Family |
{timestamp} |
Unix timestamp of conversion creation |
* - read more about conversions' statuses here.
To get an accurate list of Affiliate’s parameters for Affiliate's postback, you should contact the Affiliate directly.
You can proceed with Integration tests with your Advertiser & Affiliate when the links are updated with the correct parameters & macros. Here you can find a detailed guide on how to proceed with Integration tests.
You may also find the following articles helpful:
- Affise parameters & macros for the S2S Integration with Advertiser
- How to take the S2S Integration Test with Affiliate?
Should you have any further doubts or questions on S2S integration with Affiliate, 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 Deryugina
0 Comments