Z tego przewodnika dowiesz się, jak zintegrować niestandardowe formaty reklam natywnych z otwartymi pomiarami.
Wymagania wstępne
- Pakiet SDK do reklam mobilnych Google w wersji 18.1.1 lub nowszej.
- Przeczytaj artykuł Open Measurement w pakiecie SDK do reklam mobilnych.
- Korzystaj z niestandardowych formatów reklam natywnych.
- Skonfiguruj dostawcę usług pomiaru widoczności i przypisz go do elementu zamówienia.
- Wpisz nazwę partnera podczas tworzenia formatu niestandardowego w interfejsie Ad Managera.
Integracja
Jeśli zamierzasz stosować pomiary otwarte w przypadku niestandardowych formatów reklam natywnych, które nie zawierają zasobu wideo, musisz samodzielnie wywoływać interfejsy Open Measurement API. Pomiar otwarty dla niestandardowych formatów reklam natywnych typu displayowego jest obsługiwany tylko przez pakiet SDK do reklam mobilnych w wersji 18.1.1 lub nowszej.
Jeśli używasz niestandardowych formatów reklam natywnych z komponentem wideo, nie musisz korzystać z tego przewodnika. Pakiet SDK do reklam mobilnych śledzi w Twoim imieniu widoczność zasobu wideo.
Zobaczmy, jak korzystać z pomiaru otwartego w metodzie NativeCustomTemplateAd. Ogólnie rzecz biorąc, jeśli chcesz rozpocząć pomiar widoczności i zarejestrować niestandardowy widok reklamy, musisz wysłać alert z pakietu SDK do reklam mobilnych.
Wczytywanie reklamy
Wczytywanie reklamy wygląda tak samo niezależnie od tego, czy korzystasz z pomiaru otwartego, czy nie. Oto metoda pokazująca, jak zażądać właściwości 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();
}
Zarejestruj widok i rozpocznij pomiary
Aby włączyć pomiar otwarty dla obiektu NativeCustomTemplateAd, zarejestruj niestandardowy widok reklamy za pomocą obiektu DisplayOpenMeasurement powiązanego z: NativeCustomTemplateAd. Obiekt DisplayOpenMeasurement udostępnia metodę setView(), która pozwala zarejestrować widok kontenera za pomocą pomiaru otwartego.
Musisz też wyraźnie wskazać pakietowi SDK rozpoczęcie pomiaru skuteczności reklamy. Aby to zrobić, wywołaj metodę start() w obiekcie DisplayOpenMeasurement NativeCustomTemplateAd. Metoda start() musi być wywoływana z wątku głównego, a kolejne wywołania nie mają żadnych skutków.
Jak to wygląda:
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();
}
Pamiętaj, że przed zarejestrowaniem wyświetlenia należy wyświetlić reklamę. Wyświetlanie reklam jest uwzględnione w sekcji Niestandardowe formaty reklam natywnych.
Układ customTemplateAdFrame odpowiada kontenerowi reklamy NativeCustomTemplateAd i musi zawierać wszystkie zasoby w ramce ograniczającej widok.
Certyfikacja przez IAB
Gdy opublikujesz aplikację, zaczniesz otrzymywać dane pomiarowe. Nie będą one jednak certyfikowane, dopóki nie ukończysz procesu certyfikacji IAB.