Follow

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:

unnamed__4_.png

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} clickid_param_info: a required macro
{pid} partner 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
{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} OD of Advertiser
{offer_name} Offer Title
{referrer} Click referrer

 

 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):

__________.png

Or in ‘Advertisers’ section - > ‘Edit Advertiser’ - > ‘S2S’ (Postback):

______.png

import.pngRight now we support the following samples of the default Admin domain, which is used in Affise Postback URL:

  • http://offers.rocketcompany.affise.com - will be supported until the end of the 2020 year!!!
  • http://offers-rocketcompany.affise.com
  • https://offers-rocketcompany.affise.com

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

request status*:

Approved - 1

Pending - 2

Declined - 3

Not found - 4

Hold - 5

referrer referrer (additional information on traffic and deeplinks)
comment comment
secure  the hash password generated on offer, advertiser level
custom_field1 - custom_field7  custom field 1 - custom field 7

* - 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 support@affise.com or your internal live-chat as long as to contact your dedicated Account Manager. 

Updated by Anastasia Dziaruhina 

 

Was this article helpful?
5 out of 6 found this helpful
Have more questions? Submit a request

0 Comments

Article is closed for comments.