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 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 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 tag_for_child_directed_treatment-Mitglied der RequestConfiguration-Struktur 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 speziell für Kinder erstellt 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), die das gültige Mindestalter noch nicht erreicht haben, 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. Bitte lesen Sie sich die Richtlinien der Europäischen Union durch 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 dem 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 den 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 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 Einstellung „Inhalte speziell für Kinder“ und „Nutzer, die das gültige Mindestalter noch nicht erreicht haben“ sollten nicht gleichzeitig auf „true“ gesetzt sein. In diesem Fall hat die Einstellung „Speziell für Kinder“ Vorrang.

Filtern von Anzeigeninhalten

Apps können über RequestConfiguration::max_ad_content_rating field eine höchste Altersfreigabe für Anzeigeninhalte für ihre Anzeigenanfragen festlegen. Wenn diese Option konfiguriert ist, haben die zurückgegebenen AdMob-Anzeigen eine Altersfreigabe, die dieser Stufe entspricht oder darunter liegt. Die möglichen Werte dafür basieren auf den 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 Apps eine Anzeige anfordern, können sie 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();