Log in

SKAdNetwork data protocol

Input data

End-point

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:
  • myTarget — 1
  • Unity — 10017
  • Persona.ly — 10171
  • TikTok — 10146
  • Liftoff — 10127
  • Moloco — 10263
  • Crossinstall — 10254
  • Yandex Direct — 10029
"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?