Tracking links record how users interact with your ad. User activity is reported in the form of clicks or views. After a user has clicked an attribution link, the user is redirected to download the app. The click then triggers a notification to the AppsFlyer server. This guide includes everything you need to know about Appsflyer tracking links.
Anatomy of an Appsflyer tracking link
Required tracking link parameters
Parameter | Description |
app.appsflyer.com | This is the endpoint for Appsflyer. |
app_id | This is your unique identifier in Appsflyer. Format generally follows that of Apple App Store or Google Play ID. |
media_source | This is Moloco's unique identifier for the partner (i.e., Appsflyer). |
AppsFlyer tracking links consist of the following properties. Be sure to check that your Appflyer tracking links include all of the following information.
Appsflyer parameter | Macro value from Moloco | Macro value from Moloco (Legacy) | Property | Macro description | Note |
af_sub4 | {{mtid}} | %{mtid} | CT,VT |
MTID. This is the protostring Moloco uses to identify attribution.
|
|
clickid | {{request.id}} | %{bid_id} | CT,VT | Bid ID | |
pid | moloco_int | moloco_int | CT,VT |
Hardcoded value is moloco_int
|
|
c | {{campaign.title}} | %{campaign} | CT,VT |
This is the campaign name on Moloco Cloud DSP.
|
|
af_c_id | {{campaign.id}} |
%{campaign_name}
|
CT,VT |
This is the Campaign ID in alphanumeric format on Moloco DSP.
|
|
af_siteid | {{publisher.bundle}} |
%{raw_app_bundle}
|
CT,VT |
This is the Store ID of the publisher where ad is displayed.
|
|
af_cost_currency | {{price.cost_currency}} |
%{cost_currency}
|
CT,VT | Cost currency | |
af_cost_value | {{price.cost_amount}} | %{cost_amount} | CT,VT | Cost amount | |
af_cost_model | {{price.cost_type}} | %{cost_type} | CT,VT | Cost type | |
af_ad_type | {{creative.type}} |
%{creative_type}
|
CT,VT |
Creative file name.
|
|
af_ad_id | {{creative.cr_id}} | %{creative_id} | CT,VT |
This is the Creative ID on the Cloud DSP.
|
|
af_ad | {{creative.title}} | %{creative_title} | CT,VT | Creative title | |
af_adset | {{adgroup.title}} | %{adgroup_title} | CT,VT | Ad group name | |
af_adset_id | {{adgroup.id}} | %{adgroup_id} | CT,VT | ||
advertising_id | {{device.gaid}} for Android and {{device.idfa}} for iOS | %{a_idfa} for Android and %{i_idfa} for iOS | CT,VT | ADID (Android) or IDFA (iOS) | |
af_click_lookback | 7d | 7d | CT | Hardcoded value | |
af_viewthrough_lookback | 1d | 1d | VT | Hardcoded value | |
&af_model | {{device.model}} |
%{device_model}
|
CT,VT | Device model | iOS Only |
&af_os_version | {{device.osv}} | %{os_ver} | CT,VT | OS version | iOS Only |
&af_sub1 | {{skan.version}} | %{skan.version} | CT,VT | SKAdNetwork (SKAN) version | iOS Only |
&af_ip | {{device.ip}} | %{ip_address} | CT,VT | IP address | S2S |
&af_lang | {{device.language}} |
%{device_language}
|
CT,VT | Device language | S2S |
&af_ua | {{device.user_agent}} | %{user_agent} | CT,VT | User-Agent | S2S |
&af_channel | {{request.exchange}} | %{exchange} | CT,VT | Ad exchange name |
[Android] Sample click-through tracking link
https://app.appsflyer.com/com.appsflyer.adNetworkTest
?af_sub4={{mtid}}
&c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.type}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_click_lookback=7d
&clickid={{request.id}}
&advertising_id={{device.gaid}}
&af_c_id={{campaign.id}}
&af_ip={{device.ip}}
&af_ua={{device.user_agent}}
&af_os_version={{device.osv}}
&af_model={{device.model}}
&af_channel={{request.exchange}}
[Android] Sample view-through tracking link
https://impression.appsflyer.com/com.appsflyer.adNetworkTest
?af_sub4={{mtid}}
&c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.type}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_viewthrough_lookback=1d
&clickid={{request.id}}
&advertising_id={{device.gaid}}
&af_c_id={{campaign.id}}
&af_ip={{device.ip}}
&af_ua={{device.user_agent}}
&af_os_version={{device.osv}}
&af_model={{device.model}}
&af_channel={{request.exchange}}
[iOS] Sample click-through tracking link
https://app.appsflyer.com/id554782625
?af_sub4={{mtid}}
&c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.type}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_click_lookback=7d
&clickid={{request.id}}
&idfa={{device.idfa}}
&af_c_id={{campaign.id}}
&af_sub1={{skan.version}}
&af_model={{device.model}}
&af_os_version={{device.osv}}
&af_ip={{device.ip}}
&af_lang={{device.language}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
[iOS] Sample view-through tracking link
https://impression.appsflyer.com/id554782625
?af_sub4={{mtid}}
&c={{campaign.titl}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.title}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_viewthrough_lookback=1d
&clickid={{request.id}}
&idfa={{device.idfa}}
&af_c_id={{campaign.id}}
&af_sub1={{skan.version}}
&af_model={{device.model}}
&af_os_version={{device.osv}}
&af_ip={{device.ip}}
&af_lang={{device.language}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
Normal tracking link
This section describes how Moloco validates Normal tracking links. To learn how to resolve common tracking link related errors, see the troubleshooting guide.
Host
The Cloud DSP validates the host value for the following tracking link types: impression (i.e., view) and click. An error message is displayed in the event that your tracking link doesn't include the following host value or your tracking link's host value is different from the following.
Impression | Click |
https://impression.appsflyer.com/ | https://app.appsflyer.com/ |
Path
The Cloud DSP validates the path value for OS compatibility. An error message is displayed when one of the following applies.
1) The OS selected for the app is different from the tracking link's OS.
2) The path value is different from Appsflyer's path format as in the following table. Path value must be identical to the corresponding app market store's package name.
OS type | Path value format | Example |
Android | Alphanumeric characters separated by a period | https://impression.appsflyer.com/moloco.cloud.portal |
iOS | Numeric digits beginning with id |
https://impression.appsflyer.com/id111110100 |
Your tracking link's path value, which is the app_id
value, must be identical to the MMP bundle ID of the app it is linked to. When a mismatch between the two values is detected, an error message is displayed.
Required parameters
The following table shows the specifications for required parameter and value pairs. You won't be able to create or update a tracking link if any of the following is missing.
Parameter | Value | Note |
&pid | moloco_int | |
&af_sub4 | {{mtid}} | |
&idfa | {{device.idfa}} | iOS only |
&advertising_id | {{device.gaid}} | Android only |
OneLink
This section describes how Moloco validates OneLink tracking links. To learn how to resolve common tracking link related errors, see the troubleshooting guide.
Host
The URL host for OneLink tracking links must end with onelink.me
.
e.g., httsp://qbc123.onelink.me
Path
A OneLink tracking link may not have a path value. If it has one, it must be comprised of letters, digits, and underscores.
Required parameters
The following table shows the specifications for required parameter and value pairs. You won't be able to create or update a tracking link if any of the following is missing.
Parameter | Value | Note |
&pid | moloco_int | |
&af_sub4 | {{mtid}} | |
&idfa | {{device.idfa}} | iOS only |
&advertising_id | {{device.gaid}} | Android only |