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

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

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

  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 и выше.

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

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

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

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

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

  1. Обновите Yandex Mobile Ads SDK до версии 7.6.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 не требуется.

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

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

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