Обзор отчётов по сырым данным

Краткий обзор: Данные на уровне строк (т.н. сырые данные) описывают события, связанные с пользователями, такие как установки, внутренние события приложения, посещения сайта, установки, заблокированные Protect360, доход от рекламы и связанные с пользователями постбэки, отправленные партнерам. Отчёты с сырыми данными доступны для скачивания, через API и в Data Locker.

Отчётность по сырым данным: инструменты и отчёты

С помощью отчётов с сырыми данными вы можете анализировать поведение и пути пользователей, выполнять сверку аккаунтов рекламных сетей и дополнять данные в CRM и системах бизнес-аналитики. Когда вы используете сырые данные, у вас больше возможностей для анализа, оптимизации и улучшения показателей эффективности приложения. 

Отчёты доступны через инструменты отчётности. У этих инструментов разные характеристики; они подходят для разных сценариев использования. Например, для сверки аккаунта рекламной сети отчёт скачивается со страницы экспорта данных. Данные об эффективности по пользователям для загрузки в системы бизнес-аналитики следует получать программным образом с помощью Data Locker или Pull API.

Совет

Хотите больше узнать о сырых данных? Ознакомьтесь с этим коротким информативным курсом на портале обучения AppsFlyer.

Инструменты отчётности: характеристики и возможности

Отчёты предоставляются через инструменты отчётности, перечисленные в этом разделе.

Факторы, которые необходимо учитывать:

  • Диапазон дат в отчёте относится к (фактической) дате активности, когда произошло событие. В этом их отличие от агрегированных отчётов, в которых диапазон дат основан на LTV.
  • Описания полей см. в словаре полей данных.

Инструменты отчётности

Инструмент Описание Несколько/одно приложение (1) Обновление данных (2) Встроено в скрипты Часовой пояс Валюта
Страница экспорта необработанных данных
  • Отчёт скачивается через пользовательский интерфейс
  • Формат: Файл CSV
Одно Непрерывно x

Зависит от приложения

Зависит от приложения
Pull API*
  • Отчёт скачивается с помощью вызовов API.
  • Формат: CSV-файлы
Одно Непрерывно
  • Можно выбрать
  • По умолчанию: UTC
  • Можно выбрать
  • По умолчанию: USD
Data Locker П
  • Данные, передаваемые в корзину в облаке.
  • Нет ограничений по объёму.
  • Окно доступности данных: 14 дней.
  • Формат: CSV или parquet
Несколько Обновляется непрерывно с задержкой в несколько часов UTC USD 
Push API П
  • Данные о пути пользователя (установки, внутренние события, ретаргетинг, SKAN) отправляются на ваши серверы в режиме реального времени.
  • Формат: JSON или параметры запроса
Могут использовать одну конечную точку В течение нескольких минут после регистрации события в AppsFlyer UTC + время приложения USD + валюта приложения
Данные о конверсиях через SDK (3)
  • Получайте данные об атрибуции конверсий внутри приложения.
  • Формат: JSON
Не применимо   В режиме реального времени <5 секунд   UTC Не применимо

Примечания и сокращения:
(1) Поддержка нескольких приложений
(2) Фактическое обновление данных зависит от самого отчёта, поскольку некоторые отчёты обновляются ежедневно.
(3) С помощью метода получения данных о конверсиях через SDK данные об атрибуции пользователя извлекаются менее чем через 5 секунд после первого запуска приложения, поэтому это самый неточный метод.
(П) Функция категории «Премиум»
(*) Применяются квоты на создание отчетов

Ограничения инструментов

Ограничение  Pull API (*) Push API Data Locker SDK
Данные о конверсиях
Ограничение объёма данных 1 млн строк за вызов Не применимо Н\/Д Не применимо
Варианты выбора данных Выбор типов данных. Ограниченные возможности по выбору полей Выберите типы данных, поля и внутренние события Выберите типы данных, поля и внутренние события Нет
Окно доступности данных 90 дней Не применимо 14 дней  Бессрочно (доступно в SDK)

