Чем мы можем помочь?

Расширенные агрегированные отчеты в Data Locker Категория "Премиум"

  • Обновлено

Краткий обзор: Расширенные агрегированные отчеты в Data Locker содержат агрегированные данные с оптимальной актуальностью, точностью, детализацией и неограниченным объемом.

Расширенные агрегированные отчеты в Data Locker

Расширенные агрегированные отчеты в Data Locker:

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

Настройка

Чтобы получить расширенные агрегированные отчеты, выполните одну из следующих процедур. 

Получаете ли вы в настоящее время данные через Data Locker?  Процедура

 

Да 

AppsFlyerAdmin_us-en.pngДля добавления отчетов в Data Locker:
  1. В AppsFlyer в боковом меню выберите Экспорт > Data Locker.
  2. Выберите все отчеты, которые вы хотите получить. 
  3. Нажмите кнопку Сохранить конфигурацию. Отчеты будут доступны на следующий день. .
Нет AppsFlyerAdmin_us-en.pngЧтобы настроить Data Locker:
  1. Выполните первоначальную настройку Data Locker (advertiser | partner).
  2. Добавьте отчеты в Data Locker:
    1. В AppsFlyer в боковом меню выберите Экспорт > Data Locker.
    2. Выберите все отчеты, которые вы хотите получить. 
    3. Нажмите Сохранить конфигурацию. 
      Отчеты будут доступны на следующий день.0>

Доступные отчеты

Расширенная агрегированная версия (с учетом когорты)

Факты об отчете

Обзор

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

Скачать образец отчета

Доступные отчеты Для загрузки доступны следующие отчеты. Типы отчетов подробнее описаны в дэшборде Когорта.
  • Привлечение пользователей: атрибутируется медиаисточнику привлечения пользователя, включая LTV в течение действия окон повторного вовлечения.
  • Ретаргетинг: приписывается медиаисточнику ретаргетинга для событий, происходящих:
    • во время окна повторного вовлечения
    • в результате реатрибуции
  • Унифицировано: отображает данные медиаисточника последнего взаимодействия, приводящего пользователя, согласно правилам двойной атрибуции AppsFlyer. Это означает, что LTV, формируемая в результате повторного взаимодействия с пользователем, отображается для медиаисточника ретаргетинга, а не для медиаисточника первоначального привлечения пользователя. 
Отчетный период Пользователи, совершившие конверсию в течение предыдущих 1095 дней. Другими словами, каждый день в отчеты попадают события пользователей, которые совершили конверсию в течение предыдущих 1095 дней. 
Структура отчета Схема отчета (включенные в него измерения и метрики) фиксирована и не подлежит редактированию. 
Актуальность данных
  • В течение дня. Отчеты отправляются каждые несколько часов.
  • Отчеты содержат данные за этот день. То есть 18 апреля каждая версия отчета содержит все актуальные данные на 18 апреля. Подробнее
Часовой пояс UTC
Структура каталогов и названий файлов Подробнее
Влияние политики хранения данных партнеров

Учтите, что некоторые партнеры внедряют политику хранения данных. В этом случае события, произошедшие после окончания периода удержания, считаются органическими в когортных отчетах.

Пример: SRN «A» придерживается политики хранения данных в течение 180 дней. События пользователей до 180 дня атрибутируются сети SRN «A». События, происходящие после 180 дней, считаются органическими.

Структура отчета

Отчет состоит из показателей и метрик.

Формат полей следующий:

  • Измерения: Строка. Максимальная длина строки является динамической и в большинстве случаев зависит от того, как вы заполняете элементы рекламной иерархии.
  • Показатели: Число. Примечание: Формат поля selected_currency — это строка.
    Доступны такие метрики, как доход, уникальные пользователи, совершившие событие, и частота события. Для расчета метрик, связанных с затратами, таких как ROI и ROAS, вам нужны метрики дохода и затрат. Метрики дохода находятся в когорте, а метрики затрат предоставляются через ROI360 Cost ETL.

Измерения

Название поля  Описание
app_id  
media_source  
conversion_type Возможные значения: install, install_unified (представляют установки в объединенном отчете), re-engagement, re-attribution.
attributed_touch_type Возможные значения: click, impressions, pre-install, unknown, tv, null
days_post_attribution
  • Количество дней, прошедших с даты конверсии (не конкретная временная метка конверсии).
  • Совет! Используйте для расчета дней удержания и KPI.
event_date  
  • Дата выполнения пользователем данного события.
  • Формат: гггг-мм-дд
  • Пример: Дата выполнения пользователем данного события в приложении. В случае конверсии.
  • Примечание! Если event_name равно af_conversion, то дата события и дата конверсии будут совпадать. 
