URL für Transparenzvorschriften für Anzeigen konfigurieren

Mit der URL für Anzeigentransparenz können Sie das AdChoices-Symbol anpassen, das in bestimmten Anzeigen zu sehen ist. Standardmäßig wird dieses Symbol Ihren Nutzern über eine von Google gerenderte AT&C-Funktion (Ad Transparency and Control, Transparenz und Kontrolle bei Anzeigen) angezeigt, die Informationen wie den Werbetreibenden und die Anzeige selbst enthält.

Sie können die URL für Anzeigentransparenz abrufen, indem Sie eine Anzeigenanfrage an das Google Mobile Ads SDK senden und eine Antwort mit der URL für Anzeigentransparenz erhalten. Nachdem Sie die URL in Ihrer App erhalten haben, können Sie ein personalisiertes Symbol einfügen, das dem Design Ihrer Anzeigen entspricht, und Ihren Nutzern Ihre eigenen Nutzungsbedingungen präsentieren.

Auf dieser Seite wird beschrieben, wie Sie die URL für Anzeigentransparenz anfordern, parsen und validieren.

Vorbereitung

Bevor Sie fortfahren, müssen Sie Folgendes erledigen:

  • Richten Sie native Anzeigen in Ihrer App ein. Weitere Informationen zu nativen Anzeigen finden Sie unter Native Anzeigen.
  • Beantragen Sie den Zugriff auf die Zulassungsliste für diese Funktion. Wenden Sie sich an Ihren Account Manager, um Zugriff anzufordern.
    • Wenn Sie keinen Zugriff haben, wird in Ihren Antworten nicht die URL für Anzeigentransparenz zurückgegeben und das Standardsymbol wird wie vorgesehen gerendert.

URL anfordern

Damit GMA Next-Gen SDK die URL für Anzeigentransparenz zurückgibt, fügen Sie Ihren Anfragen für native Anzeigen einen zusätzlichen Anfrageparameter hinzu. Dieser Parameter signalisiert, dass Ihre App bereit ist, ein personalisiertes Symbol zu verarbeiten.

Fügen Sie in Ihrer Anfrage den Schlüssel "ad_transparency_url_requested" mit dem Wert "1" in Ihr Paket mit Netzwerk-Extras ein. Weitere Informationen zu Netzwerk-Extras finden Sie unter setGoogleExtrasBundle.

Im folgenden Beispiel werden dieser Schlüssel und Wert festgelegt, um die URL für die Anzeigentransparenz anzufordern:

Java 

private void loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation.
  Bundle extras = new Bundle();
  extras.putString("ad_transparency_url_requested", "1");
  NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
      .setGoogleExtrasBundle(extras)
      .build();
}

Kotlin 

private fun loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation
  val extras = Bundle()
  extras.putString("ad_transparency_url_requested", "1");
  val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
}

Ersetzen Sie AD_UNIT_ID durch Ihre Anzeigenblock-ID. Beispiel: ca-app-pub-3940256099942544/2247696110 für native Anzeigen.

URL parsen

Nachdem Sie die URL angefordert haben, erhalten Sie eine Anzeigenantwort mit der URL für die Anzeigentransparenz im Antwortinformationsobjekt. Weitere Informationen zum Antwortinfo-Objekt finden Sie unter Antwortinfo.

Sie können über die Antwort-Extras über den Schlüssel "ad_transparency_url" auf die URL zur Anzeigentransparenz zugreifen. Im folgenden Beispiel wird die URL zur Anzeigentransparenz im Antwortinformationsobjekt abgerufen:

Java 

nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");

Kotlin 

nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")

URL validieren

Wenn Sie die URL für Anzeigentransparenz testen und validieren möchten, prüfen Sie, ob in Ihrer nativen Anzeige nicht das von Google bereitgestellte Standardsymbol, sondern Ihr personalisiertes Symbol zu sehen ist. Klicken Sie auf das Symbol, um die AT&C-Funktion aufzurufen.

Prüfen Sie außerdem, ob die URL für die Anzeigentransparenz in den zusätzlichen Informationen der Antwort in Ihrem Antwortinformationsobjekt angezeigt wird. Wenn die URL für Anzeigentransparenz nicht angezeigt wird, wird anstelle Ihres personalisierten Symbols das Standardsymbol von Google gerendert. Hier ist ein Beispiel für eine URL zur Anzeigentransparenz:

https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID