Ausrichtung

In diesem Leitfaden erfahren Sie, wie Sie einer Anzeigenanfrage Targeting-Informationen zur Verfügung stellen.

Voraussetzungen

RequestConfiguration

RequestConfiguration ist eine Struktur, die Targeting-Informationen erfasst, die mithilfe der globalen Funktion SetRequestConfiguration() global angewendet werden sollen.

Rufen Sie zum Aktualisieren der Anfragekonfiguration zuerst die aktuelle Konfiguration ab, nehmen Sie die gewünschten Aktualisierungen vor 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 Kinder

Im Rahmen des US-Gesetzes 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 Festlegen dieses Tags bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Auftrag des Inhabers der App zu handeln. Der Missbrauch dieser Einstellung kann zur Kündigung Ihres Google-Kontos führen.

Als App-Entwickler können Sie angeben, ob Google Ihren Content 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.

Sie können die Einstellung konfigurieren, indem Sie das Mitglied tag_for_child_directed_treatment der Struktur RequestConfiguration einem der folgenden Aufzählungswerte zuweisen:

  • Weisen Sie RequestConfiguration::tag_for_child_directed_treatment RequestConfiguration::kChildDirectedTreatmentTrue zu, um anzugeben, dass Ihre Inhalte gemäß COPPA als auf Kinder ausgerichtet behandelt werden sollen.
  • Weisen Sie RequestConfiguration::tag_for_child_directed_treatment RequestConfiguration::kChildDirectedTreatmentFalse zu, um anzugeben, dass Ihre Inhalte gemäß COPPA nicht als auf Kinder ausgerichtet behandelt werden sollen.
  • Weisen Sie RequestConfiguration::tag_for_child_directed_treatment zu RequestConfiguration::kChildDirectedTreatmentUnspecified zu, wenn Sie nicht angeben möchten, wie Ihr Inhalt in Bezug auf COPPA in Anzeigenanfragen behandelt werden soll.

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 Festlegen dieses Tags bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Auftrag 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. Bitte beachten Sie, dass die Tools von Google dazu dienen, die Einhaltung der Bestimmungen zu erleichtern und keinen bestimmten Publisher von seinen rechtlichen Verpflichtungen zu entlasten. Weitere Informationen zu den Auswirkungen der DSGVO auf Publisher

Wenn Sie diese Funktion verwenden, wird ein Tag für Nutzer unter 18 Jahren in die Anzeigenanfrage aufgenommen. Mit diesem Parameter wird personalisierte Werbung, 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.

Ähnlich wie bei Einstellungen, die auf Kinder ausgerichtet sind, gibt es in „RequestConfiguration“ ein Mitglied zum Konfigurieren des TFUA-Parameters: tag_for_under_age_of_consent, das mit den folgenden Aufzählungswerten konfiguriert werden kann:

  • 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 minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden 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, die für Kinder gedacht sind, und Nutzer, die das 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

Über RequestConfiguration::max_ad_content_rating field können Apps eine höchste Altersfreigabe für Anzeigeninhalte für ihre Anzeigenanfragen festlegen. AdMob-Anzeigen, die zurückgegeben werden, wenn dies konfiguriert ist, haben eine Altersfreigabe, die der entsprechenden Altersfreigabe entspricht oder darunter liegt. 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

Mit dem folgenden Code wird eine RequestConfiguration-Struktur konfiguriert. Damit wird angegeben, dass der zurückgegebene Anzeigeninhalt der Kennzeichnung eines digitalen Inhaltslabels entsprechen sollte, 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

Mit dem AdRequest-Objekt werden Ausrichtungsinformationen erfasst, die mit einer Anzeigenanfrage gesendet werden.

Inhalts-URL

Wenn eine Anzeige angefragt wird, geben Apps möglicherweise die URL des bereitgestellten Inhalts weiter. Dadurch wird die Ausrichtung der Keywords auf die Inhalte abgestimmt.

Wenn Ihre App beispielsweise eine Anzeige anfordert, während Inhalte von https://www.example.com präsentiert wird, können Sie diese URL übergeben, um 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();