[Beta] Отчеты Predict

beta_feature.png

Краткий обзор. Получайте отчеты Predict с помощью Predict Pull API и/или Data Locker. Отчеты доступны на основе атрибуции SKAdNetwork (SKAN) или AppsFlyer (модель AF).

 Материалы по теме

Подробнее о методах доступа к отчетам Predict см. в этих статьях:

Обзор

Отчеты 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

  • Predict Pull API
  • Data Locker
Data Locker

Установки по модели AF

Data Locker

Дополнительные сведения и инструкции по доступу к отчетам с помощью этих методов приведены на следующих вкладках:

Predict Pull API

Администратор вашего аккаунта может получить токен V2.0 (токен на предъявителя), необходимый для доступа к API, с дэшборда AppsFlyer.

Подробнее о Predict Pull API и о том, как получить отчет.

Data Locker

Чтобы включить доступ к отчетам Predict через Data Locker:

  1. Если вы еще не получаете отчеты через Data Locker (для любой функции AppsFlyer), выполните первоначальную настройку Data Locker. (Если вы уже получаете отчеты Data Locker, перейдите к шагу 2).
  2. Добавьте отчеты Predict в Data Locker:
    1. В AppsFlyer перейдите в раздел Интеграция > Data Locker.
    2. Выберите все отчеты в разделе Predict.
    3. Нажмите Сохранить конфигурацию.
      • Отчеты будут доступны на следующий день к 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.
2 {x},{y},{z} представляют собой 3 даты измерения удержания, выбранные в процессе интеграции.

Отчеты по сырым данным — атрибуция SKAN

Имя поля 1 Источник данных Описание Формат В копии постбэка? 

ad_network_campaign_id

Рекламная сеть Идентификатор кампании, сообщенный рекламной сетью в AppsFlyer Строка Нет

ad_network_campaign_name

Рекламная сеть

Название кампании, сообщенное рекламной сетью в AppsFlyer

Строка Нет

ad_network_timestamp

Рекламная сеть

Время получения постбэка рекламной сетью.

  • В случае Google Рекламы это время определяется по времени последнего клика, которое сообщает Google.
Временная отметка Нет

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, отправляющего постбэк.

  • Примечание. Это поле заполняется, если рекламная сеть предоставляет AppsFlyer этот адрес. SDK AppsFlyer не участвует в получении IP-адреса.
Строка Нет
media_source iOS. Рекламная сеть, атрибутированная с помощью имен сетей в AppsFlyer Строка Нет

postal_code

  С 30 августа 2021 года значение всегда null   Строка Нет

Регион

AppsFlyer Согласно сообщаемому коду страны country_code Строка Нет

skad_ad_network_id

SKAN 1.0+
  • Идентификатор рекламной сети, принесшей установку. Используйте did_win, чтобы определить, является ли рекламная сеть основной или ассистентом. 
  • Некоторые SRN не сообщают свои идентификаторы (например, Twitter). В этом случае поле остается пустым.
Строка

Да 

skad_attribution_signature

SKAN 1.0+   Строка Да
skad_campaign_id SKAN 1.0+

Идентификатор кампании, используемый для публикации объявления

  • Диапазон: 0–100
Строка Да
skad_conversion_value SKAN 2.0+

Значение конверсии, сообщаемое iOS

  • Диапазон: 0–63

2 Будет ли поле заполнено, определяет порог конфиденциальности SKAN.

Целое число Да
skad_mode Predict

Режим измерения конверсий, используемый для декодирования постбэка iOS

Строка Нет
skad_redownload SKAN 2.0+ Если TRUE, приложение было загружено повторно

Логическое значение

Да

skad_source_app_id SKAN 2.0+

ID сайта (приложение, разместившее объявление)

  • Это поле идентично source_app_id

2 Будет ли поле заполнено, определяет порог конфиденциальности SKAN.

Строка Да
skad_transaction_id SKAN 1.0+   Строка Да
skad_version SKAN 2.0+   Строка Да
timestamp Рекламная сеть

Время отправки постбэка с устройства iOS.

В случае Google Рекламы это время определяется по времени последнего клика, которое сообщает Google Реклама. 

Строка времени Да

source_app_id

AppsFlyer

ID сайта (приложение, разместившее объявление)

  • Это поле идентично полю skad_source_app_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+)

Используется для различения кампаний, которые способствовали установке и которым атрибутирована установка:

  • Если TRUE, установка атрибутирована этой кампании.
  • Если FALSE, то кампания считается ассистентом в установке.
Логическое значение Да

fidelity_type

SKAN 2.2+ (iOS 14.5+)

Различает варианты представления объявлений, влияющие на атрибуцию:

  • 0 = просмотр рекламы
  • 1 = реклама с рендерингом StoreKit

Не учитывайте значение поля, если версия SKAN менее 2.2.

Целое число Да

ad_network_source_app_id

Рекламная сеть ID приложения издателя, который сообщает рекламная сеть. Используется для сверки затрат; сообщается рекламной сетью. Приложение издателя дает основу для этих данных.  Строка Нет

ad_network_channel

Рекламная сеть   Строка Нет

af_prt

Рекламная сеть   Строка Нет

measurement_window

AppsFlyer

Продолжительность окна активности

  • По умолчанию: 24 (часа)
Целое число Нет

af_attribution_found

AppsFlyer В настоящее время null для Predict Логическое значение Нет

p_revenue

Predict Средний прогнозируемый доход (30-й день) группы пользователей по доходам, к которой относится пользователь. Число Нет

