Benutzerdefinierte native Anzeigenformate für Displayanzeigen und Open Measurement

In diesem Leitfaden wird beschrieben, wie Sie benutzerdefinierte native Anzeigenformate in offene Analysen einbinden.

Vorbereitung

Integration

Wenn Sie die offene Analyse 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 Display-Anzeigen werden erst vom Mobile Ads SDK ab Version 18.1.1 unterstützt.

Wenn Sie benutzerdefinierte native Anzeigenformate mit einem Video-Asset verwenden, befolgen Sie diese Anleitung; erfasst das Mobile Ads SDK die Sichtbarkeit des Video-Assets in Ihrem Namen.

Anzeige laden

Unabhängig davon, ob Sie Open Measurement verwenden oder nicht, funktioniert das Laden der Anzeige immer gleich. Hier ist Eine Methode, die zeigt, wie ein NativeCustomFormatAd angefordert wird:

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

Registrieren Sie Ihre Ansicht und beginnen Sie mit der Messung

Um Open Measurement auf einem NativeCustomFormatAd zu aktivieren, müssen Sie Ihre benutzerdefinierte Anzeigenaufruf mit dem DisplayOpenMeasurement-Objekt, das dem NativeCustomFormatAd Das DisplayOpenMeasurement-Objekt stellt die setView()-Methode, um Ihre Containeransicht bei Open Measurement zu registrieren.

Außerdem müssen Sie das SDK ausdrücklich anweisen, mit der Messung Ihrer Anzeige zu beginnen. Aktion start()-Methode für das DisplayOpenMeasurement-Objekt Ihres NativeCustomFormatAd Die Methode start() muss aus dem Hauptthread aufgerufen werden. Alle nachfolgenden Aufrufe haben keine Auswirkungen.

Hier sehen Sie das Beispiel eines Testergebnisses:

public void  registerOpenMeasurementAndShowAd(NativeCustomFormatAd ad) {

...
// Show ad
...
displayCustomFormatAd(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();

}

Bevor Sie Ihre Ansicht erfassen, sollten Sie Ihre Anzeige schalten. Informationen zur Auslieferung Ihrer Anzeige finden Sie unter Benutzerdefinierte native Anzeigenformate.

Das customTemplateAdFrame-Layout ist der Anzeigencontainer für die NativeCustomFormatAd und muss alle Assets innerhalb des Begrenzungsrahmens der Ansicht enthalten.

Mit IAB zertifizieren

Sobald Sie Ihre App veröffentlichen, erhalten Sie Messdaten. Allerdings Ihre Daten werden erst zertifiziert, wenn Sie die IAB-Zertifizierungsprozess: