How Moloco validates AppsFlyer tracking links

  • Updated

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  Macro value from Moloco (legacy value) Property Macro value 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 Ads. 
 
af_c_id {{campaign.id}}
%{campaign_name}
CT,VT
This is the Campaign ID in alphanumeric format on Moloco Ads. 
 
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 Moloco Ads. 
 
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

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  
&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 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  
&af_sub4 {{mtid}}  
&idfa {{device.idfa}} iOS only
&advertising_id {{device.gaid}} Android only

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request