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

Краткий обзор. Данные по эффективности SKAN обогащаются дополнительными точками данных. Аналогично данным на дэшборде SKAdNetwork. Агрегирование с использованием даты установки или даты прибытия постбэка.

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

API возвращает метрики атрибуции, предоставленные Apple SKAdNetwork (реальные данные) и другие точки данных, используя дату установки или поступления постбэка. Отчет по своей структуре аналогичен данным, представленным на дэшборде SKAN.

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

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

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

Параметры

Имя параметра Формат Обязательно / Нет

date_type

Тип даты, используемый в диапазоне дат, ограниченном start_date и end_date

Варианты: 

  • [По умолчанию] install: Дата установки, полученная AppsFlyer с использованием времени поступления постбэка и с учетом периода измерения.
  • arrival: Время прибытия постбэка. Примечание. Метрики органических установок имеют значение Н/Д. 

Данные Google Рекламы: Даты установки и поступления совпадают благодаря методологии отчетности Google Рекламы. 

Нет

start_date

 

Диапазон дат установки ограничен значениями start_date и end_date. Внимание! Дата установки отличается от даты поступления постбэка. 

  • Самая ранняя дата установки в формате ГГГГ-ММ-ДД 
  • Самая ранняя допустимая дата: 2020-11-01
    Пример: 2020-11-05
Да
end_date
  • Дата последней установки в формате ГГГГ-ММ-ДД
  • Максимальное количество дней на вызов отчета: 90 дней 
  • Пример: 2020-11-12
Да
view_type

Отфильтруйте установки по типу следующим образом: 

  • acquisition: установки 
  • retargeting: повторные загрузки
  • unified: Привлечение и повторные загрузки объединены.
  • [По умолчанию] unified
  • Метрики затрат, кликов и показов возвращаются в следующих, если view_type=unified

Нет

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

Нет

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

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

  • Поля и метрики, доступные в отчете, перечислены в таблице ниже. 
  • Некоторые метрики (доход, вовлечение, конверсия) зависят от настроек измерения эффективности SKAN.
  • В отчет включаются только внутренние события приложения, которые пользователи совершили за отчетный период. Таким образом, количество и последовательность столбцов внутренних событий приложения могут меняться от отчета к отчету. Не полагайтесь на последовательность столбцов при планировании процесса импорта данных.
  • Примеры: V1 | V2

Поля отчета

Имя поля Параметр или метрика Доступно с токеном API V1  Доступно с токеном API V2

Доступно с токеном API V2 (для SKAN 4)

Доступно с фильтром только по смоделированным данным

Дата 

Данные предоставляются в соответствии с выбранным параметром date_type.

Параметр N Y Y Y
Медиа Источник (PID) Параметр Y Y Y Y
Кампания (c)

Параметр

Y

Y

Y

Y

ID кампании Параметр Y Y Y Y
ID сайта Параметр Y Y Y N
Группа объявлений Параметр N Y Y Y
ID блока рекламы Параметр N Y Y Y
Реклама Параметр N Y Y N
ID рекламы Параметр N Y Y N
Страна Параметр Y Y N

Флаг атрибуции AF

См: Руководство по SSOT

Параметр N Y Y Y

Индекс последовательности постбэков

Параметр N N Y Y

Креатив

Параметр N N Y N

Канал

Параметр N N Y N
Показы Метрика Y Y Y Y
Клики Метрика Y Y Y Y
CTR Метрика Y Y Y Y
установки Метрика Y Y Y Y

Установки по кликам (fidelity_type = 1)

Метрика Y Y Y Y

Установки по просмотрам

(fidelity_type = 0)

Метрика Y Y Y Y

Коэффициент нулевого значения конверсии

[Доступно с 23 января 2022 г.] 

Метрика N Y Y Y
Коэффициент конверсии Метрика Y Y Y Y
Конвертированные пользователи Метрика Y Y Y Y
Конвертированные пользователи / Установки Метрика Y Y Y Y
Total Revenue (Общий доход) Метрика дохода Y Y Y Y
Общая стоимость Метрика Y Y Y Y
ROI Метрика дохода Y Y Y Y
ARPU Метрика дохода Y Y Y Y
Средний eCPI Метрика Y Y Y Y
{af_skad_revenue} (уникальные пользователи) Метрика дохода Y Y Y Y
{af_skad_revenue} (счетчик событий) Метрика дохода Y Y Y Y

{название вашего внутреннего события приложения} (уникальные пользователи) 

Метрика Y Y Y Y
{название вашего внутреннего события приложения} (счетчик событий)  Метрика Y Y Y Y

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

Спецификация Примечания 
Актуальность данных Доступность данных соответствует коэффициенту актуальности данных SKAN.
Диапазон дат
  • При установке диапазона дат самой последней датой должна быть текущая дата: часовой пояс UTC минус 3 дня. То есть 31 марта следует использовать 28 марта. 
  • Самая ранняя дата: 1 ноября 2020 г.
  • Максимальный диапазон запросов: 90 дней
Лимиты на предоставление данных
  • Запросы возвращают до 250 тыс. строк
  • 10 вызовов в минуту
Сети с собственной атрибуцией (SRN)
  • Meta ads: данные доступны. 
  • Google Реклама: установки могут быть зарегистрированы в течение 45 дней после установки благодаря методологии времени клика Google. Если вы запрашиваете данные Google за последние 45 дней ежедневно, это обеспечивает необходимый охват данных SKAN для Google.
Доступ рекламной сети  Если вы являетесь партнером по аналитике, попросите рекламодателя предоставить вам разрешение.
Доступ агентств Не доступно
Часовой пояс приложения Только UTC
Валюта приложения  Всегда доллары США
Органические данные Рассчитывается как разница между всеми данными, передаваемыми SDK непосредственно в AppsFlyer, за вычетом неорганических данных, передаваемых постбэками SKAN
Неорганические данные Рассчитывается с использованием постбэков SKAN, полученных AppsFlyer
Исторические данные Самая ранняя поддерживаемая дата конверсии (установка или ретаргетинг): 1 ноября 2020 г.
Доступ пользователей аккаунта Токен авторизации доступен пользователю с правами администратора на дэшборде.
Общие затраты API SKAN может не включать метрику общей стоимости, если обычная атрибуция (обычный обзор) содержит кампании SKAN с самым низким уровнем детализации (например, реклама, страна или идентификатор сайта) с более чем 50 тысячами строк.