Краткий обзор. Атрибутируйте доходы от рекламы, чтобы иметь полное представление об эффективности LTV.
Атрибуция рекламного дохода
- Размещение рекламы в приложении на баннерах, панелях предложений (offer walls), рекламных вставках и т. п. приносит доход. Интегрируйте SDK сетей монетизации рекламы в приложение, чтобы получать доход от показа рекламы своим пользователям.
- Совокупность дохода от рекламы, покупок внутри приложения и дохода от подписок даст полную картину по LTV пользователя. Путем сопоставления LTV пользователя с расходами на рекламу определяется окупаемость инвестиций (ROI), значение которой доступно на платформе для дальнейшего анализа.
Данные по доходу от рекламы:
- Получены из сетей-посредников и/или сетей монетизации рекламы через серверные API или с помощью SDK отчетности, встроенного в приложение (включая iOS 14).
- Атрибутируются медиа-источнику, который изначально привлек пользователя.
- Детализация отчетности зависит от типа интеграции сети монетизации:
- Агрегированные данные: разбивка по странам/гео.
- Детализация на уровне пользователя: позволяет дойти в иерархии рекламы до уровня устройства. Для дальнейшего анализа ценности пользователей можно использовать отчеты с сырыми данными по доходу от рекламы.
Детализация до уровня пользователя и агрегированные данные
Атрибуция доходов от рекламы поддерживает различные методы детализации. Детализация зависит от сети монетизации.
-
Агрегированные данные
- AppsFlyer получает данные о доходе ежедневно с разбивкой по географическим регионам.
- Эффективный доход за действие (eRPA) рассчитывается путем деления общего дохода на количество срабатываний события.
- Триггерными являются событие открытия приложения или определенные внутренние события, заданные в приложении.
-
Детализация до уровня пользователя (также детализация до уровня показов) [рекомендуется]
- Сеть монетизации передает данные о доходах по пользователям на уровне показов. Не все сети монетизации поддерживают детализацию до уровня пользователя.
- Этот доход атрибутируется медиа-источнику, который привлек пользователя. Это означает, что атрибуция доходов от рекламы в AppsFlyer соответствует правилам атрибуции, установленным на платформе, в том числе правилам атрибуции ретаргетинга.
Примечание. При использовании сети-посредника, прежде чем включить интеграцию для детализации до уровня пользователя, обязательно отключите интеграции доходов от рекламы для партнеров по монетизации, которые поддерживаются через сеть-посредник. Невыполнение этого требования приводит к дублированию данных.
Атрибутированный доход и API доходов от монетизации
AppsFlyer предоставляет различные типы данных о доходе от рекламы. Примечание. Не все рекламные сети предоставляют весь набор указанных ниже опций.
Атрибутированный доход: доход от рекламы по источнику привлечения пользователей, доступен как в агрегированном виде, так и на уровне пользователя. Например:
- Пользователь видит рекламу в сети А и скачивает ваше приложение.
- В приложении отображается реклама.
- Доход от рекламы атрибутируется сети A (привлекшей пользователя), независимо от того, кто опубликовал объявление.
API доходов от монетизации: доход по источникам рекламы, а не по источникам привлечения пользователей. Например:
- Пользователь видит рекламу в сети А и скачивает ваше приложение.
- В приложении отображается реклама из сети В.
- Доход от рекламы атрибутируется сети В.
Реализация
В следующих разделах описаны доступные типы атрибуции доходов от рекламы, а также процессы и шаги, необходимые для их реализации и поддержки.
Процессы для атрибуции дохода от рекламы через API
Чтобы реализовать атрибуцию дохода от рекламы через API, следуйте одному из процессов, приведенных для разных методов детализации в следующей таблице.
Шаг | Агрегированные данные | Детализация до уровня пользователя (уровень показов) |
---|---|---|
1 | Не применимо | |
2 |
Реализуйте в приложении:
|
Реализуйте в приложении:
|
3 | Подключитесь к партнеру по монетизации рекламы в AppsFlyer |
Подключитесь к сети монетизации рекламы, предоставляющей данные на уровне пользователя: |
4 | Генерируйте и атрибутируйте доход от рекламы | Генерируйте и атрибутируйте доход от рекламы |
Агрегированная отчетность по событию открытия приложения или внутренним событиям
Реализация агрегированной отчетности
- Интегрированная сеть сообщает общий доход за день с разбивкой по географическому положению.
- AppsFlyer рассчитывает эффективный доход за действие (eRPA) путем деления общего дохода от рекламы на количество срабатываний события.
- Каждый раз при возникновении триггерного события AppsFlyer создает событие _monetized, которое включает eRPA. Например, ad_matched_monetized.
- По eRPA доход атрибутируется медиа-источнику.
- Не передавайте данные о доходе от рекламы во внутренних событиях. Это приводит к дублированию доходов от рекламы на дэшборде, поскольку AppsFlyer получает данные о доходах из сети монетизации через интеграцию.
- При использовании сети-посредника, прежде чем включить интеграцию с сетью-посредником для передачи данных о доходе от рекламы, обязательно отключите интеграции доходов от рекламы для партнеров по монетизации, которые поддерживаются через сеть-посредник. Невыполнение этого требования приводит к дублированию данных.
- Вы можете использовать один из следующих типов событий:
- Уникальное внутреннее событие монетизации (потребуется внести изменения в приложение).
- Событие af_app_opened, доступное по умолчанию.
Метод события | Как реализован | Факторы, которые необходимо учитывать |
---|---|---|
Уникальное внутреннее событие монетизации |
|
|
событие af_app_opened |
|
|
Метод | Плюсы | Минусы | Факторы, которые необходимо учитывать |
---|---|---|---|
Одно и то же событие используется для всех сетей. Например, ad_watched. При этом автоматически создается событие ad_watched_monetized со сведениями о монетизации | Самый простой с точки зрения реализации. | Нет информации о качестве рекламы, такой как количество кликов и доход от рекламы по сетям. |
|
(рекомендуется) Каждой сети назначается уникальное событие просмотра объявления. Пример: ad_watch_admob, ad_watch_vungle. |
Полная прозрачность и возможность сравнивать сети монетизации на дэшборде и в сырых данных. | Доход от рекламы не аккумулируется в рамках одного события. Количество событий равно количеству сетей. | Позволяет сравнивать сети монетизации на дэшборде. Доход от рекламы разделяется по сетям на основе заданного для каждой из них внутреннего события приложения. |
Отчетность уровня пользователя через API доходов от рекламы
Настройка детализации до уровня пользователя (уровень показов)
Это рекомендуемый метод. Он обеспечивает самый высокий уровень детализации, а для атрибуции дохода от рекламы не требуется вносить изменения в приложение. Доход от рекламы точно атрибутируется источнику UA.
Данные о доходах от рекламы на уровне пользователя: атрибуция доступна в отчетах сырых данных. Мы не отправляем постбэки с данными на уровне пользователя интегрированным партнерам.
Доход от пользователей приложения, по которым в AppsFlyer нет записей об атрибуции, считается органическим, при этом дата установки считается днем, когда зарегистрирован доход от рекламы. Это может произойти, например, после удаления данных уровня пользователя из Facebook.
Внимание
При использовании сети-посредника, прежде чем включить интеграцию с сетью-посредником для передачи данных о доходе от рекламы, обязательно отключите интеграции доходов от рекламы для партнеров по монетизации, которые поддерживаются через сеть-посредник. Невыполнение этого требования приводит к дублированию данных.
Метод | Как реализован | Факторы, которые необходимо учитывать |
---|---|---|
Получение данных уровня пользователя через API доходов от рекламы |
|
— |
Примечания о переходе с агрегированных данных на детализацию до уровня пользователя
- Переход не влияет на исторические данные о доходах от рекламы. Эти данные не изменятся.
- Данные о доходах от рекламы извлекаются один раз в день в 14:00 UTC согласно выбранным на тот момент параметрам детализации.
- Для детализации на уровне пользователя не нужно определять внутренние события (как для отчетности на агрегированном уровне). Вы можете продолжить отправлять эти события, но они не влияют на детализацию отчетов на уровне пользователя в AppsFlyer.
Подключение к интегрированным партнерам, поддерживающим передачу данных о доходе от рекламы

