Skip to main content

Macros

How to configure macros

J
Written by Jorge Rubia
Updated over 5 months ago

Many parameters can be sent from the affiliate to the advertiser and back to the affiliate. This article will explain all these parameters and how to configure them.

Affiliate - Tracking URL

In the affiliate configuration form, you can select all the parameters that can be included in the affiliate tracking link. Here is the complete list of parameters.

Parameter name

Can it be passed to the advertiser?

Related macros in the offer URL

click_id

no

{affiliate_click_id}

aggregate_id

no

source

yes

{source}, {source_plain}

sub_source

yes

{subsource}, {subsource_plain}

placement

yes

{placement}

app_name

yes

{app_name}

app_id

yes

{app_id}

site

yes

{site}

creative

yes

{creative}

idfa

yes

{idfa}

gaid

yes

{gaid}

custom1

yes

{custom1}

custom2

yes

{custom2}

custom3

yes

{custom3}

custom4

yes

{custom4}

custom5

yes

{custom5}

custom6

yes

{custom6}

custom7

yes

{custom7}

custom8

yes

{custom8}

user_ip

yes

{declared_user_ip}

user_agent

yes

{declared_user_agent}

user_language

yes

{declared_user_language}

The parameters you fill in will be included in the affiliate tracking URL. You can set fixed values or macros using branches, brackets, or whatever you agree with the affiliate. For example:

So as a result, the affiliate tracking URL for an offer will include these parameters:

https://your-affiliate-tracking-url?offer_id=1&publisher_id=1&click_id={REPLACE}&source=[Source]&sub_source={{Sub_Source}}&custom1=MyCustomValue

Offer

In the offer form, you can select all the parameters in the offer URL and the impression URL. Here is the complete list of parameters.

Advertiser parameter

Offer macro

Comments

The related parameter in the affiliate tracking URL

Related macros in the postback URL

your_advertiser_param_for_click_id

{click_id}

This is the internal click ID nor the affiliate click ID.

{click_id}

your_advertiser_param_for_aggregate_id

{aggregate_id}

This is the internal aggregated ID nor the affiliate aggregated ID

{aggregated_id}

your_advertiser_param_for_source

{source}

Affiliate source encrypted

source

your_advertiser_param_for_subsource

{subsource}

Affiliate subsource encrypted

sub_source

your_advertiser_param_for_source_plain

{source_plain}

Affiliate source, original value

source

your_advertiser_param_for_sub_source_plain

{sub_source_plain}

Affiliate subsource, original value

sub_source

your_advertiser_param_for_affiliate_id

{affiliate_id}

Internal affiliate ID encrypted

your_advertiser_param_for_affiliate_id_plain

{affiliate_id_plain}

Internal affiliate ID, the original value

your_advertiser_param_for_affiliate_click_id

{affiliate_click_id}

Affiliate click ID

click_id

your_advertiser_param_for_app_name

{app_name}

Affiliate app name

app_name

your_advertiser_param_for_app_id

{app_id}

Affiliate app ID

app_id

your_advertiser_param_for_site

{site}

Affiliate site

site

your_advertiser_param_for_creative

{creative}

Affiliate creative

creative

your_advertiser_param_for_idfa

{idfa}

Affiliate IDFA

idfa

your_advertiser_param_for_gaid

{gaid}

Affiliate GAID

gaid

your_advertiser_param_for_declared_user_ip

{declared_user_ip}

Affiliate declared user IP

user_ip

your_advertiser_param_for_declared_user_agent

{declared_user_agent}

Affiliate declared user agent

user_agent

your_advertiser_param_for_declared_user_language

{declared_user_language}

Affiliate declared user browser language

user_language

your_advertiser_param_for_advertising_id

{advertising_id}

Advertising ID

your_advertiser_param_for_request_ip

{request_ip}

Original IP from which the click or impression is received

your_advertiser_param_for_country_code

{country_code}