conversion_date
  • Дата, когда произошла конверсия
  • Формат: гггг-мм-дд
  • Пример: Дата установки
event_name Определяет событие. Некоторые названия событий имеют определенное значение, другие относятся к внутренним событиям, заданным рекламодателем в приложении. 
event_name Что сделал пользователь
af_conversion Пользователь совершил конверсию. Используйте conversion_type, чтобы указать это install, re-engagement или re-attribution.
af_session Открыл приложение
cohort_uninstalls Удалили приложение 
Рекламодатель определил внутреннее событие приложения Выполнил внутреннее событие в приложении
campaign

Иерархия кампаний

Обратите внимание: изменение названий кампаний не поддерживается. Следовательно, с одним идентификатором кампании может быть связано несколько названий. 

campaign_id Иерархия кампаний
adset Иерархия кампаний
adset_id Иерархия кампаний
ad Иерархия кампаний
ad_id Иерархия кампаний
канал

Иерархия кампаний.

[Обновлено 27 октября 2021 г.] В настоящее время Meta ads не отображает канал в данных, предоставляемых через механизм Google Install Referrer.

site_id Иерархия кампаний
is_primary_attribution Используйте для идентификации и дедупликации данных ретаргетинга.
geo Код страны по ISO, полученный из IP-адреса пользователя.
agency
  • Поддержка прозрачности агентств.
  • В случае непрозрачных агентств может возникать несколько строк с одинаковым названием кампании, если рекламодатель и агентство одновременно запускают кампании с одним названием. Не беспокойтесь. Строки не дублируются.
install_app_store Только приложения для Android: Магазин Android, из которого было загружено приложение. Заполняется рекламодателями, внедряющими атрибуцию Android для нескольких магазинов. Если пусто, значит Google Play Store. 
keywords Слово или слова, появляющиеся в поисковых запросах пользователя. В соответствии с отчетами рекламной сети.
keyword_id Идентификатор ключевого слова, возвращенный рекламной сетью.

Метрики

Название поля Описание Формат
unique_users Количество уникальных пользователей, выполнивших событие Число
revenue_usd
  • Сумма выручки в долларах США. Например, 100,56 долл. США отражается как 100.56.
  • Максимум 2 знака после запятой.
Число
event_count Сколько раз произошло событие. Число
selected_currency 3-буквенный код валюты (USD, EUR), установленный вами в настройках приложения. Формат ISO-4217. Это та же валюта, которая используется для отображения выручки в разделе "Когорта" в пользовательском интерфейсе.  Строка
revenue_selected_currency
  • Сумма дохода в выбранной валюте. Например, если выбранная валюта — EUR, то 1234,56 евро отражается как 1234.56
  • Максимум 2 знака после запятой
Число
first_inapp
  • Количество пользователей, впервые реализовавших событие после конверсии.
  • Суммируя метрики first_inapp, вы получаете общее количество уникальных пользователей для данного события.
Число

Структура каталога и названий файлов

Путь к отчету состоит из следующей иерархии папок:

В следующем формате: <bucket-name>/t=cohort_unified_versioned/dt=<yyyy-mm-dd>/version=<unix timestamp>/<parquet file number>

Иерархия папок с отчетами

Пример иерархии папок отчета по когортам с поддержкой версий в бакете рекламодателя:

bucket
|
└── t=cohort_unified_versioned
    |
    ├── dt=2024-05-05
    |   |
    |   └── version=1714890235
    |   |    |
    |   |    ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   |    |
    |   |    ├── part-00001-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   |    │
    |   |    └── part-00002-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   |
    |   |
    |   └── version=1714890286
    |        |
    |        ├── part-00000-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |        |
    |        ├── part-00001-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |        │
    |        └── part-00002-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |   |
    .   . 
    .   . 

Условные обозначения:

  • dt: Дата, когда произошли события, включенные в отчет.
  • t: тип отчета.
  • version: Временная метка Unix, когда была создана версия.

Версии отчетов и актуальность данных

  • В течение дня. Отчеты отправляются каждые несколько часов.
  • Отчеты содержат все данные, доступные на данный момент за день. То есть 18 апреля каждая версия отчета содержит все доступные на этот момент данные за 18 апреля.
  • Загружайте только последнюю доступную версию отчета.
