Ciblage

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;

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 sur true 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 sur false 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 sur true 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 demande 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.

Important :Ce paramètre tagForUnderAgeOfConsent n'est pas transmis aux adaptateurs de médiation pour les sources d'annonces tierces. 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 de consentement, conformément au 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 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.

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

.

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;

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

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"];

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

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.

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

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:

Swift Objective-C

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 des annonces, l'objet GAMRequest précédemment spécifié est à nouveau utilisé 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 ?

Consultez Médiation pour découvrir comment envoyer un ciblage aux réseaux de médiation.