Краткий обзор. Данные по эффективности SKAN обогащаются дополнительными точками данных. Аналогично данным на дэшборде SKAdNetwork. Агрегирование с использованием даты установки или даты прибытия постбэка.
API для агрегированного отчета SKAN об эффективности
API возвращает метрики атрибуции, предоставленные Apple SKAdNetwork (реальные данные) и другие точки данных, используя дату установки или поступления постбэка. Отчет по своей структуре аналогичен данным, представленным на дэшборде SKAN.
Использование API для агрегированного отчета SKAN об эффективности
Для использования API для агрегированного отчета SKAN об эффективности:
- Получите токен API. Получить токен должен админ.
- Дайте разработчику токен API, который будет использоваться в заголовке аутентификации.
- Предоставьте разработчикам параметры, которые они должны ввести при вызове API, как описано в следующем разделе. Параметры определяют, что содержится в отчете, как он организован, а также устанавливают временные рамки отчетности.
- Скажите своему разработчику, чтобы он следовал API для агрегированного отчета SKAN об эффективности в хабе разработчиков.
Параметры
Имя параметра | Формат | Обязательно / Нет |
---|---|---|
|
Тип даты, используемый в диапазоне дат, ограниченном Варианты:
Данные Google Рекламы: Даты установки и поступления совпадают благодаря методологии отчетности Google Рекламы. |
Нет |
|
Диапазон дат установки ограничен значениями start_date и end_date. Внимание! Дата установки отличается от даты поступления постбэка.
|
Да |
end_date |
|
Да |
view_type |
Отфильтруйте установки по типу следующим образом:
|
Нет |
modeled_conversion_values |
|
Нет |
Структура и пример отчета
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 | Y | N |
Флаг атрибуции AF |
Параметр | 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. |
Диапазон дат |
|
Лимиты на предоставление данных |
|
Сети с собственной атрибуцией (SRN) |
|
Доступ рекламной сети | Если вы являетесь партнером по аналитике, попросите рекламодателя предоставить вам разрешение. |
Доступ агентств | Не доступно |
Часовой пояс приложения | Только UTC |
Валюта приложения | Всегда доллары США |
Органические данные | Рассчитывается как разница между всеми данными, передаваемыми SDK непосредственно в AppsFlyer, за вычетом неорганических данных, передаваемых постбэками SKAN |
Неорганические данные | Рассчитывается с использованием постбэков SKAN, полученных AppsFlyer |
Исторические данные | Самая ранняя поддерживаемая дата конверсии (установка или ретаргетинг): 1 ноября 2020 г. |
Доступ пользователей аккаунта | Токен авторизации доступен пользователю с правами администратора на дэшборде. |
Общие затраты | API SKAN может не включать метрику общей стоимости, если обычная атрибуция (обычный обзор) содержит кампании SKAN с самым низким уровнем детализации (например, реклама, страна или идентификатор сайта) с более чем 50 тысячами строк. |