We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

for Partners

Delayed Attribution API

With the server-to-server Delayed Attribution API, TV partners can overwrite an install originally attributed to “Organic” for a device. This lets you claim an install up to 7 days after it happens.

Before you begin

To work with this API you will need an API token from Adjust. Reach out to integration@adjust.com to request this.

Endpoint

https://s2s.adjust.com/delayed_attribution

POST Method

This API requires the POST method to overwrite the device’s original organic install attribution.

Important:

You can only send us attribution information for installs up to 7 days old. Try making your callbacks to the API as frequent and early as possible.

API Parameters

Required parameters

Parameter	Data type	Description	Example
`tracker`	String	Adjust's organic link token for this app.	`foobar`
`partner_token`	String	Supplied by Adjust, unique to each attribution partner.	`8wfxq4brf343`
`click_time`	Date	The television advertisement airing time in UTC (the format is mandatory).	`2006-01-02T15:04:05`

Device ID parameters

You must include at least one of the following parameters, and as many as possible.

Parameter	Data type	Description	Example
`adid`	String	Adjust device id contained in our callbacks.	`e3f5536a141811db40efd6400f1d0a4e`
`idfa`	String	iOS Id for Advertisers.	`D2CADB5F-410F-4963-AC0C-2A78534BDF1E`
`idfv`	String	iOS Id for Vendors.	`EF76726C-D952-451C-8E1A-4E86938BDC20`
`mac`	String	MAC address of device (without ":") - Android only	`15118fdce61d`
`mac_md5`	String	MD5 of MAC (upper case without ":") - Android only.	`e3f5536a141811db40efd6400f1d0a4e`
`mac_sha1`	String	SHA1 of MAC (upper case with ":") - Android only	`c1976429369bfe063ed8b3409db7c7e7d87196d9`
`android_id`	String	Android ID	`e1cbfb61613b4f50`
`gps_adid`	String	Google Play Advertiser ID.	`660e1d86-6796-463a-be86-897993136018`

Optional Parameters

Parameter	Data type	Description	Example
`campaign`	String	Basic campaign instrument e.g. TV channel.	`ProSieben`
`adgroup`	String	Second level of campaign structure for e.g. TV show.	`News`
`creative`	String	Third level of campaign structure for e.g. advertisement format.	`Funny Spot 1`

Example

curl  -d adid=e3f5536a141811db40efd6400f1d0a4e  \\
      -d tracker=foobar                         \\
      -d partner_token=asd123asd123             \\
      -d campaign=test123                       \\
      -d adgroup=test123                        \\
      -d creative=test123                       \\

      https://s2s.adjust.com/delayed_attribution

Example response

HTTP Status 2XX

If the interface returns an error, this is usually because the device is unknown or the posted adid cannot be found.