Follow

Affise Parameters & Macros for the S2S Integration With Affiliate

Time to read: 7 min.

topic.png 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:

Markup 2020-05-07 at 19.10.37.png

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.

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

ref1.png

ref2.png

Or set by you inAffiliates’ section - > Affiliate Management - > ‘Edit’ affiliate - > ‘Affiliate postbacks’:

Markup 2020-05-07 at 19.13.07.png

 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’.

Markup 2020-05-07 at 19.15.39.png

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.

article.pngYou may also find the following articles helpful:

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 

 

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

0 Comments

Please sign in to leave a comment.