Ciblage

Le ciblage vous permet de fournir des informations contextuelles et sur l'audience à Google Mobile Ads SDK for React Native afin de diffuser des annonces pertinentes auprès de vos utilisateurs.

Vous pouvez configurer le ciblage aux niveaux suivants :

  • Configuration globale des demandes : appliquez des paramètres à toutes les demandes d'annonces de votre application, y compris les traitements adaptés aux enfants et aux adolescents, les classifications maximales du contenu des annonces, les traitements de confidentialité des éditeurs et les ID des appareils de test.
  • Ciblage par demande : personnalisez les demandes d'annonces individuelles à l'aide d'objets de demande d'annonce, y compris les URL de contenu et les extras du réseau.

Ce guide explique comment fournir des informations de ciblage à Google Mobile Ads SDK for React Native.

Prérequis

Avant de continuer, configurez Google Mobile Ads SDK for React Native.

Définir la configuration de la requête

L'objet RequestConfiguration collecte les informations de ciblage appliquées de manière globale à chaque demande d'annonce.

Pour appliquer les paramètres de ciblage de votre première demande d'annonce, définissez la propriété requestConfiguration lorsque vous appelez la méthode initialize :

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

Remplacez TEST_DEVICE_HASHED_ID par un ID d'appareil de test haché. Cet ID spécifie un appareil qui doit recevoir des annonces tests.

Pour mettre à jour vos paramètres de ciblage après avoir initialisé Google Mobile Ads SDK for React Native, appelez la méthode setRequestConfiguration. La méthode setRequestConfiguration remplace une configuration existante et prend effet lors des demandes d'annonces ultérieures.

L'exemple suivant modifie un objet RequestConfiguration avec des paramètres de ciblage mis à jour et applique les paramètres aux demandes d'annonces :

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

setRequestConfiguration(requestConfiguration);

Définir le traitement selon l'âge

Pour vous aider à respecter les réglementations applicables sur la confidentialité des données des enfants et des adolescents, Google Mobile Ads SDK for React Native propose un paramètre de traitement selon l'âge. Le paramètre de traitement selon l'âge vous permet d'indiquer si Google Mobile Ads SDK for React Native doit appliquer des protections spécifiques lors de la diffusion d'annonces auprès d'enfants, d'adolescents ou d'utilisateurs d'un âge non spécifié.

Vous pouvez définir le traitement selon l'âge avec la propriété ageRestrictedTreatment sur RequestConfiguration.

L'exemple suivant indique que les demandes d'annonces doivent bénéficier d'un traitement adapté aux enfants :

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

setRequestConfiguration(requestConfiguration);

Pour indiquer un traitement adapté aux adolescents ou un traitement non spécifié en fonction de l'âge, remplacez le paramètre AgeRestrictedTreatment.CHILD par ce qui suit :

Lorsque vous utilisez ce paramètre, Google Mobile Ads SDK for React Native inclut un paramètre tfat dans les demandes d'annonces. Consultez votre conseiller juridique pour déterminer le traitement de l'âge applicable à vos utilisateurs en fonction de vos obligations légales et réglementaires. Pour en savoir plus, consultez Taguer une demande d'annonce d'une application pour un traitement avec restriction d'âge.

Filtrer le contenu des annonces

La classification maximale du contenu des annonces vous permet de contrôler le contenu des annonces diffusées auprès de vos utilisateurs. Vous pouvez définir une classification maximale du contenu pour vous aider à respecter les règles de la plate-forme.

Vous pouvez définir une classification maximale du contenu des annonces pour les demandes d'annonces dans votre application à l'aide de la propriété maxAdContentRating de l'objet RequestConfiguration. Une fois ce paramètre configuré, les annonces renvoyées ont une classification de contenu égale ou inférieure à cette classification. Les valeurs possibles pour ce paramètre sont basées sur les classifications des libellés de contenu numérique et doivent correspondre à l'une des constantes suivantes :

L'exemple suivant configure un objet RequestConfiguration pour spécifier que le contenu de l'annonce renvoyé doit correspondre à une désignation de libellé de contenu numérique ne dépassant pas la constante G :

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

setRequestConfiguration(requestConfiguration);

Pour plus de détails, consultez les pages suivantes :

Facultatif : Définir l'API PPT (bêta)

L'API Publisher Privacy Treatment (PPT) vous permet d'indiquer si vous souhaitez désactiver la personnalisation des annonces pour toutes les demandes d'annonces à l'aide de la propriété publisherPrivacyPersonalizationState de l'objet RequestConfiguration. Lorsque vous utilisez cette fonctionnalité, Google Mobile Ads SDK for React Native inclut un paramètre de traitement de la confidentialité pour les éditeurs (PPT) dans toutes les demandes d'annonces pour le reste de la session.

Par défaut, les demandes d'annonces envoyées à Google diffusent des annonces personnalisées. L'exemple suivant désactive la personnalisation des annonces pour toutes les demandes d'annonces :

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

setRequestConfiguration(requestConfiguration);

Définir l'objet AdRequest

L'objet AdRequest collecte les informations de ciblage envoyées avec une demande d'annonce.

Contrairement à la configuration globale définie avec la méthode setRequestConfiguration, l'objet AdRequest est transmis à la méthode load d'une classe de format d'annonce, par exemple InterstitialAd.load pour les annonces interstitielles ou BannerAd.load pour les bannières.

Ajouter des extras du réseau

Pour transmettre des paramètres spécifiques au réseau à Google Mobile Ads SDK for React Native, tels que des paramètres pour les annonces réductibles, utilisez la propriété extras.

L'exemple suivant définit une clé de paramètre supplémentaire collapsible avec la valeur bottom :

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

Fournissez l'URL d'un contenu

Pour fournir une URL de contenu pour les annonces ciblant du contenu et la brand safety, ajoutez la propriété contentUrl :

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

L'URL du contenu doit comporter 512 caractères maximum.