Implémenter la segmentation par clé-valeur

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 sur l'ajout d'une paire clé-valeur dans l'interface utilisateur d'AdMob, consultez Ajouter une segmentation clé-valeur à un groupe de médiation.

Cette page vous explique comment implémenter la segmentation par clé-valeur lors de la configuration d'une demande d'annonce à l'aide du SDK Google Mobile Ads pour iOS.

Avant de commencer

Pour configurer la segmentation par clé-valeur dans votre application, vous devez d'abord ajouter la segmentation par 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 d'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é.

  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 en fonction de la durée d'utilisation d'une application :

Swift 

let daysInApp = 1

// Step 1: Create the key-value pair dictionary with custom targeting data.
let customTargeting: [String: String] = [
  "USER_DURATION": daysInApp < 3 ? "NEW" : "MATURE"
]

// Step 2: Create an ad request with custom targeting.
let request = GADRequest()
request.customTargeting = customTargeting

Objective-C 

int days_in_app = 1;

// Step 1: Create the key-value pair object with custom targeting data.
NSDictionary *customTargeting = @{
  @"USER_DURATION" : days_in_app < 3 ? @"NEW" : @"MATURE"
};

// Step 2: Create an ad request with custom targeting.
GADRequest *request = [GADRequest request];
request.customTargeting = customTargeting;

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 ResponseInfo. 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"
  }
}