Прежде чем начать:
- Попросите интегрированного партнера предоставить вам учетные данные API.
Чтобы включить интеграцию рекламного дохода с сетью доходов от рекламы:
-
В AppsFlyer перейдите в раздел Configuration (Настройки) > Integrated Partners (Интегрированные партнеры).
Откроется окно «Интегрированные партнеры». -
Выберите партнера. Совет: выберите опции Active (Активный) и Ad revenue (Доход от рекламы), чтобы отобразились имеющиеся партнеры с поддержкой передачи данных о доходе от рекламы.
Откроется окно настройки интегрированного партнера. - На вкладке Ad Revenue (Доход от рекламы) включите Get Ad Revenue Data (Получать данные о доходах от рекламы).
-
Выберите необходимый тип данных о доходах от рекламы. Примечание. Не все рекламные сети предоставляют весь набор указанных ниже опций. Если у атрибутированного дохода нет опции «На уровне пользователя», значит доступны только агрегированные данные.
- Атрибутированный доход. Имеется в виду доход по источнику привлечения пользователей. Отчеты об атрибутированному доходу бывают двух видов:
- Агрегированные. Для них также требуется выбрать событие, по которому считается доход от рекламы. Например, если выбрать событие af_app_opened, общий доход от рекламы делится между всеми событиями app-opened, в результате чего вы получите доход от рекламы на открытие приложения.
- На уровне SDK
- Примечание. При использовании сети-посредника, прежде чем включить интеграцию с сетью-посредником для передачи данных о доходе от рекламы, обязательно отключите интеграции доходов от рекламы для партнеров по монетизации, которые поддерживаются через сеть-посредник. Невыполнение этого требования приводит к дублированию данных.
- API доходов от монетизации. Имеется в виду доход по источникам рекламы, а не по источникам привлечения пользователей.
- Атрибутированный доход. Имеется в виду доход по источнику привлечения пользователей. Отчеты об атрибутированному доходу бывают двух видов:
- Заполните учетные данные API или войдите в аккаунт в соответствии с требованиями интегрированного партнера. Это не относится к интеграции на уровне SDK.
- Нажмите Save ad revenue (Сохранить доходы от рекламы).
-
Если отображается кнопка Test Connection (Тестировать подключение), как показано на рисунке выше, нажмите Test Connection.
- Если отобразится сообщение API key verified (Ключ API подтвержден), это значит, что вы успешно выполнили процедуру.
- Если отобразится любое другое сообщение, см. раздел Статус и тестирование API для доходов от рекламы и повторите процедуру.
-
Если кнопка Test Connection (Тестировать подключение) отсутствует, это значит, что вы выполнили процедуру.
AppsFlyer получает данные от партнера несколько раз в день.
Статус и тестирование API доходов от рекламы
-
Рабочий статус интеграции доходов от рекламы доступен следующим образом:
- Дэшборд статуса интеграции по затратам и доходам от рекламы: централизованный список партнеров, для которых включена интеграция доходов от рекламы по одному или нескольким приложениям, размещенным в вашем аккаунте.
- Некоторые партнеры позволяют протестировать подключение к API. Если такая возможность есть, отображается кнопка Test connection (Тестировать подключение).
- Чтобы проверить работоспособность подключения к API:
- Нажмите Test Connection
(Тестировать подключение). Появится сообщение API key verified (Ключ API подтвержден). Если это не так, выполните корректирующие действия, приведенные в следующей таблице.
Статус | Значение | Нужны пояснения/действия |
---|---|---|
API-ключ верифицирован |
|
Нет |
Недействительные учетные данные. |
Предоставленные учетные данные неверны. |
Получите от интегрированного партнера корректные учетные данные. |
Не хватает данных о конфигурации | Одно или несколько полей с учетными данными не заполнены. | Получите учетные данные на дэшборде партнера, поддерживающего передачу данных по доходам от рекламы, или запросите учетные данные у самого партнера. |
Данные о доходе от рекламы
Данные о доходе от рекламы доступны на дэшбордах и в отчетах AppsFlyer.
Доход от рекламы на дэшборде
Доход от рекламы показывает качество пользователей из различных источников в динамике. По мере того, как пользователи продолжают запускать приложение и взаимодействовать с рекламой, их LTV увеличивается.
Примечание. В данных о доходах от рекламы, отображаемых на различных дэшбордах и в отчетах, возможны расхождения. Узнать больше.
Атрибуция дохода от рекламы доступна в следующем виде:
- На основе LTV:
- Дэшборды: обзорный, события
- Аналитика по когорте
- Master API
- На основе активности:
- Дэшборд: Активность
- Сырые данные по доходу от рекламы
Обзорный дэшборд: агрегированный отчет об эффективности

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

