Benutzerdefinierte native Displayanzeigenformate und Open Measurement

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

Vorbereitung

Führen Sie zuerst folgende Schritte aus:

• Open Measurement mit dem Mobile Ads SDK
• Benutzerdefinierte native Anzeigenformate einbinden
• Konfigurieren Sie einen Anbieter für die Sichtbarkeitsmessung und weisen Sie ihn Ihrer Werbebuchung zu.
• Geben Sie den Namen des Partners ein, wenn Sie in der Ad Manager-Benutzeroberfläche ein benutzerdefiniertes Format erstellen.

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.

Wenn Sie benutzerdefinierte native Anzeigenformate mit einem Video-Asset verwenden, müssen Sie dieser Anleitung nicht folgen. Das Mobile Ads SDK erfasst die Sichtbarkeit des Video-Assets für Sie.

Wichtiger Hinweis :Damit Ihre Messergebnisse für native benutzerdefinierte Displayanzeigen vom IAB zertifiziert werden können, müssen Sie vom IAB Tech Lab als Anbieter von Messlösungen zertifiziert sein.

Ansicht registrieren und mit der Messung beginnen

Wenn Sie Open Measurement für eine benutzerdefinierte native Anzeige aktivieren möchten, blenden Sie die Anzeige zuerst ein und registrieren Sie dann die benutzerdefinierte Anzeigenansicht mit dem DisplayOpenMeasurement-Objekt, das der benutzerdefinierten nativen Anzeige zugeordnet ist. Das DisplayOpenMeasurement-Objekt bietet die setView()-Methode zum Registrieren Ihrer Containeransicht für Open Measurement.

Außerdem müssen Sie dem SDK explizit mitteilen, dass die Messung Ihrer Anzeige beginnen soll. Rufen Sie dazu die Methode start() für das DisplayOpenMeasurement-Objekt Ihrer benutzerdefinierten nativen Anzeige auf. Die Methode start() muss aus dem Hauptthread aufgerufen werden. Nachfolgende Aufrufe haben keine Auswirkungen.

Hier sehen Sie das Beispiel eines Testergebnisses:

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

Die Anzeige sollte vor der Registrierung des Aufrufs ausgeliefert werden. Wie Ihre Anzeige ausgeliefert wird, wird unter Benutzerdefinierte native Anzeigenformate beschrieben.

Das nativeAdViewContainer-Layout ist der Anzeigencontainer für die benutzerdefinierte native Anzeige und muss alle Assets innerhalb des umgebenden Rechtecks der Ansicht enthalten.

Wichtig :Rufen Sie destroy() für die benutzerdefinierte native Anzeige auf, wenn Sie die Anzeige nicht mehr benötigen, z. B. nachdem Sie die Dereferenzierung des Objekts oder die Zerstörung der Aktivität abgeschlossen haben. So wird sichergestellt, dass das IAB-Ereignis sessionFinish ausgelöst wird.

IAB-Zertifizierung

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