API даты получения агрегированного постбэка SKAN

Для:
маркетологов
Последнее обновление:

Краткий обзор: Агрегированные постбэки SKAdNetwork через API. Данные агрегируются по дате поступления постбэка. 

API даты получения агрегированного постбэка SKAN

API возвращает агрегированные постбэки SKAdNetwork, используя диапазон дат поступления постбэков.

Примечание! Дата поступления постбэка отличается от даты установки, использующейся в дэшборде и отчетах SKAdNetwork.

Использование API агрегированного отчета об эффективности SKAN

Чтобы использовать API агрегированного отчета об эффективности SKAN, выполните следующие шаги:

  1. Получите API токен. Токен должен получить администратор.
  2. Передайте вашему разработчику токен API для использования в заголовке аутентификации.
  3. Предоставьте разработчикам параметры, которые нужно указать при вызове API, как описано в следующих разделах. Параметры определяют содержимое отчета, его структуру и временные рамки отчетности.
  4. Скажите вашим разработчикам следовать инструкциям в API агрегированного отчета об эффективности SKAN, представленным в центре для разработчиков.

Параметры

Имя параметра Подробности Обязательный

start_date

Диапазон дат поступления постбэка ограничен значениями start_date и end_date. Примечание! Дата поступления отличается от даты установки, использующейся в дэшборде и отчетах SKAdNetwork.

  • YYYY-MM-DD 
  • Самая ранняя разрешенная дата: 2020-11-01
    Пример: 2020-11-05
Да
end_date
  • YYYY-MM-DD
  • Максимальное количество дней на один запрос отчета: 60 дней 
  • Пример: 2020-11-12
Да
ad_network_name

Фильтр по медиа-источнику

Нет
geo Фильтрация по коду страны ISO 3166 (альфа-2). Пример: US, CN

Нет
skad_redownload

Фильтр по true или false

Нет
skad_source_app_id

Фильтр по идентификатору источника приложения

Нет
ad_network_campaign_id

Фильтр по идентификатору кампании рекламной сети.

Примечание: Это не идентификатор кампании, полученный от SKAdNetwork.

Нет
modeled_conversion_values
  • Поддерживается только с версии V2
  • Значение может быть либо , либо
  • Если true, постбэк заполняет столбец «count» моделируемыми данными о значении конверсии.  См. доступное поле для моделируемых данных
  • Если , постбэк отображает количество значений конверсии со всеми доступными полями, представленными в структуре отчета, без моделируемых данных.
  • Значение по умолчанию — .

Нет

Структура отчета и пример

API возвращает CSV-файл.

Доступные столбцы и показатели перечислены в таблице ниже.

Примеры: В1 |В2

Структура сводного отчета SKAdNetwork
Имя столбца Размерность или мера Доступно с токеном API V1 Доступно с токеном API V2 Доступно с токеном API V2 (для SKAN 4) Доступно только с фильтром модельных данных
skad_postback_sequence_index Группировать по Н Н Д Д

skad_conversion_value

 Группировать по Д Д Д Д

skad_coarse_conversion_value

 Группировать по Н Н Д Д

skad_ad_network_id

Некоторые SRN не передают свои идентификаторы. В этом случае поле будет пустым, а заполняется поле ad_network_name.

Группировать по

Д

Д

Д

Д

имя_рекламной_сети

В настоящее время, в большинстве случаев это поле пустое. Мы заполняем его для SRN, которые не передают свой skad_ad_network_id.

 Группировать по Д Д Д Д

skad_source_identifier

 Группировать по Н Н Д Д

skad_campaign_id

 Группировать по Д Д Д Д

идентификатор_кампании_рекламной_сети

 Группировать по Д Д Д Д

название_кампании_рекламной_сети

 Группировать по Д Д Д Д

идентификатор_набора_объявлений_рекламной_сети

 Группировать по Н Д Д Д

название_набора_объявлений_рекламной_сети

 Группировать по Н Д Д Д

идентификатор_рекламы_рекламной_сети

 Группировать по Н Д Д Н

название_рекламной_сети_рекламы

 Группировать по Н Д Д Н

креатив_рекламной_сети

 Группировать по Н Н Д Н

канал_рекламной_сети

 Группировать по Н Н Д Н

skad_версия

 Группировать по Д Д Д Н

skad_redownload

 Группировать по Д Д Д Н

skad_source_app_id

 Группировать по Д Д Д Н

skad_source_domain

 Группировать по Н Н Д Д

skad_fidelity_type

 Группировать по Н Д Д Н

гео

 Группировать по Д Д Д Н

дата_прибытия

 Группировать по Д Д Д Д

количество

 Мера Д Д Д Д

Спецификации и ограничения

Спецификация Примечания 
Актуальность данных

Отчет обновляется ежедневно.

Доступность данных определяется свежестью данных SKAdNetwork.
Диапазон дат
  • Самая ранняя поддерживаемая дата: 1 ноября 2020 г.
  • Максимальный диапазон запроса: 60 дней
Ограничение скорости
  • Запросы возвращают до 200 тыс. строк.
  • 60 запросов в минуту
SRN:

Google Реклама: Дата получения постбэка определяется временем последнего клика, указанного Google. 
Доступ рекламной сети  Доступно аналитическим партнерам с разрешения рекламодателя. 
Доступ агентства Недоступно
Часовой пояс конкретного приложения Только UTC
Валюта приложения  Всегда USD
Органические данные Недоступно с этим API
Неорганические данные Вычисляются на основе постбэков SKAdNetwork, полученных AppsFlyer
Исторические данные Самая ранняя поддерживаемая дата конверсии (установка или ретаргетинг): 1 ноября 2020 г.
Доступ пользователей аккаунта Токен авторизации доступен администратору в дэшборде.

См. также