(*) Применяются квоты на создание отчётов

Замечания по интеграции

Особенности  Pull API Push API Data Locker SDK
Данные о конверсиях
Разработка на стороне сервера Необязательно Обязательный Необязательно Необязательно
Требуется ли обработка данных Необязательно Обязательный Необязательно Необязательно
Риск потери данных Нет Да, если сбой на принимающих серверах Нет Небольшой, если есть задержки в ответе рекламных сетей
Стоимость обработки клиент-сервер Нет Высокая Низкая Нет (если не отправлять данные на серверы)
Обслуживание системы клиент-сервер Нет Высокая Низкая Нет (если не отправлять данные на серверы)
Формат данных Файл CSV JSON или параметры запроса CSV или parquet JSON

В отчётах записи сырых данных, создаваемые в определенном контексте, группируются: неорганические установки, органические внутренние события приложения и т. п. Для удобства отчёты сгруппированы следующим образом:

  • Путь пользователя: Используется для отслеживания пути и взаимодействия пользователя с приложением.
    Например: клик > установка > внутреннее событие > удаление.
  • Функциональность: Относятся к конкретным возможностям AppsFlyer, но не к основному пути пользователя. Например, отчёты по постбэкам в рекламные сети, мошенничеству и правилам валидации, а также отчёты по доходу от рекламы уровня пользователя.

Поля отчёта

В словаре полей сырых данных содержатся поля, актуальные для отчётов о пути пользователя, и некоторые поля отчётов по функциям. Принципы следующие:

  • Путь пользователя:
    • Имеет общий набор полей.
    • Заполнение полей зависит от контекста пути. Например, в неорганических отчётах указываются медиа-источники, которым атрибутировано привлечение пользователя. Поля атрибуции в органических отчётах не заполнены, поскольку в них медиа-источники отсутствуют. 
  • Функциональность: имеет уникальный набор полей или содержит поля пути пользователя и дополнительные поля, актуальные для определенной функции. Например, в отчётах SKAdNetwork есть уникальный набор полей, тогда как в отчётах по постбэкам содержатся поля пути пользователя и дополнительные поля, связанные с отправкой постбэков партнерам. 

Совет! Лучший способ знакомства с отчётами — их просмотр. Вы можете скачать отчёты на странице экспорта данных

Для удобства поля пути пользователя разделены на группы в зависимости от контекста.

Группы полей с сырым данными о пути пользователя

Группа полей Актуальность для органических пользователей Примеры полей
Приложение Да App ID, название приложения, версия приложения, версия SDK, ATT
Атрибуция

Нет, кроме времени установки

Время установки, время атрибутированного взаимодействия, медиа-источник, кампания, группа объявлений, рекламное объявление, партнер, тип конверсии ретаргетинга

Атрибуция ассистентов Нет Партнер-ассистент, тип соответствия
Информация об устройстве Да ID рекламы, GAID, OAID, тип устройства, ID клиента
Местоположение устройства Да IP-адрес, город, страна
Событие

Да

Заполняется в отчётах по внутренним событиям приложения:

имя события, значение события, доход от события

отчёты о пути пользователя

Raw_data_-_User_acquisition_.png

Основные сведения о пути пользователя

отчёты о пути пользователя содержат данные, собранные по событиям, произошедшим в течение жизненного цикла пользователя. Эти данные разделяются в отчётах по следующим критериям:

  • Источник появления пользователя: органический или неорганический
  • Контекст пути:
    • Взаимодействие с рекламой до установки (показы и клики)
    • Привлечение пользователей
    • Ретаргетинг

отчёты о привлечении пользователей (UA) содержат:

  • Показы и клики, имевшие место перед установкой приложения любым потенциальным пользователем, взаимодействовавшим с рекламой.
  • Событие установки.
  • Последующие внутренние события, выполненные пользователем.

