Ciblage

Ce guide explique comment fournir des informations de ciblage dans une demande d'annonce.

Pour voir comment fonctionne le ciblage des annonces, téléchargez l'application de démonstration de l'API iOS en Swift ou en Objective-C.

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

Conditions préalables

Suivez le guide de démarrage.

GADRequestConfiguration

GADRequestConfiguration est un objet qui collecte des informations de ciblage à appliquer globalement via l'instance partagée GADMobileAds. Il est accessible à l'aide du code suivant:

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Paramètre destiné aux enfants

Aux fins de la loi COPPA (Children's Online Privacy Protection Act), il existe un paramètre appelé tagForChildDirectedTreatment.

En tant que développeur d'applications, vous pouvez indiquer à Google que vous souhaitez que votre contenu soit considéré comme destiné aux enfants lorsque vous envoyez une demande d'annonce. Lorsque vous indiquez que vous souhaitez que Google traite votre contenu comme étant destiné aux enfants, Google prend des mesures pour désactiver la publicité ciblée par centres d'intérêt et les annonces de remarketing pour cette demande d'annonce. Les options de configuration sont les suivantes:

• Définissez tagForChildDirectedTreatment sur true pour indiquer que vous souhaitez que votre contenu soit traité comme étant destiné aux enfants conformément à la loi COPPA. Cela empêche la transmission de l'identifiant publicitaire (IDFA).
• Définissez tagForChildDirectedTreatment sur false pour indiquer que vous ne souhaitez pas que votre contenu soit traité comme étant destiné aux enfants aux fins de la loi COPPA.
• Ne définissez pas tagForChildDirectedTreatment si vous ne souhaitez pas indiquer comment vous souhaitez que votre contenu soit traité par rapport à la loi COPPA.

L'exemple suivant indique que vous souhaitez que votre contenu soit traité comme étant destiné aux enfants conformément à la loi COPPA:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

En définissant cette balise, vous certifiez que cette notification est exacte et que vous êtes autorisé à agir pour le compte 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 Google.

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 de l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis. Cette fonctionnalité est conçue pour vous aider à respecter le Règlement général sur la protection des données (RGPD). Notez que vous pouvez avoir d'autres obligations légales en vertu du RGPD. Consultez les consignes de l'Union européenne et adressez-vous à votre conseiller juridique. Notez que les outils de Google sont conçus pour faciliter la conformité et ne dispensent aucun éditeur de ses obligations légales. En savoir plus sur l'impact du RGPD sur les éditeurs

Lorsque vous utilisez cette fonctionnalité, un paramètre TFUA (Tag pour les utilisateurs n'ayant pas atteint l'âge de consentement en Europe) sera inclus dans toutes les demandes d'annonces ultérieures. Ce paramètre désactive la publicité personnalisée, y compris le remarketing, pour cette demande d'annonce spécifique. Il désactive également les demandes adressées aux fournisseurs d'annonces tiers, comme les pixels de mesure des annonces et les ad servers tiers.

Vous pouvez utiliser ce paramètre avec toutes les versions du SDK Google Mobile Ads en définissant la propriété tagForUnderAgeOfConsent sur l'objet GADMobileAds.requestConfiguration et en transmettant true.

• Définissez tagForUnderAgeOfConsent sur true pour indiquer que vous souhaitez que les demandes d'annonces soient traitées d'une manière adaptée aux utilisateurs n'ayant pas atteint l'âge minimal requis. Cela empêche également la transmission de l'identifiant publicitaire (IDFA).
• Si vous ne définissez pas tagForUnderAgeOfConsent, vous ne souhaitez pas que les demandes d'annonces soient traitées d'une manière adaptée aux utilisateurs n'ayant pas atteint l'âge minimal requis.

L'exemple suivant indique que vous souhaitez inclure le tag TFUA dans votre demande d'annonce:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Les tags permettant d'activer le paramètre destiné aux enfants et tagForUnderAgeOfConsent ne doivent pas être tous les deux définis sur true. Si c'est le cas, le paramètre destiné aux contenus destinés aux enfants prévaut.

Important :Ce paramètre tagForUnderAgeOfConsent n'est pas transmis aux adaptateurs de médiation par réseau publicitaire. Il est de votre responsabilité de vous assurer que chaque réseau publicitaire tiers de votre application diffuse des annonces adaptées aux utilisateurs n'ayant pas atteint l'âge minimal requis, selon le RGPD.

Filtrage du contenu des annonces

Les applications peuvent définir une classification maximale du contenu des annonces pour toutes les demandes d'annonces à l'aide de la propriété maxAdContentRating de GADRequestConfiguration. Ce paramètre s'applique à toutes les futures demandes d'annonces jusqu'à la fin de la session. Les valeurs possibles pour cette propriété sont basées sur des classifications de libellés de contenu numérique et doivent être l'une des constantes suivantes:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Le code suivant configure toutes les demandes d'annonces pour spécifier que le contenu d'annonce renvoyé doit correspondre à une désignation de libellé de contenu numérique inférieure ou égale à GADMaxAdContentRatingGeneral.

Important :Les paramètres de filtrage de classification du contenu spécifiés via le SDK remplacent tous les paramètres configurés à l'aide de l'UI Ad Manager .

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

Le Traitement de la confidentialité des éditeurs (l'API PPT) est un outil facultatif qui permet aux applications d'indiquer s'il faut désactiver la personnalisation des annonces pour toutes les demandes d'annonces à l'aide de la propriété publisherPrivacyPersonalizationState de GADRequestConfiguration. Lorsque vous utilisez cette fonctionnalité, un paramètre de traitement de la confidentialité de l'éditeur (PPT) est inclus dans toutes les futures demandes d'annonces pour le reste de la session.

Par défaut, les demandes d'annonces envoyées à Google reçoivent des annonces personnalisées. Le code suivant désactive la personnalisation des annonces pour toutes les demandes d'annonces:

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Remarque :Pour les demandes d'annonces comportant plusieurs signaux de confidentialité utilisateur, le signal le plus restrictif prévaut. Consultez la documentation de l' API Publisher Privacy Treatment pour obtenir des exemples spécifiques.

GAMRequest

L'objet GAMRequest collecte les informations de ciblage à envoyer avec une demande d'annonce.

URL de contenu

Lorsqu'elles demandent une annonce, les applications peuvent transmettre l'URL du contenu qu'elles diffusent. Cela permet au ciblage par mots clés d'établir une correspondance entre l'annonce et le contenu.

Par exemple, si votre application demande une annonce tout en affichant du contenu provenant de https://www.example.com, vous pouvez transmettre cette URL pour cibler des mots clés pertinents:

Swift

let request = GAMRequest()
request.contentURL = "https://www.example.com"

Objective-C

GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";

Ciblage personnalisé

Une fois que vous avez configuré des paires clé-valeur dans l'interface utilisateur d'Ad Manager, définissez un ciblage personnalisé à l'aide des clé-valeurs d'une demande d'annonce. Les éléments de campagne qui ciblent ces clé-valeurs peuvent alors être diffusés pour cette demande d'annonce. Si vous souhaitez cibler plusieurs valeurs pour une même clé, saisissez ces valeurs sous forme de chaîne séparée par des virgules.

Swift

let request = GAMRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

Brand safety (bêta)

Les applications qui affichent du contenu dynamique destiné à différentes audiences peuvent fournir une courte liste d'URL via la propriété neighboringContentURLs. Les URL de contenu voisines diffèrent de la propriété contentURL, car elles ne sont utilisées que pour la brand safety.

Supposons que votre application affiche le contenu de quatre URL dans un flux contenant également des annonces. Vous pouvez demander des annonces dont la classification du contenu est semblable à celle de ces URL en les transmettant comme suit:

Swift

let request = GAMRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

Important :Seules les quatre premières URL sont utilisées par le SDK. Tous les autres sont ignorés.

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 et d'autres commandes de diffusion des annonces en fonction de l'audience sur les différents appareils.

Remarque :Cette fonctionnalité n'est pas disponible pour tous les éditeurs. Pour en savoir plus, consultez À propos des identifiants fournis par l'éditeur.

La définition du PPID s'effectue via GAMRequest:

Swift

let request = GAMRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

Consultez l'exemple de PPID Ad Manager pour l'implémentation d'identifiants fournis par l'éditeur (PPID) dans l'application de démonstration de l'API iOS:

Swift Objective-C

Signaux fournis par l'éditeur

Vous pouvez envoyer des données d'audience et contextuelles en tant que signaux fournis par l'éditeur (PPS) dans les demandes d'annonces. Les PPS vous permettent d'utiliser vos données utilisateur pour améliorer la monétisation programmatique en communiquant aux enchérisseurs les caractéristiques de votre audience dans tous les types de transactions, à l'aide de taxonomies standards, sans avoir à partager les identifiants utilisateur. Les caractéristiques de votre audience peuvent inclure des données comportementales et basées sur les centres d'intérêt (Taxonomie d'audience de l'IAB 1.1) et des données contextuelles (Taxonomie de contenu de l'IAB 2.2).

Swift

let extras = GADExtras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = GAMRequest()()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

Questions fréquentes

Quel ciblage est utilisé lorsqu'une annonce est actualisée automatiquement ?

Lors de l'actualisation de l'annonce, l'objet GAMRequest spécifié précédemment est utilisé à nouveau pour le ciblage. Pour définir un nouveau ciblage, appelez explicitement loadRequest sur GAMBannerView avec un nouvel objet GAMRequest.

Comment transmettre des paramètres de ciblage supplémentaires aux réseaux de médiation ?

Pour savoir comment envoyer un ciblage aux réseaux de médiation, consultez la section Médiation.