This article is intended for ad networks that want to integrate with the Singular. Singular can send Trackier attribution data for both installs and in-app events. 



TABLE OF CONTENTS


To begin integration, provide Singular with both the attribution link URL and the postback URL. The URLs are needed for reporting purposes. This article explains how to build these URLs.


Note

The integration will be done with Network Level Event and Install Postback, so you don't need to change the Postback if you are working with multiple advertisers.

This section provides the base attribution link and related parameter descriptions.

https://singularassist.sng.link/D59c0/ohkp?st=xxxxxxxxxxxxxx&idfa={idfa}&aifa={gaid}&psid={pub_id}&pcid={camp_id}&cl={click_id}&pcn={campaign_title}&pscn={creative_name}&h=xxxxxxxxxxxxxxx

Singular base URLDefinitionDescription

https://singularassist.sng.link/D59c0/ohkp?

Base URL

Singular endpoint 

&st=xxxxx&h=xxxxApplication IDDynamic value that differs for each app

~cl=

Click Id 

Parameter for click id

Note


The attribution links in the following table are mandatory
See complete parameter lists for:


Singular parameterTrackier macroDescription

&cl=

{click_id}

Request the ID for each user session

&psid=

{publisher_id}

ID of the Publisher promoting an offer 

&pssid={source}

ID of the Sub publisher promoting the offer

&aifa=

{gaid}

Android ID

&idfa={idfa}Ios ID

Postback URLs for install and in-app events

This section provides examples of postback URLs and parameters for install and in-app events. 

Install postback URLs

http://network.yourdomain.com/acquisition?click_id={cl?Network Name}&security_token=xxxxxxxxxxxxxxx&idfa={IDFA}&gaid={AIFA}


Event postback URLs

http://network.yourdomain.com/acquisition?click_id={cl?Network Name}&security_token=xxxxxxxxxxxxxxx&idfa={IDFA}&gaid={AIFA}&goal_vlaue={EVTNAME}


Postback parameters 

Trackier Postback URLDescription
network.yourdomain.com
  • Network ID (domain) name
  • Provided by Trackier
security_tokenProvided by Trackier
goal_value
  • In-app event name
  • Event name Defined by the advertiser
click_idFor Click ID
gaid

For Android ID

idfaFor Ios ID


Finalising your registration


Already integrated with Singular? Send the URLs to partners-int@singular.net.

Not yet integrated with Singular? Complete the Ad partners registration application.

Note

You can download the Sample of Singular Partner Form click here.
Also, share this Article with the Singular team for Integration reference.


You can find the content to email in your panel in the platform itself, Go to Automation > Integration > MMP Partner > Singular.
You will find there the following:

  • Network Level Install Postback
  • Network Level Event Postback
  • Trackier Macro List
  • Sample Attribution URL


Confirmation from Singular


Wait for 24-72 hours for the response from Singular Team, once the integration is complete they will update you via registered email. Once you are done, you can create a Test campaign with the Singular App, test the tracking link and add Goal as per Partner Event Identifier.


In case you have any issue please mail us at support@trackier.com