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:
You can use any of free subs parameters in the affiliate’s tracking link (sub1 - sub8), os_id parameter, any of extra paramteres ext1 - ext3, and additional parameter ref_id. After all, the link can be shared with the Affiliate.
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 - > Get link
Or set by you in ‘Affiliates’ section - > Affiliate Management - > ‘Edit’ affiliate - > ‘Affiliate postbacks’:
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 |
|
{unid} |
An additional parameter for tracking URL |
|
{ref_id} |
An additional parameter for tracking URL |
|
{os_id} |
An additional parameter for tracking URL |
|
{user_id} |
An additional parameter for tracking URL |
|
{ext1} |
An additional parameter for tracking URL |
|
{ext2} |
An additional parameter for tracking URL |
|
{ext3} |
An additional parameter for tracking 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 – action "Allowed" (will be paid later by the advertiser) 2 – action "In process" (the decision is not taken yet, you need request the status later) 3 – action "Declined" (will not be paid later by the advertiser) 5 – action is «Approved» and put on Hold (will be paid by the advertiser at a certain amount of time - the period of hold is taken from the offer settings). |
|
{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} |
Randomly generated number |
|
{referrer} |
Click referrer |
|
{custom_field1} - {custom_field8} or {custom_field_1} - {custom_field_8} |
Custom field 1 - Custom field 8 |
|
{os} |
OS Family |
|
{timestamp} |
unix timestamp of conversion creation |
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