Руководство по ROI360 – Атрибуция доходов от рекламы

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

Примечание: Для реализации типов интеграции SDK требуется помощь разработчика. Типы интеграции S2S требуют наличия правильных учётных данных сети.

Прежде чем начать:

• Попросите интегрированного партнера предоставить вам учетные данные API.

Чтобы включить интеграцию рекламного дохода с сетью доходов от рекламы:

1. В AppsFlyer в боковом меню выберите Настройки > Настройки дохода> Доход от рекламы.
2. В интеграции дохода от рекламы нажмите Новая интеграция доходов от рекламы.
3. Выберите партнера по доходам от рекламы и нажмите кнопку Далее.
   
4. Выберите необходимый тип данных о доходах от рекламы. Примечание: Не все рекламные сети предоставляют весь набор указанных ниже опций.
   • Атрибутированный доход. Имеется в виду доход по источнику привлечения пользователей. Отчеты об атрибутированному доходу бывают двух видов:
     • Агрегированные отчеты через S2S API.
       • Выберите событие, по которому считается доход от рекламы. Например, если выбрать событие af_app_opened, общий доход от рекламы делится между всеми событиями app-opened, в результате чего вы получите доход от рекламы на одно открытие приложения.
     • На уровне устройства через API S2S.
       • Для Android: Убедитесь, что разработчики включили сбор данных app_set_id, потому что некоторые посредники могут предоставлять только этот идентификатор. См. инструкции для разработчиков для Сбора AppSet ID.
       • Примечание: Если вы включаете API доходов от рекламы на уровне устройства для платформы-посредника, вы должны отключить интеграцию доходов от рекламы для тех сетей монетизации, посредником которых она является. Невыполнение этого требования приводит к дублированию данных.
     • На уровне показов через SDK.
       • Попросите своих разработчиков интегрировать API SDK AppsFlyer для измерения доходов от рекламы.
     • Рекомендовано: На уровне показов (через SDK) с уровнем устройств (через S2S API).
       • Попросите своих разработчиков интегрировать API SDK AppsFlyer для измерения доходов от рекламы.
     • Для Android: Убедитесь, что разработчики включили сбор данных app_set_id, потому что некоторые посредники могут предоставлять только этот идентификатор. См. инструкции для разработчиков для Сбора AppSet ID.
     • Примечание: При использовании платформы-посредника, прежде чем включить интеграцию с платформой-посредником для передачи данных о доходе от рекламы, обязательно отключите интеграции доходов от рекламы для партнеров по монетизации, которые поддерживаются через платформу-посредник. Невыполнение этого требования приводит к дублированию данных.
5. Заполните учетные данные API или войдите в аккаунт в соответствии с требованиями интегрированного партнера. Это не относится к интеграции SDK.
6. Нажмите Сохранить.
7. Если отображается кнопка Test Connection (Тестировать подключение), как показано на рисунке выше, нажмите Test Connection.
   • Если отобразится сообщение API key verified (Ключ API подтвержден), это значит, что вы успешно выполнили процедуру.
   • Если отобразится любое другое сообщение, см. раздел Статус и тестирование API для доходов от рекламы и повторите процедуру.
8. Если кнопка «Тестовое подключение» (Test Connection) отсутствует, процедура завершена.
   AppsFlyer собирает данные от партнёра несколько раз в день. Дополнительную информацию см. в разделе Свежесть данных.
9. [Необязательно] Проверьте и сравните данные о доходах от рекламы, которые вы видите в AppsFlyer, с данными о доходах от рекламы, которые вы видите на дэшбордах партнеров-посредников и партнеров по UA. Подробнее
10. [Необязательно] Обменивайтесь данными о доходах от рекламы со своими партнёрами по UA с помощью сигналов UA и постбэков по событиям доходов от рекламы.

Примечание: Если вы переходите от одного типа интеграции к другому, изменение вступает в силу в 12:00 UTC на следующий день. 

Чтобы просмотреть, изменить или удалить интеграцию с сетью доходов от рекламы:

