Ciblage

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

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

Conditions préalables

• Suivez le guide de démarrage.

RequestConfiguration

RequestConfiguration est un objet qui collecte des informations de ciblage à appliquer au niveau mondial via un MobileAds statique.

Pour mettre à jour la configuration de la requête, obtenez un compilateur à partir de la effectuer les mises à jour souhaitées, puis définissez-les 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

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

En tant que développeur d'applications, vous pouvez indiquer si vous souhaitez que Google traite vos lorsque vous envoyez une demande d'annonce. Si vous indiquez que souhaitez que Google considère votre contenu comme étant destiné aux enfants, nous prenons 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 à RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

• Appeler setTagForChildDirectedTreatment avec TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE pour indiquer que vous souhaitez le contenu traité comme étant destiné aux enfants aux fins de la loi COPPA. Cela permet d'éviter la transmission de l'identifiant publicitaire Android (AAID).

• Appeler setTagForChildDirectedTreatment avec TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE pour indiquer que vous ne souhaitez pas le contenu traité comme étant destiné aux enfants aux fins de la loi COPPA.

• Appeler setTagForChildDirectedTreatment avec TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED si vous ne souhaitez pas préciser la manière dont vous aimeriez 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 destiné aux enfants conformément à 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 :Les applications du programme Pour la famille Programme en tant que Applications destinées en priorité aux enfants et ceux connectés à des comptes Google gérés avec la famille Traitement automatique de tous les contenus dans les liens comme étant destiné 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 aux utilisateurs du domaine suivant : dans l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis. Cette fonctionnalité est visant à vous aider à respecter les Règles générales Règlement sur la protection des données (RGPD). Notez que vous pouvez avoir d'autres en vertu du RGPD. Consulter les directives de l'Union européenne et consulter votre propre conseiller juridique. Notez que les outils Google sont conçus pour faciliter de conformité et ne dispensent aucun éditeur de ses obligations en vertu des la loi. En savoir plus sur l'impact du RGPD sur les éditeurs

Lorsque vous utilisez cette fonctionnalité, une balise pour les utilisateurs n'ayant pas atteint l'âge minimal requis en Europe (TFUA) est inclus dans la demande d'annonce. Ce paramètre désactive de la publicité personnalisée (y compris le remarketing) pour toutes les demandes d'annonces. Il y a aussi désactive les demandes adressées à des fournisseurs d'annonces tiers, comme les pixels de mesure des annonces des ad servers tiers.

Comme pour les contenus destinés aux enfants, il existe une méthode RequestConfiguration.Builder pour définir le paramètre TFUA: setTagForUnderAgeOfConsent(), avec les options suivantes.

• Appeler le 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 situés dans dans l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis. Cette opération empêche la transmission de l'identifiant publicitaire Android (AAID).

• Appeler le 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. n'ayant pas atteint l'âge minimal requis dans l'Espace économique européen (EEE).

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

L'exemple suivant indique que vous souhaitez inclure le tag 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 tous les deux définis sur true en même temps. Si c'est le cas, le paramètre destiné aux contenus destinés aux enfants prévaut.

Filtrage du contenu des annonces

Pour respecter les Règles Google Play relatives aux annonces inappropriées incluant les offres associées dans une annonce, toutes les annonces et leurs Les offres affichées dans votre application doivent être en adéquation avec le contenu note de votre application, même si le contenu en lui-même est conforme aux 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 de vos utilisateurs. Vous pouvez définir la classification maximale du contenu sur pour vous aider à respecter les règles de la plate-forme.

Les applications peuvent définir la classification maximale du contenu des annonces pour leurs demandes d'annonces à l'aide de la setMaxAdContentRating . Lorsque cette option est configurée, les annonces AdMob affichent une classification du contenu égale ou égale à en dessous de ce niveau. Les valeurs possibles de cet extra réseau sont basées sur classification de libellés de contenu numérique, et doit correspondre à l'une des chaînes:

• 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 à une désignation de libellé de contenu numérique non supérieure à 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éfinition de la classification maximale du contenu pour chaque annonce demande

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

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

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

La Traitement de la confidentialité des éditeurs L'API (PPT) est un outil facultatif qui permet aux applications d'indiquer s'il faut désactiver les annonces pour toutes les demandes d'annonces setPublisherPrivacyPersonalizationState(). Lorsque vous utilisez cette fonctionnalité, un paramètre de traitement de la confidentialité de l'éditeur (PPT) est seront incluses dans toutes les futures demandes d'annonces jusqu'à la fin de la session.

Par défaut, les demandes d'annonces envoyées à Google reçoivent des annonces personnalisées. Les éléments suivants : 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 paramètre le plus restrictif est prioritaire. Consultez le API Publisher Privacy Treatment pour obtenir des exemples spécifiques.

Demande d'annonce

L'objet AdManagerAdRequest collecte le ciblage à envoyer avec une demande d'annonce.

Ciblage personnalisé

Vous pouvez transmettre des paires clé-valeur personnalisées pour cibler des campagnes Google Ad Manager (ligne ) à 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, pour cibler les personnes d'une vingtaine d'années et non plus seulement les 25 ans.

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

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égories au niveau de l'espace publicitaire à une demande à 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'exclusion de catégories dans Ad Manager. pour découvrir l'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) à utiliser pour la limitation de la fréquence d'exposition, la segmentation et le ciblage de l'audience, la rotation séquentielle des annonces des commandes de diffusion d'annonces basées sur l'audience sur les différents appareils.

Remarque :Cette fonctionnalité n'est pas disponible pour tous les éditeurs. Reportez-vous à la section À propos de l'éditeur les identifiants fournis pour plus de détails.

Voici un exemple de configuration 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 implémenter les identifiants fournis par l'éditeur (PPID) dans le Application de démonstration des API

Signaux fournis par l'éditeur

Vous pouvez envoyer des données d'audience et contextuelles 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 tous les enchérisseurs types de transactions, en utilisant les taxonomies standards, sans qu'il soit nécessaire de partager les identifiants utilisateur. Votre audience peuvent inclure des données comportementales et basées sur les centres d'intérêt (Audience de l'IAB Taxonomie 1.1) et de ciblage contextuel (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 :L'URL multicontenu est en version bêta fermée pour un groupe restreint d'éditeurs.

Les applications qui affichent du contenu dynamique destiné à différentes audiences ne sont être en mesure de 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(), car il ne s'agit utilisées pour la brand safety.

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