Benutzerdefinierte native Anzeigenformate für Displayanzeigen und Open Measurement

In diesem Leitfaden wird erläutert, wie Sie benutzerdefinierte native Anzeigenformate in offene Analysen einbinden.

Voraussetzungen

Integration

Wenn Sie Open Measurement mit benutzerdefinierten nativen Anzeigenformaten verwenden möchten, die kein Video-Asset enthalten, müssen Sie die Open Measurement APIs selbst aufrufen. Open Measurement für benutzerdefinierte native Anzeigenformate vom Typ Display-Typ wird erst ab Version 18.1.1 des Mobile Ads SDK unterstützt.

Wenn Sie benutzerdefinierte native Anzeigenformate mit einem Video-Asset verwenden, können Sie sich an diese Anleitung nicht halten. Das Mobile Ads SDK erfasst die Sichtbarkeit des Video-Assets für Sie.

Als Nächstes sehen wir uns an, wie Sie Open Measurement mit NativeCustomTemplateAd verwenden. Im Allgemeinen müssen Sie das Mobile Ads SDK benachrichtigen, wenn Sie mit der Sichtbarkeitsmessung beginnen und Ihre benutzerdefinierte Anzeigenansicht registrieren möchten.

Anzeige laden

Anzeigen werden immer geladen, unabhängig davon, ob Sie Open Measurement verwenden oder nicht. Hier ist eine Methode, die zeigt, wie ein NativeCustomTemplateAd angefordert wird:

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();
}

Ansicht registrieren und Messung starten

Um Open Measurement für eine NativeCustomTemplateAd zu aktivieren, registrieren Sie Ihre benutzerdefinierte Anzeigenansicht mit dem DisplayOpenMeasurement-Objekt, das dem NativeCustomTemplateAd zugeordnet ist. Das Objekt DisplayOpenMeasurement bietet die Methode setView() zum Registrieren der Containeransicht bei Open Measurement.

Außerdem müssen Sie das SDK explizit dazu auffordern, mit der Analyse Ihrer Anzeige zu beginnen. Rufen Sie dazu die Methode start() für das DisplayOpenMeasurement-Objekt Ihrer NativeCustomTemplateAd auf. Die Methode start() muss vom Hauptthread aus aufgerufen werden. Nachfolgende Aufrufe haben keine Auswirkungen.

Hier sehen Sie das Beispiel eines Testergebnisses:

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();

}

Sie sollten Ihre Anzeige schalten, bevor Sie Ihren Aufruf registrieren. Wie Sie Ihre Anzeige ausliefern können, wird unter Benutzerdefinierte native Anzeigenformate beschrieben.

Das Layout customTemplateAdFrame ist der Anzeigencontainer für NativeCustomTemplateAd und muss alle Assets im Begrenzungsrahmen der Ansicht enthalten.

Bei IAB zertifizieren lassen

Sobald Sie Ihre App veröffentlichen, erhalten Sie Messdaten. Ihre Daten werden jedoch erst zertifiziert, wenn Sie den IAB-Zertifizierungsprozess abgeschlossen haben.