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 Singular's server.
Tracking Link Parameters
|
Parameter by Singular |
Macro value by Moloco |
Macro value by Moloco(Legacy) |
Description by Singular |
|
aifa |
{{device.gaid} |
%{a_idfa} |
Android GAID |
|
idfa |
{{device.idfa}} |
%{i_idfa} |
IOS IDFA |
|
pcn |
{{campaign.title}}
|
%{campaign} |
campaign name |
|
pcid |
{{campaign.id} |
%{campaign_name} |
campaign ID |
|
pcrid |
{{creative.id}} |
%{creative_id} |
creative ID |
|
pcrn |
{{creative.filename}}
|
%{creative_filename} |
creative name |
|
psid |
{{publisher.bundle}}
|
%{raw_app_bundle} |
publisher ID |
|
pshid |
{{publisher.encoded_bundle}}
|
%{encoded_app_bundle} |
publisher ID |
|
psn |
{{publisher.name}}
|
%{app_title} |
app title |
|
pscn |
{{adgroup.title}}
|
%{adgroup_title} |
adgroup name |
|
pscid |
{{adgroup.id}}
|
%{adgroup_id} |
adgroup ID |
|
p |
{{device.os}}
|
%{os} |
platform |
|
ve |
{{device.osv}}
|
%{os_ver} |
device version |
|
ip |
{{device.ip}} |
%{ip_address} |
ip address |
|
cl |
{{request.id}} |
%{bid_id} |
click ID |
|
imp_id |
{{request.id}} |
%{bid_id} |
impression ID |
|
mtid |
{{mtid}} |
%{mtid} |
custom parameter |
|
ua |
{{device.user_agent}}
|
%{user_agent} |
user agent |
|
lc |
{{device.language}}
|
%{device_language} |
device language |
Host
This section describes how Moloco validates Singular 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://i.sng.link/ - https://i.singular.net/ - https://i.apsalar.com/ |
- ending with "sng.link" (Example: https://c.sng.link/) - ending with "singular.net" (Example: https://c.singular.net/ - ending with "apsalar.com" (Example: https://c.apsalar.com/) |
Path
The path validation is also divided into 2 types: impression and click. You will see the error message if the path value is different from the usual Singular's path format as below:
| Type | Format | Example |
| Impression |
-“/api/v1/imp” - any combination of letters, digits, and underscores |
- https://i.sng.link/api/v1/imp - https://i.sng.link/a_bCD1233 |
| Click |
-“/api/v1/ad” - any combination of letters, digits, and underscores |
-https://c.sng.link/api/v1/ad - https://c.sng.link/a_bCD123 |
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 |
| &mtid | {{mtid}} | |
| &i_idfa OR &idfa | {{device.idfa}} | IOS only |
| &a_idfa OR &aifa | {{device.gaid}} | Android only |