Targeting


In diesem Leitfaden wird erläutert, wie Sie Targeting-Informationen für eine Anzeigenanfrage bereitstellen.

Vorbereitung

RequestConfiguration

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

Wenn Sie die Anfragekonfiguration aktualisieren möchten, rufen Sie 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 Inhalte, die speziell für Kinder bestimmt sind

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 zur Klassifizierung als Inhalte für Kinder“. Durch das Festlegen dieses Tags bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Ihnen ist bewusst, dass ein Missbrauch dieser Einstellung zur Kündigung Ihres Google-Kontos führen kann.

Als App-Entwickler können Sie angeben, ob Google bei einer Anzeigenanfrage Ihre Inhalte als auf Kinder ausgerichtet klassifizieren soll. Wenn Sie angeben, dass Google Ihre Inhalte als auf Kinder ausgerichtet einstufen soll, deaktivieren wir interessenbezogene Werbung 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 den Wert RequestConfiguration::kChildDirectedTreatmentTrue zu, um anzugeben, dass Ihre Inhalte im Sinne von COPPA als auf Kinder ausgerichtet eingestuft werden sollen.
  • Weisen Sie RequestConfiguration::tag_for_child_directed_treatment den Wert RequestConfiguration::kChildDirectedTreatmentFalse zu, um anzugeben, dass Ihre Inhalte im Sinne von COPPA nicht als auf Kinder ausgerichtet eingestuft werden sollen.
  • Weisen Sie RequestConfiguration::tag_for_child_directed_treatment den Wert RequestConfiguration::kChildDirectedTreatmentUnspecified zu, wenn Sie in Anzeigenanfragen nicht angeben möchten, wie Ihre Inhalte im Hinblick auf COPPA behandelt werden sollen.

Im folgenden Beispiel wird angegeben, dass Ihre Inhalte gemäß COPPA als Inhalte speziell für Kinder eingestuft 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 das Setzen dieses Tags bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Ihnen ist bewusst, dass ein Missbrauch dieser Einstellung zur Kündigung Ihres Google-Kontos führen kann.

Sie können Ihre Anzeigenanfragen zur Verarbeitung für Nutzer im Europäischen Wirtschaftsraum (EWR) unter dem gültigen Mindestalter kennzeichnen. Mit dieser Funktion soll die Einhaltung der EU-Datenschutz-Grundverordnung (DSGVO) erleichtert werden. Unter Umständen gelten für Sie im Rahmen der DSGVO noch weitere rechtliche Verpflichtungen. Sehen Sie sich daher die Richtlinien der Europäischen Union an und wenden Sie sich gegebenenfalls an Ihren Rechtsbeistand. Die Tools von Google sollen die Einhaltung gesetzlicher Bestimmungen erleichtern. Sie entbinden Publisher nicht von ihren gesetzlichen Pflichten. Weitere Informationen zu den Auswirkungen der DSGVO für Publisher

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

Wie bei den Einstellungen für Inhalte, die speziell für Kinder bestimmt sind, gibt es in RequestConfiguration ein Mitglied zum Konfigurieren des TFUA-Parameters: tag_for_under_age_of_consent. Dieser kann mit den folgenden Aufzählungswerten konfiguriert werden:

  • Weisen Sie RequestConfiguration::tag_for_under_age_of_consent den Wert RequestConfiguration::kUnderAgeOfConsentTrue zu, um anzugeben, dass die Anzeigenanfrage für Nutzer im Europäischen Wirtschaftsraum (EWR) unter dem gültigen Mindestalter behandelt werden soll.
  • Weisen Sie RequestConfiguration::tag_for_under_age_of_consent dem Wert RequestConfiguration::kUnderAgeOfConsentFalse zu, um anzugeben, dass die Anzeigenanfrage nicht 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 den Wert RequestConfiguration::kUnderAgeOfConsentUnspecified zu, um anzugeben, dass Sie nicht festgelegt haben, ob die Anzeigenanfrage für Nutzer im Europäischen Wirtschaftsraum (EWR) unter dem gültigen Mindestalter behandelt werden soll.

Im folgenden Beispiel wird angegeben, dass TFUA in Ihre Anzeigenanfragen aufgenommen werden 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 Einstellung „Inhalte speziell für Kinder“ und „Nutzer, die das gültige Mindestalter noch nicht erreicht haben“ sollten nicht gleichzeitig auf „true“ gesetzt sein. Sollte dieser Fall auftreten, hat die Einstellung für Inhalte speziell für Kinder Vorrang.

Filtern von Anzeigeninhalten

In Apps kann über RequestConfiguration::max_ad_content_rating field eine höchste Altersfreigabe für Anzeigeninhalte für Anzeigenanfragen festgelegt werden. AdMob-Anzeigen, die bei dieser Konfiguration zurückgegeben werden, haben eine Altersfreigabe, die diesem Wert entspricht oder darunter liegt. Die möglichen Werte dafür basieren auf Klassifizierungen von Labels für digitalen Content und müssen einem der folgenden Aufzählungswerte entsprechen:

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

Mit dem folgenden Code wird eine RequestConfiguration-Struktur konfiguriert, um anzugeben, dass der zurückgegebene Anzeigeninhalt einer Bezeichnung für digitale Inhalte entsprechen soll, die 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 sollen.

Inhalts-URL

Wenn eine Anzeige angefordert wird, können Apps die URL des Inhalts übergeben, den sie bereitstellen. So kann die Anzeige mithilfe von Keyword-Targeting auf die Inhalte abgestimmt werden.

Wenn deine App beispielsweise eine Anzeige anfordert, während Inhalte von https://www.example.com angezeigt werden, kannst du diese URL übergeben, um relevante Keywords anzusprechen:

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

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