At a glance: This article is intended for ad networks that want to integrate with the Singular MMP platform. Singular can send Trackier attribution data for both installs and in-app events.
Overview
To begin integration, provide Singular with the postback URL and generate the attribution link URL on Singular. The URLs are needed for tracking and reporting of install and in-app events. This article explains how to build these URLs.
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.
Attribution link URL
This section provides the base attribution link and related parameter descriptions.
Singular base URL | Definition | Description |
Base URL | Singular endpoint | |
&st=xxxxx&h=xxxx | Application ID | Dynamic value that differs for each app |
~cl= | Click Id | Parameter for click ID |
Attribution link parameters
Singular parameter | Trackier macro | Description |
&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 |
&ip= | {ip} | IP of the user clicking on the campaign |
&p | {os} | Operating System of the device used |
&pcid | {camp_id} | Partner Campaign ID |
&paffid | {aff_id} | Publisher long ID |
&paffn | {aff_name} | Name of the publisher running the campaign |
Note: For the complete Trackier macro list, click here
Postback URLs for install and in-app events
You can go to the Automation section, click on Integrations, and navigate to mobile app tracking. You will be redirected to the mobile app tracking page. Navigate to Singular and click on Setup Instructions.
You will be able to find your global install and global event postback, which you can further share with Singular.
Example Install Postback: http://network.yourdomain.com/acquisition?click_id={cl?Network Name}&security_token=xxxxxxxxxxxxxxx&idfa={IDFA}&gaid={AIFA}
Example Event postback: http://network.yourdomain.com/acquisition?click_id={cl?Network Name}&security_token=xxxxxxxxxxxxxxx&idfa={IDFA}&gaid={AIFA}&goal_value={EVTNAME}
For complete list of singular postback macros, click here
Postback parameters
Trackier Postback URL | Description |
network.yourdomain.com |
|
security_token | Provided by Trackier |
goal_value |
|
click_id | For Click ID |
gaid | For Android ID |
idfa | For Ios ID |
sale_amount | For receiving the sale amount |
currency | To receive the currency |
sub1 - sub10 | Open parameters |
Finalizing 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 Singular Partner Form by clicking here.
Also, share this article with the Singular team for integration reference.
You can find the content to email on the platform itself. Go to the Singular setup instructions in the Mobile App section in the Automation segment.
You will find there the following:
Global Install Postback
Global Event Postback
Trackier Macro List
Confirmation from Singular
Wait for 24–72 hours for the response from the 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 a goal as per the partner event identifier.
We're thrilled to have put together a top-notch team of qualified experts who are available to handle any of your concerns and respond to any inquiries you may have. You can contact us at any time by sending an email to support@trackier.com or using the in-platform chat feature.