Версия Отчет включает данные, которые AppsFlyer получил к (время в UTC) Пример использования Время доступности отчета (время в UTC)
1 День 0 в 4 утра Частичные данные за день 0 День 0 в 8:00
2 День 0 в 8:00 Частичные данные за день 0 День 0 в 13:00
3 День 0 в 12:00 Частичные данные за день 0 День 0 в 18:00
4 День 0 в 16:00 Частичные данные за день 0 День 0 в 21:00
5 День 0 в 20:00 Частичные данные за день 0 День 0 в 23:59
6 День 0 в 23:59 Полные данные о конверсиях и событиях в приложении за день 0 (исключая события S2S, которые AppsFlyer получает в период между днем 0 в 23:59 вечера и днем 1 в 2:00) День 1 в 4:00
7 День 1 в 3:00 Полные данные о конверсиях и событиях в приложении за день 0, а также все доступные на данный момент данные о доходах от рекламы, отправленные через S2S День 1 в 8:00
8 День 1 в 11:00 Полные данные о конверсиях и событиях в приложении за день 0, а также все доступные на данный момент данные о доходах от рекламы, отправленные через S2S День 1 в 18:00
9 День 1 в 17:00 Полные данные о конверсиях и событиях в приложении за день 0, а также все доступные на данный момент данные о доходах от рекламы, отправленные через S2S День 1 в 23:59
10 День 8 в 7:00 Полные данные о конверсиях и событиях в приложении за день 0, а также полные данные о доходах от рекламы, отправленные через S2S, с учетом всех потенциальных проблем, которые могли возникнуть на стороне сети доходов от рекламы День 8 в 13:00

Расширенные агрегированные отчеты (с учетом часовых поясов когорты)

Факты об отчете

Обзор

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

Скачать образец отчета

Доступные отчеты Для загрузки доступны следующие отчеты. Типы отчетов подробнее описаны в дэшборде когорты.
  • Привлечение пользователей: атрибуция медиаисточнику, включая LTV в период повторного вовлечения.
  • Ретаргетинг: приписывается медиаисточнику ретаргетинга для событий, происходящих:
    • во время окна повторного вовлечения.
    • в результате реатрибуции,
  • Унифицированный режим: данные отображаются для медиаисточника последнего касания, привлекшего пользователя, в соответствии с правилами двойной атрибуции AppsFlyer. Это значит, что суммарная прибыль, полученная от пользователей в рамках повторных вовлечений, отображается под медиаисточником ретаргетинга, а не под медиаисточником привлечения пользователей (UA). 
Отчетный период

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

Примечание: Если день еще не начался в вашем местном часовом поясе, отчеты с учетом часового пояса будут приходить без данных.

Структура отчета Схема отчета (включенные в него измерения и метрики) фиксирована и не подлежит редактированию. 
Актуальность данных
  • В течение дня. Отчеты отправляются каждые несколько часов.
  • Отчеты содержат данные за этот день. То есть 18 апреля каждая версия отчета содержит все актуальные данные на 18 апреля. Узнать больше
Часовой пояс Любой часовой пояс, кроме UTC. Это означает, что в отчетах отсутствуют данные по всем приложениям с настройками часового пояса UTC в AppsFlyer.
Структура каталога и названий файлов Подробнее
Влияние политики партнеров по хранению данных

Учтите, что некоторые партнеры проводят политику хранения данных. В этом случае события, произошедшие после окончания периода хранения, не учитываются в отчетах когорты.

Пример: SRN «A» придерживается политики хранения данных в течение 180 дней. События пользователей до 180 дня атрибутируются сети SRN «A». События, происходящие после 180 дней, не учитываются.

Примечание: События отображаются на обзорном дэшборде как органические.

Структура отчета

Отчет состоит из показателей и метрик.

Формат полей следующий:

  • Измерения: Строка. Максимальная длина строки является динамической и в большинстве случаев зависит от того, как вы заполняете элементы рекламной иерархии.
  • Показатели: Число. Примечание: Формат поля selected_currency — это строка.
    Доступны такие метрики, как доход, уникальные пользователи, совершившие событие, и частота события. Для расчета метрик, связанных с затратами, таких как ROI и ROAS, вам нужны метрики дохода и затрат. Метрики дохода находятся в когорте, а метрики затрат предоставляются через ROI360 Cost ETL.

Измерения

Название поля  Описание
app_id  
media_source  
conversion_type Возможные значения: install, install_unified (отображают установки в объединенном отчете), re-engagement, re-attribution.
attributed_touch_type Возможные значения: click, impressions, pre-install, unknown, tv, null
days_post_attribution
  • Количество дней, прошедших с даты конверсии (не конкретная временная метка конверсии).
  • Совет! Используйте для расчета дней удержания и KPI.
event_date  
  • Дата выполнения пользователем данного события.
  • Формат: гггг-мм-дд
  • Пример: Дата выполнения пользователем данного события в приложении. В случае конверсии.
  • Примечание! Если event_name равно af_conversion, то дата события и дата конверсии будут совпадать. 
conversion_date
  • Дата, когда произошла конверсия
  • Формат: гггг-мм-дд
  • Пример: Дата установки
