How Moloco validates Adjust 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 Adjust server. This guide includes everything you need to know about Adjust tracking links.

 

Anatomy of an Adjust tracking link

Adjust tracking links consist of the following properties. Be sure to check that your auto-generated Adjust tracking links include all of the following information.

Adjust parameter

Macro value from Moloco

Macro value from Moloco (legacy value)

Description 

campaign

{{campaign.title}}

%{campaign}

Campaign

adgroup

{{publisher.bundle}}

%{raw_app_bundle}

Ad group

creative

{{creative.cr_id}}

%{creative_id}

Creative

idfa

{{device.idfa}}

%{i_idfa}

IDFA

gps_adid

{{device.gaid}}

%{device.a_idfa}

GAID 

impression_id

{{request.id}}

%{bid_id}

Ad-request ID provided by exchanges

molo_click_id

{{mtid}}

%{mtid}, %{source} 

Moloco Internal ID

cost_type

{{price.cost_type}}

%{cost_type}

Cost type (e.g., CPM)

cost_amount

{{price.cost_amount}}

%{cost_amount}

Cost amount

cost_currency

{{price.cost_currency}}

%{cost_currency}

Cost currency

 

Regular tracking link

This section describes how Moloco validates Regular 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://view.adjust.io/

- https://view.adjust.com/

- https://view.adjust.world/

- https://app.adjust.io/

- https://app.adjust.com/

- https://app.adjust.world/

 

Path

Moloco Ads validates the path 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's path value isn't in the required format.

Tracking link type Path value format Example
Impression 6 or more alphanumeric characters starting with /impression/ https://view.adjust.com/impression/abc123
Click 6 or more alphanumeric characters

https://app.adjust.com/abc123

 

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

 

Universal link

This section describes how Moloco validates Universal links. To learn how to resolve common tracking link related errors, see the troubleshooting guide

 

Host

The URL host for Universal links must end with adj.st.

e.g., https://abc123.adj.st

Important: You are required to register the host value at the app registration stage before proceeding with the tracking link registration process. Before registering a new tracking link, go to Apps and click Create to register a new app first. On the New App page, selecting ADJUST for MMP displays Universal link host where you can enter the host value for your Universal link. An error message is displayed when the host value hasn't been registered during app registration. Screenshot

 

Path

A Universal link may not have a path value. If it has one, it must be comprised of letters, digits, and underscores.

e.g., https://abc123.adj.st/abc_123/

 

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
&adjust_molo_click_id {{mtid}}  
&adjust_idfa {{device.idfa}} iOS only
&adjust_gps_adid {{device.gaid}} Android only

 

Branded link

This section describes how Moloco validates Branded links. To learn how to resolve common tracking link related errors, see the troubleshooting guide

 

Host

The URL hostname for Adjust branded links must end with go.link.

e.g., https://abc123.go.link

Important: You are required to register the host value at the app registration stage before proceeding with the tracking link registration process. Before registering a new tracking link, go to Apps and click Create to register a new app first. On the New App page, selecting ADJUST for MMP displays Branded link host where you can enter the host value for your Branded link. An error message is displayed when the host value hasn't been registered during app registration.  Screenshot

 

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
&adjust_molo_click_id {{mtid}}  
&adjust_idfa {{device.idfa}} iOS only
&adjust_gps_adid {{device.gaid}} Android only

 

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request