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.

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.

Base attribution link URL

https://singulardevice.sng.link/XXXXX/XXXXX?_smtype=3&idfa={idfa}&aifa={gaid}&ip={ip}&psid={publisher_id}&pcid={camp_id}&pssid={source}&paffid={aff_id}&cl={click_id}&paffn={aff_name}&p={os}

Singular base URL	Definition	Description
https://singularassist.sng.link/D59c0/ohkp?	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

Note

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

Singular parameter	Appcarry macro	Description
&cl=	{click_id}	Request the ID for each user session
&psid=	{publisher_id}	ID of the Publisher promoting an offer
&pssid=	{sub_publisher_id}	ID of the Sub publisher promoting the offer
&aifa=	{gaid}	Android ID
&idfa=	{idfa}	iOS ID
&ip=	{click_ip}	IP
&p	{click_os_name}	Operating System
&pcid	{campaign_id}	Partner Campaign ID
&paffid	{publisher_id}	Publisher Affiliate ID

Postback URLs 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

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

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

Postback parameters

Appcarry Postback URL	Description
network.yourdomain.com	Network ID (domain) name Provided by Appcarry
security_token	Provided by Appcarry
goal	In-app event name Event name Defined by the advertiser
click_id	For Click ID
gaid	For Android ID
idfa	For iOS ID
revenue	For receiving the sale amount
currency	To receive the currency
{custom_param1} to {custome_param5}	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.

Copy the below email and send it to partners-int@singular.net cc: support@appcarry.com

Hi Singular team,

We would like to initiate the integration process between Singular and Appcarry. Please find below Install and Event Postback

Attribution	Description
Global Install Postback	https://demo.appcarry.live/acquisition?security_token=6988c0bc-d56b-3ea5-8a6d-f2778d7fb746&click_id={CLICK_ID}&idfa={idfa}&gaid={gaid}
Event Postback	https://demo.appcarry.live/acquisition?security_token=6988c0bc-d56b-3ea5-8a6d-f2778d7fb746&click_id={CLICK_ID}&idfa={idfa}&gaid={gaid}&goal={event_name}

Macro List for Tracking link URL

Macro	For
{click_id}	Click Id
{publisher_id}	Publisher id
{sub_publisher_id}	Sub Publisher Id
{gaid}	Android device ID
{idfa}	iOS device ID
{goal}	Event name

Singular Appcarry Integration