Интеграция с Yandex Ads SDK
Если у вас установлен Yandex Mobile Ads SDK версии 7.6.0 или выше, вы можете использовать аналитические возможности AppMetrica, не инициализируя SDK AppMetrica отдельно. Также вам доступны автоматически собираемые события взаимодействия с рекламой.
Основные возможности:
-
Автоматическое отслеживание базовых событий: установок, стартов и завершений сессий, диплинков, in-app покупок.
Cобытия начнут отслеживаться автоматически при инициализации Yandex Mobile Ads SDK в приложении. Для этого активируйте интеграцию в интерфейсе AppMetrica. Обновлять код приложения не потребуется.
-
Автоматическое отслеживание событий взамодействия с рекламой Yandex Mobile Ads SDK: запросы рекламы, ответы, показы, клики.
Данные начнут автоматически поступать в AppMetrica для приложений, которые синхронизированы с Yandex Mobile Ads SDK.
Если вы инициализируете AppMetrica SDK в приложении самостоятельно, данные начнут поступать автоматически при условии, что в приложении также инициализирован Yandex Mobile Ads SDK и сделана синхронизация с Yandex Mobile Ads в настройках приложения AppMetrica.
Если вы уже используете AppMetrica в приложении
-
Обновите Yandex Mobile Ads SDK до версии 7.6.0 и выше.
-
В Настройках в разделе Синхронизация Ads SDK добавьте связь с приложением Yandex Mobile Ads:
-
Используйте тот же Yandex ID, на котором приложение зарегистрировано в Yandex Mobile Ads.
-
Убедитесь, что вы прошли проверку владением приложением.
-
-
Новые данные о взамодействии с рекламой Yandex Mobile Ads SDK появятся в отчете События в течение нескольких минут. Такие события не учитываются в лимитах на события.
При необходимости вы можете отключить сбор данных с помощью метода setAppAdAnalyticsReporting для Android и setAppAdAnalyticsReportingEnabled для iOS в конфигурации Yandex Mobile Ads SDK или удалить связку в настройках синхронизации.
Если вы ранее не использовали AppMetrica
Активируйте интеграцию при регистрации в интерфейсе ApppMetrica:
-
Обновите Yandex Mobile Ads SDK до версии 7.6.0 и выше.
-
Убедитесь, что вы прошли проверку владением приложением.
-
Зарегистрируйтесь в AppMetrica с помощью Yandex ID, на котором приложение зарегистрировано в Yandex Mobile Ads.
На шаге 1 отобразится нотификация о возможности привязки приложения Yandex Ads SDK. Если её нет — возможно, используется другой логин или приложение не прошло верификацию.
-
На 3 шаге Синхронизация Ads SDK укажите, из каких приложений с Ads SDK собирать статистику в AppMetrica.
Рекомендуется выбрать все платформы (например, iOS и Android) для одного приложения. Больше приложений можно будет добавить на шаге 5.
-
После завершения регистрации статистика начнет собираться в AppMetrica в течение нескольких минут. Обновлять код приложения не нужно.
-
Если вы хотите передавать в AppMetrica дополнительные данные, например кастомные события — используйте соответствующие методы. Инициализировать AppMetrica не требуется.
-
Если вы хотите использовать возможности расширенной конфигурации AppMetrica — инициализируйте AppMetrica самостоятельно, используя API Key, указанный в разделе Настройки → Основное.
Автоматические события Yandex Mobile Ads SDK
Доступные события и их параметры:
-
ad_request
: запрос рекламы приложениемad_type
: тип рекламы, например,banner
,interstitial
,native
,rewarded
;block_id
: идентификатор рекламного места;sdk_version
: версия Yandex Mobile Ads SDK;
-
ad_attempt
: успешный запрос за рекламой в рекламную сетьad_type
: тип рекламы, например,banner
,interstitial
,native
,rewarded
;block_id
: идентификатор рекламного места;sdk_version
: версия Yandex Mobile Ads SDK;ad_network
: рекламная сеть, которая показывает рекламу;
-
ad_filled_request
: запрос, успешно завершившийся подбором рекламыad_type
: тип рекламы, например,banner
,interstitial
,native
,rewarded
;block_id
: идентификатор рекламного места;sdk_version
: версия Yandex Mobile Ads SDK;ad_network
: рекламная сеть, которая показывает рекламу;banner_id
: идентификатор баннера;
-
ad_impression
: показ рекламыad_type
: тип рекламы, например,banner
,interstitial
,native
,rewarded
;block_id
: идентификатор рекламного места;sdk_version
: версия Yandex Mobile Ads SDK;ad_network
: рекламная сеть, которая показывает рекламу;banner_id
: идентификатор баннера;ad_revenue
: доход за показ в валюте рекламной сети;currency
: валюта рекламной сети;precision
: точность значенияad_revenue
. Допустимые значения:publisher_defined
— значение с учетом порога CPM из интерфейса медиации;estimated
— значение с учетом автостратегий;
-
ad_click
: клик по рекламеad_type
: тип рекламы, например,banner
,interstitial
,native
,rewarded
;block_id
: идентификатор рекламного места;sdk_version
: версия Yandex Mobile Ads SDK;ad_network
: рекламная сеть, которая показывает рекламу;banner_id
: идентификатор баннера;
-
ad_reward
: начисление вознаграждения за просмотр рекламы типа rewardedad_type
: тип рекламы, например,banner
,interstitial
,native
,rewarded
;block_id
: идентификатор рекламного места;sdk_version
: версия Yandex Mobile Ads SDK;ad_network
: рекламная сеть, которая показывает рекламу.
Узнайте больше
- Как использовать возможности расширенной конфигурации AppMetrica SDK?
- Нужно ли что-то менять в интеграции, если вы уже используете AppMetrica SDK в приложении?
- Как отключить автоматические события Yandex Ads SDK?
- Как инициализировать AppMetrica SDK по логике, отличной от инициализации Yandex Mobile Ads SDK?