1. В боковом меню AppsFlyer выберите Параметры > Настройки дохода > Доход от рекламы и выберите своё приложение из списка.
   Отобразится список всех интеграций партнеров, а также сведения о продукте и типе интеграции, статусе интеграции и названиях событий дохода от рекламы.
2. Наведите курсор на интеграцию и нажмите Изменить или Удалить.

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

Как помочь избежать частичного дублирования данных о доходах при наличии перекрестных ссылок между двумя посредническими платформами:

1. Если они доступны, используйте интеграцию на уровне показов через SDK.
   • Дублирования не будет, если обе посреднические платформы используют интеграцию на уровне показов через SDK.
   • Если у вас есть несколько интеграций, и одна из них – SDK, мы рекомендуем использовать SDK и для других интеграций.
2. Для интеграции через API дедуплицируйте доход от рекламы:
   1. В AppsFlyer в боковом меню выберите Настройки > Настройки дохода> Доход от рекламы.
   2. В Общих настройках поставьте галочку в Дедуплицировать доходы от рекламы при наличии перекрестных ссылок между двумя посредническими платформами. Примечание: Не устанавливайте флажок, если две посреднические платформы:
      • Обеспечивают посредничество для разных форматов объявлений Например, если платформа 1 показывает баннеры и рекламные вставки, а платформа 2 – AppOpen и нативную рекламу.
      • Используют интеграцию на уровне показов через SDK.

Агрегированная детализация для доходов от рекламы работает следующим образом:

• Интегрированная сеть сообщает общий доход за день с разбивкой по географическому положению.
• AppsFlyer рассчитывает эффективный доход за действие (eRPA) путем деления общего дохода от рекламы на количество срабатываний события.
• AppsFlyer создает событие _monetized, которое включает общий eRPA для каждого атрибутированного устройства. Например, ad_matched_monetized.
• По eRPA доход атрибутируется медиа-источнику.
• Вы можете использовать один из следующих типов событий:
  • Уникальное внутреннее событие монетизации (потребуется внести изменения в приложение).
  • Событие af_app_opened, доступное по умолчанию.
• Не передавайте данные о доходе от рекламы во внутренних событиях параллельно с интеграцией доходов от рекламы. Это приводит к дублированию доходов от рекламы на дэшборде, поскольку AppsFlyer получает данные о доходах из сети монетизации через интеграцию. 

Агрегированный доход от рекламы на основе событий

Сравнение методов внутренних событий

• Рабочий статус интеграции доходов от рекламы доступен следующим образом:
  • Дэшборд статуса интеграции по затратам и выручке от рекламы: Централизованный список партнеров, для которых включена интеграция дохода от рекламы для одного или нескольких приложений в вашем аккаунте.
  • Некоторые партнеры позволяют протестировать подключение к API. Если такая возможность есть, отображается кнопка Test connection (Тестировать подключение)
  • Чтобы проверить работоспособность подключения к API:
  • Нажмите Тестировать подключение.
    Появится сообщение Ключ API подтверждён. Если это не так, выполните корректирующие действия, приведенные в следующей таблице. 

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

Примечание: В данных о доходах от рекламы, отображаемых на различных дэшбордах и в отчетах, возможны расхождения. Подробнее. 

Атрибуция дохода от рекламы доступна в следующем виде:

• На основе LTV:
  • Дэшборды: Обзор, события
  • Отчеты по LTV
  • Дэшборд когорт и отчеты
  • Master API.
• На основе активности:
  • Дэшборд: Активность
  • Сырые данные по доходу от рекламы

Обзорный дэшборд: агрегированный отчет об эффективности

На обзорном дэшборде:

• Значения, включая доход, являются LTV. См. Сравнение LTV и активности.
• В столбце Revenue (Доход) указывается весь доход, включая доход от рекламы и покупок в приложении.
• Перейдите на нужный уровень иерархии рекламы (медиа-источник, кампания, группа объявлений, гео) для просмотра монетизируемых событий в отчете.

