Ciblage

Ce guide explique comment fournir des informations de ciblage au SDK Google Mobile Ads.

Télécharger la démo de l'API

Conditions préalables

Avant de continuer, configurez Google Mobile Ads SDK (Legacy).

RequestConfiguration

RequestConfiguration collecte les informations de ciblage appliquées globalement à chaque demande d'annonce. Pour connaître les tags de ciblage disponibles, consultez la documentation sur RequestConfiguration.Builder.

Pour mettre à jour la configuration de la requête, obtenez un compilateur à partir de la configuration existante, effectuez les mises à jour sélectionnées et définissez-le comme suit :

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Pour vous assurer que toutes les demandes d'annonces appliquent les modifications de configuration de la demande, définissez la configuration de la demande avant d'initialiser Google Mobile Ads SDK (Legacy).

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 (Legacy) 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 (Legacy) 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 en fonction de l'âge avec la méthode setAgeRestrictedTreatment() de l'API RequestConfiguration.Builder.

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

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Pour indiquer un traitement adapté aux adolescents ou un traitement non spécifié, remplacez le paramètre CHILD par ce qui suit :

• TEEN
• UNSPECIFIED

Lorsque vous utilisez ce paramètre, Google Mobile Ads SDK (Legacy) 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.

Migrer vers le traitement selon l'âge à partir de TFCD et TFUA

Le paramètre de traitement en fonction de l'âge remplace les paramètres obsolètes .setTagForChildDirectedTreatment() (TFCD) et .setTagForUnderAgeOfConsent() (TFUA).

Le tableau suivant présente les paramètres TFCD et TFUA, ainsi que leurs équivalents en termes de traitement en fonction de l'âge :

Comprendre les interactions entre le traitement selon l'âge et les tags TFCD et TFUA

Si vous définissez le paramètre de traitement en fonction de l'âge, et les paramètres TFCD (tag pour un traitement adapté aux contenus destinés aux enfants) ou TFUA (tag pour les utilisateurs qui n'ont pas l'âge minimal requis), Google applique le traitement le plus prudent.

Transférer le traitement selon l'âge avec la médiation AdMob

Si vous définissez le traitement selon l'âge à l'aide de Google Mobile Ads SDK (Legacy), les adaptateurs de médiation transmettent le signal de traitement selon l'âge aux SDK tiers médiés.

Le tableau suivant liste les versions d'adaptateurs de médiation compatibles avec le transfert du signal de traitement réservé aux adultes au SDK tiers de médiation :

Paramètre "Contenu conçu pour les enfants"

