Targeting

Mit dem Targeting können Sie Google Mobile Ads SDK for React Native Kontext- und Zielgruppeninformationen zur Verfügung stellen, damit Ihren Nutzern relevante Anzeigen präsentiert werden.

Sie können das Targeting auf den folgenden Ebenen konfigurieren:

  • Globale Anfragekonfiguration: Sie können Einstellungen für alle Anzeigenanfragen in Ihrer App festlegen, einschließlich der Alterskennzeichnung für Kinder und Jugendliche, der höchsten Altersfreigabe für Anzeigeninhalte, der Datenschutzeinstellungen für Publisher und der Testgeräte-IDs.
  • Targeting pro Anfrage: Sie können einzelne Anzeigenanfragen mithilfe von Anzeigenanfrageobjekten anpassen, einschließlich Content-URLs und Netzwerk-Extras.

In diesem Leitfaden wird erläutert, wie Sie Targeting-Informationen für Google Mobile Ads SDK for React Native bereitstellen.

Vorbereitung

Bevor Sie fortfahren, richten Sie Google Mobile Ads SDK for React Native ein.

Anfragekonfiguration festlegen

Das Objekt RequestConfiguration erfasst Targeting-Informationen, die global auf jede Anzeigenanfrage angewendet werden.

Wenn Sie die Targeting-Einstellungen aus Ihrer ersten Anzeigenanfrage anwenden möchten, legen Sie das Attribut requestConfiguration fest, wenn Sie die Methode initialize aufrufen:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

Ersetzen Sie TEST_DEVICE_HASHED_ID durch eine gehashte Testgeräte-ID. Diese ID gibt ein Gerät an, auf dem Testanzeigen ausgeliefert werden sollen.

Wenn Sie die Targeting-Einstellungen nach der Initialisierung von Google Mobile Ads SDK for React Native aktualisieren möchten, rufen Sie die Methode setRequestConfiguration auf. Mit der Methode setRequestConfiguration wird eine vorhandene Konfiguration ersetzt. Sie wird bei nachfolgenden Anzeigenanfragen wirksam.

Im folgenden Beispiel wird ein RequestConfiguration-Objekt mit aktualisierten Targeting-Einstellungen überarbeitet und die Einstellungen werden auf Anzeigenanfragen angewendet:

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

Alterskennzeichnung festlegen

Damit Sie die Einhaltung der geltenden Datenschutzbestimmungen für Kinder und Jugendliche besser verwalten können, bietet Google Mobile Ads SDK for React Native eine Einstellung für die Altersbehandlung. Mit der Einstellung für die Alterskennzeichnung können Sie angeben, ob Google Mobile Ads SDK for React Native bestimmte Schutzmaßnahmen für die Anzeigenbereitstellung für Kinder, Jugendliche oder ein nicht angegebenes Alter anwenden soll.

Sie können die Alterskennzeichnung mit dem Attribut ageRestrictedTreatment in RequestConfiguration festlegen.

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen eine Alterskennzeichnung für Kinder erhalten sollen:

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

Wenn Sie die Behandlung als Inhalt für Teenager oder ein nicht angegebenes Alter festlegen möchten, ersetzen Sie die Einstellung AgeRestrictedTreatment.CHILD durch Folgendes:

Wenn Sie diese Einstellung verwenden, fügt Google Mobile Ads SDK for React Native den Parameter tfat in Anzeigenanfragen ein. Lassen Sie sich von Ihrem Rechtsbeistand beraten, um das Mindestalter für Ihre Nutzerinnen und Nutzer basierend auf Ihren rechtlichen und regulatorischen Verpflichtungen festzulegen. Weitere Informationen finden Sie unter Anzeigenanfragen aus Apps als Inhalte mit Altersbeschränkung kennzeichnen.

Anzeigeninhalt filtern

Mit der höchsten Altersfreigabe für Anzeigeninhalte können Sie steuern, welche Inhalte Nutzern in Anzeigen präsentiert werden. Diese Einstellung hilft Ihnen, die Plattformrichtlinien einzuhalten.

Sie können die höchste Altersfreigabe für Anzeigeninhalte für Anzeigenanfragen in Ihrer App mit der Property maxAdContentRating des Objekts RequestConfiguration festlegen. Nachdem Sie diese Einstellung konfiguriert haben, haben die zurückgegebenen Anzeigen eine Altersfreigabe, die dieser Altersfreigabe entspricht oder niedriger ist. Die möglichen Werte für diese Einstellung basieren auf Klassifizierungen von Labels für digitale Inhalte und müssen eine der folgenden Konstanten sein:

Im folgenden Beispiel wird ein RequestConfiguration-Objekt konfiguriert, um anzugeben, dass der zurückgegebene Anzeigeninhalt einer Bezeichnung für digitale Inhalte entsprechen soll, die nicht höher als die Konstante G ist:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

Entsprechende Details finden Sie hier:

Optional: PPT API (Beta) festlegen

Über die Publisher Privacy Treatment API (PPT API) können Sie angeben, ob personalisierte Anzeigen für alle Anzeigenanfragen deaktiviert werden sollen. Verwenden Sie dazu die Property publisherPrivacyPersonalizationState im Objekt RequestConfiguration. Wenn Sie diese Funktion verwenden, fügt Google Mobile Ads SDK for React Native für den Rest der Sitzung in alle Anzeigenanfragen einen PPT-Parameter (Publisher Privacy Treatment) ein.

Standardmäßig werden bei Anzeigenanfragen an Google personalisierte Anzeigen ausgeliefert. Im folgenden Beispiel wird die Personalisierung von Anzeigen für alle Anzeigenanfragen deaktiviert:

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

Legen Sie das AdRequest-Objekt fest.

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

Im Gegensatz zur globalen Konfiguration, die mit der Methode setRequestConfiguration festgelegt wird, wird das Objekt AdRequest an die Methode load einer Anzeigenformatklasse übergeben, z. B. InterstitialAd.load für Interstitial-Anzeigen oder BannerAd.load für Banneranzeigen.

Netzwerk-Extras hinzufügen

Wenn Sie netzwerkspezifische Parameter an Google Mobile Ads SDK for React Native übergeben möchten, z. B. Parameter für minimierbare Anzeigen, verwenden Sie das Attribut extras.

Im folgenden Beispiel wird ein zusätzlicher Parameterschlüssel collapsible mit dem Wert bottom festgelegt:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

Inhalts-URL angeben

Wenn Sie eine Content-URL für Anzeigen mit inhaltsbezogenem Targeting und Markensicherheit angeben möchten, fügen Sie die Property contentUrl hinzu:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

Die Content-URL darf maximal 512 Zeichen lang sein.