Ausrichtung

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

In diesem Leitfaden wird erläutert, wie Sie einer Anzeigenanfrage Ausrichtungsinformationen zur Verfügung stellen.

Voraussetzungen

RequestConfiguration

RequestConfiguration ist eine Struktur, die Targeting-Informationen erfasst, die global über die globale Funktion SetRequestConfiguration() angewendet werden müssen.

Rufen Sie zum Aktualisieren der Anfragekonfiguration zuerst eine aktuelle Konfiguration ab, führen Sie die gewünschten Aktualisierungen durch und legen Sie sie so fest:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Einstellung für Inhalte, die auf Kinder ausgerichtet sind

Im Zusammenhang mit dem US-Gesetz zum Schutz der Privatsphäre von Kindern im Internet (Children's Online Privacy Protection Act, COPPA) gibt es eine Einstellung namens „Tag für Inhalte für Kinder“. Durch die Verwendung dieses Tags bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Sie nehmen zur Kenntnis, dass ein Missbrauch dieser Einstellung zur Kündigung Ihres Google-Kontos führen kann.

Als App-Entwickler können Sie angeben, ob Google Ihre Inhalte bei einer Anzeigenanfrage als auf Kinder ausgerichtet behandeln soll. Wenn Sie angeben, dass Google Ihre Inhalte als auf Kinder ausgerichtet behandeln soll, deaktivieren wir IBA und Remarketing-Anzeigen für diese Anzeigenanfrage.

Die Einstellung kann konfiguriert werden, indem das Mitglied tag_for_child_directed_treatment der Struktur RequestConfiguration einem der folgenden Aufzählungswerte zugewiesen wird:

  • Weisen Sie RequestConfiguration::tag_for_child_directed_treatment zu RequestConfiguration::kChildDirectedTreatmentTrue zu, um anzugeben, dass Ihre Inhalte im Sinne des COPPA als auf Kinder ausgerichtet behandelt werden sollen.
  • Weisen Sie RequestConfiguration::tag_for_child_directed_treatment zu RequestConfiguration::kChildDirectedTreatmentFalse zu, um anzugeben, dass Ihre Inhalte im Sinne des COPPA nicht als auf Kinder ausgerichtet behandelt werden sollen.
  • Weisen Sie RequestConfiguration::tag_for_child_directed_treatment zu RequestConfiguration::kChildDirectedTreatmentUnspecified zu, wenn Sie nicht möchten, dass Ihre Inhalte in Bezug auf COPPA in Anzeigenanfragen behandelt werden.

Das folgende Beispiel zeigt, dass deine Inhalte im Sinne des COPPA als auf Kinder ausgerichtet behandelt werden sollen:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Durch die Verwendung dieses Tags bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Der Missbrauch dieser Einstellung kann zur Kündigung Ihres Google-Kontos führen.

Sie können Ihre Anzeigenanfragen zur Verarbeitung für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) kennzeichnen. Diese Funktion soll die Einhaltung der EU-Datenschutz-Grundverordnung (DSGVO) erleichtern. Möglicherweise gelten für Sie im Rahmen der DSGVO weitere rechtliche Verpflichtungen. Bitte lesen Sie die Richtlinien der Europäischen Union und wenden Sie sich an Ihren Rechtsbeistand. Die Tools von Google wurden entwickelt, um die Einhaltung von Vorschriften zu erleichtern, und entbinden keinen bestimmten Publisher von seinen gesetzlichen Verpflichtungen. Weitere Informationen zu den Auswirkungen der DSGVO auf Publisher

Wenn Sie diese Funktion verwenden, wird der Parameter „Tag For Users under the Age of Consent in Europe (TFUA)“ in die Anzeigenanfrage eingefügt. Mit diesem Parameter werden personalisierte Anzeigen, einschließlich Remarketing, für alle Anzeigenanfragen deaktiviert. Außerdem werden an Drittanbieter gerichtete Anfragen deaktiviert, z. B. Tracking-Pixel und Ad-Server eines Drittanbieters.

Wie bei auf Kinder ausgerichteten Einstellungen gibt es in RequestConfiguration ein Mitglied, das den TFUA-Parameter konfiguriert: tag_for_under_age_of_consent. Es kann mit den folgenden Aufzählungswerten konfiguriert werden:

  • Weisen Sie RequestConfiguration::tag_for_under_age_of_consent zu RequestConfiguration::kUnderAgeOfConsentTrue zu, um anzugeben, dass die Anzeigenanfrage für Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll, die das gültige Mindestalter noch nicht erreicht haben.
  • Weisen Sie RequestConfiguration::tag_for_under_age_of_consent zu RequestConfiguration::kUnderAgeOfConsentFalse zu, um anzugeben, dass die Anzeigenanfrage nicht für Nutzer im Europäischen Wirtschaftsraum (EWR) behandelt werden soll, die das gültige Mindestalter noch nicht erreicht haben.
  • Weisen Sie RequestConfiguration::tag_for_under_age_of_consent zu RequestConfiguration::kUnderAgeOfConsentUnspecified zu, um anzugeben, dass Sie nicht angegeben haben, ob die Anzeigenanfrage für Nutzer im Europäischen Wirtschaftsraum (EWR) minderjährig sein soll.

Das folgende Beispiel zeigt, dass TFUA in Ihren Anzeigenanfragen enthalten sein soll:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Die Tags zum Aktivieren der auf Kinder ausgerichteten Einstellung und für Nutzer, die das gültige Mindestalter noch nicht erreicht haben, sollten nicht gleichzeitig auf „wahr“ gesetzt sein. Ist dies der Fall, hat die auf Kinder ausgerichtete Einstellung Vorrang.

Filtern von Anzeigeninhalten

Apps können über RequestConfiguration::max_ad_content_rating field eine höchste Altersfreigabe für Anzeigeninhalte festlegen. AdMob-Anzeigen, die zurückgegeben werden, wenn das konfiguriert ist, haben eine Altersfreigabe auf oder unter dieser Ebene. Die möglichen Werte dafür basieren auf Labels für digitale Inhalte und müssen einer der folgenden Aufzählungswerte sein:

  • RequestConfiguration::kMaxAdContentRatingG
  • RequestConfiguration::kMaxAdContentRatingPG
  • RequestConfiguration::kMaxAdContentRatingT
  • RequestConfiguration::kMaxAdContentRatingMA

Im folgenden Code wird die Struktur RequestConfiguration konfiguriert, um anzugeben, dass der zurückgegebene Anzeigeninhalt der Kennzeichnung eines digitalen Inhaltslabels entsprechen soll, das nicht höher als G ist:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

Das Objekt AdRequest erfasst Targeting-Informationen, die mit einer Anzeigenanfrage gesendet werden.

Inhalts-URL

Bei der Anforderung einer Anzeige können Apps die URL des bereitgestellten Inhalts übergeben. So kann die Ausrichtung auf Keywords mit der Anzeige an den Content angepasst werden.

Wenn Ihre App beispielsweise eine Anzeige anfordert und gleichzeitig Inhalte von https://www.example.com präsentiert wird, können Sie diese URL übergeben, um sie auf relevante Keywords auszurichten:

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();