your_advertiser_param_for_region

{region}

Region

your_advertiser_param_for_city

{city}

City

your_advertiser_param_for_postal_code

{postal_code}

Postal code

your_advertiser_param_for_metro_code

{metro_code}

Metro code

your_advertiser_param_for_user_agent

{user_agent}

User agent

your_advertiser_param_for_os

{os}

OS

your_advertiser_param_for_os_version

{os_version}

OS version

your_advertiser_param_for_brand

{brand}

Brand

your_advertiser_param_for_model

{model}

Model

your_advertiser_param_for_language

{language}

Browser language

your_advertiser_param_for_carrier

{carrier}

Carrier

your_advertiser_param_for_browser

{browser}

Browser

your_advertiser_param_for_browser_version

{browser_version}

Browser version

your_advertiser_param_for_landing_page_id

{landing_page_id}

Landing page ID

your_advertiser_param_for_landing_page_name

{landing_page_name}

Landing page name

your_advertiser_param_for_af_os_version

{af_os_version}

your_advertiser_param_for_af_device_model

{af_device_model}

your_advertiser_param_for_custom1

{custom1}

Affiliate custom1

custom1

your_advertiser_param_for_custom2

{custom2}

Affiliate custom2

custom2

your_advertiser_param_for_custom3

{custom3}

Affiliate custom3

custom3

your_advertiser_param_for_custom4

{custom4}

Affiliate custom4

custom4

your_advertiser_param_for_custom5

{custom5}

Affiliate custom5

custom5

your_advertiser_param_for_custom6

{custom6}

Affiliate custom6

custom6

your_advertiser_param_for_custom7

{custom7}

Affiliate custom7

custom7

your_advertiser_param_for_custom8

{custom8}

Affiliate custom8

custom8

your_advertiser_param_for_random_10

{random_10}

Random from 1..10

your_advertiser_param_for_random_20

{random_20}

Random from 1..20

your_advertiser_param_for_random_50

{random_50}

Random from 1..50

your_advertiser_param_for_random_100

{random_100}

Random from 1..100

Advertiser - Postback URL

The advertiser's postback URL can be obtained in the advertiser configuration form. The complete list of parameters is here.

Parameter name

Can it be passed to the advertiser?

Related macros in the offer URL

click_id

{aftrad_click_id}

{click_id}

aggregated_id

{aftrad_aggregated_id}

{aggregate_id}

event_parameter

{event_type}

N/A. This value is configured in the offer's payout rules

payout

{payout_in_USD}

N/A. This value is configured in the offer's payout rules

Affiliate - Postback URL

In the affiliate configuration form, you can set a postback URL to notify the affiliate about events, payables, and KPIs. Here is the complete list of parameters.

Parameter name

Can it be passed to the advertiser?

Related macros in the offer URL

your_affiliate_param_for_click_id

{affiliate_click_id}

Affiliate click ID

your_affiliate_param_payout

{payout}

Affiliate Payout in USD

your_affiliate_param_for_source

{source}

Affiliate source

your_affiliate_param_for_sub_source

{sub_source}

Affiliate sub source

your_affiliate_param_for_placement

{placement}

Affiliate placement

your_affiliate_param_for_app_name

{app_name}

Affiliate app name

your_affiliate_param_for_app_id

{app_id}

Affiliate app ID

your_affiliate_param_for_site

{site}

Affiliate site

your_affiliate_param_for_creative

{creative}

Affiliate creative

your_affiliate_param_for_idfa

{idfa}

Affiliate IDFA

your_affiliate_param_for_gaid

{gaid}

Affiliate GAID

your_affiliate_param_for_advertising_id

{advertising_id}

Affiliate advertising ID

your_affiliate_param_for_appsFlyer_os_version

{af_os_version}

AppsFlyer OS version

your_affiliate_param_for_appsFlyer_device_model

{af_device_model}

AppsFlyer Device model

Did this answer your question?