event_name Обозначает событие. Некоторые названия событий имеют определенное значение, другие относятся к внутренним событиям, заданным рекламодателем в приложении. 
event_name Что сделал пользователь
af_conversion Пользователь совершил конверсию. Используйте conversion_type, чтобы указать тип: install, re-engagement или re-attribution.
af_session Открыл приложение
cohort_uninstalls Удалили приложение 
Рекламодатель определил внутреннее событие приложения Реализовал внутреннее событие в приложении
event_timezone Часовой пояс для:
  • days_post_atribution
  • event_date
  • conversion_date
campaign

Иерархия кампаний

Примите к сведению: Изменение названия кампании не поддерживается. Следовательно, с одним идентификатором кампании может быть связано несколько названий. 

campaign_id Иерархия кампаний
adset Иерархия кампаний
adset_id Иерархия кампаний
ad Иерархия кампаний
ad_id Иерархия кампаний
channel

Иерархия кампаний.

[Обновлено 27 октября 2021 г.] В настоящее время Meta ads не отображает канал в данных, предоставляемых через механизм Google Install Referrer.

site_id Иерархия кампаний
is_primary_attribution Используется для обозначения и удаления дубликатов данных ретаргетинга
geo Код страны по ISO, полученный из IP-адреса пользователя.
agency
  • Поддержка прозрачности агентств.
  • В случае непрозрачных агентств может возникать несколько строк с одинаковым названием кампании, если рекламодатель и агентство одновременно запускают кампании с одним названием. Не беспокойтесь. Строки не дублируются.
install_app_store Только приложения для Android: Магазин Android, из которого было загружено приложение. Заполняется рекламодателями, внедряющими атрибуцию Android для нескольких магазинов. Если пусто, это означает Google Play Store. 
keywords Слово или слова, появляющиеся в поисковых запросах пользователя. В соответствии с отчетами рекламной сети.
keyword_id Идентификатор ключевого слова, возвращенный рекламной сетью.

Метрики

Имя поля Описание Формат
unique_users Количество уникальных пользователей, выполнивших событие Число
revenue_usd
  • Сумма дохода в выбранной валюте. Например, если выбранная валюта — EUR, то 1234,56 евро отражается как 1234.56
  • Максимум 2 знака после запятой.
Число
event_count Сколько раз произошло событие. Число
selected_currency 3-буквенный код валюты (USD, EUR), установленный вами в настройках приложения. Формат ISO-4217. Это та же валюта, которая используется для отображения выручки в "Когортах" в пользовательском интерфейсе.  Строка
revenue_selected_currency
  • Сумма выручки в долларах США. Например, если выбранная валюта — EUR, то 1234,56 евро отражается как 1234.56
  • Максимум 2 знака после запятой
Число
first_inapp
  • Количество пользователей, впервые реализовавших событие после конверсии.
  • Суммируя метрики first_inapp, вы получаете общее количество уникальных пользователей для данного события.
Число

Структура каталога и имен файлов

Путь к отчету состоит из следующей иерархии папок:

В следующем формате: <bucket-name>/t=cohort_unified_timezone_versioned/dt=<yyyy-mm-dd>/version=<unix timestamp>/<parquet file number>

Иерархия папок с отчетами

Пример иерархии папок отчетов когорты с версиями по часовым поясам в корзине рекламодателя:

bucket
|
└── t=cohort_unified_timezone_versioned
    |
    ├── dt=2024-05-05
    |   |
    |   └── version=1714890235
    |   |    |
    |   |    ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   |    |
    |   |    ├── part-00001-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   |    │
    |   |    └── part-00002-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   |
    |   |
    |   └── version=1714890286
    |        |
    |        ├── part-00000-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |        |
    |        ├── part-00001-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |        │
    |        └── part-00002-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |   |
    .   . 
    .   . 

Условные обозначения:

  • dt: Дата, когда произошли события, включенные в отчет.
  • t: тип отчета.
  • version: Временная метка Unix, когда была создана версия.

Версии отчетов и актуальность данных

  • В течение дня. Отчеты отправляются каждые несколько часов.
  • Отчеты содержат все данные, доступные на данный момент за день. То есть 18 апреля каждая версия отчета содержит все доступные на этот момент данные за 18 апреля.
  • Варианты использования отчетов могут отличаться в зависимости от географии и часового пояса. Узнать больше
  • Загружайте только последнюю доступную версию отчета.
