Краткий обзор. Получайте отчеты Predict с помощью Predict Pull API и/или Data Locker. Отчеты доступны на основе атрибуции SKAdNetwork (SKAN) или AppsFlyer (модель AF).
Материалы по теме
Подробнее о методах доступа к отчетам Predict см. в этих статьях:
- Отчеты Predict (эта статья)
- Predict Pull API
- Data Locker: для рекламодателей
Обзор
Отчеты Predict включают атрибуцию установок, данные о затратах и прогнозируемые метрики для групп вновь привлеченных пользователей (или «когорт»). Доступны различные типы отчетов, основанные на:
-
Метод атрибуции, выбранный для отчета:
- Атрибуция SKAdNetwork (SKAN), или
- Атрибуция AppsFlyer (модель AF).
-
Уровень данных в отчете:
- Агрегированные отчеты: данные агрегируются с использованием даты прибытия постбэка (для атрибуции SKAN) или даты установки (для атрибуции по модели AF).
- Отчеты по сырым данным: данные сообщаются на уровне пользователя.
Доступ к отчетам Predict
Отчеты Predict создаются в виде файлов CSV, доступ к ним можно получить через Predict Pull API и/или AppsFlyer Data Locker.
- С помощью Predict Pull API вы можете генерировать отчеты по запросу, используя вызовы API.
- С помощью Data Locker данные отчета автоматически записываются в облачное хранилище, что позволяет напрямую загружать их в ваши внутренние системы (например, в системы бизнес-аналитики или CRM).
Методы, с помощью которых можно получить доступ к отчетам, зависят от типа отчета:
| Отчет | Агрегированный | Сырые данные |
|---|---|---|
| Установки SKAN |
|
Data Locker |
|
Повторные загрузки SKAN |
|
Data Locker |
|
Установки по модели AF |
|
Data Locker |
Дополнительные сведения и инструкции по доступу к отчетам с помощью этих методов приведены на следующих вкладках:
Predict Pull API
Администратор вашего аккаунта может получить токен V2.0 (токен на предъявителя), необходимый для доступа к API, с дэшборда AppsFlyer.
Подробнее о Predict Pull API и о том, как получить отчет.
Data Locker
Чтобы включить доступ к отчетам Predict через Data Locker:
- Если вы еще не получаете отчеты через Data Locker (для любой функции AppsFlyer), выполните первоначальную настройку Data Locker. (Если вы уже получаете отчеты Data Locker, перейдите к шагу 2).
-
Добавьте отчеты Predict в Data Locker:
- В AppsFlyer перейдите в раздел Интеграция > Data Locker.
- Выберите все отчеты в разделе Predict.
- Нажмите Сохранить конфигурацию.
- Отчеты будут доступны на следующий день к 10:00 UTC.
Структура отчетов Predict
На следующих вкладках перечислены поля данных, включенные в отчеты Predict:
Агрегированные отчеты
| Имя столбца | Параметр/метрика | Формат |
|---|---|---|
| Дате установки | Параметр | Строка |
| Идентификатор приложения | Параметр | Строка |
| ID рекламы. |
Параметр |
Строка |
| Имя рекламы |
Параметр |
Строка |
| ID блока рекламы |
Параметр |
Строка |
| Название блока рекламы |
Параметр |
Строка |
| Агентство |
Параметр |
Строка |
| ID кампании |
Параметр |
Строка |
| Кампания (c) |
Параметр |
Строка |
| Канал |
Параметр |
Строка |
| Платформа |
Параметр |
Строка |
| Геоданные |
Параметр |
Строка |
| Медиа Источник (PID) |
Параметр |
Строка |
| Регион | Параметр | Строка |
| ID сайта | Параметр | Строка |
| Всего пользователей | Метрика | Целое число |
| Пользователи без значения конверсии | Метрика | Целое число |
| Пользователи с недостаточными данными | Метрика | Целое число |
| Прогнозируемый доход | Метрика | Число |
| pARPU | Метрика | Число |
| Прогнозируемая доля платящих пользователей | Метрика | Число |
| Доля «китов» | Метрика | Число |
| eCPI | Метрика | Число |
| pROAS | Метрика | Число |
| 1 Найдена ли атрибуция AppsFlyer | Параметр | Логическое значение |
| 1 Повторные загрузки SKAN | Параметр | Логическое значение |
| 1 ID исходного приложения SKAN | Параметр | Логическое значение |
| 2 p-день удержания {x} | Метрика | Число |
| 2 p-день удержания {y} | Метрика | Число |
| 2 p-день удержания {z} | Метрика | Число |
|
ПРИМЕЧАНИЯ 1 Столбец появляется только в отчетах, использующих метод атрибуции SKAN. |
||
Отчеты по сырым данным — атрибуция SKAN
| Имя поля | 1 Источник данных | Описание | Формат | В копии постбэка? |
|---|---|---|---|---|
|
ad_network_campaign_id |
Рекламная сеть | Идентификатор кампании, сообщенный рекламной сетью в AppsFlyer | Строка | Нет |
|
ad_network_campaign_name |
Рекламная сеть |
Название кампании, сообщенное рекламной сетью в AppsFlyer |
Строка | Нет |
|
ad_network_timestamp |
Рекламная сеть |
Время получения постбэка рекламной сетью.
|
Временная отметка | Нет |
|
app_id |
AppsFlyer | ID приложения (приложение рекламодателя); включает префикс id | Строка | Да |
|
city |
AppsFlyer | С 30 августа 2021 года значение всегда null | Строка | Нет |
|
country_code |
Рекламная сеть | Строка | Нет | |
| dma | С 30 августа 2021 года значение всегда null | Строка | Нет | |
| install_date | iOS. | Оценка AppsFlyer на основе текущего окна конверсии | Строка времени | Нет |
| install_type | iOS. |
Новая установка/загрузка (соответствует skad_redownload) |
Строка | Нет |
| ip |
IP-адрес в HTTP-сообщении устройства iOS, отправляющего постбэк.
|
Строка | Нет | |
| media_source | iOS. | Рекламная сеть, атрибутированная с помощью имен сетей в AppsFlyer | Строка | Нет |
|
postal_code |
С 30 августа 2021 года значение всегда null | Строка | Нет | |
|
Регион |
AppsFlyer | Согласно сообщаемому коду страны country_code | Строка | Нет |
|
skad_ad_network_id |
SKAN 1.0+ |
|
Строка |
Да |
|
skad_attribution_signature |
SKAN 1.0+ | Строка | Да | |
| skad_campaign_id | SKAN 1.0+ |
Идентификатор кампании, используемый для публикации объявления
|
Строка | Да |
| skad_conversion_value | SKAN 2.0+ |
Значение конверсии, сообщаемое iOS
2 Будет ли поле заполнено, определяет порог конфиденциальности SKAN. |
Целое число | Да |
| skad_mode | Predict |
Режим измерения конверсий, используемый для декодирования постбэка iOS |
Строка | Нет |
| skad_redownload | SKAN 2.0+ | Если TRUE, приложение было загружено повторно |
Логическое значение |
Да |
| skad_source_app_id | SKAN 2.0+ |
ID сайта (приложение, разместившее объявление)
2 Будет ли поле заполнено, определяет порог конфиденциальности SKAN. |
Строка | Да |
| skad_transaction_id | SKAN 1.0+ | Строка | Да | |
| skad_version | SKAN 2.0+ | Строка | Да | |
| timestamp | Рекламная сеть |
Время отправки постбэка с устройства iOS. В случае Google Рекламы это время определяется по времени последнего клика, которое сообщает Google Реклама. |
Строка времени | Да |
|
source_app_id |
AppsFlyer |
ID сайта (приложение, разместившее объявление)
|
Строка | Нет |
|
ad_network_adset_id |
Рекламная сеть | Строка | Нет | |
|
ad_network_adset_name |
Рекламная сеть | Строка | Нет | |
|
ad_network_ad_name |
Рекламная сеть | Строка | Нет | |
|
ad_network_ad_id |
Рекламная сеть | Строка | Нет | |
|
skad_did_win |
SKAN 3.0+ (iOS 14.6+) |
Используется для различения кампаний, которые способствовали установке и которым атрибутирована установка:
|
Логическое значение | Да |
|
fidelity_type |
SKAN 2.2+ (iOS 14.5+) |
Различает варианты представления объявлений, влияющие на атрибуцию:
Не учитывайте значение поля, если версия SKAN менее 2.2. |
Целое число | Да |
|
ad_network_source_app_id |
Рекламная сеть | ID приложения издателя, который сообщает рекламная сеть. Используется для сверки затрат; сообщается рекламной сетью. Приложение издателя дает основу для этих данных. | Строка | Нет |
|
ad_network_channel |
Рекламная сеть | Строка | Нет | |
|
af_prt |
Рекламная сеть | Строка | Нет | |
|
measurement_window |
AppsFlyer |
Продолжительность окна активности
|
Целое число | Нет |
|
af_attribution_found |
AppsFlyer | В настоящее время null для Predict | Логическое значение | Нет |
|
p_revenue |
Predict | Средний прогнозируемый доход (30-й день) группы пользователей по доходам, к которой относится пользователь. | Число | Нет |
|
is_p_payer |
Predict |
|
Целое число | Нет |
|
is_p_whale |
Predict |
|
Целое число | Нет |
|
p_retention |
Predict | Последняя из 3 выбранных дат измерения удержания, на которую пользователь будет являться удержанным пользователем. | Целое число | Нет |
|
no_conversion_value |
Predict |
|
Целое число | Нет |
|
insufficient_data |
Predict |
|
Целое число | Нет |
|
Примечания. |
||||
Отчеты по сырым данным — атрибуция по модели AF
| Имя поля | Описание | Формат |
|---|---|---|
|
af_ad_id |
ID рекламы. |
Строка |
|
platform |
Платформа устройства (iOS) |
Строка перечисления |
|
af_adset_id |
ID группы объявлений (группа, содержащая одно или несколько объявлений) |
Строка |
|
af_adset |
Название группы объявлений |
Строка |
|
media_source |
Атрибутированная рекламная сеть (с помощью названий сетей в AppsFlyer) |
Строка |
|
af_ad |
Имя рекламы |
Строка |
|
Регион |
Географический регион, на основе IP-адреса устройства, сообщенном SDK |
Строка |
|
campaign |
Название кампании |
Строка |
|
af_channel |
Канал медиа-источника
|
Динамическая строка перечисления |
|
campaign_id |
ID кампании |
Строка |
|
Страна |
Код страны по ISO 3166 (alpha-2), на основе IP-адреса устройства, сообщенном SDK, например, US, CN.
|
Строка перечисления |
|
site_id |
Идентификатор издателя |
Строка |
|
attribution_type |
Тип атрибуции:
В настоящее время Predict поддерживает только атрибуцию установок. |
Строка |
|
af_prt |
Агентство |
Строка |
|
install_time |
В настоящее время Predict поддерживает только UA, поэтому время установки install_time всегда будет первым запуском после установки. |
Дата/Время |
|
app_id |
Идентификатор приложения, присвоенный магазином приложений.
|
Строка |
|
ip |
IP-адрес в HTTP-сообщении устройства iOS, отправляющего постбэк, как сообщает SDK. |
Строка |
|
attributed_touch_type |
Возможные значения:
В настоящее время Predict поддерживает только UA, поэтому атрибутированный тип взаимодействия attributed_touch_type будет одним из возможных значений для UA. |
Перечисление |
|
city |
Наиболее детальное местоположение пользователя, основанное на IP-адресе устройства, сообщенном SDK.
|
Строка |
|
dma |
Назначенный район охвата или географическая зона, на основе IP-адреса устройства, сообщенном SDK.
|
Строка |
|
postal_code |
Почтовый индекс, основанный на IP-адресе устройства, сообщенном SDK. |
Строка |
|
Состояние |
Штат, на основании IP-адреса, предоставленного SDK. |
Строка |
|
user_agent |
Агент пользователя URL |
Строка |
|
is_lat |
Ограничение отслеживания рекламы (LAT):
|
Логическое значение |
|
app_name |
Имя приложения, заданное рекламодателем. |
Строка |
|
источник |
Органические и неорганические |
Строка перечисления |
|
p_retention |
Последний день (в течение первых 30 дней после установки), в который пользователь будет использовать приложение. |
Целое число |
|
p_purchase_revenue |
Прогнозируемый доход на 30-й день от совершения пользователем покупок/событий в приложении. | Строка |
|
p_ad_revenue |
Прогнозируемый доход на 30-й день от показов рекламы. | Строка |
|
bucket_revenue_0 |
|
Целое число |
|
bucket_revenue_1 |
|
Целое число |
|
bucket_revenue_2 |
|
Целое число |
|
bucket_revenue_3 |
|
Целое число |
|
bucket_revenue_4 |
|
Целое число |
|
bucket_revenue_5 |
|
Целое число |
|
bucket_revenue_6 |
|
Целое число |
|
bucket_retention_0 |
|
Целое число |
|
bucket_retention_1 |
|
Целое число |
|
bucket_retention_2 |
|
Целое число |
|
bucket_retention_3 |
|
Целое число |
|
is_p_whale |
|
Целое число |
|
is_p_payer |
|
Целое число |
|
insufficient_data |
|
Целое число |
|
install_date |
Дата первого запуска после установки на основе часового пояса UTC.
|
Строка даты |
|
install_date_tz |
Дата первого запуска после установки, скорректированная на основе часового пояса приложения.
|
Строка даты |
Характеристики функции
- Доступ рекламных сетей: рекламным сетям отправляются постбэки.
- Доступ агентства: не доступно
- Прозрачность агентства: Н/Д
- Валюта: USD
- Часовой пояс: UTC
-
Обновление данных: ежедневно
- Для отчетов, основанных на методе атрибуции SKAN, время в SKAN означает, что iOS сообщает об установке через 48–72 часа после открытия первого приложения.
- Исторические данные: данные доступны с даты включения Predict в вашем аккаунте AppsFlyer.
- Источник (органический/неорганический): отчеты, основанные на методе атрибуции SKAN, включают только неорганические данные, рассчитанные на основе постбэков от SKAN, полученных AppsFlyer.