Отчёты о ретаргетинге содержат:

  • Показы и клики, имевшие место при ретаргетинге пользователя.
  • События конверсии: повторное вовлечение или реатрибуция.
  • Последующие внутренние события приложения, произошедшие в рамках повторного вовлечения. Обратите внимание:
    • Данные ретаргетинга всегда неорганические.
    • Внутренние события приложения, произошедшие в результате ретаргетинга, присутствуют как в отчёте по привлечению пользователей, так и в отчёте по внутренним событиям в результате ретаргетинга. См. статью о методологии двойной атрибуции ретаргетинга.

      Raw_data_-_Retargeting.png

Чтобы отследить путь пользователя, используйте комбинацию отчётов, которые относятся к интересующей вас части пути, например, по установкам и внутренним событиям приложения. Далее отсортируйте отчёт по AppsFlyer ID, времени события и типу отчёта. Так вы получите события по конкретному пользователю за период, т. е. путь пользователя. 

Доступность отчёта о пути пользователя

  • Доступность данных зависит от тарифного плана аккаунта.
  • отчёты могут включать органических пользователей, неорганических пользователей, или оба типа, как указано.
  • Политики хранения данных, применяемые к отчётам с сырыми данными за прошлые периоды, зависят от инструмента отчётности и источника сырых данных. Как правило, данные доступны за предыдущие 90 дней. Важно! Политики хранения данных не распространяются на агрегированные данные.  

Отчёты о пути пользователя

Категория Уникальные возможности Data Locker Тема отчёта Органический Неорганический
Привлечение пользователей Клики Не применимо
Ретаргетинг Клики от кампаний ретаргетинга   Ретаргетинг всегда неорганический
Привлечение пользователей Показы Не применимо
Ретаргетинг Показы от кампаний ретаргетинга Ретаргетинг всегда неорганический
Привлечение пользователей - Установки 
Привлечение пользователей - Внутренние события приложений 
Привлечение пользователей - Атрибутированный доход от рекламы -
Привлечение пользователей - Органический доход от рекламы -
Ретаргетинг - Доход от рекламы ретаргетинга Ретаргетинг всегда неорганический
Ретаргетинг - Конверсии ретаргетинга (повторные вовлечения и реатрибуции) Ретаргетинг всегда неорганический
Ретаргетинг - Внутренние события ретаргетинга (повторные вовлечения и реатрибуции) Ретаргетинг всегда неорганический
Ретаргетинг   Сессии ретаргетинга (повторные вовлечения и реатрибуции) Ретаргетинг всегда неорганический
Привлечение пользователей   Сессии
Привлечение пользователей - Неорганические удаления.  -
Привлечение пользователей - Органические удаления -
Привлечение пользователей Кросс-платформенные интеракции

Описания отчёта о пути пользователя

Клики и показы

Отчёт Характеристики
Контекст Пользователь взаимодействует с рекламной кампанией, совершая клик или просмотр рекламного объявления.
Характеристики отчёт содержит запись со ссылкой атрибуции и заголовками HTTP, присутствующими, когда пользователь кликает или просматривает рекламное объявление.
Сценарий
  • Оптимизация кампаний, которые не приводят к открытию приложения (установка, реатрибуция, повторное вовлечение).
  • Ретаргетинг пользователей с помощью других кампаний.
Пример отчёта Клики
Примечания

Данные SRN недоступны.

Ограниченные данные о пользователях В некоторых случаях из-за правил конфиденциальности данные о показах и кликах либо ограничены (не содержат идентификаторы пользователей), либо не доступны вовсе. Доступность зависит от медиа-источника и платформы. 

Установки и конверсии ретаргетинга

Название отчёта 

Привлечение пользователей: Установки

Ретаргетинг: Конверсии
Контекст

Когда пользователь впервые открывает приложение.

Пользователь открывает приложение после взаимодействия с рекламным объявлением в рамках ретаргетинга. Конверсия ретаргетинга является повторным вовлечением или реатрибуцией.

