Краткий обзор. Данные по эффективности SKAN обогащаются дополнительными точками данных. Аналогично данным на дэшборде SKAdNetwork. Агрегирование с использованием даты установки или даты прибытия постбэка.
API для агрегированного отчета SKAN об эффективности
API возвращает метрики атрибуции, предоставленные Apple SKAdNetwork (реальные данные) и другие точки данных, используя дату установки или поступления постбэка. Отчет по своей структуре аналогичен данным, представленным на дэшборде SKAN.
Использование API для агрегированного отчета SKAN об эффективности
Для использования API для агрегированного отчета SKAN об эффективности:
- Получите токен API. Получить токен должен админ.
- Дайте разработчику токен API, который будет использоваться в заголовке аутентификации.
- Предоставьте разработчикам параметры, которые они должны ввести при вызове API, как описано в следующем разделе. Параметры определяют, что содержится в отчете, как он организован, а также устанавливают временные рамки отчетности.
- Скажите своему разработчику, чтобы он следовал API для агрегированного отчета SKAN об эффективности в хабе разработчиков.
Параметры
| Имя параметра | Формат | Обязательно |
|---|---|---|
|
|
Тип даты, используемый в диапазоне дат, ограниченном Варианты:
Данные Google Рекламы: Даты установки и поступления совпадают благодаря методологии отчетности Google Рекламы. |
Нет |
|
|
Диапазон дат установки ограничен значениями start_date и end_date. Внимание! Дата установки отличается от даты поступления постбэка.
|
Да |
дата_выезда |
|
Да |
тип_представления |
Отфильтруйте установки по типу следующим образом:
|
Нет |
моделируемые_значения_конверсии |
|
Нет |
Структура и пример отчета
API возвращает файл CSV.
- Поля и метрики, доступные в отчете, перечислены в таблице ниже.
- Некоторые метрики (доход, вовлечение, конверсия) зависят от настроек измерения эффективности SKAN.
- В отчет включаются только внутренние события приложения, которые пользователи совершили за отчетный период. Таким образом, количество и последовательность столбцов внутренних событий приложения могут меняться от отчета к отчету. Не полагайтесь на последовательность столбцов при планировании процесса импорта данных.
- Примеры: V1 | V2
Поля отчета
| Имя поля | Параметр или метрика | Доступно с токеном API V1 | Доступно с токеном API V2 |
Доступно с токеном API V2 (для SKAN 4) |
Доступно с фильтром только по смоделированным данным |
|---|---|---|---|---|---|
|
Дата Данные предоставляются в соответствии с выбранным параметром date_type. |
Параметр | Н | Д | Д | Д |
| Медиа Источник (PID) | Параметр | Д | Д | Д | Д |
| Кампания (c) |
Параметр |
Д |
Д |
Д |
Д |
| ID кампании | Параметр | Д | Д | Д | Д |
| ID сайта | Параметр | Д | Д | Д | Н |
| Группа объявлений | Параметр | Н | Д | Д | Д |
| ID блока рекламы | Параметр | Н | Д | Д | Д |
| Реклама | Параметр | Н | Д | Д | Н |
| ID рекламы | Параметр | Н | Д | Д | Н |
| Страна | Параметр | Д | Д | Д | Н |
|
Флаг атрибуции AF |
Параметр | Н | Д | Д | Д |
|
Индекс последовательности постбэков |
Параметр | Н | Н | Д | Д |
|
Креатив |
Параметр | Н | Н | Д | Н |
|
Канал |
Параметр | Н | Н | Д | Н |
| Показы | метрику | Д | Д | Д | Д |
| клики; | метрику | Д | Д | Д | Д |
| CTR | метрику | Д | Д | Д | Д |
| установки | метрику | Д | Д | Д | Д |
|
Установки по кликам (fidelity_type = 1) |
метрику | Д | Д | Д | Д |
|
Установки по просмотрам (fidelity_type = 0) |
метрику | Д | Д | Д | Д |
|
Коэффициент нулевого значения конверсии [Доступно с 23 января 2022 г.] |
метрику | Н | Д | Д | Д |
| Коэффициент конверсии | метрику | Д | Д | Д | Д |
| Конвертированные пользователи | метрику | Д | Д | Д | Д |
| Конвертированные пользователи / Установки | метрику | Д | Д | Д | Д |
| Total Revenue (Общий доход) | Метрика дохода | Д | Д | Д | Д |
| Общая стоимость | метрику | Д | Д | Д | Д |
| ROI | Метрика дохода | Д | Д | Д | Д |
| Рост ARPU | Метрика дохода | Д | Д | Д | Д |
| Средний eCPI | метрику | Д | Д | Д | Д |
| {af_skad_revenue} (уникальные пользователи) | Метрика дохода | Д | Д | Д | Д |
| {af_skad_revenue} (счетчик событий) | Метрика дохода | Д | Д | Д | Д |
|
{название вашего внутреннего события приложения} (уникальные пользователи) |
метрику | Д | Д | Д | Д |
| {название вашего внутреннего события приложения} (счетчик событий) | метрику | Д | Д | Д | Д |
Спецификации и ограничения
| Спецификация | Примечания |
|---|---|
| Актуальность данных | Доступность данных соответствует коэффициенту актуальности данных SKAN. |
| Диапазон дат |
|
| Лимиты на предоставление данных |
|
| SRN: |
|
| Доступ рекламной сети | Если вы являетесь партнером по аналитике, попросите рекламодателя предоставить вам разрешение. |
| Доступ агентств | Не доступно |
| Часовой пояс приложения | Только UTC |
| Валюта приложения | Всегда доллары США |
| Органические данные | Рассчитывается как разница между всеми данными, передаваемыми SDK непосредственно в AppsFlyer, за вычетом неорганических данных, передаваемых постбэками SKAN |
| Неорганические данные | Рассчитывается с использованием постбэков SKAN, полученных AppsFlyer |
| Исторические данные | Самая ранняя поддерживаемая дата конверсии (установка или ретаргетинг): 1 ноября 2020 г. |
| Доступ пользователей аккаунта | Токен авторизации доступен пользователю с правами администратора на дэшборде. |
| Общие затраты | API SKAN может не включать метрику общей стоимости, если обычная атрибуция (обычный обзор) содержит кампании SKAN с самым низким уровнем детализации (например, реклама, страна или идентификатор сайта) с более чем 50 тысячами строк. |
This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.