Доход от рекламы на уровне показа

Когда происходит показ, Google Mobile Ads SDK for React Native предоставляет данные о доходе от рекламы, связанном с этим показом. Используйте эти данные, чтобы рассчитать пожизненную ценность пользователя (LTV), или передать их на платформы аналитики или сторонним партнерам по атрибуции.

В этом руководстве рассказывается, как реализовать сбор данных о доходе от рекламы на уровне показа в приложении React Native.

Требования

Прежде чем продолжить, сделайте следующее:

Каждый формат объявлений поддерживает обратный вызов события onAdPaid. В течение жизненного цикла объявления Google Mobile Ads SDK for React Native отслеживает события показа и вызывает обработчик с полученными полезными данными AdValue.

В примере ниже показано, как зарегистрировать прослушиватель событий оплаты в объявлении с вознаграждением, записать данные о полученном доходе от рекламы и показать объявление.

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

Мы рекомендуем сделать следующее:

  • Для полноэкранных объявлений настройте прослушиватель в объекте объявления после загрузки объявления и до его показа. Для баннеров и нативных объявлений передайте обратный вызов onAdPaid в качестве свойства компоненту <BannerAdView /> или <NativeAdView />. Это гарантирует, что вы не пропустите ни одного обратного вызова платного события.

  • Отправьте информацию о доходе от рекламы на уровне показа на нужный сервер аналитики, когда Google Mobile Ads SDK for React Native вызывает обратный вызов onAdPaid. Это позволит вам не пропустить обратные вызовы и обеспечит согласованность данных.

Об интеграции с партнерами по атрибуции конверсий в приложениях

Инструкции по передаче данных о доходе от рекламы на аналитические платформы можно найти в руководствах следующих партнеров по атрибуции конверсий в приложениях:

Объект AdValue

Объект AdValue представляет денежную ценность, полученную за показ объявления, включая код валюты и тип точности. В таблице ниже перечислены свойства объекта AdValue.

Свойство Описание
amountMicros Доход от рекламы в микроединицах, где 1000000 микроединиц равны одной единице валюты, например 1 доллару США или 1 евро.
currencyCode Код валюты по стандарту ISO 4217, например USD или EUR.
precision Уровень точности стоимости объявления. Ниже приведены подробные сведения о каждом уровне точности.
  • UNKNOWN: неизвестное значение объявления. Это значение возвращается, когда пингбек пожизненной ценности включен, но данных недостаточно.
  • ESTIMATED – доход от объявления рассчитывается на основе агрегированных данных.
  • PUBLISHER_PROVIDED – стоимость объявления, указанная издателем, например цена за тысячу показов, заданная вручную в группе медиации.
  • PRECISE – точная стоимость показа объявления.

При медиации AdMob пытается предоставить значение ESTIMATED для оптимизированных источников объявлений. Подробнее о том, как оптимизировать источники объявлений в каскаде медиации… Если источник объявлений не оптимизирован или для него недостаточно агрегированных данных, Google Mobile Ads SDK for React Native возвращает тип точности PUBLISHER_PROVIDED.

Тестовые показы из источников объявлений с назначением ставок

После того как в источнике объявлений с назначением ставок произойдет событие, связанное с доходом от рекламы на уровне показа, вы получите только следующие значения:

  • UNKNOWN – тип точности.
  • 0 – дополнительные преимущества объявления.

Подробнее о том, как отправить тестовый запрос объявления…