Ausrichtung

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

Voraussetzungen

RequestConfiguration

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

Wenn Sie die Anfragekonfiguration aktualisieren möchten, rufen Sie zuerst die aktuelle Konfiguration ab, führen Sie alle gewünschten Aktualisierungen durch und legen Sie diese 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 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 for Child Treaty“. Durch Festlegen dieses Tags bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des App-Inhabers zu handeln. Sie nehmen zur Kenntnis, 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 einstufen soll. Wenn Sie angeben, dass Google Ihre Inhalte als auf Kinder ausgerichtet einstufen soll, deaktivieren wir die interessenbezogene Werbung 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::kChildDirectedTreatmentTrue RequestConfiguration::tag_for_child_directed_treatment zu, um anzugeben, dass Ihre Inhalte gemäß COPPA als auf Kinder ausgerichtet behandelt werden sollen.
  • Weisen Sie RequestConfiguration::kChildDirectedTreatmentFalse RequestConfiguration::tag_for_child_directed_treatment zu, um anzugeben, dass Sie nicht möchten, dass Ihre Inhalte im Sinne der COPPA-Anforderungen als auf Kinder ausgerichtet behandelt werden.
  • Weisen Sie RequestConfiguration::kChildDirectedTreatmentUnspecified den Wert RequestConfiguration::tag_for_child_directed_treatment zu, wenn Sie nicht angeben möchten, wie Ihr Inhalt in Anzeigenanfragen in Bezug auf COPPA behandelt werden soll.

Im folgenden Beispiel möchten Sie, dass Ihre Inhalte im Sinne der COPPA-Bestimmungen als auf Kinder ausgerichtet behandelt werden:

  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 Namen des App-Inhabers zu handeln. Ihnen ist bewusst, dass der Missbrauch dieser Einstellung zur Kündigung Ihres Google-Kontos führen kann.

Sie können Ihre Anzeigenanfragen zur Verarbeitung für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) 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. Bitte lesen Sie sich die Richtlinien der Europäischen Union durch und wenden Sie sich gegebenenfalls an Ihren Rechtsbeistand. Die Tools von Google sollen Ihnen die Einhaltung gesetzlicher Bestimmungen erleichtern und entbinden einen bestimmten Publisher nicht von seinen gesetzlichen Verpflichtungen. Weitere Informationen zu den Auswirkungen der DSGVO auf Publisher

Wenn Sie diese Funktion verwenden, wird der Parameter „Tag für minderjährige Nutzer in Europa“ (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, z. B. Tracking-Pixel und Ad-Server eines Drittanbieters, deaktiviert.

Wie bei Einstellungen für Kinder gibt es in RequestConfiguration ein Mitglied zum Konfigurieren des TFUA-Parameters tag_for_under_age_of_consent, der mit den folgenden Aufzählungswerten konfiguriert werden kann:

  • Weisen Sie RequestConfiguration::kUnderAgeOfConsentTrue RequestConfiguration::tag_for_under_age_of_consent zu, um anzugeben, dass die Anzeigenanfrage für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll.
  • Weisen Sie RequestConfiguration::kUnderAgeOfConsentFalse RequestConfiguration::tag_for_under_age_of_consent zu, um anzugeben, dass die Anzeigenanfrage nicht für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll.
  • Weisen Sie RequestConfiguration::kUnderAgeOfConsentUnspecified RequestConfiguration::tag_for_under_age_of_consent zu, um anzugeben, dass Sie nicht angegeben haben, ob die Anzeigenanfrage für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll.

Im folgenden Beispiel soll TFUA in Ihre Anzeigenanfragen aufgenommen werden:

  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, mit denen die Einstellung "Auf Kinder ausgerichtet" und "Nutzer, die das gültige Mindestalter noch nicht erreicht haben" aktiviert werden, sollten nicht gleichzeitig auf "true" gesetzt sein. Ist dies der Fall, hat die Einstellung für Inhalte, die auf Kinder ausgerichtet ist, Vorrang.

Filterung von Anzeigeninhalten

Apps können über die RequestConfiguration::max_ad_content_rating field eine höchste Altersfreigabe für Anzeigeninhalte für ihre Anzeigenanfragen festlegen. AdMob-Anzeigen, die bei entsprechender Konfiguration zurückgegeben werden, haben eine Altersfreigabe, die der entsprechenden Altersfreigabe entspricht oder darunter liegt. Die möglichen Werte basieren auf den Klassifizierungen von 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, um anzugeben, dass der zurückgegebene Anzeigeninhalt einer Label-Kennzeichnung für digitale Inhalte entsprechen muss, 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

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

Inhalts-URL

Wenn eine Anzeige angefragt wird, können Apps die URL des bereitgestellten Inhalts übergeben. Dies ermöglicht das Keyword-Targeting, um die Anzeige an den Inhalt anzupassen.

Wenn Ihre App beispielsweise eine Anzeige anfordert, während Inhalte aus https://www.example.com zu sehen sind, können Sie diese URL übergeben, um die Kampagne 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();