Ciblage

Sélectionnez une plate-forme : Android iOS Unity Flutter

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

Pour obtenir un exemple concret, téléchargez l'application Android API Demo.

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

Conditions préalables

Avant de continuer, configurez Google Mobile Ads SDK.

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, puis définissez-le comme suit :

Kotlin

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

Java

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

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

Définir le traitement selon l'âge

Pour vous aider à respecter les réglementations applicables sur la confidentialité des enfants et des adolescents, Google Mobile Ads SDK propose un paramètre de traitement en fonction de l'âge. Ce paramètre vous permet d'indiquer si Google Mobile Ads SDK doit appliquer des protections spécifiques pour la diffusion d'annonces aux enfants, aux adolescents ou à une tranche d'âge non spécifiée.

Vous pouvez définir le traitement par â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 :

Kotlin

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

Java

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 âge non spécifié, remplacez le paramètre CHILD par les éléments suivants :

• TEEN
• UNSPECIFIED

Lorsque vous utilisez ce paramètre, Google Mobile Ads SDK 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 Ajouter un tag à une demande d'annonce pour un traitement selon l'âge.

Migrer vers le traitement selon l'âge depuis 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 les traitements équivalents en fonction de l'âge :

TFCD

TFCD	Traitement de 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 de 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 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.

Remarque : Les applications du programme Pour la famille en tant qu'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 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 set setAgeRestrictedTreatment().

Aux fins de la loi COPPA (Children's Online Privacy Protection Act), il existe un paramètre appelé "Ajouter une balise pour signaler 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 prenons 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 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 souhaitez que votre contenu soit traité en ce qui concerne la loi COPPA dans les demandes d'annonces.

L'exemple suivant indique que vous souhaitez que votre contenu soit considéré comme destiné aux enfants aux fins de la loi COPPA :

Kotlin

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

Java

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

Remarque : Les applications du programme Pour la famille en tant qu'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 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 setsetAgeRestrictedTreatment().

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 minimal requis. Cette fonctionnalité 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) est inclus dans la demande d'annonce. Ce paramètre 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 destinés 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 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 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 pour les 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 =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

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 destiné aux enfants" et setTagForUnderAgeOfConsent() ne doivent pas être définies 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 de Google Play concernant les annonces inappropriées, qui inclut les offres associées à 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 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 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 des annonces renvoyé doit correspondre à un libellé de contenu numérique dont la désignation n'est pas supérieure à G :

Kotlin

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

Java

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

Découvrez comment définir la classification maximale du contenu pour chaque demande d'annonce.

Remarque : Les paramètres de filtrage de la classification du contenu spécifiés via Google Mobile Ads SDK remplacent tous les paramètres configurés à l'aide de l'UI Ad Manager.

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 s'il faut désactiver la personnalisation des annonces 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 :

Kotlin

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

Java

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

Remarque : Pour les demandes d'annonces comportant plusieurs signaux de confidentialité des utilisateurs, le signal le plus restrictif prévaut. Pour obtenir des exemples spécifiques, consultez la documentation de l'API Publisher Privacy Treatment.

Demande d'annonce

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

Ajouter des extras de chaîne

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

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

Kotlin

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

Java

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

Ciblage personnalisé

Vous pouvez transmettre des paires clé-valeur personnalisées pour cibler des campagnes Google Ad Manager (éléments de campagne). L'exemple suivant transmet une paire clé-valeur personnalisée dans une demande d'annonce :

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build()
AdRequestSnippets.kt

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build();
AdRequestSnippets.java

Vous pouvez transmettre plusieurs valeurs pour une clé sous forme de liste de chaînes. Par exemple, pour cibler les personnes d'une vingtaine d'années plutôt que celles de 25 ans uniquement.

Kotlin

.addCustomTargeting("age", listOf("24", "25", "26"))
AdRequestSnippets.kt

Java

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
AdRequestSnippets.java

