Tracking links record how users interact with your ad. User activity is reported in the form of views and clicks. After a user has viewed and clicked your ad, the user is redirected to download the app. The ad view and ad click each 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 components
Component | 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 auto-generated AppsFlyer tracking links include all of the following information.
AppsFlyer parameter | Macro value from Moloco | Property | Macro value description | Note |
clickid | {{mtid}} | CT,VT | MTID. Moloco uses this to identify attribution. | |
pid | moloco_int | CT,VT |
Hardcoded value is
moloco_int |
|
c | {{campaign.title}} | CT,VT |
This is the campaign name on Moloco Ads.
|
|
af_c_id | {{campaign.id}} | CT,VT |
This is the Campaign ID in alphanumeric format on Moloco Ads.
|
|
af_siteid | {{publisher.bundle}} | CT,VT |
This is the Store ID of the publisher where ad is displayed.
|
|
af_cost_currency | {{price.cost_currency}} | CT,VT | Cost currency | |
af_cost_value | {{price.cost_amount}} | CT,VT | Cost amount | |
af_cost_model | {{price.cost_type}} | CT,VT | Cost type | |
af_ad_type | {{creative.type}} | CT,VT |
Creative file name.
|
|
af_ad_id | {{creative.cr_id}} | CT,VT |
This is the Creative ID on Moloco Ads.
|
|
af_ad | {{creative.title}} | CT,VT | Creative title | |
af_adset | {{adgroup.title}} | CT,VT | Ad group name | |
af_adset_id | {{adgroup.id}} | CT,VT | ||
advertising_id | {{device.gaid}} for Android and {{device.idfa}} for iOS | CT,VT | ADID (Android) or IDFA (iOS) | |
af_click_lookback | 7d | CT | Hardcoded value | |
af_viewthrough_lookback | 1d | VT | Hardcoded value | |
&af_sub1 | {{skan.version}} | CT,VT | SKAdNetwork (SKAN) version | iOS Only |
&af_lang | {{device.language}} | CT,VT | Device language | S2S |
&af_ua | {{device.user_agent}} | CT,VT | User-Agent | S2S |
&af_channel | {{request.exchange}} | CT,VT | Ad exchange name |
[Android] Sample click-through tracking link
https://app.appsflyer.com/com.appsflyer.adNetworkTest
?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={{mtid}}
&advertising_id={{device.gaid}}
&af_c_id={{campaign.id}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
[Android] Sample view-through tracking link
https://impression.appsflyer.com/com.appsflyer.adNetworkTest
?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={{mtid}}
&advertising_id={{device.gaid}}
&af_c_id={{campaign.id}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
[iOS] Sample click-through tracking link
https://app.appsflyer.com/id554782625
?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={{mtid}}
&idfa={{device.idfa}}
&af_c_id={{campaign.id}}
&af_sub1={{skan.version}}
&af_lang={{device.language}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
[iOS] Sample view-through tracking link
https://impression.appsflyer.com/id554782625
?c={{campaign.title}}
&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={{mtid}}
&idfa={{device.idfa}}
&af_c_id={{campaign.id}}
&af_sub1={{skan.version}}
&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
Moloco Ads 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
Moloco Ads 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 macro value pairs. You won't be able to create or update a tracking link if any of the following is missing.
Parameter | Macro value | Note |
&pid | moloco_int | |
&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., https://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 macro value pairs. You won't be able to create or update a tracking link if any of the following is missing.
Parameter | Macro value | Note |
&pid | moloco_int | |
&idfa | {{device.idfa}} | iOS only |
&advertising_id | {{device.gaid}} | Android only |