Affise Parameters & Macros for the S2S Integration With Advertiser

Time to read: 7 min.

topic.png 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
{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)

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.

import.png 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.

article.pngYou may also find helpful the following Articles:

Should you have any further doubts or questions on S2S integration with Advertiser, feel free to address them to Affise Support Team via or your internal live-chat as long as to contact your dedicated Account Manager. 

Updated by Anastasia Dziaruhina 

Was this article helpful?
10 out of 11 found this helpful
Have more questions? Submit a request


Article is closed for comments.