Guide for integration with ad networks (Talking Data) – Affise

Overview

Note for usage

Data postback service provided by AdTracking is available to global ad networks, DSPs, and with postback feature. This article should be used tech or product team from the companies mentioned above.

Solutions for integration

302 short link

Pass the business/device ids to the AdTracking system through 302 redirects.

Click request

TalkingData provides short links for redirects

Requested from：	Ad Network
Method：	GET
Example：	https: //lnk0.com/FlIVhg

(campaign ID and App ID are both hidden in the link)

Parameters

AdTracking attribution system provides precise attribution based on device ids. Ad networks pass the ids of the devices where the clicks take place to the AdTracking system.

Parameters	Description	Example
idfa	iOS's idfa，with “-”，plaintext	458BE47D-7205-4010-BC77-DC6E551EC514
idfa_md5	iOS' idfa calculation MD5，with “-” and in capitals to compute MD5 and then turn it to captitals	D4C00E03AC3BFAFE392A310E5D35807F
androidid	Android's AndroidID，original，plaintext	a2948e662f4b4056
androidid_md5	Android' AndroidID，original in capitals，compute MD5 and then turn to capitals	ABDCEC144E1BA7513FFC00D6BC87E17C
androidid_md5_1	Android's AndroidID，original in lower case，compute MD5 and then turn to capitals	0C15D7B13A72324DC395C70E8B334AEE
imei	Android IMEI，original，plaintext	865790026966473
imei_md5	Android IMEI，original to lowercase，compute MD5	e86607bc47b52dc939e71e9edfe09f55
oaid	Android OAID，original，plaintext	5b8176b0ca089434
advertisingid	Android advertising ID（AndroidIDFA），original，plaintext	73af65f4-a06c-44a5-8cc6-f72465ac52ac
advertisingid_md5	Android advertising ID（AndroidIDFA），original to uppercase, compute MD5 and then turn to capitals	D0BD09A1199F89A6B12C4B309ED4710A
callback_url	postback address parameter, adnetworks can dynamically pass postback address via this parameter.	http: //TalkingDataDemo/active
adcampaign	advertising series, combinations of numbers, letters, characters, and simple symbols up to 32 digits.	双十一广告系列.123-abc
adcreative	advertising creatives, combinations of numbers, letters, characters, and simple symbols up to 32 digits.	视频贴图.123-abc
adgroup	advertising groups, combinations of numbers, letters, characters, and simple symbols up to 32 digits.	618大促测试组.123-abc

Please note：simple symbols include：- _ .

For any specific platform, only one of the above-mentioned ids is required to pass to AdTracking to do the precise matching. When the parameter affiliates can provide is not certain, multiple device ids can be passed. When parameters are not available please leave it empty.

302 click example

https:// lnk0.com/FlIVhg?idfa_md5={Your_idfamd5_Here}

https:// lnk0.com/FlIVhg?idfa_md5={ Your_idfamd5_Here}&IMP={impressionid}

response

HTTP Status Code: 302

Location: Download page for the promoted App

S2S Integration

Pass the click request and related parameters to AdTracking through requesting server API.

Click request

TalkingData doesn't provide short links for redirects

Request from：	Ad Network
Method：	GET
Address：	https: //lnk0.com/FlIVhg?action=none

Parameters：

Required parameters： or &

