Impression Level revenue data (ILRD)

Impression Level revenue data (ILRD) дает возможность обрабатывать детализированные данные о доходах. Начиная с версии Mobile Ads SDK 5.0.0, SDK предоставляет вам информацию о доходах, связанную с каждым показом, а также информацию о том, какая рекламная сеть (если используется мобильная медиация) показала объявление. Эта информация предоставляется в режиме реального времени на устройстве в приложении паблишера. Вы получаете возможность обрабатывать эти данные напрямую или передавать их стороннему поставщику аналитики.

Какие данные можно получить

Паблишеру доступны данные:

Поле

Тип

Описание

ad_unit_id

string

Уникальный идентификатор ad unit ID.

adType

string

Тип рекламного объявления:

  • баннер;
  • полноэкранная реклама;
  • нативная реклама;
  • реклама с вознаграждением.

currency

string

Валюта рекламной сети.

revenue

string

Доход за показ в валюте рекламной сети. Используется значение валюты из поля currency.

revenueUSD

string

Доход за показ, конвертированный в USD.

precision

string

Точность значения revenue. Допустимые значения:

  • publisher_defined — значение с учетом порога CPM из интерфейса медиации;
  • estimated — значение с учетом автостратегий.

network.name

string

Название рекламной сети, которая совершила показ рекламы (параметр актуален для Мобильной медиации).

network.ad_unit_id

string

Уникальный идентификатор ad unit ID в рекламной сети, которая совершила показ (параметр актуален для Мобильной медиации).

Подключение ILRD

  1. Подключите Mobile Ads SDK версии 8.0.0 и выше по инструкции (Рекламная сеть Яндекса — Compose Multiplatform, Мобильная медиация — Compose Multiplatform).

  2. Реализуйте интерфейсы на стороне клиента для отслеживания событий.

    При работе с баннерной рекламой используйте коллбэк onImpression в BannerEvents. Для полноэкранных форматов (InterstitialAd, RewardedAd, AppOpenAd) — коллбэк onAdImpression у соответствующего слушателя событий. Коллбэк вызывается, когда показ зафиксирован. Объект ImpressionData содержит свойство rawData — JSON-строку с ILRD.

    После получения загруженного полноэкранного объявления (обычно внутри корутины, запущенной из rememberCoroutineScope()) подключите слушатель перед вызовом show():

    ad.setAdEventListener(
        object : InterstitialAdEventListener {
            override fun onAdShown() {}
    
            override fun onAdFailedToShow(adError: AdError) {}
    
            override fun onAdDismissed() {}
    
            override fun onAdClicked() {}
    
            override fun onAdImpression(impressionData: ImpressionData?) {
                val rawData = impressionData?.rawData
            }
        },
    )
    ad.show()
    
Следующая