---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://boost.yandex.com/doc/en/analytics/content/data-collection/about-adrevenue.md
- https://boost.yandex.com/doc/ru/analytics/content/data-collection/about-adrevenue.md
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/ru/llms.txt
# Ad Revenue
Один из типов монетизации мобильного приложения — показ рекламы внутри приложения (Ad Revenue). В Boost Analytics можно передавать данные о выручке от показов рекламы.
После настройки отправки Ad Revenue вы сможете:
- Оценивать доходность приложения в целом — от in-app покупок и до рекламной монетизации.
- Выделять рекламные блоки, форматы и экраны, которые приносят лучшие результаты.
- Строить воронки для оценки конверсии в просмотр рекламы.
- Оценивать User Acquisition — находить партнеров, которые приносят наибольший доход, и оценивать эффективность их трафика.
- Выделять самые прибыльные сегменты пользователей, использовать когортный анализ для отслеживания дохода от пользователей со временем.
- Оптимизировать пользовательские сценарии и наращивать рекламную монетизацию.
{% note info "" %}
События Ad Revenue не входят в платные лимиты, их отправка не влияет на [стоимость тарифа](https://boost.yandex.com/doc/ru/analytics/content/common/pricing/ru-currency.md).
{% endnote %}
## Как рассчитывается Ad Revenue {#calculation}
Данные передаются от SDK для каждого показа рекламного объявления с выручкой от этого события (Impression level Revenue Data).
Все события рекламной выручки в Boost Analytics привязываются к пользователям и на основе этих данных рассчитываются метрики для Ad Revenue:
| **Метрика** | **Описание** |
| ----------- | ----------- |
| Ad Revenue события | Количество событий с рекламной выручкой (Ad Revenue). |
| Ad Revenue | Суммарная выручка от рекламной монетизации. |
| Ad ARPU | Отношение выручки приложения от рекламной монетизации к количеству пользователей приложения. Подробнее о [конвертации валют](#currency). |
| eCPM | Отношение суммарной выручки от рекламной монетизации к количеству событий с рекламной выручкой (Ad Revenue), умноженное на 1000. |
| Пользователи с Ad Revenue |Количество пользователей с событиями рекламной выручки (Ad Revenue). |
| Ad Revenue событий на пользователя | Отношение количества событий с рекламной выручкой (Ad Revenue) к количеству пользователей. |
| Сессий с Ad Revenue | Количество сессий, в рамках которых были совершены события с рекламной выручкой (Ad Revenue). |
| Ad Revenue событий на сессию | Отношение количества событий с рекламной выручкой (Ad Revenue) к общему количеству сессий. |
| % пользователей c Ad Revenue | Отношение количества пользователей с событиями c рекламной выручкой (Ad Revenue) ко всем пользователям. |
С учетом данных по Ad Revenue рассчитываются метрики по суммарному доходу:
| **Метрика** | **Описание** |
| ----------- | ----------- |
| Total Revenue | Суммарная выручка от рекламной монетизации, in-app покупок и подписок в приложении. Подробнее о [конвертации валют](#currency). |
| Total ARPU | Отношение общей выручки приложения от рекламной монетизации, in-app покупок и подписок к количеству пользователей приложения. Подробнее о [конвертации валют](#currency). |
## Настройка отправки событий Ad Revenue {#send}
Существуют два способа настройки отправки событий Ad Revenue: [через SDK](#send-sdk) (основной способ) и [с помощью Post API](#send-post-api).
### Настройка отправки событий через SDK {#send-sdk}
#### Шаг 1. Активируйте SDK {#activate-sdk}
Убедитесь, что SDK AppMetrica активирован в вашем приложении:
- [Android](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-operations.md#initialize)
- [iOS](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue-activate)
- [Flutter](https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/analytics/flutter-operations.md#send-adrevenue-active)
- [React Native](https://boost.yandex.com/doc/ru/analytics/content/sdk/react-native/analytics/quick-start.md)
- [Unity](https://boost.yandex.com/doc/ru/analytics/content/sdk/unity/analytics/quick-start.md)
#### Шаг 2. Настройте отправку Ad Revenue через SDK {#setup-sdk}
Выберите платформу и способ интеграции и настройте соответствующие методы SDK.
В Boost Analytics поддерживаются следующие способы интеграции с сервисами рекламной монетизации и медиации:
- AppLovin MAX
- Android: [Упрощенная интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-applovin-max)
- iOS: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue)
- Flutter: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/analytics/flutter-operations.md#send-adrevenue)
- Unity: [Автоматическая интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/unity/analytics/unity-operations.md#adrevenue-autocollection)
- Digital Turbine
- Android: [Упрощенная интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-digital-turbine)
- iOS: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue)
- Flutter: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/analytics/flutter-operations.md#send-adrevenue)
- Unity: [Упрощенная интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/unity/analytics/unity-operations.md#adrevenue-autocollection)
- Google AdMob
- Android: [Упрощенная интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-google-admob)
- iOS: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue)
- Flutter: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/analytics/flutter-operations.md#send-adrevenue)
- Unity: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/unity/analytics/unity-operations.md#send-adrevenue)
- ironSource
- Android: [Автоматическая интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-automatic-integration-ironsource)
- iOS: [Самостоятельная интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue)
- Flutter: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/analytics/flutter-operations.md#send-adrevenue)
- Unity: [Автоматическая интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/unity/analytics/unity-operations.md#adrevenue-autocollection)
- Yandex Mobile Ads
- Android: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-manual-integration)
- iOS: [Самостоятельная интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue)
- Flutter: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/analytics/flutter-operations.md#send-adrevenue)
- Unity: [Автоматическая интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/unity/analytics/unity-operations.md#adrevenue-autocollection)
- TopOn
- Android: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-manual-integration)
- iOS: [Самостоятельная интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue)
- Flutter: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/analytics/flutter-operations.md#send-adrevenue)
- Unity: [Автоматическая интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/unity/analytics/unity-operations.md#adrevenue-autocollection)
- Любой сервис рекламной монетизации, который предоставляет Impression level Revenue Data
- Android: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-operations.md#send-adrevenue-manual-integration)
- iOS: [Самостоятельная интеграция](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue)
- Flutter: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/analytics/flutter-operations.md#send-adrevenue)
- Unity: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/unity/analytics/unity-operations.md#send-adrevenue)
- React Native: [Самостоятельная настройка](https://boost.yandex.com/doc/ru/analytics/content/sdk/react-native/analytics/react-native-operations.md#send-adrevenue)
{% note info "Отладка" %}
В Boost Analytics нет возможности сегментировать события на тестовые и не тестовые. Если для отладки сбора данных о рекламной монетизации вы используете основной API key, то тестовые события будут попадать в общую статистику. Поэтому для отладки используйте отправку на дополнительный API key с помощью репортера.
{% cut "Подробнее о репортере" %}
- Android
- [Отправка статистики на дополнительный API key](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-operations.md#reporter-different-apikey)
- [Отслеживание сессий для репортеров](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-listen.md)
- iOS
- [Отправка статистики на дополнительный API key](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-operations.md#reporter-different-apikey)
- [Отслеживание сессий для репортеров](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-listen.md#reporter-listen)
- Flutter
- [Отправка статистики на дополнительный API key](https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/analytics/flutter-operations.md#reporter-different-apikey) .
- React Native
- [Отправка статистики на дополнительный API key](https://boost.yandex.com/doc/ru/analytics/content/sdk/react-native/analytics/react-native-operations.md#reporter-different-apikey)
- Unity
- [Отправка статистики на дополнительный API key](https://boost.yandex.com/doc/ru/analytics/content/sdk/unity/analytics/unity-operations.md#reporter-different-apikey)
{% endcut %}
{% endnote %}
### Настройка отправки событий через Post API {#send-post-api}
Post API может быть полезен в следующих случаях:
- Импорт исторических данных — загрузка данных за период, когда SDK еще не был установлен (загрузить события можно только за последние 14 дней).
- Серверная валидация — отправка данных с вашего бэкенда после дополнительной обработки или валидации.
- Агрегация данных — объединение данных из нескольких источников перед отправкой в Boost Analytics.
- Офлайн-сценарии — отправка данных, которые были собраны, когда устройство было офлайн.
- Интеграция с внешними системами — получение данных от рекламных сетей через их API и отправка в Boost Analytics.
- Дополнительная логика — применение бизнес-логики на сервере перед отправкой аналитики.
Учитывайте [особенности](https://boost.yandex.com/doc/ru/analytics/content/mobile-api/post/about.md) и [ограничения](https://boost.yandex.com/doc/ru/analytics/content/mobile-api/post/restrictions.md) Post API.
#### Шаг 1. Получите Post API key {#send-api-key}
Перейдите в раздел **Настройки** → **Основное** и получите **Post API key** для авторизации запросов.
{% note info "Отладка" %}
Чтобы в процессе отладки сбора данных тестовые события не попадали в общую статистику, используйте разные Post API key для разных окружений — тестового и рабочего.
{% endnote %}
#### Шаг 2. Подготовьте данные для отправки {#send-api-data}
Ознакомьтесь с документацией по загрузке событий Ad Revenue через Post API: [Загрузка событий Ad Revenue](https://boost.yandex.com/doc/ru/analytics/content/mobile-api/post/post-adrevenue.md).
Соберите необходимые параметры для события Ad Revenue.
#### Шаг 3. Отправьте HTTP-запрос {#send-api-request}
Post API поддерживает два способа передачи данных:
- Передача в теле запроса (CSV формат). Подходит для массовой загрузки данных.
Используйте endpoint: `/logs/v1/import/adrevenue.csv`
Передайте данные в теле запроса в формате CSV.
- Передача в параметрах запроса. Подходит для одиночных событий.
Используйте endpoint: `/logs/v1/import/adrevenue`
Передайте данные как параметры URL.
#### Шаг 4. Обработайте ответ {#send-api-response}
API возвращает следующие коды ответа:
- `200` — данные успешно загружены
- `403` — ошибка авторизации
- `400` — отсутствуют обязательные параметры
## Проверка данных в отчетах {#metrics}
После настройки отправки событий Ad Revenue [через SDK](#send-sdk) или [с помощью Post API](#send-post-api) убедитесь, что события поступают в систему и количество событий соответствует количеству просмотров рекламы.
Метрики Ad Revenue доступны в следующих отчетах:
[In-app и Ad Revenue](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/revenue-report.md)
: В отчете **In-app и Ad Revenue** вы можете оценить общий доход приложения, доход от разных типов монетизации (рекламной и in-app), доход по разным рекламным сетям и разным типам объявлений.
[User Acquisition](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/user-acquisition-report.md) и [Remarketing](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/remarketing-report.md)
: В этих отчетах вы можете оценить эффективность источников привлечения и возвращения трафика с точки зрения ARPU и других метрик рекламной и in-app монетизации. Обратите внимание, метрики в этом отчете считаются суммарно за весь период жизни пользователя.
[Когортный анализ](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/cohort-report.md)
: В когортном отчете вы сможете оценить, какой доход вы получаете от пользователей с течением времени и ARPU на интересующий вас день.
[Воронки](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/funnels-report.md)
: В воронках вы можете оценить, какая доля пользователей доходит до просмотра рекламы в целом или, например, доходит до просмотра рекламы с вознаграждением.
[Сегментация](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/segmentation.md)
: Для построения каждого отчета вы можете выбрать только тех пользователей, которые, например, взаимодействовали с рекламными объявлениями определенной рекламной сети или определенного рекламного формата.
### Конвертация валюты {#currency}
Вы можете передавать Ad Revenue в разных валютах. Список всех поддерживаемых валют см. в разделе [Поддерживаемые валюты](https://boost.yandex.com/doc/ru/analytics/content/data-collection/currency-codes.md).
Выручка от Ad Revenue конвертируется во все валюты отчета: USD, EUR, RUB. Для конвертации валюты используется курс, который предоставляют более 15 источников, включая Европейский центральный банк.
Конвертация происходит по курсу, который был днем ранее. Например, если Ad Revenue событие было в день N, то выручка конвертируется по курсу дня N − 1. Конвертация в валюты EUR и RUB происходит относительно USD.
## Узнать больше {#learn-more}
- [Рекламная монетизация: как анализировать доход от рекламы в Boost Analytics](https://appmetrica.yandex.ru/about/blog/ad-revenue-release)
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.
Написать в службу поддержки
Предложить улучшение для документации