Ce guide explique comment fournir des informations de ciblage à une requête d'annonce.
Pour voir le ciblage publicitaire en action, 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
Prérequis
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
. Vous pouvez y accéder à l'aide du code suivant:
Swift
let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
Pour vous assurer que toutes les demandes d'annonces appliquent les modifications de configuration de la demande, définissez la configuration de la demande avant d'initialiser le SDK Mobile Ads.
Paramètre destiné aux enfants
Conformément à la loi COPPA (Children's Online Privacy Protection Act), un paramètre appelé tagForChildDirectedTreatment
est disponible.
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 les mesures nécessaires 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 paramétrage sont les suivantes:
- Définissez
tagForChildDirectedTreatment
surtrue
pour indiquer que vous souhaitez que votre contenu soit considéré comme destiné aux enfants aux fins de la loi COPPA. Cela empêche la transmission de l'identifiant publicitaire (IDFA). - Définissez
tagForChildDirectedTreatment
surfalse
pour indiquer que vous ne souhaitez pas que votre contenu soit considéré comme 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é conformément à la loi COPPA.
L'exemple suivant indique que vous souhaitez que votre contenu soit considéré comme destiné aux enfants aux fins de 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 au nom du propriétaire de l'application. Vous comprenez que l'utilisation abusive de ce paramètre peut entraîner la résiliation 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 à des utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis. Cette fonctionnalité vise à vous aider à respecter le Règlement général sur la protection des données (RGPD). Notez que le RGPD peut inclure d'autres obligations légales. Consultez les consignes de l'Union européenne et contactez votre conseiller juridique. Notez que les outils Google sont conçus pour simplifier la conformité et ne dispensent aucun éditeur de ses obligations envers la loi. En savoir plus sur l'impact du RGPD sur les éditeurs
Lorsque vous utilisez cette fonctionnalité, un paramètre TFUA (balise pour les utilisateurs n'ayant pas atteint l'âge de consentement en Europe) est inclus dans toutes les futures demandes d'annonces. Il 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 (les pixels de mesure des performances des annonces et les ad servers tiers, par exemple).
Ce paramètre peut être utilisé 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
surtrue
pour indiquer que vous souhaitez que les demandes d'annonces soient traitées de 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
, cela signifie que vous ne souhaitez pas que les demandes d'annonces soient traitées de manière adaptée aux utilisateurs n'ayant pas atteint l'âge de consentement.
L'exemple suivant indique que vous souhaitez inclure TFUA dans votre requête d'annonce:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
Vous ne devez pas définir simultanément les tags permettant d'activer le paramètre pour les contenus destinés aux enfants et tagForUnderAgeOfConsent
sur true
.
Si tel est le cas, le paramètre "Contenu destiné aux enfants" est prioritaire.
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 pour le reste de la session. Les valeurs possibles pour cette propriété sont basées sur les classifications des libellés de contenu numérique et doivent correspondre à l'une des constantes suivantes:
GADMaxAdContentRatingGeneral
GADMaxAdContentRatingParentalGuidance
GADMaxAdContentRatingTeen
GADMaxAdContentRatingMatureAudience
Le code suivant configure toutes les demandes d'annonces pour spécifier que le contenu de l'annonce renvoyé doit correspondre à une désignation de libellé de contenu numérique ne dépassant pas GADMaxAdContentRatingGeneral
.
Swift
GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
Traitement de la confidentialité pour les éditeurs (bêta)
L'API
Traitement de la confidentialité pour les éditeurs
(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 diffusent 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;
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. Le ciblage par mots clés permet ainsi de mettre en correspondance l'annonce avec le contenu.
Par exemple, si votre application demande une annonce pendant la diffusion de 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 le ciblage personnalisé avec les valeurs de clé dans une requête d'annonce. Les éléments de campagne qui ciblent ces clés-valeurs peuvent ensuite être diffusés en réponse à cette demande d'annonce. Pour cibler plusieurs valeurs pour une clé, saisissez les valeurs sous la forme d'une 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 contenus voisins diffèrent de la propriété contentURL
en ce sens qu'elles ne sont utilisées que pour la brand safety.
Supposons que votre application affiche du contenu provenant de quatre URL dans un flux qui contient é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"];
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 types d'appareil.
Le paramétrage 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 une implémentation des identifiants fournis par l'éditeur (PPID) dans l'application de démonstration de l'API iOS:
Signaux fournis par l'éditeur
Vous pouvez envoyer des données contextuelles et sur l'audience en tant que signaux fournis par l'éditeur (PPS) dans les demandes d'annonces. Avec le PPS, vous pouvez utiliser vos données utilisateur pour améliorer la monétisation programmatique en communiquant les caractéristiques de votre audience aux enchérisseurs pour tous les types de transactions, à l'aide de taxonomies standards, sans avoir à partager d'identifiants utilisateur. Vos caractéristiques d'audience peuvent inclure des données sur le comportement 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 la mise à jour de l'annonce, l'objet
GAMRequest
précédemment spécifié est à nouveau utilisé pour le ciblage. Pour définir un nouveau ciblage, appelez explicitementloadRequest
surGAMBannerView
avec un nouvel objetGAMRequest
. - Comment transmettre des paramètres de ciblage supplémentaires aux réseaux de médiation ?
- Consultez Médiation pour découvrir comment envoyer du ciblage aux réseaux de médiation.