Implémenter la segmentation par clé-valeur

Sélectionnez une plate-forme : Android iOS Unity Android (Legacy)

La segmentation clé-valeur vous permet de définir un ciblage personnalisé pour segmenter les utilisateurs via une demande d'annonce. Pour en savoir plus sur la segmentation clé-valeur, par exemple comment ajouter une paire clé-valeur dans l'interface utilisateur AdMob, consultez Ajouter une segmentation clé-valeur à un groupe de médiation.

Cette page vous explique comment implémenter la segmentation clé-valeur lorsque vous configurez une demande d'annonce à l'aide du SDK Google Mobile Ads pour Android.

Avant de commencer

Pour configurer la segmentation clé-valeur dans votre application, vous devez d'abord l'ajouter à un groupe de médiation.

Associer des paires clé-valeur à une demande d'annonce

Après avoir configuré vos paires clé-valeur personnalisées dans l'interface utilisateur AdMob, associez-les à une demande d'annonce dans votre application.

Pour associer les paires clé-valeur à une demande d'annonce, appelez addCustomTargeting() avec la clé et la valeur.

L'exemple suivant segmente les utilisateurs par durée dans une application :

Kotlin 

val daysInApp = 1
val request = AdRequest.Builder()
  .addCustomTargeting("USER_DURATION", if (daysInApp < 3) "NEW" else "MATURE")
  .build()

Java 

int daysInApp = 1;
AdRequest request = new AdRequest.Builder()
    .addCustomTargeting("USER_DURATION", (daysInApp < 3) ? "NEW" : "MATURE")
    .build();

Tester la configuration de la segmentation clé-valeur

Pour tester votre implémentation sur des paires clé-valeur personnalisées, envoyez une demande d'annonce et vérifiez l'objet d'informations de réponse. Vérifiez que la valeur du champ mediation_group_name correspond au nom de groupe de médiation attendu.

L'exemple suivant vérifie le nom d'un groupe de médiation dans la réponse d'annonce :

{
  "Response ID": "r6_DZtitA8Gi2OMPyKeksAI",
  ...
  "Response Extras": {
    "mediation_group_name": "Mediation group for new users"
  }
}