Benutzerdefinierte native Displayanzeigenformate und Open Measurement

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

Vorbereitung

Führen Sie zuerst folgende Schritte aus:

Integration

Wenn Sie die offene Messung mit benutzerdefinierten nativen Anzeigenformaten verwenden möchten, die kein Video-Asset enthalten, müssen Sie die APIs für die offene Messung selbst aufrufen.

Wenn Sie benutzerdefinierte native Anzeigenformate mit einem Video-Asset verwenden, müssen Sie diesem Leitfaden nicht folgen. Das Mobile Ads SDK erfasst die Sichtbarkeit des Video-Assets in Ihrem Namen.

Ansicht registrieren und Messung starten

Wenn Sie die offene Messung für eine benutzerdefinierte native Anzeige aktivieren möchten, müssen Sie die Anzeige zuerst präsentieren und dann die benutzerdefinierte Anzeigenansicht mit dem DisplayOpenMeasurement-Objekt registrieren, das mit der benutzerdefinierten nativen Anzeige verknüpft ist. Das DisplayOpenMeasurement-Objekt bietet die Methode setView(), mit der Sie Ihre Containeransicht für die offene Messung registrieren können.

Außerdem müssen Sie dem SDK explizit mitteilen, dass die Messung Ihrer Anzeige gestartet werden 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();
  }
}

Präsentieren Sie die Anzeige, bevor Sie die Ansicht registrieren. Wie Sie Ihre Anzeige präsentieren, erfahren Sie im Hilfeartikel Benutzerdefinierte native Anzeigen formate.

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

Zertifizierung durch das IAB

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