Consultez l'exemple de ciblage personnalisé Ad Manager pour découvrir comment implémenter le ciblage personnalisé dans l'application de démonstration de l'API Android.

Exclusions de catégories

Vous pouvez ajouter un niveau d'exclusion de catégorie au niveau de l'emplacement à une demande à l'aide de la méthode addCategoryExclusion() :

Kotlin

// Example: Exclude "automobile" and "boat" categories.
val newRequest =
  AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build()
AdRequestSnippets.kt

Java

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder()
        .addCategoryExclusion("automobile")
        .addCategoryExclusion("boat")
        .build();
AdRequestSnippets.java

Consultez l'exemple d'exclusions de catégories Ad Manager pour découvrir comment implémenter des exclusions de catégories dans l'application de démonstration de l'API Android.

Identifiants fournis par l'éditeur

Vous pouvez définir un identifiant fourni par l'éditeur (PPID) pour la limitation de la fréquence d'exposition, la segmentation et le ciblage de l'audience, la rotation séquentielle des annonces et d'autres commandes de diffusion des annonces en fonction de l'audience sur les différents types d'appareil.

Remarque : Cette fonctionnalité n'est pas disponible pour tous les éditeurs. Pour en savoir plus, consultez À propos des identifiants fournis par l'éditeur.

Voici un exemple de définition du PPID :

Kotlin

val adRequest = AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build()
AdRequestSnippets.kt

Java

AdManagerAdRequest adRequest =
    new AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build();
AdRequestSnippets.java

Consultez l'exemple de PPID Ad Manager pour découvrir comment implémenter les identifiants fournis par l'éditeur (PPID) dans l'application de démonstration de l'API Android.

Signaux fournis par l'éditeur

Vous pouvez envoyer des données d'audience et contextuelles sous forme de signaux fournis par l'éditeur (PPS) dans les demandes d'annonces. Les PPS vous permettent d'utiliser vos données utilisateur pour améliorer la monétisation programmatique en communiquant les caractéristiques de votre audience aux enchérisseurs dans tous les types de transactions, à l'aide de taxonomies standards, sans avoir à partager les identifiants utilisateur. Les caractéristiques de votre audience peuvent inclure des données comportementales et basées sur les centres d'intérêt (Taxonomie d'audience de l'IAB 1.1) et des données contextuelles (Taxonomie de contenu de l'IAB 2.2).

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6, 284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4, 5, 6))

val request =
  AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
AdRequestSnippets.kt

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));

AdManagerAdRequest request =
    new AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
AdRequestSnippets.java

URL de contenu

Pour fournir une URL de contenu pour les annonces ciblées sur le contenu et la brand safety, ajoutez les éléments suivants :

Kotlin

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()
AdRequestSnippets.kt

Java

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();
AdRequestSnippets.java

Brand safety (bêta)

Remarque : Le type "URL de contenu multiples" est en version bêta fermée pour un groupe d'éditeurs sélectionnés.

Les applications qui affichent du contenu dynamique destiné à différentes audiences peuvent fournir une courte liste d'URL :

Kotlin

val urls =
  mutableListOf(
    "https://www.mycontenturl1.com",
    "https://www.mycontenturl2.com",
    "https://www.mycontenturl3.com",
    "https://www.mycontenturl4.com",
  )

val requestWithContent = AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build()
AdRequestSnippets.kt

Java

List<String> urls =
    Arrays.asList(
        "https://www.mycontenturl1.com",
        "https://www.mycontenturl2.com",
        "https://www.mycontenturl3.com",
        "https://www.mycontenturl4.com");

AdManagerAdRequest requestWithContent =
    new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build();
AdRequestSnippets.java

.setNeighboringContentUrls() diffère de .setContentUrl() en ce qu'il n'est utilisé que pour la brand safety.

Remarque setNeighboringContentUrls n'utilise que les quatre premières URL de la liste. Les autres sont ignorées.