См. руководство по атрибуции ретаргетинга.
Примеры
  • Формирование агрегированных отчётов с полями, недоступными в аналитических инструментах AppsFlyer.
  • Объединение с другими отчётами для расширенного перекрестного анализа.
  • Анализ эффективности по различным параметрам, таким как города, области и т. д. 
  • Сегментация пользователей по стране, городу и языку для таргетинга.
  • Получение идентификаторов устройств пользователей в целях ретаргетинга.
Аналогично установкам.
Органические и неорганические
  • Неорганические: заполняются группы полей атрибуции и атрибуции ассистентов
  • Органические: поле медиа-источника не заполнено либо содержит значение null или organic. Учитывайте это при загрузке данных в свои системы. 
Не применимо
Пример отчёта Установки Отчёт по конверсиям ретаргетинга имеет ту же структуру полей, что и отчёт по установкам. Некоторые поля заполняются в контексте ретаргетинга. См. сырые данные ретаргетинга.  

Внутренние события приложений

Отчёт Характеристики

Контекст отчёта

Отсортированный в хронологическом порядке список действий, выполненных пользователями после атрибуции (установка, реатрибуция или повторное вовлечение)

Характеристики

  • По структуре и полям отчёт аналогичен отчётам по установкам.
  • Выделенные поля описывают событие. К ним относятся название события, значение, доход и время. 

Сценарий

Используйте этот отчёт, чтобы:

  • получать аналитические данные, отслеживая путь пользователя на протяжении его жизненного цикла;

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

Значения событий

Поле «Значение события»

Поле «Значение события» содержит все данные, связанные с событием в формате JSON. Их можно загрузить в систему бизнес-аналитики для дальнейшего анализа.

Совет Вы можете использовать Power Query в Microsoft Excel для анализа параметров события из текстовых строк JSON.


{"af_level":"10","af_user_journey":"3387","arena":"7","char_type":"paladin"}

Отчёты по доходам

В AppsFlyer данные о доходах и ROI берутся из параметра af_revenue, отправляемого в событиях. 

Когда параметр af_revenue передается во внутреннем событии приложения, AppsFlyer использует его значение для заполнения поля с доходом от события. Именно это поле используется AppsFlyer для обновления данных на дэшборде и в агрегированных отчётах. 

Примечание! Используйте параметр af_revenue только с внутренними событиями приложения, которые описывают фактически полученный доход. Для других событий, которые связаны с доходом, но в которых он не является окончательным, например, add_to_cart (добавление в корзину), используйте другие параметры, такие как af_price.

Пример отчёта

Внутренние события приложения

Примечания

  • Внутренние события приложения, произошедшие в результате ретаргетинга, регистрируются дважды: в отчётах с сырыми данными по привлечению пользователей и по внутренним событиям в результате ретаргетинга. 
  • Отчёт по внутренним событиям приложения не включает событие запуска приложения (af_app_opened). Оно доступно в отчёте с сырыми данными по сессиям
  • Регион: определяется на основе IP-адреса пользователя на момент события. 

Сессии

Отчёт Характеристики
Контекст Когда пользователь открывает приложение, событие сессии отправляется в AppsFlyer. Это событие регистрируется, если превышено минимальное время между сессиями
Характеристики

По структуре этот отчёт аналогичен отчётам по внутренним событиям приложения. Сессии (события сессий) находятся в отдельном отчёте из-за большого количества таких событий.

Сценарий Анализ взаимодействия пользователей с приложением.
Пример отчёта Отчёт по сессиям аналогичен отчёту по внутренним событиям приложения. Примечание: сессии в сырых данных имеют название события launch (запуск). 

Удаления

Отчёт Характеристики
Контекст Регистрация пользователей, удаляющих приложение. 
Характеристики
  • Этот отчёт обновляется не непрерывно, а раз в день, как и другие отчёты о пути пользователя. 
  • В этом отчёте временем события является момент, когда AppsFlyer определяет, что приложение удалено, а не фактическое время удаления. См. измерение удалений.
