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://view.adjust.net.in/ |
- https://app.adjust.io/ - https://app.adjust.com/ - https://app.adjust.world/ - https://app.adjust.net.in/ |
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.
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.
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 |