How can we help?

Когортная аналитика через Data Locker

  • Обновлено

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

Когортная аналитика в Data Locker

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

Скачать пример отчёта

Включение Data Locker

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

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

 

Да 

AppsFlyerAdmin_us-en.pngЧтобы добавить когортные отчёты в Data Locker:
  1. В AppsFlyer в боковом меню выберите Отчёт > Data Locker.
  2. Выберите все отчеты в разделе Когортная аналитика
  3. Нажмите Сохранить конфигурацию. 
    Отчеты будут доступны на следующий день до 10:00 UTC. 
Нет AppsFlyerAdmin_us-en.pngЧтобы настроить Data Locker:
  1. Завершите первоначальную настройку Data Locker (рекламодатель | партнер).
  2. Добавьте когортные отчеты в Data Locker:
    1. В AppsFlyer в боковом меню выберите Отчёт > Data Locker.
    2. Выберите все отчеты в разделе Когортная аналитика
    3. Нажмите Сохранить конфигурацию. 
      Отчеты будут доступны на следующий день до 10:00 UTC.

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

Доступные метрики

Доступные показатели включают выручку, уникальных пользователей, совершивших событие, и количество событий. Для расчета метрик, связанных с затратами, таких как ROI и ROAS, вам нужны метрики выручки и затрат. Показатели доходов находятся в Cohort, а показатели затрат предоставляются ROI360 Cost ETL.

Факты о когортной аналитике

Доступные отчеты Для загрузки доступны следующие отчеты. Типы отчетов подробнее описаны в когортном дэшборде.
  • Привлечение пользователей: атрибуция медиа-источнику, включая LTV в период повторного вовлечения.
  • Ретаргетинг: приписывается медиа-источнику ретаргетинга для событий, происходящих:
    • во время окна повторного вовлечения.
    • в результате реатрибуции,
  • Унифицировано: отображает данные медиа-источника последнего взаимодействия, приводящего пользователя, согласно правилам двойной атрибуции AppsFlyer. Это значит, что суммарная прибыль, полученная от пользователей в рамках повторных вовлечений, отображается под медиа-источником ретаргетинга, а не под медиа-источником привлечения пользователей (UA). 
Отчетный период Пользователи, совершившие конверсию в течение предыдущих 365 дней. Другими словами, каждый день отчеты включают в себя пользователя, совершившего конверсию за предыдущие 365 дней. 
Структура отчета Схема отчета (включенные в него показатели и метрики) фиксирована и не подлежит редактированию. См. структуру отчета.
Доставка отчетов  См. Включение когортных отчетов в Data Locker.
Обновление данных
  • Ежедневно.
  • Метрики рассчитываются на основе данных, доступных в полночь по UTC. Другими словами, в конце дня. 
  • Отчеты доступны в Data Locker в папке даты и времени (dt) до 10:00 UTC. Например, данные за понедельник доступны во вторник в 10:00 UTC в папке «Понедельник». 
Влияние политики партнеров по хранению данных

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

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

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

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

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

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

Аспекты

Имя поля  Описание
app_id (идентификатор приложения) --
медиа-источник --
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 Открыл приложение
когорта_удалений Удалили приложение 
Рекламодатель определил внутреннее событие приложения Выполнил внутреннее событие в приложении
campaign (кампания)

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

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

campaign_id (идентификатор кампании) Иерархия кампаний
рекламный набор Иерархия кампаний
adset_id (идентификатор группы объявлений) Иерархия кампаний
ad (объявление) Иерархия кампаний
ad_id (идентификатор объявления) Иерархия кампаний
канал

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

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

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

Метрики

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

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

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

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

Вы можете загружать в свои 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 кампании, и метрики будут корректными. 
  • Вы можете агрегировать данные по полям иерархии кампаний. 
  • Доход в долларах США рассчитывается по валютному курсу на день события. 
  • События дохода от рекламы включены в случае наличия, но с задержкой по времени до 3 дней.

Общие соображения

Данные всех приложений предоставляются в одном файле. Используйте поле «Идентификатор приложения» для разделения данных по приложениям или настройте разделение по приложениям в Data Locker.

Использование когорты

Ниже приведены примеры некоторых популярных практических вариантов применения когортных данных, которые разработчики 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 повторное вовлечение 6.23 5.11 2.34
98765432 повторное вовлечение 3.57 1.34 4.86
07315466 повторная атрибуция 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', 'install_unified')
    and conversion_type = 'install'
    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
group by 1,2,3
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', 'install_unified')
    and conversion_type = 'install'
    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
Южная Корея 120660 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$

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

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

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

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: