Ciblage

Ce guide explique comment fournir des informations de ciblage dans une demande d'annonce. Pour obtenir un exemple fonctionnel, téléchargez l'application de démonstration de l'API Android.

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

Prérequis

• Suivez le guide de démarrage.

RequestConfiguration

RequestConfiguration est un objet qui collecte des informations de ciblage à appliquer à l'échelle mondiale via une méthode statique MobileAds.

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

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Paramètre destiné aux enfants

Dans le cadre 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 au nom du propriétaire de l'application. Vous comprenez qu'une utilisation abusive de ce paramètre peut entraîner la clôture 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 du contenu destiné aux enfants lorsque vous envoyez une demande d'annonce. Si vous indiquez à Google que vous souhaitez que votre contenu soit considéré comme étant destiné aux enfants, nous prenons des mesures pour désactiver la publicité ciblée par centres d'intérêt et les annonces de remarketing pour cette demande d'annonce.

Ce paramètre peut être utilisé avec toutes les versions du SDK des services Google Play via RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

• Appelez setTagForChildDirectedTreatment avec TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE pour indiquer que vous souhaitez que votre contenu soit considéré comme étant destiné aux enfants conformément aux dispositions 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 considéré comme du contenu 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é conformément à la loi COPPA dans les demandes d'annonces.

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

Java

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

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Remarque :Pour les applications du programme Pour la famille sous la catégorie Applications en priorité pour les enfants et les utilisateurs connectés à des comptes Google gérés avec Family Link, tous les contenus sont automatiquement traités comme destinés aux enfants pour toutes les demandes d'annonces.

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

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é est conçue pour vous aider à respecter le Règlement général sur la protection des données (RGPD). Notez que vous avez peut-être d'autres obligations légales dans le cadre du RGPD. Consultez les directives de l'Union européenne et consultez votre conseiller juridique. Notez que les outils Google sont conçus pour faciliter la 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 fonctionnalité, un paramètre "Tag pour les utilisateurs n'ayant pas atteint l'âge de consentement en Europe" (TFUA) 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, tels que les pixels de mesure des performances des annonces et les ad servers tiers.

Comme pour les paramètres destinés aux enfants, il existe une méthode dans RequestConfiguration.Builder permettant de 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 souhaitez que la demande d'annonce ne soit pas 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 TFUA dans vos demandes d'annonces:

Java

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

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

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

Filtrage du contenu des annonces

Conformément aux Règles relatives aux annonces inappropriées de Google Play, qui incluent les offres associées dans une annonce, toutes les annonces et les offres associées qui s'affichent dans votre application doivent être adaptées à la classification du contenu de votre application, même si le contenu en lui-même est conforme aux autres règles de Google Play.

Des outils tels que 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 affichées avec cette configuration ont une classification du contenu égale ou inférieure à ce niveau. Les valeurs possibles de cet extra de réseau sont basées sur des classifications de 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 d'annonce renvoyé doit correspondre à un libellé de contenu numérique inférieur à G:

Java

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

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Consultez les articles suivants :

• 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 dans le SDK Google Mobile Ads remplacent ceux configurés à l'aide de l' Ad Manager UI.

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

Le Publisher Privacy Treatment 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é de l'éditeur (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 reçoivent des annonces personnalisées. Le code suivant désactive la personnalisation des annonces pour toutes les demandes d'annonces:

Java

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

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Remarque :Pour les demandes d'annonces comportant plusieurs signaux de confidentialité utilisateur, le signal le plus restrictif est prioritaire. Consultez la documentation de l' API Publisher Privacy Treatment pour obtenir des exemples spécifiques.

Demande d'annonce

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

Ciblage personnalisé

Vous pouvez transmettre des paires clé-valeur personnalisées aux campagnes (éléments de campagne) Google Ad Manager cibles via AdManagerAdRequest.Builder.addCustomTargeting():

Java

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

Kotlin

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

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

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

Consultez l'exemple de ciblage personnalisé Ad Manager pour découvrir une implémentation du 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 requête à l'aide de la méthode addCategoryExclusion() fournie par AdManagerAdRequest.Builder:

Java

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

Kotlin

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

Consultez l'exemple d'exclusions de catégories Ad Manager pour une implémentation 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 appareils.

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:

Java

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

Kotlin

var adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

Consultez l'exemple de PPID Ad Manager pour une implémentation des 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 en tant que signaux fournis par l'éditeur (PPS) dans les demandes d'annonces. Avec les PPS, vous pouvez 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 par 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).

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", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

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

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 = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

URL de contenu

Afin de fournir une URL de contenu pour les annonces ciblées sur le contenu et la brand safety, vous pouvez appeler setContentUrl() lors de la création d'un AdManagerAdRequest:

Java

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

Kotlin

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

Brand safety (bêta)

Remarque :Les URL de contenus multiples sont disponibles en version bêta fermée pour un nombre limité d'éditeurs.

Les applications qui affichent du contenu dynamique destiné à des audiences différentes peuvent fournir une courte liste d'URL à l'aide de la méthode setNeighboringContentUrls() lors de la création d'un AdManagerAdRequest:

Java

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

Kotlin

var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
  .setNeighboringContentUrls(urls)
  .build()

.setNeighboringContentUrls() diffère de .setContentUrl() en ce sens 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és.