Пользовательские форматы нативной рекламы дисплейного типа и Open Measurement

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

Предпосылки

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

• Ознакомьтесь с Открытым измерением с помощью SDK мобильной рекламы .
• Интегрируйте собственные форматы нативной рекламы .
• Настройте поставщика видимости и назначьте его своей позиции.
• Введите имя вашего партнера при создании пользовательского формата в пользовательском интерфейсе Менеджера объявлений.

Интеграция

Если вы планируете использовать открытые измерения с пользовательскими форматами нативной рекламы, которые не содержат видеоактив, вы будете нести ответственность за вызов API открытых измерений самостоятельно.

Если вы используете пользовательские нативные форматы рекламы с видеоактивом, вам не нужно следовать этому руководству; Mobile Ads SDK отслеживает просматриваемость видеоактива от вашего имени.

Ключевой момент: для того чтобы результаты измерений вашей нативной пользовательской рекламы дисплейного типа были сертифицированы IAB, вы должны быть сертифицированы как поставщик измерений в IAB Tech Lab .

Зарегистрируйте свой взгляд и начните измерять

Чтобы включить функцию открытого измерения для нативного объявления, сначала отобразите его, а затем зарегистрируйте представление вашего объявления с помощью объекта DisplayOpenMeasurement , связанного с этим объявлением. Объект DisplayOpenMeasurement предоставляет метод setView() для регистрации представления контейнера с функцией открытого измерения.

Вам также необходимо явно указать SDK, что нужно начать измерение эффективности вашей рекламы. Для этого вызовите метод start() объекта DisplayOpenMeasurement вашего нативного объявления. Метод start() должен быть вызван из основного потока, и последующие вызовы не будут иметь никакого эффекта.

Вот как это выглядит:

Котлин

@MainThread
private fun displayCustomNativeAd(
  customNativeAd: CustomNativeAd,
  nativeAdViewContainer: FrameLayout,
) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  val displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement()
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer)
    displayOpenMeasurement.start()
  }
}

Ява

@MainThread
private void displayCustomNativeAd(
    CustomNativeAd customNativeAd, FrameLayout nativeAdViewContainer) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  DisplayOpenMeasurement displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer);
    displayOpenMeasurement.start();
  }
}

Обратите внимание, что показ рекламы должен осуществляться до регистрации вашего представления. Показ рекламы описан в разделе «Форматы нативной рекламы» .

Макет nativeAdViewContainer представляет собой рекламный контейнер для пользовательской нативной рекламы и должен содержать все активы в пределах ограничивающей рамки представления.

Важно: Обязательно вызовите метод destroy() для пользовательского нативного объявления после завершения работы с ним, например, после разыменования объекта или уничтожения активности. Это гарантирует срабатывание события IAB sessionFinish .

Сертификация в IAB

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