SKAdNetwork data protocol
Input data
Endpoint
https://tracker-skadnetwork.my.com/
Method
POST
Parameters
All parameters are passed in the request body in JSON format.
Limit on the maximum size of imported data — 10Kb.
Name |
Description |
Type |
Example |
ts* |
Time when the ad network received SKAdNetwork postback |
Number, minimum value 0, maximum value 4294967295 |
"ts":1577191920 |
payload* |
json data received from Apple (url-encoded) |
String, minimum length 45 |
"payload":"%7B%0A%20%22version%22%20%3A%20%221.0%22%2C%20%20%0A%20%22ad-network-id%22%20%3A%20%22test.com%22%2C%0A%20%20%22campaign-id%22%20%3A%2042%2C%0A%20%20%22app-id%22%20%3A%20%2012213%2C%0A%20%20%22attribution-signature%22%20%3A%20%22TELMMQesQ4y%22%0A%7D" |
ip |
IP address, ipV4, and ipV6 are supported |
String, minimum length 45 |
"ip":"2001:0db8:85a3:0000:0000:8a2e:0370:7334"
"ip":"125.125.125.125" |
userAgent |
User-Agent |
String, minimum length 2048 |
"userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.87 Safari/537.36" |
idPartner* |
The ad network identifier |
Number, possible values:- VK Ads+myTarget — 1
- Unity — 10017
- Persona.ly — 10171
- Liftoff — 10127
- Crossinstall — 10254
- Yandex Direct — 10029
- Moloco — 10263
|
"idPartner":10017 |
adNetworkCampaignId |
The campaign identifier in the network |
String, minimum length 1 |
"adNetworkCampaignId":"2222" |
adNetworkCampaignName |
The campaign name in the network |
String, minimum length 1 |
"adNetworkCampaignName":"skadnetwork_campaign_1" |
adNetworkAdSetId |
The ad set identifier in the network |
String, minimum length 1 |
"adNetworkAdSetId":"111" |
adNetworkAdSetName |
The ad set name in the network |
String, minimum length 1 |
"adNetworkAdSetName":"skadnetwork_ad_set_1" |
adNetworkCreativeId |
The creative identifier in the network |
String, minimum length 1 |
"adNetworkCreativeId":"111" |
adNetworkCreativeName |
The creative name in the network |
String, minimum length 1 |
"adNetworkCreativeName":"skadnetwork_creative_1" |
* — required parameter.
Example
curl -k -X POST https://tracker-skadnetwork.my.com -d '{"idPartner":1,"payload":"%7B%22version%22%3A%2258113%22%2C%22ad-network-id%22%3A%2295945%22%2C%22campaign-id%22%3A91988%2C%22transaction-id%22%3A%229dac5ea2-93b6-11eb-abdb-23f3b16851ce%22%2C%22app-id%22%3A78919%2C%22attribution-signature%22%3A%2242434%22%2C%22redownload%22%3Atrue%2C%22source-app-id%22%3A62445%2C%22fidelity-type%22%3A1%2C%22conversion-value%22%3A1%7D","ts":1601187911,"ip":"109.124.6.51"}'
Responses
Code |
Text |
Description |
200 |
{"message": "ОK"} |
The request was successfully processed |
400 |
{"error": "Bad Request"} |
Request error, parameters not validated |
400 |
{"error": "Empty post data"} |
Empty request body |
400 |
{"error": "Bad json"} |
Passed an invalid JSON file in the request body |
500 |
{"error": "Internal Server Error"} |
Internal API error. Try to repeat the request later |
Was this article helpful?
Thank you for your feedback!
Why did this article not help?