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:

sub1-sub8 Parameters for all kinds of information
os_id An additional parameter
ext1-ext3 Additional parameters
ref_id An additional parameter

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 - > A certain offer

addpb.png

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

Markup 2020-05-07 at 19.13.07.png

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.

Annotation_on_2020-11-27_at_14-18-14.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’.

PB.png

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.

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.