Агрегированный отчет об эффективности кампаний для рекламных сетей

Краткий обзор. Рекламные сети загружают агрегированный отчет об эффективности (он же Когортный отчет) в свои системы бизнес-аналитики для расчета показателей эффективности кампаний, таких как удержание пользователей на 7-й день. 

Агрегированный отчет об эффективности кампаний 

Этот отчет содержит данные об эффективности кампаний, включая количество уникальных пользователей, совершивших те или иные события. Вы (рекламная сеть) используете эти данные в своих системах бизнес-аналитики для расчета показателей эффективности кампаний в контексте KPI рекламодателя. Отчет доступен ежедневно через Data Locker для партнеров 

Зачем нужен этот отчет?

До выхода iOS 14.5 постбэки, отправляемые вам AppsFlyer, содержали достаточно данных для расчета метрик событий по уникальным пользователям. 

После выхода iOS 14.5 и внедрения рекламодателями агрегированной атрибуции, основанной на дифференцированной конфиденциальности (AAP), постбэки по пользователям, не давшим согласия, не содержат идентификаторов пользователей. Без идентификаторов нельзя рассчитать метрики событий по уникальным пользователям, например, удержание клиентов на 7-й день. Отсутствие метрик по уникальным пользователям ограничивает возможности оптимизации кампаний и определения общих с рекламодателями целей по удержанию пользователей. 

Какие данные есть в отчете?

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

    • Прибыль
    • Сколько раз выполнялось данное событие
    • Кол-во уникальных пользователей, совершивших событие
    • Пример отчета

Как получить отчет?

Об отчете

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

Аспекты

Имя поля 

Примечания

app_id

 

media_source

 

conversion_type

  • Возможные значения: install (установка), re-engagement (повторное вовлечение), re-attribution (реатрибуция)
  • Эквивалентный макрос для постбэка: is_retargeting

attributed_touch_type

Возможные значения: click (клик), impressions (показы), pre-install (предварительная установка), unknown (неизвестно), tv (ТВ), null (пустое)

days_post_attribution

Количество дней с момента события атрибуции. 

Совет! Используйте для расчета дней удержания и KPI. 

event_date 

Дата события.

Формат: гггг-мм-дд

conversion_date

Формат: гггг-мм-дд

event_name

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

event_name

Что сделал пользователь

af_conversion Пользователь совершил конверсию. Используйте conversion_type, чтобы указать ее тип: install (установка), re-engagement (повторное вовлечение) или re-attribution (реатрибуция).
af_sessions Открыл приложение
af_uninstall Удалили приложение 
Рекламодатель определил внутреннее событие приложения Выполнил внутреннее событие в приложении. Имена внутренних событий приложения не сопоставлены с именами событий партнера.

campaign

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

campaign_id

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

adset

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

adset_id

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

реклама

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

ad_id

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

channel

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

site_id

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

is_primary_attribution

Используется для обозначения и дедупликации данных ретаргетинга

country_code

Определяется на основе IP-адреса пользователя

agency

Если пустое — нет связанного агентства

Ключевые слова

[Доступно с 27 апреля 2022 г.] Слова, появляющиеся в поисковых запросах пользователя. Их сообщает рекламная сеть

ID ключевого слова

[Доступно с 27 апреля 2022 г.] Идентификатор ключевого слова, возвращенный рекламной сетью.

Метрики

Имя

Поле

Уникальные пользователи, выполнившие событие

Уникальные пользователи

unique_users

Количество уникальных пользователей, выполнивших событие

Прибыль

revenue_usd

Совокупный доход в долларах США. Например, 100,00 долл. США отражается как 100. 

event_count

event_count

Сколько раз произошло событие

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

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

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

В процессе потребления данных необходимо реализовать логику разделения данных по типам кампаний. То есть на атрибуцию пользователей (установки) и ретаргетинг (повторные вовлечения). Для этого используйте поля conversion_type и is_primary_attribution. Подробнее о двойной атрибуции событий ретаргетинга. 

Примечания по полям

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

Общие примечания

  • Обновление данных: ежедневно в 08:00 UTC. Данные записываются в папку h=23 в Data Locker.
  • Доступные данные — это данные атрибуции пути пользователя, атрибутируемые AppsFlyer. Это значит, что данные SKAdNetwork, передаваемые в постбэках iOS, в этот набор данных не входят.
  • Данные содержатся в файлах по нескольким приложениям. Идентифицировать приложения можно по полю app_id.
  • Если вы не получили данные по определенному приложению, убедитесь, что рекламодатель предоставил вам необходимые разрешения.

Примечания по отчетам об удержании пользователей

Чтобы создать метрики удержания пользователей, например, удержание пользователей на 7-й день, настройте фильтры по следующим полям:

  • days_post_install=7
  • event_name=af_session
  • conversion_type, если требуется
  • Чтобы исключить дублирующиеся события ретаргетинга, выберите is_primary_attribution=true или используйте conversion_type, чтобы ограничить набор данных установками (installs). 
  • Сгруппировать по: кампания и другие показатели.
  • Сумма: unique_users_count

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

Разрешения

Вы (рекламная сеть) должны попросить рекламодателя предоставить вам перечисленные здесь разрешения. Рекламодатель должен выполнить эту процедуру один раз для каждого приложения. 

Разрешение получать агрегированные данные об эффективности

Рекламные сети, назначенные (активированные) агентствами: агентство не может предоставить разрешение. Агентство должно попросить рекламодателя предоставить им разрешение. 

Чтобы разрешить рекламной сети получать агрегированные данные об эффективности:

  1. Перейдите в раздел Configuration (Настройка) > Integrated partners (Интегрированные партнеры). 
  2. Выберите интегрированного партнера. 
  3. Перейдите на вкладку Интеграция.
  4. Поверьте, что переключатель Activate Partner (Активировать партнера) включен. Если нет, данные не передаются.
  5. Перейдите на вкладку Permissions (Разрешения).
  6. Активируйте следующие разрешения:
    • Доступ к агрегированным данным о конверсиях.
    • Доступ к агрегированным данным по внутренним событиям приложения.
    • Доступ к агрегированным данным о доходах.
  7. Нажмите Save Settings (Сохранить настройки). 
  8. Сообщите рекламной сети, что разрешения предоставлены.
  9. Если у вас несколько приложений, повторите процедуру по каждому приложению, для которого настроена интеграция с партнером.