Aux fins de la loi COPPA (Children's Online Privacy Protection Act), il existe un paramètre appelé "Balise pour un traitement adapté aux contenus destinés aux enfants". En définissant cette balise, vous certifiez que cette notification est exacte et que vous êtes autorisé à agir pour le compte du propriétaire de l'application. Vous comprenez qu'une utilisation abusive de ce paramètre pourrait entraîner la résiliation de votre compte Google.

En tant que développeur d'applications, vous pouvez indiquer à Google que vous souhaitez que votre contenu soit considéré comme destiné aux enfants lorsque vous envoyez une demande d'annonce. Si vous indiquez à Google que vous souhaitez que votre contenu soit considéré comme destiné aux enfants, nous prendrons les mesures nécessaires pour désactiver la publicité ciblée par centres d'intérêt et les annonces de remarketing pour la demande d'annonce concernée.

Vous pouvez appliquer le paramètre "Contenu conçu pour les enfants" via setTagForChildDirectedTreatment() :

• Appelez setTagForChildDirectedTreatment avec TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE pour indiquer que vous souhaitez que votre contenu soit traité comme étant destiné aux enfants, conformément à la loi COPPA. Cela empêche la transmission de l'identifiant publicitaire Android (AAID).

• Appelez setTagForChildDirectedTreatment avec TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE pour indiquer que vous ne souhaitez pas que votre contenu soit traité comme étant destiné aux enfants conformément à la loi COPPA.

• Appelez setTagForChildDirectedTreatment avec TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED si vous ne souhaitez pas indiquer comment vous voulez que votre contenu soit traité conformément à la loi COPPA dans les demandes d'annonces.

L'exemple suivant indique que vous souhaitez que votre contenu soit traité comme étant destiné aux enfants, conformément à la loi COPPA :

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForChildDirectedTreatment(
            RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Utilisateurs n'ayant pas atteint l'âge minimal requis

Vous pouvez marquer vos demandes d'annonces à l'aide du tag TFUA. Elles feront ainsi l'objet d'un traitement restreint des données pour les utilisateurs n'ayant pas atteint l'âge minimal requis dans l'Espace économique européen (EEE). Cette option vise à vous aider à respecter le Règlement général sur la protection des données (RGPD). D'autres obligations légales peuvent s'appliquer en vertu du RGPD. Consultez les directives de l'Union européenne et adressez-vous à votre conseiller juridique. Les outils Google sont conçus pour faciliter la mise en conformité et ne dispensent aucun éditeur de ses obligations envers la loi. En savoir plus sur l'impact du RGPD sur les éditeurs

Lorsque vous utilisez cette option, un paramètre TFUA (Tag For Users under the Age of Consent in Europe, tag pour les utilisateurs n'ayant pas atteint l'âge minimal requis en Europe) est inclus dans la demande d'annonce. Il désactive la publicité personnalisée, y compris le remarketing, pour toutes les demandes d'annonces. Il désactive également les demandes adressées aux fournisseurs d'annonces tiers (les pixels de mesure des performances des annonces et les ad servers tiers, par exemple).

Comme pour les paramètres de contenu conçu pour les enfants, il existe une méthode dans RequestConfiguration.Builder pour définir le paramètre TFUA : setTagForUnderAgeOfConsent(), avec les options suivantes.

• Appelez setTagForUnderAgeOfConsent() avec TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE pour indiquer que vous souhaitez que la demande d'annonce soit traitée pour les utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis. Cela empêche également la transmission de l'identifiant publicitaire Android (AAID).

• Appelez setTagForUnderAgeOfConsent() avec TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE pour indiquer que vous ne souhaitez pas que la demande d'annonce soit traitée pour les utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis.

• Appelez setTagForUnderAgeOfConsent() avec TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED pour indiquer que vous n'avez pas spécifié si la demande d'annonce doit être traitée pour les utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis.

L'exemple suivant indique que vous souhaitez inclure la balise TFUA dans vos demandes d'annonces :

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Les balises permettant d'activer le paramètre "Contenu conçu pour les enfants" et setTagForUnderAgeOfConsent() ne doivent pas être définies simultanément sur true. Si tel est le cas, le paramètre "Contenu conçu pour les enfants" est prioritaire.

Filtrage du contenu des annonces

Pour respecter les Règles relatives aux annonces inappropriées de Google Play, qui incluent les offres associées dans une annonce, toutes les annonces et leurs offres associées diffusées dans votre application doivent être adaptées à la classification du contenu de votre application, même si le contenu en lui-même est par ailleurs conforme aux règles de Google Play.

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

Les applications peuvent définir une classification maximale du contenu des annonces pour leurs demandes d'annonces à l'aide de la méthode setMaxAdContentRating. Les annonces AdMob renvoyées lorsque cette option est configurée ont une classification de contenu égale ou inférieure à ce niveau. Les valeurs possibles pour cet extra du réseau sont basées sur les classifications des libellés de contenu numérique et doivent correspondre à l'une des chaînes suivantes :

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

Le code 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 G :

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Pour en savoir plus :

• Définir la classification maximale du contenu pour chaque demande d'annonce

• Définir la classification maximale du contenu des annonces pour une application ou un compte

Traitement de la confidentialité pour les éditeurs (bêta)

L'API Publisher Privacy Treatment (PPT) est un outil facultatif qui permet aux applications d'indiquer si la personnalisation des annonces doit être désactivée pour toutes les demandes d'annonces à l'aide de la méthode setPublisherPrivacyPersonalizationState(). Lorsque vous utilisez cette fonctionnalité, un paramètre de traitement de la confidentialité pour les éditeurs (PPT) est inclus dans toutes les futures demandes d'annonces pour le reste de la session.

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

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setPublisherPrivacyPersonalizationState(
            RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Demande d'annonce

L'objet AdRequest collecte les informations de ciblage à envoyer avec une demande d'annonce.

Ajouter des extras du réseau

Les extras du réseau sont des détails supplémentaires envoyés avec une demande d'annonce et spécifiques à une seule source d'annonce.

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

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)
AdRequestSnippets.kt

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);
AdRequestSnippets.java