is_p_payer

Predict
  • 0 = пользователь НЕ будет платящим пользователем на 30-й день.
  • 1 = пользователь будет платящим пользователем на 30-й день.
Целое число Нет

is_p_whale

Predict Целое число Нет

p_retention

Predict Последняя из 3 выбранных дат измерения удержания, на которую пользователь будет являться удержанным пользователем. Целое число Нет

no_conversion_value

Predict
  • 0 = постбэк сообщил значение конверсии
  • 1 = нет прогноза, так как постбэк не сообщил значение конверсии (из-за порогов конфиденциальности SKAN)
Целое число Нет

insufficient_data

Predict
  • 0 = достаточно данных для прогнозирования
  • 1 = нет прогноза в результате недостаточного количества данных
Целое число Нет

Примечания.
1 Когда SKAN является источником данных, указывается первая версия SKAN, которая сообщает эти данные.
2 SKAN определяет, заполнено ли поле, используя механизм порога конфиденциальности.

Отчеты по сырым данным — атрибуция по модели AF

Имя поля Описание Формат

af_ad_id

ID рекламы.

Строка

platform

Платформа устройства (iOS)

Строка перечисления

af_adset_id

ID группы объявлений (группа, содержащая одно или несколько объявлений)

Строка

af_adset

Название группы объявлений

Строка

media_source

Атрибутированная рекламная сеть (с помощью названий сетей в AppsFlyer)

Строка

af_ad

Имя рекламы

Строка

Регион

Географический регион, на основе IP-адреса устройства, сообщенном SDK

Строка

campaign

Название кампании

Строка

af_channel

Канал медиа-источника 

  • Например, YouTube — это канал Google; Instagram — канал Meta и т.д.

Динамическая строка перечисления

campaign_id

ID кампании

Строка

Страна

Код страны по ISO 3166 (alpha-2), на основе IP-адреса устройства, сообщенном SDK, например, US, CN.

  • Для Великобритании используется код UK, а не GB. 

Строка перечисления

site_id

Идентификатор издателя

Строка

attribution_type

Тип атрибуции:

  • Установка
  • Повторные установки
  • Повторное вовлечение 
  • Неизвестно

В настоящее время Predict поддерживает только атрибуцию установок.

Строка

af_prt

Агентство

Строка

install_time

  • UA: первый запуск после установки
  • Ретаргетинг: первый запуск после повторного вовлечения / реатрибуции

В настоящее время Predict поддерживает только UA, поэтому время установки install_time всегда будет первым запуском после установки.

Дата/Время

app_id

Идентификатор приложения, присвоенный магазином приложений.

  • Для iOS он всегда включает префикс id.

Строка

ip

IP-адрес в HTTP-сообщении устройства iOS, отправляющего постбэк, как сообщает SDK.

Строка

attributed_touch_type

Возможные значения:

  • UA: click, impression, TV, pre-installed (клик, показ, ТВ, предустановка).
  • Ретаргетинг: click, impression (клик, показ).

В настоящее время Predict поддерживает только UA, поэтому атрибутированный тип взаимодействия attributed_touch_type будет одним из возможных значений для UA.

Перечисление

city

Наиболее детальное местоположение пользователя, основанное на IP-адресе устройства, сообщенном SDK.

  • Как правило, значение является названием города, но также может включать районы, округа, то есть более точные данные.

Строка

dma

Назначенный район охвата или географическая зона, на основе IP-адреса устройства, сообщенном SDK.

  • Эти значения определены компанией Nielsen.

Строка

postal_code

Почтовый индекс, основанный на IP-адресе устройства, сообщенном SDK.

Строка

Состояние

Штат, на основании IP-адреса, предоставленного SDK.

Строка

user_agent

Агент пользователя URL

Строка

is_lat

Ограничение отслеживания рекламы (LAT):

  • Для пользователей iOS до версий iOS 14 значение TRUE означает, что пользователь решил ограничить отслеживание рекламы (включил LAT).
  • Для пользователей iOS 14 или более поздних версий TRUE означает, что пользователь решил запретить отслеживание на основе статуса ATT.
Логическое значение

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

  • 0 = пользователь НЕ будет платящим пользователем на 30-й день.
  • 1 = пользователь БУДЕТ платящим пользователем на 30-й день.

Целое число

insufficient_data

  • 0 = достаточно данных для прогнозирования
  • 1 = нет прогноза в результате недостаточного количества данных

Целое число

install_date

Дата первого запуска после установки на основе часового пояса UTC.

  • Представлено в формате ММ/ДД/ГГГГ.

Строка даты

install_date_tz

Дата первого запуска после установки, скорректированная на основе часового пояса приложения.

  • Представлено в формате ММ/ДД/ГГГГ.
Строка даты

Характеристики функции

  • Доступ рекламных сетей: рекламным сетям отправляются постбэки.
  • Доступ агентства: не доступно
  • Прозрачность агентства: Н/Д
  • Валюта: USD
  • Часовой пояс: UTC
  • Обновление данных: ежедневно
    • Для отчетов, основанных на методе атрибуции SKAN, время в SKAN означает, что iOS сообщает об установке через 48–72 часа после открытия первого приложения.
  • Исторические данные: данные доступны с даты включения Predict в вашем аккаунте AppsFlyer.
  • Источник (органический/неорганический): отчеты, основанные на методе атрибуции SKAN, включают только неорганические данные, рассчитанные на основе постбэков от SKAN, полученных AppsFlyer.