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

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

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

Интеграция

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

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

Давайте теперь посмотрим, как использовать открытое измерение с NativeCustomTemplateAd . Как правило, вам необходимо уведомить Mobile Ads SDK, когда вы хотите начать измерение видимости и зарегистрировать собственный просмотр рекламы.

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

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

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

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

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

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

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

public void  registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {

...
// Show ad
...
displayCustomTemplateAd(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 — это рекламный контейнер для NativeCustomTemplateAd , который должен содержать все ресурсы в ограничивающей рамке представления.

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

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