Обзор отчетов с сырыми данными

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

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

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

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

 Совет

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

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

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

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

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

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

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

Валюта приложения

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

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

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

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

Ограничения  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 Тема отчета Органика Неорганические
Привлечение пользователей Clicks (Клики)
Ретаргетинг Клики от кампаний ретаргетинга  Ретаргетинг всегда неорганический
Привлечение пользователей Показы
Ретаргетинг Показы от кампаний ретаргетинга Ретаргетинг всегда неорганический
Привлечение пользователей - Установки 
Привлечение пользователей - In-App Events (Внутренние события приложения) 
Привлечение пользователей - Атрибутированный доход от рекламы -
Привлечение пользователей - Органический доход от рекламы -
Ретаргетинг - Выручка от рекламного сообщения ретаргетинга Ретаргетинг всегда неорганический
Ретаргетинг - Конверсии ретаргетинга (повторные вовлечения и реатрибуции) Ретаргетинг всегда неорганический
Ретаргетинг - Внутренние события ретаргетинга (повторные вовлечения и реатрибуции) Ретаргетинг всегда неорганический
Ретаргетинг   Сессии ретаргетинга (повторные вовлечения и реатрибуции) Ретаргетинг всегда неорганический
Привлечение пользователей   Sessions (Сеансы)
Привлечение пользователей - Неорганические удаления  -
Привлечение пользователей - Органические удаления -
Привлечение пользователей Кросс-платформенные интеракции

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

Данные о кликах и показах

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

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

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

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

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

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

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

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

Context

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

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

См. руководство по атрибуции ретаргетинга.
ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ
  • Формирование агрегированных отчетов с полями, недоступными в аналитических инструментах 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-адреса пользователя на момент события. 

Sessions (Сеансы)

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

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

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

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

Удаления

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

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

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

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

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

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

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

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

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

(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 месяцев назад и спустя несколько дней забронировал рейс.
  • Впоследствии этот пользователь просмотрел несколько предложений, но бронирований больше не делал. При более глубоком изучении данных менеджер находит других пользователей с такой же моделью поведения и продолжает анализ.
  • Он обнаружил, что большинство этих пользователей пришли с рекламного объявления A в рамках кампании B, запущенной в медиа-источнике C. Оказалось, что эти объявление и кампания таргетировались на пользователей, желающих совершить путешествие в определенном направлении.
  • Проанализировав путь пользователя, менеджер смог понять, что эта кампания, возможно, была слишком узкой или точечной, чтобы вовлечь пользователей.

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

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

Постбэки

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

Отчеты о постбэках (доступны на странице экспорта данных и через 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 (Доступ к агрегированным данным по внутренним событиям).