Версия Отчет включает данные, которые AppsFlyer получил к (время в UTC) Пример использования Время доступности отчета (время в UTC)
1 День -1 в 4:00 Восточные регионы — частичные данные за день 0 День -1 в 8:00
2 День -1 в 8:00 Восточные регионы — частичные данные за день 0 День -1 в 13:00
3 День -1 в 12:00 Восточные регионы — частичные данные за день 0 День -1 в 18:00
4 День -1 в 16:00 Восточные регионы — частичные данные за день 0 День -1 в 21:00
5 День -1 в 20:00 Восточные регионы — частичные данные за день 0 День -1 в 23:59
6 День -1 в 23:59 Восточные и центральные регионы — частичные данные за день 0 День 0 в 4 утра
7 День 0 в 4 утра Все регионы — частичные данные за день 0 День 0 в 8:00
8 День 0 в 8:00 Все регионы — частичные данные за день 0 День 0 в 13:00
9 День 0 в 12:00 Все регионы — частичные данные за день 0 День 0 в 18:00
10 День 0 в 16:00 Все регионы — частичные данные за день 0 День 0 в 21:00
11 День 0 в 20:00
  • Восточные регионы — полные данные о конверсиях и событиях в приложении за день 0
  • Центральные и западные регионы — частичные данные за день 0
День 0 в 23:59
12 День 0 в 23:59 Центральные и западные регионы — частичные данные за день 0 День 1 в 4:00
13 День 1 в 4:00
  • Центральные регионы — полные данные о конверсиях и событиях в приложении за день 0
  • Западные регионы — частичные данные за день 0
  • Все имеющиеся на данный момент данные о доходах от рекламы, отправленные через S2S
День 1 в 8:00
14 День 1 в 8:00 Западные регионы — частичные данные за день 0, а также все доступные на данный момент данные о доходах от рекламы, отправленные через S2S День 1 в 13:00
15 День 1 в 12:00 Западные регионы – частичные данные за день 0, а также все доступные на данный момент данные о доходах от рекламы, отправленные через S2S в момент обработки отчета День 1 в 18:00
16 День 1 в 12:00 Западные регионы — частичные данные за день 0, а также обновлённые данные о доходах от рекламы, отправленные через S2S (отчет обрабатывается только после завершения обработки данных о доходах от рекламы) День 1 в 18:00
17 День 1 в 16:00 Западные регионы — частичные данные за день 0, а также все доступные на данный момент данные о доходах от рекламы, отправленные через S2S День 1 в 21:00
18 День 1 в 18:00 Западные регионы — частичные данные за день 0, а также все доступные на данный момент данные о доходах от рекламы, отправленные через S2S День 1 в 23:59
19 День 1 в 20:00 Западные регионы — полные данные о конверсиях, событиях в приложении за день 0 и полные данные о доходах от рекламы, отправленные через S2S День 1 в 23:59
20 День 1 в 23:59 Полные данные о конверсиях и событиях в приложении за день 0, а также полные данные о доходах от рекламы, отправленные через S2S, с учетом всех потенциальных проблем, которые могли возникнуть на стороне сети доходов от рекламы День 2 в 4:00
21 День 8 в 00:00 Полные данные о конверсиях и событиях в приложении за день 0, а также полные данные о доходах от рекламы, отправленные через S2S, с учетом всех потенциальных проблем, которые могли возникнуть на стороне сети доходов от рекламы День 8 в 6:00

Дополнительные сведения

Регионы часовых поясов

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

Регион Часовой пояс
Восточный UTC+12 - UTC+3
Центральный UTC+2,5 - UTC-3
Западный UTC-3,5 - UTC-12

Информация для разработчика бизнес-аналитики

Объем данных в отчете

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

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

  • Для объединенного используйте поле is_primary_attribution=true или null.
  • Для привлечения пользователей используйте conversion_type=Install.
  • Для ретаргетинга используйте conversion_type=re-engagement или re-attribution.

Если вы просто используете объединенный обзор в процессе загрузки данных, вы можете использовать логику разделения данных по типам кампаний, то есть атрибуции пользователей (установки) и ретаргетинг (повторные вовлечения). Для этого используйте conversion_type=install, install_unified, re-engagement или re-attribution. См. Двойная атрибуция событий ретаргетинга. 

Соображения на уровне поля

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

Общая информация

Данные всех приложений настраиваются; они могут быть представлены в одном файле или в отдельных файлах для каждого приложения.

Примеры использования

Ниже приведены примеры некоторых популярных примеров использования данных, которые разработчики BI могут извлекать с помощью Data Locker. Каждый пример сопровождается SQL-запросом и наглядным примером в Excel. 

1. Расчет удержания

В следующем примере мы:

  • Подсчитаем показатели удержания в день 1 и день 7, а также общее количество установок по каждой кампании и объявлению.
  • Рассчитаем количество событий на каждое событие конверсии, отфильтровав event_name, чтобы получить af_conversion.
  • Отдельно проанализируем кампании по привлечению пользователей в объединенном отчете, отфильтровав данные следующим образом: conversion_type IN (install, install_unified).

SQL-запрос

