Пользовательские форматы нативной рекламы для медийной рекламы и открытое измерение

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

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

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

Интеграция

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

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

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

Загрузить объявление

Загрузка объявления одинакова независимо от того, используете ли вы открытое измерение или нет. Вот метод, демонстрирующий, как запросить NativeCustomFormatAd :

public void loadAd() {
   AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
    .forCustomFormatAd("YOUR-TEMPLATE-ID",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
          @Override
          public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
              // Register your view and begin open measurement.
              // We will define this method below.
              MyActivity.this.registerOpenMeasurementAndShowAd(ad);
          }
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();
}

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

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

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

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

public void  registerOpenMeasurementAndShowAd(NativeCustomFormatAd ad) {

...
// Show ad
...
displayCustomFormatAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();

}

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

Макет customTemplateAdFrame — это рекламный контейнер для NativeCustomFormatAd , который должен содержать все ресурсы в ограничивающей рамке представления.

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

Сертифицироваться в IAB

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