API: /app_installs

Korrekted
Korrekted
Last updated 

Общее

Этот раздел API содержит метод для регистрации «первых открытий» приложения (приравнивается к установкам)
  • вызов /app_installs/register — регистрирует установку с возможной привязкой к Search Ads

/register

Описание: служит для регистрации установки с возможностью передачи SearchAds-параметров
Полный путь к методу: https://www.s1eep.app/api/app_installs/register
Тип запроса: POST
Требования безопасности: API-ключ
Дополнительные ожидаемые параметры:
  • idfa — IDFA пользователя, необязательно
  • version — номер билда приложения
  • random_string — случайная строчка, генерируемая копией приложения на всю свою жизнь
  • iad-conversion-date — дата и время конверсии (обычно — скачивание) по рекламному объявлению, формат Y-m-d H:i:s (например 2017-01-31 23:26:59), необязательно
  • iad-keyword — ключевое слово, по которому пользователь увидел объявление, строка, необязательно
  • iad-keyword-id, ID ключа, по которому пользователь увидел объявление, строка, необязательно
  • iad-country-or-region — страна AppStore, необязательно, необязательно
  • iad-creativeset-id — идентификатор набора граифческих материалов, число, необязательно
  • iad-conversion-type — тип конверсии, строка, необязательно
  • iad-click-date — дата и время клика по рекламному объявлению, формат Y-m-d H:i:s (например 2017-01-31 23:26:59), необязательно
  • iad-adgroup-name — название группы объявлений, строка, необязательно
  • iad-campaign-id — идентификатор рекламной кампании, число, необязательно
  • iad-org-name — название организации, от имени которой запущена реклама, строка, необязательно
  • iad-lineitem-id — идентификатор хрен знает чего, число, необязательно
  • iad-keyword-matchtype — тип метчинга по ключевому слову, строка, необязательно
  • iad-org-id — идентификатор организации, от имени которой запущена реклама, число, необязательно
  • iad-lineitem-name — хрен знает чего, строка, необязательно
  • iad-attribution — флаг атрибуции, boolean, необязательно
  • iad-purchase-date — дата и время покупки, формат Y-m-d H:i:s (например 2017-01-31 23:26:59), необязательно
  • iad-campaign-name — название рекламной кампании, строка, необязательно
  • iad-adgroup-id — идентификатор группы объявлений, число, необязательно
  • iad-creativeset-name — название набора графических материалов, необязательно
Дополнительные возвращаемые параметры: нет
Примера ответа:
{"_code":200,"_msg":"OK","_need_payment":false,"_data":"{}"}