select
    campaign_id, ad_id,
    sum(if(event_name = 'af_conversion', event_count,0)) as installs,
    sum(if(event_name = 'af_session' and days_post_attribution = 1, unique_users,0)) / sum(if(event_name = 'af_conversion', event_count,0)) as retention_day1,
    sum(if(event_name = 'af_session' and days_post_attribution = 7, unique_users,0)) / sum(if(event_name = 'af_conversion', event_count,0)) as retention_day7
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08' 
    and app_id = YOUR_APP
group by 1,2

Пример в Excel

Идентификатор кампании идентификатор рекламы Установки День удержания 1 День удержания 7
12345678 987654 100 30% 10%
98765432 123456 200 25% 15%
07315466 613770 300 20% 12 %

2. Расчет ARPU нескольких внутренних событий в приложении

В следующем примере мы:

  • Рассчитаем ARPU для нескольких событий в приложении для одной кампании.
  • Отдельно проанализируем ретаргетинговые кампании, отфильтровав данные следующим образом: conversion_type=re-engagement и conversion_type=re-attribution.
  • Рассчитаем количество событий на каждое событие конверсии, отфильтровав event_name, чтобы получить af_conversion.
  • Вычислим общую выручку от нескольких событий, в данном случае af_purchase и af_coins.
  • Установим для days_post_attribution минимально необходимое значение (в данном случае 7), чтобы минимизировать нагрузку по обработке данных.

SQL-запрос

