Implémenter la segmentation par clé-valeur

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

La segmentation par 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 sur l'ajout d'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 par 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 par paire clé-valeur dans votre application, vous devez d'abord ajouter une segmentation par paire clé-valeur à 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 en fonction de la durée passé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 par clé-valeur

Pour tester votre implémentation sur des paires clé-valeur personnalisées, envoyez une demande d'annonce et vérifiez l'objet response info. Vérifiez que la valeur du champ mediation_group_name correspond au nom du 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"
  }
}