Интеграция с Yandex Ads SDK

Вы можете использовать аналитические возможности AppMetrica, не инициализируя SDK AppMetrica отдельно, если у вас установлен Yandex Mobile Ads SDK версии 7.6.0 или выше, или один из плагинов:

  • Unity Ads SDK версии 7.10.0 и выше;
  • React Ads SDK версии 7.10.0 и выше;
  • Flutter Ads SDK версии 7.9.0 и выше.

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

Основные возможности:

  1. Автоматическое отслеживание базовых событий: установок, стартов и завершений сессий, диплинков, in-app покупок.

    Cобытия начнут отслеживаться автоматически при инициализации Yandex Mobile Ads SDK в приложении. Для этого активируйте интеграцию в интерфейсе AppMetrica. Обновлять код приложения не потребуется.

  2. Автоматическое отслеживание событий взамодействия с рекламой Yandex Mobile Ads SDK: запросы рекламы, ответы, показы, клики.

    Данные начнут автоматически поступать в AppMetrica для приложений, которые синхронизированы с Yandex Mobile Ads SDK.

    Если вы инициализируете AppMetrica SDK в приложении самостоятельно, данные начнут поступать автоматически при условии, что в приложении также инициализирован Yandex Mobile Ads SDK и сделана синхронизация с Yandex Mobile Ads в настройках приложения AppMetrica.

Если вы уже используете AppMetrica в приложении

  1. Обновите платформу Yandex Mobile Ads SDK до версии 7.6.0 и выше, или нужный вам плагин:

    • Unity Ads SDK — до версии 7.10.0 и выше;
    • React Ads SDK — до версии 7.10.0 и выше;
    • Flutter Ads SDK — до версии 7.9.0 и выше.

  2. В разделе Настройки выберите Синхронизация Ads SDK и добавьте связь с приложением Yandex Mobile Ads:

  3. Новые данные о взамодействии с рекламой Yandex Mobile Ads SDK появятся в отчете События в течение нескольких минут. Такие события не учитываются в лимитах на события.

При необходимости вы можете отключить сбор данных с помощью метода setAppAdAnalyticsReporting для Android и setAppAdAnalyticsReportingEnabled для iOS в конфигурации Yandex Mobile Ads SDK или удалить связку в настройках синхронизации.

Если вы ранее не использовали AppMetrica

Активируйте интеграцию при регистрации в интерфейсе AppMetrica:

  1. Обновите платформу Yandex Mobile Ads SDK до версии 7.6.0 и выше, или нужный вам плагин:

    • Unity Ads SDK — до версии 7.10.0 и выше;
    • React Ads SDK — до версии 7.10.0 и выше;
    • Flutter Ads SDK — до версии 7.9.0 и выше.

  2. Убедитесь, что вы прошли проверку владением приложением.

  3. Зарегистрируйтесь в AppMetrica с помощью Yandex ID, на котором приложение зарегистрировано в Yandex Mobile Ads.

    На шаге 1 отобразится нотификация о возможности привязки приложения Yandex Ads SDK. Если её нет — возможно, используется другой логин или приложение не прошло верификацию.

  4. На 3 шаге Синхронизация Ads SDK укажите, из каких приложений с Ads SDK собирать статистику в AppMetrica.

    Рекомендуется выбрать все платформы (например, iOS и Android) для одного приложения. Больше приложений можно будет добавить на шаге 5.

  5. После завершения регистрации статистика начнет собираться в AppMetrica в течение нескольких минут. Обновлять код приложения не нужно.

  6. Если вы хотите передавать в AppMetrica дополнительные данные, например кастомные события — используйте соответствующие методы. Инициализировать AppMetrica SDK не требуется.

  7. Если вы хотите использовать возможности расширенной конфигурации AppMetrica SDK — инициализируйте AppMetrica SDK самостоятельно, используя 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: начисление вознаграждения за просмотр рекламы типа rewarded

    • ad_type: тип рекламы, например, banner, interstitial, native, rewarded;
    • block_id: идентификатор рекламного места;
    • sdk_version: версия Yandex Mobile Ads SDK;
    • ad_network: рекламная сеть, которая показывает рекламу.

Узнайте больше

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

Написать в службу поддержки Предложить улучшение для документации
Предыдущая
Конверсии
Следующая
Экспорт данных в Yandex Cloud