select
    campaign_id,
    sum(if(days_post_attribution <= 1 and event_name in ('af_purchase', 'af_coins') , revenue_usd, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day1,
    sum(if(days_post_attribution <= 3 and event_name in ('af_purchase', 'af_coins') , revenue_usd, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day3,
    sum(if(days_post_attribution <= 7 and event_name in ('af_purchase', 'af_coins') , revenue_usd, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day7
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    and days_post_attribution <= 7
    and conversion_type in ('re-engagement', 're-attribution')
    and app_id = YOUR_APP
group by 1

Пример в Excel

Идентификатор кампании Тип конверсии

ARPU

День 1

ARPU

День 3

ARPU

День 7

12345678 re-engagement 6.23 5.11 2.34
98765432 re-engagement 3.57 1.34 4.86
07315466 re-attribution 7.41 6.79 5.29

3. Расчет коэффициента конверсии внутренних событий приложения для конкретного дня когорты

В следующем примере мы:

  • Рассчитаем коэффициент конверсии событий в приложении в день 0 для нескольких показателей (в данном случае дата конверсии, регион, кампания, объявление и идентификатор сайта).
  • Проанализируем объединенные данные (как UA, так и ретаргетинговые кампании), фильтруя их следующим образом: is_primary_attribution=true.
  • Рассчитаем количество событий на каждое событие конверсии, отфильтровав event_name, чтобы получить af_conversion.
  • Установим для days_post_attribution минимально необходимое значение (в данном случае 7), чтобы минимизировать нагрузку по обработке данных.

SQL-запрос

select
    conversion_date, geo, campaign_id, ad_id, site_id,
    sum(if(days_post_attribution = 0 and event_name = 'af_complete_tutorial', unique_users, 0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as day0_af_tutorial_conversion
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    and is_primary_attribution = true
    and app_id = YOUR_APP
group by 1,2,3,4,5

Пример в Excel

Дата конверсии Гео Идентификатор кампании Идентификатор рекламы Идентификатор сайта День 0 af_complete_tutorial
2022-11-07 США 12345678 123456 site_123 45%
2022-11-05 Великобритания 98765432 Null site_654 70%
2022-10-31 KR 07315466 Null Null 63%

4. Расчет ежедневных установок 

В следующем примере мы:

  • Подсчитаем количество установок по идентификатору приложения, дате конверсии, медиаисточнику, названию события и типу конверсии.
  • Отфильтруем данные в объединенном отчете так, чтобы отобразить установки UA (не ретаргетинг), установив для conversion_type значение install или install_unified.
  • Подсчитаем сумму установок, установив event_name на af_conversion.

SQL-запрос

select
    app_id,
    conversion_date,
    media_source,
    event_name,
    conversion_type,
    sum(events_count) as total
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-06-01' and '2023-06-08'
    // Если вы запрашиваете данные из унифицированных отчетов, измените строку ниже на: and conversion_type IN ('установка', 'install_unified')
    and conversion_type = 'установка'
    and event_name = 'af_conversion'
    and app_id = YOUR_APP
group by 1,2,3,4,5

Пример в Excel

Идентификатор приложения Дата конверсии Медиаисточник Имя события Всего
id123456789 2022-11-07 adnet1_int af_conversion 105
id123456789 2022-11-05 adnet2_int af_conversion 216
id123456789 2022-10-31 adnet3_int af_conversion 327

5. Расчет дохода от рекламы в Facebook 

В следующем примере мы:

  • Рассчитаем доход за третий день от Facebook по дате конверсии и идентификатору приложения.
  • Проанализируем данные Facebook, отфильтровав их следующим образом: media_source='Facebook Ads'.
  • Установим для days_post_attribution минимально необходимое значение (в данном случае 3), чтобы минимизировать нагрузку по обработке данных.

SQL-запрос

select
    conversion_date,
    app_id,
    media_source,
    sum(if(days_post_attribution <= 3, revenue_usd, 0)) as revenue_day3
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2022-06-01' and '2023-05-31'
    and days_post_attribution <= 3
    and media_source = 'Facebook Ads'
    and app_id in (APP_ID1, APP_ID2, ...)

group by 1,2,3

Пример в Excel

Дата конверсии Идентификатор приложения Медиаисточник

Доход

День 3

2022-11-07 id123456789 adnet1_int 400.45
2022-11-05 id123456789 adnet2_int 99.23
2022-10-31 id123456789 adnet3_int 13.34

6. Расчет ARPU для идентификатора ключевого слова ASA для когортных дней до 365 

В следующем примере мы:

  • Рассчитаем ARPU от Apple Search Ads на один идентификатор ключевого слова до 365-го дня когорты.
  • Проанализируем данные Apple Search Ads, отфильтровав их следующим образом: media_source='Apple Search Ads'.
  • Рассчитаем количество событий на каждое событие конверсии, отфильтровав event_name, чтобы получить af_conversion.

SQL-запрос

select
    media_source,
    keyword_id,
    sum(if(days_post_attribution <= 365, revenue_usd,0)) / sum(if(event_name = 'af_conversion', event_count, 0)) as ARPU_day365
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2022-06-01' and '2023-05-31'
    and media_source = 'Apple Search Ads'
    and app_id = YOUR_APP
group by 1

Пример в Excel

Медиаисточник ID ключевого слова

ARPU

День 365

adnet1_int 123456 57,019.93
adnet2_int 987654 64,867.84
adnet3_int 666854 48,160.02

7. Расчет ARPU за 7 дней по времени атрибуции для каждого региона 

Следующий пример демонстрирует, как использовать KPI по времени атрибуции. В этом примере мы:

  • Рассчитаем ARPU (средний доход на пользователя) за 7 дней по дате атрибуции для каждого региона.
  • Отсортируем результаты по количеству конверсий, с отображением 20 лучших регионов.
  • Отфильтруем данные таким образом, чтобы conversion_type='install'.
  • В первом столбце укажем регион. Во втором столбце: общее количество конверсий. В последующих столбцах: доход за 7 дней для каждого дня, указанного в качестве строки в запросе.

SQL-запрос

select
    geo,
    sum(if(event_name = 'af_conversion', event_count, 0)) total_conversions,
    sum(if(cohort_day = '2023-07-11' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-11' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_11,
    sum(if(cohort_day = '2023-07-12' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-12' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_12,
    sum(if(cohort_day = '2023-07-13' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-13' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_13,
    sum(if(cohort_day = '2023-07-14' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-14' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_14,
    sum(if(cohort_day = '2023-07-15' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-15' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_15,
    sum(if(cohort_day = '2023-07-16' and days_post_attribution <= 7, revenue_usd, 0)) / sum(if(cohort_day = '2023-07-16' and event_name = 'af_conversion', event_count, 0)) as ARPU_day7_2023_07_16
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-07-11' and '2023-07-16'
    and days_post_attribution <= 7
    // Если вы запрашиваете данные из унифицированных отчетов, измените строку ниже на: and conversion_type IN ('установка', 'install_unified')    
    and conversion_type = 'установка'
    and app_id = 'YOUR_APP'
group by 1
order by 2 desc
limit 20

Пример в Excel

Гео Всего конверсий ARPU: День 7 для 11.07.2023 ARPU: День 7 для 12.07.2023 ARPU: День 7 для 13.07.2023 ARPU: День 7 для 14.07.2023 ARPU: День 7 для 15.07.2023 ARPU: День 7 для 16.07.2023
Южная Корея 120,660 7798,89$ 6997,37$ 8258,95$ 9050,21$ 10018,04$ 13765,73$
Канада 35099 64867,84$ 7050,19$ 5656,33$ 9553,75$ 8632,41$ 11308,06$
Чили 26750 48160,02$ 21249,55$ 22584,57$ 24033,07$ 31118,91$ 41145,22$

8. Расчет покупок на 7 день после конверсии 

В следующем примере мы:

  • Рассчитаем общее количество уникальных пользователей, совершивших событие af_purchase через 7 дней после конверсии (в объединенном представлении).
  • Рассчитаем коэффициент конверсии для события, то есть долю конверсий, совершивших покупку в течение 7 дней после конверсии.
  • Отфильтруем данные таким образом, чтобы conversion_type='install'.
  • Сгруппируем данные по приложениям, дате конверсии,медиаисточникам, кампаниям и рекламным сетям.

Оператор SQL

select
    app_id, conversion_date, media_source, campaign, adset,
    sum(if(event_name = 'af_conversion', event_count,0)) as unified_conversions,
    sum(if(event_name = 'af_purchase', first_inapp, 0)) as af_purchase_day_7_cumulative_unique_users,
    concat(
        cast(
            round(
                sum(if(event_name = 'af_purchase', first_inapp, 0)) /
                sum(if(event_name = 'af_conversion', event_count, 0)) * 100.0
            ,2)
        as varchar),
    '%') as af_purchase_day_7_cumulative_unique_users_conversion_rate
from YOUR_DATA_LOCKER_REPORT
where
    conversion_date between '2023-12-01' and '2023-12-31'
    and is_primary_attribution = true
    and days_post_attribution <= 7
    and app_id in (APP_ID1, APP_ID2, ...)

группировать по 1,2,3,4,5

Пример в Excel

Идентификатор приложения Дата конверсии Медиаисточник Кампания Группа объявлений Унифицированные конверсии Д7 af_purchase кумулятивно Д7 af_purchase коэффициент конверсий
id123456789 05.03.2024 adnet1_int campaign_1 adset_1 100 20 20%
id123456789 07.03.2024 adnet2_int campaign_2 adset_2 200 10 5%
id123456789 31.03.2024 adnet3_int campaign_3 adset_3 150 15 10%

9. Расчет DAU

В следующем примере мы:

  • Рассчитаем DAU для каждого дня в выбранном диапазоне времени, с группировкой по медиаисточнику, кампании и рекламе.
  • Отфильтруем данные таким образом, чтобы event_name = 'af_session'.
  • Подсчитаем сумму уникальных пользователей за 1 день, где каждая дата является отдельным измерением (столбцом).

Примечание:

  • Нельзя суммировать несколько дней (например, чтобы получить WAU или MAU). 
  • DAU основан на активности пользователей, которые конвертировались за последние 1095 дней. Это отличается от данных, которые могут быть видны на дэшборде активности и в отчетах, где нет этого ограничения. Смотрите «Дни после конверсии» в разделе характеристики и ограничения.

SQL-запрос

select
media_source,campaign_id, ad_id,
sum(case when event_date = '2024-08-06' then unique_users end) as dau_2024_08_06,
sum(case when event_date = '2024-08-07' then unique_users end) as dau_2024_08_07,
sum(case when event_date = '2024-08-08' then unique_users end) as dau_2024_08_08
from YOUR_DATA_LOCKER_REPORT
where event_date between '2024-08-06' and '2024-08-08'
and event_name = 'af_session'
and app_id = YOUR_APP
group by 1,2,3 

Пример в Excel

Медиаисточник Кампания Реклама DAU за 6 августа DAU за 7 августа DAU за 8 августа
adnet1_int campaign_1 adset_1 475 250 420 485 463 912
adnet2_int campaign_2 adset_2 380 987 355 665 401 232
adnet3_int campaign_3 adset_3 290 042 570 322 489 787

Характеристики и ограничения

Специфика  
Данные о затратах
Изменения в названиях кампаний Не поддерживается. Используйте ID кампании для группировки и фильтрации, если названия кампаний были изменены.
Актуальность данных В течение дня
Доход от рекламы Доступно
Валюта  Для каждой строки доступны доллары США и валюта конкретного приложения
Часовой пояс Часовой пояс для конкретного приложения доступен в отчете с версией по часовым поясам.
Органические данные Доступно
Доступны данные о днях после конверсии (установка, реатрибуция, повторное вовлечение) Доступно 1095 дней.
Прозрачность агентства
  • Поддерживается 
  • Данные X Ads и Meta ads всегда прозрачны
Разделение приложений Поддерживается
Данные SKAN Не включены. То есть данные предоставляются в постбэках iOS, а не через отчеты Data Locker.
Данные по удалениям Удаления приложений обрабатываются ежедневно. Таким образом, они появляются только в отчетах, содержащих полные данные за день (не частичные данные).
Повторные установки
  • Если события после переустановки считаются неатрибутированными органическими:
    • Они включены только с 26 мая 2024 года. Узнать больше
    • Время установки определяется на основе поля device_download_time.
    • Они не учитываются в подсчетах уникальных пользователей и показателях удержания.
  • Если события после переустановки отнесены к первой установке, они всегда учитываются. Узнать больше