How Moloco validates Singular tracking links

  • 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 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.sing.link/

- https://i.singular.net/

- https://i.apsalar.com/

- ending with "sng.net" (Example: https://c.sng.net/)

- 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.net/api/v1/ad

- https://c.sng.net/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

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request