На дэшборде активности:
- Значения, включая доход, основаны на дате активности. См. Сравнение LTV и активности.
- Среднее количество действий на пользователя показывает, насколько пользователи склонны взаимодействовать с рекламой, демонстрируемой в приложении.
Примеры
Три пользователя устанавливают приложение 31 декабря 2017 года. Они атрибутируются следующим образом:
- Пользователь А: сети А
- Пользователь В: сети В
- Пользователь С: органический
Приложение интегрировано с пятью различными платформами монетизации. Каждая платформа использует уникальное внутреннее событие с помощью SDK AppsFlyer следующим образом:
- Facebook Audience Network: fb_ad_view
- Chartboost: chartboost_ad_view
- Admob: admob_ad_view
- Applovin: applovin_ad_view
- IronSource: is_ad_view
В течение четырех дней после установки пользователям будут показаны объявления следующим образом:
Пользователь |
Сеть UA |
fb_ |
chartboost_ |
admob_ |
applovin_ |
is_ad_view |
Total (Всего) |
---|---|---|---|---|---|---|---|
A |
Сеть А 31.12.2017 |
01.01.2018 $1 |
02.01.2018 $1 |
03.01.2018 $1 |
04.01.2018 $1 |
|
$4 |
B |
Сеть B 31.12.2017 |
02.01.2018 $1 |
|
04.01.2018 $1 |
|
$2 | |
C |
Органика 31.12.2017 |
01.01.2018 $1 |
02.01.2018 $1 |
$2 |
На основе этих данных можно рассчитать доход на пользователя, за день (и на внутреннее событие приложения):
Пользователь |
01.01.2018 |
02.01.2018 |
03.01.2018 |
04.01.2018 |
Общий показатель LTV |
---|---|---|---|---|---|
A |
$1 |
$1 |
$1 |
$1 |
$4 |
B | $1 | $1 | $2 | ||
C | $1 | $1 | $2 | ||
Total (Всего) | $2 | $3 | $1 | $2 | 8 $ |
Информация в отчетах:
Как упоминалось ранее, доход от рекламы привязан к показателю LTV пользователя. Поэтому период, который вы выбираете на дэшборде соответствует когорте с установками, доход по которым будет агрегирован до текущего часа и дня. Рассмотрим отчет с двумя выбранными датами:
Агрегированный отчет за период с 31.12.2017 по 05.01.2018
Сеть |
Доход LTV |
---|---|
Органика |
$2 |
Сеть А |
$4 |
Сеть B |
$2 |
Сеть С |
$2 |
В данном случае когорта — это пользователи, установившие приложение с 31 декабря 2017 года по 05 января 2018 года. Весь доход, полученный от этих пользователей, привязан к источнику привлечения и представлен в LTV-данных пользователя.
Сырые данные по доходу от рекламы
Отчеты с сырыми данными о доходах от рекламы содержат сведения, предоставленные сетями монетизации, которые имеют интеграцию с AppsFlyer на уровне пользователя.
Принципы работы с сырыми данными по доходам от рекламы
- Данные агрегируются по количеству уникальных показов на пользователя. Уникальные показы определяются по комбинации сети монетизации рекламы, рекламного блока и размещения.
- Актуальность сырых данных идентична актуальности данных о доходах от рекламы на уровне пользователя на дэшборде «Активность».
Отчет |
Страница Экспорт данных |
Pull API | Data Locker |
---|---|---|---|
Атрибутированный доход от рекламы (неорганический) | ✓ | ✓ | ✓ |
Органический доход от рекламы | ✓ | ✓ | ✓ |
Доход от рекламы в рамках ретаргетинга | ✓ | ✓ | ✓ |
Характеристики и поля данных
Полях в отчетах о доходах от рекламы могут содержать следующее:
- Само событие дохода от рекламы и параметры, перечисленными в таблице ниже. Эти поля подразделяются на:
- Специфичные: поля, которые относятся к доходу от рекламы. Например, показы и размещение. Внимание! Состав заполняемых полей зависит от партнера по монетизации. См. таблицу «Поля по сетям».
- Контекстные: поля, имеющие аналогичное значение в других отчетах с сырыми данными. Например, имя события, значение события, валюта.
- Результат атрибуции события медиа-источнику, который привлек пользователя. Эти поля копируются из события конверсии, привлекшего пользователя. Например, медиа-источник и кампания. Такие поля в таблице ниже не указаны.
api_name | Имя поля | Тип поля | Описание |
---|---|---|---|
event_time | Event Time (Время события) | Context |
Дата атрибуции дохода от рекламы |
event_name | Имя события | Context |
Всегда устанавливайте значение af_ad_revenue |
event_revenue | Валюта выручки от событий | Context |
|
event_revenue_currency | Валюта события | Context |
Валюта выручки от события |
event_revenue_XXX | Доход от события XXX | Context |
|
Страна | Страна |
|
Страна установки для конверсии установки. |
ad_unit |
Рекламный блок |
Специфичное |
Тип рекламы |
segment | Сегмент | Специфичное | Название места размещения рекламы |
monetization_network | Сеть монетизации | Специфичное | Сеть, отправляющая рекламу |
Показы | Показы | Специфичное | Сколько раз пользователь видел рекламу |
mediation_network | Сеть-посредник | Специфичное | Сеть-посредник, сообщающая о событии в AppsFlyer |
Отображаемое имя | Admob | ironSource | AppLovin MAX | Appodeal | Fyber |
---|---|---|---|---|---|
Рекламный блок | ✓ | ✓ | ✓ | ✓ | ✓ |
Сегмент | - | (1) | - | - | - |
Placement | - | ✓ | ✓ | ✓ | ✓ |
Сеть монетизации | ✓ | ✓ | - | ✓ | - |
Показы | - | - | ✓ | ✓ | - |
Сеть-посредник | - | ✓ | ✓ | ✓ | - |
(1) Задается рекламодателем в ironSource. |
Дополнительные сведения
Вопросы и ответы
Как получить данные об общем доходе от рекламы с каждой платформы?
- Атрибуция доходов от рекламы связана с источником привлечения пользователей и отображается соответствующим образом.
- Это позволяет получить LTV-данные о рентабельности инвестиций и ключевых показателях эффективности.
- Чтобы просмотреть общий доход от каждой платформы монетизации, используйте свое внутреннее событие для каждой сети и выполните следующую процедуру:
- На обзорном дэшборде перейдите в таблицу агрегированного отчета об эффективности.
- Выберите до четырех монетизируемых событий, соответствующих платформам, по которым вы хотите отправить запрос.
-
Чтобы скачать отчет, нажмите Export CSV (Экспорт в CSV).
- Суммируйте значения в столбце Revenue (Доход) по монетизируемому событию соответствующей платформы
- Обратите внимание, что общий доход от рекламы — это данные LTV, т. е. весь доход, полученный сетью монетизации для вашего приложения от пользователей, которые совершили установку в рамках указанного диапазона дат.
Доступны ли данные о доходе от рекламы на странице активности?
Да!
На странице «Активность» отображается совокупный доход от покупок в приложении и от рекламы. Примечание. Данные о доходах от рекламы отправляются в AppsFlyer ежедневно на следующий день после события.
Нужно ли мне активировать партнера во вкладке «Интеграция»?
- Если вы взаимодействуете с партнером только по вопросам монетизации рекламы (доходу от рекламы): не включайте Activate Partner (Активировать партнера) на вкладке интеграции.
- Включите только Get Ad Revenue (Получать данные о доходах от рекламы) на вкладке Ad Revenue (Доход от рекламы).
Как атрибутируется доход от рекламы на уровне пользователя, если у пользователя версия приложения без SDK AppsFlyer?
- Доход от рекламы считается органическим.
Есть ли расхождения между данными о доходах от рекламы на различных дэшбордах и в отчетах?
Возможны расхождения между данными о доходах от рекламы на обзорном дэшборде и в отчетах с сырыми данными, а также на дэшбордах «Активность» и «Когорты». Это связано с тем, что:
- Данные о доходах от рекламы на дэшбордах «Активность» и «Когорты», а также данные, полученные через Master API и Cohort API, обновляются задним числом. Данные на обзорном дэшборде, а также данные, полученные через экспорт сырых данных и через Pull API, задним числом не обновляются.
- Иногда на дэшбордах «Активность» и «Когорты» данные появляются раньше, чем на обзорном дэшборде.
- На дэшбордах отображаются события, отмеченные
af_ad_revenue
и_monetized
, а в сырых данных — только событияaf_ad_revenue
. - Неизвестные устройства могут привести к увеличению дохода в день 0, о котором сообщается на дэшбордах Когорты и LTV, а также в отчетах.
Ограничения и особенности
Специфика | Заметки |
---|---|
Доступ рекламной сети | Нет доступа к когортным отчетам |
Доступ агентств |
Агентства:
|
Прозрачность агентства | Не поддерживается |
Time Zone (Часовой пояс) |
Данные о доходах от рекламы обновляются ежедневно. В сырых данных они сопровождаются меткой времени, соответствующей 00:00:00 UTC, но указанной по часовому поясу приложения. Это значит, что время события, произошедшего 2 июля 2021 года (UTC), будет отображаться следующим образом для приложений с часовым поясом:
|
Валюта |
В AppsFlyer:
|
Ограничения |
События дохода от рекламы недоступны:
Ограничения детализации до уровня пользователя:
|
Тип данных | Поддерживаются как органические, так и неорганические данные |
Актуальность данных | Доходы от рекламы |
Исторические/ретроспективные данные |
|
Доступ пользователей аккаунта | Поддерживается |
SKAN | Поддерживается путем подключения SDK Admob и общего SDK через событие af_ad_revenue. |
Неизвестные устройства |
Когда недоступны данные атрибуции, чтобы сопоставить событие дохода от рекламы (обычное явление для ретаргетинговых кампаний):
|
Гео/страна |
На дэшборде Когорты, если геоданные не известны (N/A), неизвестные данные не отображаются в сводных данных. |
Список интегрированных партнеров, поддерживающих передачу данных о доходе от рекламы
Партнер | Логотип | Необходимые учетные данные | Детализация данных |
---|---|---|---|
![]() |
|
Агрегированный отчет с геоданными | |
Admost |
![]() |
|
На уровне пользователя с геоданными |
![]() |
|
Агрегированный отчет с геоданными | |
![]() |
|
На уровне пользователя с геоданными | |
![]() |
|
|
|
Bytedance Ads - трафик из Китая | ![]() |
|
Агрегированный отчет с геоданными |
Chartboost | ![]() |
|
Агрегированный отчет с геоданными |
![]() |
|
Агрегированный отчет с геоданными | |
Fyber | ![]() |
|
На уровне пользователя с геоданными |
Google Платформа для маркетинга — DV360/CM (DoubleClick) | ![]() |
|
Агрегированный отчет с геоданными |
Google Admob | ![]() |
|
Агрегированный отчет с геоданными |
Google Ads | ![]() |
|
Агрегированный отчет с геоданными |
IronSource | ![]() |
|
|
Mintegral |
![]() |
|
Агрегированный отчет с геоданными |
Tapjoy |
![]() |
|
На уровне пользователя с геоданными |
![]() |
|
Агрегированный отчет с геоданными |
|
TopOn |
![]() |
|
На уровне пользователя с геоданными |
Tradplus mediation |
![]() |
|
На уровне пользователя с геоданными |
|
![]() |
|
Агрегированный отчет с геоданными |
Voodoo Ads | ![]() |
|
Агрегированный отчет с геоданными |
![]() |
|
Агрегированный отчет с геоданными |