В этом руководстве объясняется, как интегрировать собственные форматы нативной рекламы с открытой оценкой.
Предварительные условия
- Google Mobile Ads SDK версии 18.1.1 или выше.
- Прочтите «Открытое измерение с помощью Mobile Ads SDK ».
- Интегрируйте собственные форматы нативной рекламы .
- Настройте поставщика видимости и назначьте его своей позиции.
- Введите имя своего партнера при создании специального формата в интерфейсе Менеджера рекламы.
Интеграция
Если вы планируете использовать открытое измерение с собственными форматами нативной рекламы, не содержащими видеоресурсов, вам придется самостоятельно вызывать 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 .