Дэшборд событий

На дэшборде активности:

• Значения, включая доход, основаны на дате активности. См. Сравнение LTV и активности.
• Среднее количество действий на пользователя показывает, насколько пользователи склонны взаимодействовать с рекламой, демонстрируемой в приложении. 

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

Принципы работы с сырыми данными по доходам от рекламы

• Данные агрегируются по количеству уникальных показов на пользователя. Уникальные показы определяются по комбинации сети монетизации рекламы, рекламного блока и размещения.
• Сырые данные на уровне показов:
  • Агрегированные данные на уровне устройства, доступны в отчетах на уровне устройства.
  • Доступны в отчетах на уровне показов в Data Locker.
  • Актуальность сырых данных идентична актуальности данных о доходах от рекламы на уровне пользователя на дэшборде «Активность».

Характеристики и поля данных

Полях в отчетах о доходах от рекламы могут содержать следующее:

• Само событие дохода от рекламы и параметры, перечисленными в таблице ниже. Эти поля подразделяются на:
  • Специфичные: поля, которые относятся к доходу от рекламы. Например, показы и размещение. Важно! Состав заполняемых полей зависит от партнера по монетизации. См. таблицу «Поля по сетям».
  • Контекстные: поля, имеющие аналогичное значение в других отчетах с сырыми данными. Например, имя события, значение события, валюта.
• Результат атрибуции события медиа-источнику, который привлек пользователя. Эти поля копируются из события конверсии, привлекшего пользователя. Например, медиа-источник и кампания. Такие поля в таблице ниже не указаны. 

Поля с данными о доходе от рекламы

Поля по сетям

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

Для интеграции по API S2S самое раннее, когда данные становятся доступными:

• Дэшборды и отчёты актуальных данных (через Data Locker), начиная с дня X+1 в 12:00 UTC, обновление примерно 4 раза в день каждые 6 часов. И в дни 2, 3, 7 и 14, раз в день.

Для интеграции SDK на уровне показов самое раннее, когда данные становятся доступными:

• Дашборды (метрики активности и когорт): Непрерывные (через 15–60 минут после события)

• Дашборды (метрики LTV) и отчёты по сырым данным (через Data Locker) в лучшем случае, начиная с Дня X с 05:00 UTC, обновляются примерно 6 раз в день, каждые 4 часа.

• Отчеты по сырым данным уровня показов (через Data Locker) — день X с 1:00 UTC, обновляются каждый час.

Для уровня показов (через SDK) с уровнем устройств (через S2S API) актуальность данных за день X с точностью данных за дни X+1 можно получить следующим образом:

• Для данных на уровне показов, поступающих через SDK:

  • Дашборды (метрики активности и когорт): Непрерывные (через 15–60 минут после события)

  • Дашборды (метрики LTV) и отчёты по сырым данным (через Data Locker) в лучшем случае, начиная с Дня X с 05:00 UTC, обновляются примерно 6 раз в день, каждые 4 часа.

  • Отчеты по сырым данным уровня показов (через Data Locker) — день X с 1:00 UTC, обновляются каждый час.

• Для данных на уровне устройств, поступающих через S2S API:

  • Дэшборды и отчёты актуальных данных (через Data Locker), начиная с дня X+1 в 12:00 UTC, обновление примерно 4 раза в день каждые 6 часов. И в дни 2, 3, 7 и 14, раз в день.

Примечание: Для получения данных в течение дня в дэшбордах требуется расширенная подписка ROI360 Advanced.

• Переход не влияет на исторические данные о доходах от рекламы. Эти данные не изменятся.
• Данные о доходах от рекламы извлекаются один раз в день в 14:00 UTC согласно выбранным на тот момент параметрам детализации.
• Для детализации на уровне устройства не нужно определять внутренние события (в отличие от отчетности на агрегированном уровне). Вы можете продолжить отправлять эти события, но они не влияют на детализацию отчетов на уровне устройств в AppsFlyer.