Войти

Протокол передачи SKAdNetwork данных

Входные данные

Endpoint

https://tracker-skadnetwork.my.com/

Метод

POST

Параметры

Все параметры передаются в теле POST запроса в формате json.

Ограничение на максимальный размер загружаемых данных — 10Кб.

Название параметра Описание Тип Пример
ts* Время, когда рекламная сеть получила SKAdNetwork постбэк Число, минимальное 0, максимальное значение 4294967295 "ts":1577191920
payload* json данные полученные от Apple (url-encoded) Строка, минимальная длина 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-адрес, поддерживается версия ipV4 и ipV6 Строка, максимальная длина 45 "ip":"2001:0db8:85a3:0000:0000:8a2e:0370:7334"
"ip":"125.125.125.125"
userAgent User-Agent Строка, максимальный размер 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* Идентификатор рекламной сети Число, возможные варианты:
  • VK Ads+myTarget — 1
  • Unity — 10017
  • Persona.ly — 10171
  • Liftoff — 10127
  • Crossinstall — 10254
  • Yandex Direct — 10029
  • Moloco — 10263
"idPartner":10017
adNetworkCampaignId Идентификатор рекламной кампании в сети Строка, минимальная длина 1 "adNetworkCampaignId":"2222"
adNetworkCampaignName Название рекламной кампании в сети Строка, минимальная длина 1 "adNetworkCampaignName":"skadnetwork_campaign_1"
adNetworkAdSetId Идентификатор рекламной группы объявлений в сети Строка, минимальная длина 1 "adNetworkAdSetId":"111"
adNetworkAdSetName Название рекламной группы объявлений в сети Строка, минимальная длина 1 "adNetworkAdSetName":"skadnetwork_ad_set_1"
adNetworkCreativeId Идентификатор объявления в сети Строка, минимальная длина 1 "adNetworkCreativeId":"111"
adNetworkCreativeName Название объявления в сети Строка, минимальная длина 1 "adNetworkCreativeName":"skadnetwork_creative_1"

* — обязательный параметр.

Пример

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"}'

Коды ответов

Код Текст Описание
200 {"message": "ОK"} Запрос был успешно обработан
400 {"error": "Bad Request"} Ошибка запроса, параметры не прошли валидацию
400 {"error": "Empty post data"} Пустое тело запроса
400 {"error": "Bad json"} Передан битый json в теле запроса
500 {"error": "Internal Server Error"} Внутренняя ошибка API. Нужно повторить запрос позже
Была ли эта статья полезна?