Доступные поля
  • Если пользователь привлечен неорганическим медиа-источником, поля медиа-источника заполняются. 
  • Рассмотрим событие удаления, созданное серверами AppsFlyer после выяснения, что пользователь удалил приложение. Соответственно, многие поля не заполнены.  
  • Доступные идентификаторы пользователей — это идентификаторы, зарегистрированные во время установки. CUID никогда не доступен.  
  • Поля, связанные с геоданными, заполняются данными о местоположении пользователя на момент интеракции с медиа-источником (клика или показа). Если местоположение по интеракции недоступно, используется местоположение по событию установки. 
Пример отчёта Удаления Важно! Для ясности в примере в строке 2 указано, какие поля заполняются при доступности соответствующих данных. 
Примеры
  • Анализ характеристик событий удаления, устройств и пользователей.
  • Формирование аудитории для ретаргетинга по событию удаления.

Доступность отчёта о пути пользователя по инструментам

Отчёт о взаимодействии с рекламой по инструментам 

Отчёт Экспорт данных Pull API Data Locker Push API SDK
Данные о конверсиях
Показы (1) - - - -
Клики (1) - - - -
(1) Данные о кликах и показах предоставляются сетями без самостоятельной атрибуции (не-SRN). SRN такие данные не предоставляют.

Отчёты о привлечении пользователей по инструментам  

Отчёт Экспорт данных Pull API Data Locker Push API Данные о конверсиях через SDK
Установки
Сессии - - - -
Внутренние события приложений -
Удаления - -

Отчёты с сырыми данными ретаргетинга по инструментам

Отчёт Экспорт данных Pull API Data Locker Push API Данные
о конверсиях через SDK
Клики (1) - - - -
Конверсии (реатрибуции + повторное вовлечение)
Показы (1) - - - -
Сессии - - - -
Внутренние события приложений -

(1) Данные о кликах и показах предоставляются сетями без самостоятельной атрибуции (не-SRN). SRN такие данные не предоставляют.

Часто задаваемые вопросы

Подробности

Почему отсутствуют сырые данные Meta Ads?

По умолчанию сырые данные Meta Ads атрибутируются скрытому медиа-источнику «restricted». См. данные Meta Ads уровня пользователя.

Есть ли отличия между метками времени?

Во всех отчётах используются общие метки времени. Благодаря этому отчёты можно комбинировать.

Актуальны следующие метки времени: 

  • Время атрибутированного взаимодействия: время взаимодействия пользователя с рекламным объявлением.
  • Время установки момент первого запуска приложения.
  • Время события: момент, когда происходит событие.

Обратите внимание: 

  • В отчётах по установкам время установки и время события совпадают.
  • В отчётах по внутренним событиям приложения время установки и время события не совпадают. По разнице между ними можно определить, сколько времени прошло между запуском приложения и взаимодействием пользователя с приложением.

Каково назначение поля «Ассистент»?

В поле «Ассистент» перечислены медиа-источники — ассистенты. Иногда их также называют Дополнительные источники рекламы. В Protect360 эти данные также используются для исправления атрибуции перехваченных установок.

Что представляет собой поле ключевых слов? Почему оно доступно не для всех неорганических установок? 

Данные по установкам, атрибутированным Google Ads или Apple Search Ads, могут содержать ключевые слова или идентификаторы ключевых слов, связанные с рекламным объявлением, принесшим установку. 

Отчёты по установкам: рекомендации

О пути пользователя

Путь пользователя — это серия шагов, которые выполняет пользователь, прежде чем совершить целевой действие, например, покупку товара или бронирование рейса. Идея анализа пути пользователя состоит в том, чтобы увидеть, что именно пользователь делает в приложении, насколько он активен, и какую ценность он приносит в течение определенного периода.

Вы можете идентифицировать и выделять пути пользователя с помощью AppsFlyer ID. Этот идентификатор генерируется для каждой установки приложения на устройство. Он не изменяется на протяжении всего жизненного цикла пользователя (от установки до удаления). Этот идентификатор сохраняется, если пользователь сбрасывает идентификатор устройства.

