Ausrichtung

In diesem Leitfaden erfahren Sie, wie Sie Targeting-Informationen in Anzeigenanfragen angeben.

Voraussetzungen

RequestConfiguration

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

Um die Anfragekonfiguration zu aktualisieren, rufen Sie zuerst die aktuelle Konfiguration ab, führen Sie die gewünschten Aktualisierungen durch 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

Für die Zwecke 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 die Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Ihnen ist bewusst, dass der Missbrauch dieser Einstellung zur Kündigung Ihres Google-Kontos führen kann.

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 Ihren Inhalt als auf Kinder ausgerichtet behandeln soll, ergreifen wir entsprechende Maßnahmen, um IBA- und Remarketing-Anzeigen zu deaktivieren.

Sie können diese Einstellung konfigurieren, indem Sie dem tag_for_child_directed_treatment-Mitglied der Struktur RequestConfiguration einen der folgenden Aufzählungswerte zuweisen:

  • Weisen Sie RequestConfiguration::kChildDirectedTreatmentTrue zu RequestConfiguration::tag_for_child_directed_treatment, um anzugeben, dass Ihre Inhalte im Sinne des COPPA als auf Kinder ausgerichtet behandelt werden sollen.
  • Weisen Sie RequestConfiguration::kChildDirectedTreatmentFalse zu RequestConfiguration::tag_for_child_directed_treatment, um anzugeben, dass Ihre Inhalte nicht als Inhalte für Kinder im Sinne des COPPA behandelt werden sollen.
  • Weisen Sie RequestConfiguration::tag_for_child_directed_treatment zu RequestConfiguration::kChildDirectedTreatmentUnspecified, wenn Sie nicht angeben möchten, wie Ihre Inhalte in Bezug auf COPPA in Anzeigenanfragen behandelt werden sollen.

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);

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. 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 Nutzer im Europäischen Wirtschaftsraum (EWR) kennzeichnen, die das gültige Mindestalter noch nicht erreicht haben. Diese Funktion soll dazu beitragen, die Einhaltung der EU-Datenschutz-Grundverordnung (DSGVO) zu erleichtern. Unter Umständen gelten für Sie im Rahmen der DSGVO weitere rechtliche Verpflichtungen. Lesen Sie die Richtlinien der Europäischen Union und wenden Sie sich an Ihren Rechtsbeistand. Bitte beachten Sie, dass die Tools von Google dazu konzipiert sind, die Einhaltung der Vorgaben zu erleichtern und keinen bestimmten Publisher von seinen gesetzlichen Verpflichtungen zu trennen. Weitere Informationen zu den Auswirkungen der DSGVO auf Publisher

Wenn Sie diese Funktion verwenden, wird der Parameter „Tag For Users Users with Age of Consent in Europe“ (TFUA) 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.

Wie bei Einstellungen, die sich an Kinder richten, gibt es in RequestConfiguration ein Mitglied, das den TFUA-Parameter konfiguriert: tag_for_under_age_of_consent. Dieser kann mit den folgenden Aufzählungswerten konfiguriert werden:

  • Weisen Sie RequestConfiguration::tag_for_under_age_of_consent RequestConfiguration::kUnderAgeOfConsentTrue zu, um anzugeben, dass die Anzeigenanfrage Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeiten soll, die das gültige Mindestalter noch nicht erreicht haben.
  • Weisen Sie RequestConfiguration::tag_for_under_age_of_consent RequestConfiguration::kUnderAgeOfConsentFalse zu, um anzugeben, dass die Anzeigenanfrage keine Behandlungen für Nutzer im Europäischen Wirtschaftsraum (EWR) vornehmen 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 Nutzer im Europäischen Wirtschaftsraum (EWR) minderjährig sein soll.

Das folgende Beispiel zeigt, 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, um die Einstellung für Inhalte, die an Kinder gerichtet sind, zu aktivieren, und Nutzer, die das gültige Mindestalter noch nicht erreicht haben, sollten nicht gleichzeitig auf „wahr“ gesetzt werden. Ist dies der Fall, hat die auf Kinder ausgerichtete Einstellung Vorrang.

Anzeigeninhalte filtern

Apps können über RequestConfiguration::max_ad_content_rating field eine höchste Altersfreigabe für Anzeigeninhalte für ihre Anzeigenanfragen festlegen. AdMob-Anzeigen, die zurückgegeben werden, wenn sie konfiguriert sind, haben eine Altersfreigabe, die der festgelegten Ebene entspricht oder darunter liegt. Die möglichen Werte hierfür basieren auf Klassifizierungen von digitalen Inhalten und müssen einer der folgenden Aufzählungswerte sein:

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

Mit dem folgenden Code wird die Struktur RequestConfiguration konfiguriert, um anzugeben, dass der zurückgegebene Anzeigeninhalt der Kennzeichnung 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 AdRequest-Objekt erfasst Targeting-Informationen, die mit einer Anzeigenanfrage gesendet werden sollen.

Inhalts-URL

Bei der Anforderung einer Anzeige kann die URL übergeben werden, über die die Apps bereitgestellt werden. Das Keyword-Targeting kann so die Anzeige auf den Content abstimmen.

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