Appsflyer tracking link validation by Moloco

  • Updated

Tracking Link Basic 

Tracking links report user activity with your ad. The activity is reported via a click on your ad or a view.

When a user clicks on an attribution link the user is redirected to download the app. The click triggers a notification to AppsFlyer's server. 

 

Tracking Link Parameters

AppsFlyer tracking links contain the following mandatory information:

    • AppsFlyer endpoint: app.appsflyer.com
    • app_id: Your unique identifier in the AppsFlyer platform. This usually follows the format of ID in the Apple App Store or Google Play. 
    • media_source: Moloco unique partner identifier 

Parameter by AppsFlyer Macro value by Moloco  Macro value by Moloco (Legacy) Property Macro description Note
af_sub4 {{mtid}} %{mtid} CT,VT
MTID (Protostring used by Moloco to identify attribution)
 
clickid {{request.id}} %{bid_id} CT,VT Impression ID  
pid moloco_int moloco_int CT,VT
Hardcoded value = moloco_int
 
c {{campaign.title}} %{campaign} CT,VT
Campaign Display Name (campaign name on MCP/MRP)
 
af_c_id {{campaign.id}}
%{campaign_name}
CT,VT
Campaign ID (alphanumeric campaign ID on MCP/MRP)
 
af_siteid {{publisher.bundle}}
%{raw_app_bundle}
CT,VT
Store ID of the publisher where ad appeared
 
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 Filename (usually set by client)
 
af_ad_id {{creative.cr_id}} %{creative_id} CT,VT
Creative ID (Can be found in MCP/MRP)
 
af_ad {{creative.title}} %{creative_title} CT,VT creative title  
af_adset {{adgroup.title}} %{adgroup_title} CT,VT Adgroup name  
af_adset_id {{adgroup.id}} %{adgroup_id} CT,VT    
advertising_id
{{device.gaid}} for ANDROID
%{a_idfa} for ANDROID
CT,VT    
  {{device.idfa}} for IOS
%{i_idfa} for IOS
CT,VT    
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 {{device.osv}} %{os_ver} CT,VT OS version IOS Only
&af_sub1 {{skan.version}} %{skan.version} CT,VT SKAdnetwork 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

 

Note: If you want to set a View-through window for probabilistic attribution, use the following parameter instead of %af_viewthrough_lookback: &af_vt_pmod_lookback_window={desired_window}

Click-through Tracking Link Example (Android)

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}}

 

View-through Tracking Link Example (Android)

https://impression.appsflyer.com/com.appsflyer.adNetworkTest
?af_sub4={{mtid}}
&c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{cretive.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}}

 

Click-through Tracking Link Example (IOS)

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={{device.osv}}
&af_ip={{device.ip}}
&af_lang={{device.language}}
&af_ua={{device.user_agent}}

 

View-through Tracking Link Example (IOS)

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={{device.osv}}
&af_ip={{device.ip}}
&af_lang={{device.language}}
&af_ua={{device.user_agent}}

 

Regular Tracking Link

Host

This section describes how Moloco validates Appslfyer tracking links. For general guidelines, you may refer to How to resolve a tracking link registration error. The host validation is divided into 2 types: Impression and click. You will see the error message if each tracking link type does not match the below:

Impression Click
https://impression.appsflyer.com/ https://app.appsflyer.com/

Path

The path validation checks the OS compatibility. You will see the error message if 1) the selected App OS differs from the tracking link's OS, and 2) the path value is different from the usual Appsflyer's path format as below (equivalent to the corresponding app market store's package names):

OS Format Example
Android alphanumeric characters separated by a period https://impression.appsflyer.com/moloco.cloud.portal
iOS digits beginning with `id`

https://impression.appsflyer.com/id111110100

Required Parameters

Below is the specification of required parameter <> value pairs for successful Moloco campaigns – Tracking link creation/update will fail if any of them are missing:

Parameter Value  Note
&pid moloco_int  
&af_sub4 {{mtid}}  
&idfa {{device.idfa}} IOS only
&advertising_id {{device.gaid}} Android only

 

OneLink

Host

The URL host for Appsflyer OneLinks must end with "onelink.me". (Example: httsp://qbc123.onelink.me).

Path

The path for Appsflyer OneLinks may not exist – if exists, it must be comprised of any letters, digits, and underscores.

Required Parameters

The criteria are identical to Appsflyer regular tracking links.

Parameter 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