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

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

Предварительные требования

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

• Ознакомьтесь с информацией об использовании Open Measurement с помощью Mobile Ads SDK .
• Интегрируйте собственные форматы нативной рекламы .
• Настройте поставщика информации о видимости и назначьте его вашей позиции в списке товаров.
• Введите название вашего партнера при создании пользовательского формата в интерфейсе Ad Manager.

Интеграция

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

Если вы используете собственные форматы нативной рекламы с видеоконтентом, вам не нужно следовать этому руководству; 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()
  }
}

Java

@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 .