Поскольку отчёты по установкам и внутренним событиям приложения имеют одинаковую структуру, их можно объединить в один отчёт. В объединенном отчёте вы можете в целях анализа путей пользователей агрегировать и фильтровать данные по AppsFlyer ID и ID клиента (если он доступен).

 Примеры

Сильное вовлечение

  • Пользователь установил приложение 20 августа в 09:31.
  • Объединенный отчёт показывает, что он совершил покупки 20 августа в 10:31, 22 августа в 15:22 и 25 августа в 16:47.
  • На основе этих данных можно сделать вывод, что это активный пользователь. Он совершил покупку через час после запуска приложения и продолжил покупки после установки.

Слабое вовлечение

  • Пользователь установил приложение 30 июля. Объединенный отчёт показывает, что он добавил товар в корзину 15 августа, но события покупки не последовало.
  • Можно предположить, что этот пользователь сомневается относительно покупки, и показать ему добавленные в корзину товары с помощью ретаргетинга.

Анализ пути пользователя для оптимизации кампании

  • Менеджер по привлечению пользователей (UA) приложения для путешествий скачивает отчёты по установкам и внутренним событиям и объединяет их.
  • Затем для просмотра путей пользователя он фильтрует и агрегирует данные по AppsFlyer ID.
  • Он замечает, что один из пользователей, идентифицированный по AppsFlyer ID, скачал приложение 12 месяцев назад и спустя несколько дней забронировал рейс.
  • Впоследствии этот пользователь просмотрел несколько предложений, но бронирований больше не делал. При более глубоком изучении данных менеджер находит других пользователей с такой же моделью поведения и продолжает анализ.
  • Они обнаружили, что большинство этих пользователей пришли из объявления А кампании Б, запущенной на медиа-источнике С. Оказалось, что эта реклама и кампания были нацелены на пользователей, которые хотели посетить определённое направление.
  • Проанализировав путь пользователя, менеджер смог понять, что эта кампания, возможно, была слишком узкой или точечной, чтобы вовлечь пользователей.

Отчёты по функциям

Отчёты, связанные с дополнительными возможностями, доступными на платформе

Постбэки

Используйте отчёты по постбэкам для проверки копии данных, отправляемых рекламной сети. Например, для выяснения причин появления расхождений. Эти отчёты носят информационный характер и не требуются для интеграции с рекламными сетями.

отчёты о постбэках (доступны на странице экспорта данных и через Pull API)

Тема отчёта События, направленные атрибутированному медиа-источнику
Установки Неорганические установки (UA)
Внутренние события приложений Неорганические внутренние события приложений.

Постбэки по конверсиям ретаргетинга

Ретаргетинг (повторное вовлечение и реатрибуция)

События ретаргетинга внутри приложений. 

События ретаргетинга внутри приложений.

Дополнительные поля о отчетах по постбэкам

Поле Примечания
URL постбэка

Некоторые значения, такие как доход, могут не отображаться в соответствующем поле, но вы все равно можете увидеть эти данные в URL-адресе постбэка.

Метод постбэка  
Код ответа HTTP постбэка 200: подтверждает, что постбэк получен рекламной сетью.
Сообщение об ошибке постбэка   

Правила проверки и защита от мошенничества Protect360

  • См. отчёты с сырыми данными по Protect360 и правилам валидации.
  • Для доступа к отчётам Protect360 и отчётам по правилам валидации рекламным сетям и агентствам требуется разрешение рекламодателя.

Чтобы предоставить интегрированному партнеру разрешение на доступ к Protect360:

  1. Перейдите в раздел Совместная работа > Активные интеграции
  2. Выберите интегрированного партнера.
  3. На вкладке Permissions (Разрешения) включите Access your Protect360 dashboard & raw data via API (Доступ к дэшборду Protect360 и сырым данным через API).
  4. Чтобы предоставить доступ к дэшборду In-app events (CPA) (Внутренние события приложения (CPA)), включите Access aggregate in-app events data (Доступ к агрегированным данным по внутренним событиям).