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 Unity.

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.

  1. Créez un objet de paire clé-valeur représentant vos données de ciblage personnalisées.

  2. Définissez la propriété CustomTargeting de la demande d'annonce sur cet objet.

L'exemple suivant couvre les étapes précédentes pour segmenter les utilisateurs par durée dans une application :

var daysInApp = 1;

// Step 1: Create the key-value pair dictionary with custom targeting data.
var customTargeting = new Dictionary<string, string> {
  ["USER_DURATION"] = daysInApp < 3 ? "NEW" : "MATURE",
};

// Step 2: Create an ad request with custom targeting.
var request = new AdRequest() {
  CustomTargeting = customTargeting,
};

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 un nom de groupe de médiation dans la réponse d'annonce :

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