Ausrichtung

In dieser Anleitung wird erläutert, wie Sie einer Anzeigenanfrage Targeting-Informationen hinzufügen.

Vorbereitung

Führen Sie die Schritte unter Erste Schritte aus.

`RequestConfiguration`

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

Wenn Sie die Anfragekonfiguration aktualisieren möchten, rufen Sie zuerst die aktuelle Konfiguration ab, nehmen Sie die gewünschten Änderungen vor und legen Sie sie wie folgt 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 die Einstellung „Tag für Inhalte für Kinder“. Wenn Sie dieses Tag festlegen, bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Sie sind sich bewusst, dass der 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 klassifizieren soll, deaktivieren wir interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage.

Die Einstellung kann konfiguriert werden, indem Sie dem Mitglied tag_for_child_directed_treatment der Struktur RequestConfiguration einen der folgenden aufgezählten Werte zuweisen:

Weisen Sie RequestConfiguration::tag_for_child_directed_treatment den Wert RequestConfiguration::kChildDirectedTreatmentTrue zu, um anzugeben, dass Ihre Inhalte im Hinblick auf COPPA als Inhalte für Kinder behandelt werden sollen.
Weisen Sie RequestConfiguration::tag_for_child_directed_treatment den Wert RequestConfiguration::kChildDirectedTreatmentFalse zu, um anzugeben, dass Ihre Inhalte im Hinblick auf COPPA nicht als Inhalte für Kinder behandelt 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 im Hinblick auf COPPA als Inhalte für Kinder 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);

Wenn Sie dieses Tag festlegen, bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Sie sind sich bewusst, dass der Missbrauch dieser Einstellung zur Kündigung Ihres Google-Kontos führen kann.

Nutzer unter dem gültigen Mindestalter

Sie können Ihre Anzeigenanfragen für die 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. Möglicherweise gelten für Sie im Rahmen der DSGVO noch weitere rechtliche Verpflichtungen. Lesen Sie die EU-Richtlinien und wenden Sie sich gegebenenfalls an Ihren Rechtsberater. Die Tools von Google sollen die Einhaltung der DSGVO erleichtern, entbinden Publisher aber nicht von ihren rechtlichen Verpflichtungen. Weitere Informationen zu den Auswirkungen der DSGVO auf Publisher.

Bei Verwendung dieser Funktion wird der Parameter „Tag For Users under the Age of Consent in Europe“ (TFUA, „Tag für Nutzer unter dem gültigen Mindestalter in Europa“) 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 von Drittanbietern.

Wie bei den Einstellungen für Inhalte für Kinder gibt es in `RequestConfiguration` ein Mitglied zum Konfigurieren des TFUA-Parameters: tag_for_under_age_of_consent. Es kann mit den folgenden aufgezählten Werten 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 verarbeitet 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) unter dem gültigen Mindestalter verarbeitet werden soll.
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 verarbeitet 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 für Inhalte für Kinder und für Nutzer unter dem gültigen Mindestalter sollten nicht gleichzeitig auf „true“ gesetzt werden. Sollte dies der Fall sein, hat die Einstellung für Inhalte für Kinder Vorrang.

Filterung von Anzeigeninhalten

Apps können über das RequestConfiguration::max_ad_content_rating field eine höchste Altersfreigabe für Anzeigeninhalte für ihre Anzeigenanfragen festlegen. Die AdMob-Anzeigen, die zurückgegeben werden, wenn diese Einstellung konfiguriert ist, haben eine Altersfreigabe, die dieser Stufe entspricht oder darunter liegt. Die möglichen Werte basieren auf den Klassifizierungen von Inhaltslabels für digitale Inhalte und müssen einer der folgenden Aufzählungswerte sein:

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

Der folgende Code konfiguriert eine RequestConfiguration-Struktur, um anzugeben, dass die zurückgegebenen Anzeigeninhalte einer Bezeichnung für digitale Inhaltslabel entsprechen müssen, 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 der Inhalte übergeben, die sie bereitstellen. So kann das Keyword-Targeting die Anzeige mit den Inhalten abgleichen.

Wenn Ihre App beispielsweise eine Anzeige anfordert, während Inhalte von https://www.example.com angezeigt werden, können Sie diese URL übergeben, um relevante Keywords zu targeten:

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

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