Parameters	Description	Example
devicetype	Device type and version	iphone,GT-9300
osversion	OS	iphone OS 8_4, Android 4.4.4 或 8_4, 4.4.4
ip	device ip	36.110.87.173
clicktime	time of the click，long millisecond UTC time（from Jan 1, 1970 to now in milliseconds）	1437118969422
useragent	的UA data from the browser	Mozilla/5.0 (iPhone; CPU iPhone OS 8_4 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Version/8.0 Mobile/12H143 Safari/600.1.4
action	server integration mark	none

Additional parameters：AdTracking attribution system provides precise attribution based on device ids. Ad networks pass the ids of the devices where the clicks take place to the AdTracking system.

Parameters	Description	Examples
idfa	iOS's idfa，with “-”，plaintext	458BE47D-7205-4010-BC77-DC6E551EC514
idfa_md5	iOS' idfa calculation MD5，with “-” and in capitals to compute MD5 and then turn it to captitals	D4C00E03AC3BFAFE392A310E5D35807F
androidid	Android's AndroidID，original，plaintext	a2948e662f4b4056
androidid_md5	Android' AndroidID，original in capitals，compute MD5 and then turn to capitals	ABDCEC144E1BA7513FFC00D6BC87E17C
androidid_md5_1	Android's AndroidID，original in lowercase，compute MD5 and then turn to capitals	0C15D7B13A72324DC395C70E8B334AEE
imei	Android IMEI，original，plaintext	865790026966473
imei_md5	Android IMEI，original to lowercase，compute MD5	e86607bc47b52dc939e71e9edfe09f55
oaid	Android OAID，original，plaintext	5b8176b0ca089434
advertisingid	Android advertising ID（AndroidIDFA），original，plaintext	73af65f4-a06c-44a5-8cc6-f72465ac52ac
advertisingid_md5	Android advertising ID（AndroidIDFA），original to uppercase, compute MD5 and then turn to capitals	D0BD09A1199F89A6B12C4B309ED4710A
callback_url	postback address parameter, adnetworks can dynamically pass postback address via this parameter.	http: //TalkingDataDemo/active
adcampaign	advertising series, combinations of numbers, letters, characters and symple symbols up to 32 digits.	双十一广告系列.123-abc
adcreative	advertising creatives, combinations of numbers, letters, characters and symple symbols up to 32 digits.	视频贴图.123-abc
adgroup	advertising groups, combinations of numbers, letters, characters and symple symbols up to 32 digits.	618大促测试组.123-abc

Please note：simple symbols include：- _ .

S2S click example

https://lnk0.com/FlIVhg?ip={ip}& clicktime ={clicktime}& devicetype ={devicetype}& osversion ={osversion}&action=none

https://lnk0.com/FlIVhg?ip={ip}& clicktime ={clicktime}& devicetype ={devicetype}& osversion ={osversion}&IMP={impressionid}&action=none

Success response

HTTP Status Code: 200

Location: Tracking link doesn't redirects with this integration

Activation data postback

postback request

Request from：	TalkingData
Protocal：	HTTP
Method：	GET
Example：	http: //a.adnet.com/track/AdTracking

Postback parameters

When postbacking, AdTracking can send advertising business ids from mobile networks, like inmobi's impression id，millennniial's goal id, etc.. You only need to implement these parameters in the tracking link. When the device is activated AdTracking will postback related device IDs and business IDs to the adnetworks.

Example：

http: //AdnetURL.com?

Request time：

When the TalkingData system confirms that the user who clicked the ad has been activated it will request postback (asynchronous postbacking that takes no more than 5 minutes).

Integration flow

Fill in the integration application form provided by the support from AdTracking then sent it to integration@tendcloud.com（please submit only through e-mail）
AdTracking integration Team reviews the application and replies with integration date, POC and other details
Two sides start testing, during which if anything disrupts the process please send the details to integration@tendcloud.com or call our support.
After the integration is successful, the integration team will send a formal mail to notify the network. (It's considered test period before the mail is received and during this period AdTracking is not responsible for any issues in ad campaigns.)

FAQ

Q1. Is it ok if IP, Device type, Os version are not passed with S2S?

No. These parameters are used to check device type and location, to judge if the click data is valid and are also important for detecting fraud. If these are not passed, the system will filter these clicks and won't include them in statistics or attribution system.

Q2. Is it ok to only pass server IP in S2S?

No. If a large number of clicks are coming from the same IP, the system will send you an alert and these clicks might be filtered. And server IPs will affect geostatistics and distort your observation.

Q3. What can be done when adnetworks provide custom parameters that are not on the list?

First of all please describe the parameters provided while filling in the application form and encrypted description should also be provided. Please attached all the necessary docs and wait for the response after the application is sent.

Q4. How to inform AdTracking after the adnetworks update postback address?

If you plan to change your postback address please update the info in the application form and e-mail to integration@tendcloud.com. AdTracking POC will arrange new testing after receiving the mail.

Q5. What should be done when postbacks are not received after the integration is successful?

Please confirm if the server of the adnetwork is stable and contact advertiser to check if there is any update or issues. If not, please contact our support to see if there is a delay.

You may also find the following articles helpful:

Published by Tatiana Mankevich

0 Comments