Ciblage

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

Conditions préalables

Avant de continuer, configurez GMA Next-Gen SDK.

RequestConfiguration

RequestConfiguration collecte les informations de ciblage appliquées globalement à chaque demande d'annonce. Pour obtenir la liste des tags de ciblage disponibles, consultez la RequestConfiguration.Builder documentation.

Créez un objet RequestConfiguration avec les tags de ciblage dont vous avez besoin à l'aide de son compilateur, puis définissez la configuration en appelant MobileAds.setRequestConfiguration().

**Point clé** : L'appel de MobileAds.setRequestConfiguration() remplace toute configuration existante.

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Pour appliquer des tags de ciblage à partir de la première demande d'annonce, fournissez la configuration de la demande lors de l'initialisation du SDK :

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next-Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

Définir le traitement selon l'âge

Pour vous aider à gérer votre conformité avec les réglementations sur la confidentialité applicables aux enfants et aux adolescents, GMA Next-Gen SDK fournit un paramètre de traitement selon l'âge. Ce paramètre vous permet d'indiquer si GMA Next-Gen SDK doit appliquer des protections spécifiques lors de la diffusion d'annonces aux enfants ou aux adolescents. Lorsque vous utilisez ce paramètre, GMA Next-Gen SDK inclut un tfat paramètre dans les demandes d'annonces. Consultez votre conseiller juridique pour déterminer le traitement selon l'âge applicable à vos utilisateurs en fonction de vos obligations légales et réglementaires. Pour en savoir plus, consultez Ajouter un tag à une demande d'annonce d'une application pour un traitement adapté à l'âge.

Vous pouvez définir le traitement selon l'âge avec la setAgeRestrictedTreatment() méthode avec l' RequestConfiguration.Builder API.

Définir le traitement selon l'âge pour les enfants

L'exemple suivant indique que les demandes d'annonces doivent recevoir un traitement pour les enfants :

Kotlin

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

Java

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

Définir le traitement pour les adolescents

L'exemple suivant indique que les demandes d'annonces doivent être traitées comme étant destinées à des adolescents :

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have teenage treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have teenage treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Définir un traitement non spécifique à l'âge

L'exemple suivant indique que les demandes d'annonces ne doivent pas être traitées comme étant destinées à une tranche d'âge spécifique :

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have unspecified age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

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

Le paramètre de traitement selon 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 selon l'âge :

TFCD

TFCD	Traitement selon l'âge
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
Aucune valeur attribuée .setTagForChildDirectedTreatment()	AgeRestrictedTreatment.UNSPECIFIED
Aucun équivalent	AgeRestrictedTreatment.TEEN

TFUA

TFUA	Traitement selon l'âge
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
Aucune valeur attribuée .setTagForUnderAgeOfConsent()	AgeRestrictedTreatment.UNSPECIFIED
Aucun équivalent	AgeRestrictedTreatment.TEEN

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

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

Remarque : Dans le programme Pour la famille , les applications destinées en priorité aux enfants et les utilisateurs connectés à des comptes Google gérés avec Family Link voient automatiquement tous les contenus traités comme étant destinés aux enfants pour toutes les demandes d'annonces.

Paramètre "Contenu destiné aux enfants"

Avertissement : La méthode setTagForChildDirectedTreatment() est obsolète. Utilisez plutôt la méthode setAgeRestrictedTreatment()

.

Aux fins de la Children's Online Privacy Protection Act (COPPA), il existe un paramètre appelé "tag pour un traitement adapté aux contenus destinés aux enfants". En définissant ce tag, vous certifiez que cette notification est exacte et que vous êtes autorisé à agir au nom du propriétaire de l'application. Vous comprenez qu'une utilisation abusive de ce paramètre peut 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 que vous souhaitez que Google traite votre contenu comme étant 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 cette demande d'annonce.

Vous pouvez appliquer le paramètre "Contenu destiné aux 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 aux fins de 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 aux fins de 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é par rapport à 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 aux fins de la loi COPPA :

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Remarque : Dans le programme Pour la famille , les applications destinées en priorité aux enfants et les utilisateurs connectés à des comptes Google gérés avec Family Link voient automatiquement tous les contenus traités comme étant destinés aux enfants pour toutes les demandes d'annonces.

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

Avertissement La méthode setTagForUnderAgeOfConsent() est obsolète. Utilisez plutôt la méthode set the setAgeRestrictedTreatment() method.

Vous pouvez marquer vos demandes d'annonces de sorte qu'elles soient traitées comme étant destinées à des utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge de consentement. Cette fonction vise à vous aider à respecter le Règlement général sur la protection des données (RGPD). Notez que le RGPD peut inclure d'autres obligations légales. Consultez les instructions de l'Union européenne et contactez votre conseiller juridique. Notez que les outils Google sont conçus pour simplifier la conformité et ne dispensent aucun éditeur de ses obligations envers la loi. Découvrez comment le RGPD affecte les éditeurs.

Lorsque vous utilisez cette fonctionnalité, un paramètre TFUA (Tag For Users under the Age of Consent in Europe, balise 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, par exemple pour les pixels de mesure des performances des annonces et les ad servers tiers.

Comme pour les paramètres "Contenu destiné aux 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 comme étant destinée à des utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge de consentement. 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 comme étant destinée à des utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge de consentement.

• 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 comme étant destinée à des utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge de consentement.

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

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Les tags permettant d'activer le paramètre "Contenu destiné aux enfants et setTagForUnderAgeOfConsent() ne doivent pas être définis simultanément sur true. Si tel est le cas, le paramètre "Contenu destiné aux enfants" est prioritaire.

Filtrage du contenu des annonces

Pour respecter le règlement Google Play sur les annonces inappropriées qui inclut 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 setMaxAdContentRating méthode. Les annonces AdMob renvoyées lorsque cette option est configurée ont une classification du contenu égale ou inférieure à ce niveau. Les valeurs possibles pour cet extra de réseau sont basées sur les classifications des libellés de contenu numérique, et doivent être 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 des annonces renvoyé doit correspondre à un libellé de contenu numérique dont la classification n'est pas supérieure à G :

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

Remarque : Les paramètres de filtre de classification du contenu spécifiés via GMA Next-Gen SDK remplacent tous les paramètres configurés à l'aide de l'interface utilisateur AdMob.

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

L' API "Traitement de la confidentialité pour les éditeurs" (PPT) est un outil facultatif qui permet aux applications d'indiquer s'il faut désactiver la personnalisation des annonces pour toutes les demandes d'annonces à l'aide de la setPublisherPrivacyPersonalizationState() méthode. Lorsque vous utilisez cette fonctionnalité, un paramètre de traitement de la confidentialité de l'éditeur (PPT) est inclus dans toutes les demandes d'annonces futures 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 :

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Remarque : Pour les demandes d'annonces comportant plusieurs signaux de confidentialité des utilisateurs, le signal le plus restrictif est prioritaire. Pour obtenir des exemples spécifiques, consultez la documentation de l'API Traitement de la confidentialité pour les éditeurs.

Demande d'annonce

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

Ajouter des extras de réseau

Les extras de réseau sont des informations supplémentaires envoyées avec une demande d'annonce, qui sont spécifiques à une seule source d'annonces.

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

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);