Z tego przewodnika dowiesz się, jak zintegrować niestandardowe formaty reklam natywnych z otwartym pomiarem.
Wymagania wstępne
Zanim przejdziesz dalej:
- Przeczytaj artykuł Open Measurement z pakietem SDK do reklam mobilnych.
- Integrowanie niestandardowych formatów reklam natywnych.
- Skonfiguruj dostawcę usług pomiaru widoczności i przypisz go do elementu zamówienia.
- Podaj nazwę partnera podczas tworzenia formatu niestandardowego w interfejsie Ad Managera.
Integracja
Jeśli planujesz używać otwartego pomiaru w przypadku niestandardowych formatów reklam natywnych, które nie zawierają komponentu wideo, musisz samodzielnie wywoływać interfejsy Open Measurement API.
Jeśli używasz niestandardowych formatów reklam natywnych z elementem wideo, nie musisz postępować zgodnie z tym przewodnikiem. Pakiet SDK do reklam mobilnych śledzi widoczność elementu wideo w Twoim imieniu.
Zarejestruj widok i zacznij pomiary
Aby włączyć otwarty pomiar w przypadku niestandardowej reklamy natywnej, najpierw wyświetl reklamę, a potem zarejestruj niestandardowy widok reklamy za pomocą obiektu DisplayOpenMeasurement powiązanego z niestandardową reklamą natywną. Obiekt DisplayOpenMeasurement udostępnia metodę setView() rejestrowania widoku kontenera w otwartym pomiarze.
Musisz też wyraźnie poinformować pakiet SDK, aby rozpoczął pomiar reklamy. Aby to zrobić, wywołaj metodę start() na obiekcie DisplayOpenMeasurement niestandardowej reklamy natywnej. Metodę start() należy wywoływać z głównego wątku, a kolejne wywołania nie mają żadnego wpływu.
Jak to wygląda:
Kotlin
@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();
}
}
Pamiętaj, że przed zarejestrowaniem wyświetlenia musisz wyświetlić reklamę. Wyświetlanie reklamy opisujemy w sekcji Niestandardowe formaty reklam natywnych.
nativeAdViewContainerUkład jest kontenerem reklamy w przypadku niestandardowej reklamy natywnej i musi zawierać wszystkie komponenty w ramach pola ograniczającego widoku.
Certyfikat IAB
Po opublikowaniu aplikacji zaczniesz otrzymywać dane pomiarowe, ale nie zostaną one certyfikowane, dopóki nie przejdziesz procesu certyfikacji IAB.