afficher ou télécharger des fichiers compatibles avec le protocole RTB ;
Protos
| Fichier | Description | Version | Dernière mise à jour |
|---|---|---|---|
| cookie-bundle-upload.proto | Utilisez ce message pour importer de manière groupée des données de ciblage des utilisateurs. | v.24 | 27 mars 2024 |
| openrtb.proto | Google est compatible avec le protocole OpenRTB, en utilisant l'encodage JSON ou Protobuf. Ce protocole est nécessaire si vous utilisez OpenRTB/Protobuf. Il comprend également la documentation des champs compatibles et leur mappage sur le protocole natif de Google. | 2.6 | 31 oct. 2024 |
| openrtb-adx.proto | Le protocole OpenRTB de Google inclut certaines extensions, fournies dans un protocole distinct. | v.180 | 1er novembre 2024 |
| publisher-settings.proto | Ensemble de paramètres d'éditeur spécifiques à un réseau d'enchères en temps réel. | v.13 | 5 février 2024 |
| realtime-bidding.proto | Protocole RTB d'Authorized Buyers de Google Il s'agit du message que Google utilise pour demander des enchères. Un BidRequest inclut l'espace publicitaire d'une seule impression. |
v.331 | 1er novembre 2024 |
Prototypes de la bêta ouverte
| Fichier | Description | Version | Dernière mise à jour |
|---|---|---|---|
| openrtb-adx.proto | Le protocole OpenRTB de Google inclut certaines extensions, fournies dans un fichier .proto distinct. | v.186 | 1er novembre 2024 |
| realtime-bidding.proto | Protocole RTB d'Authorized Buyers de Google Il s'agit du message que Google utilise pour demander des enchères. Un BidRequest inclut l'espace publicitaire d'une seule impression. |
v.342 | 31 oct. 2024 |
Données de référence
Dictionnaires (cliquez pour télécharger le fichier .txt) |
|
|---|---|
| Catégories de produits publicitaires | Utilisé dans le champ excluded_product_category de BidRequest. Ce champ décrit les catégories de produits et de services non autorisés par un éditeur, par exemple s'il ne souhaite pas héberger d'annonces liées à la banque en ligne. |
| Catégories d'annonces soumises à des restrictions | Utilisé dans le champ allowed_restricted_category de BidRequest et le champ restricted_category de BidResponse. Le champ allowed_restricted_category décrit les catégories normalement soumises à restriction, mais déclarées explicitement par un éditeur comme autorisées, par exemple les annonces contenant du contenu lié aux alcools forts et liqueurs. |
| Catégories sensibles pour les annonces | Utilisé dans le champ excluded_sensitive_category de BidRequest et le champ category de BidResponse. Le champ excluded_sensitive_category décrit les catégories sensibles qui ne sont pas autorisées par l'éditeur, par exemple, s'il ne souhaite pas héberger d'annonces liées à la politique. |
| Annonceurs | Utilisé dans le champ advertiser_id de SnippetStatusItem. Ce champ spécifie l'annonceur représenté par la création associée à l'extrait. Cette liste reflète les annonceurs de la place de marché et non les annonceurs représentés par un acheteur donné. |
| Marques | Liste des marques utilisées dans l'API Client Access. |
| Attributs de création déclarables par l'acheteur | Utilisé pour le champ attribute dans BidResponse.
Ce champ décrit les attributs déclarables par l'acheteur sur les créations qui ne doivent pas apparaître dans excluded_attribute dans BidRequest. |
| Codes d'état des appels | Codes d'état renvoyés par l'appel de la méthode performancereport. |
| Libellés de contenu | Utilisé dans le champ detected_content_labels de BidRequest. |
| Codes d'état du moteur de mise en correspondance des cookies | Utilisé dans le champ cookieMatcherStatusRate des rapports sur les performances du protocole d'enchères en temps réel. Les codes disponibles sont décrits dans le guide sur la mise en correspondance des cookies. |
| Codes d'état des créations | Utilisation creative_status_code a renvoyé des commentaires en temps réel.
|
| Codes d'état des correspondances hébergées | Utilisé dans le champ hostedMatchStatusRate des rapports sur les performances du protocole d'enchères en temps réel. |
| Motifs d'absence d'enchère | Valeurs standards du motif d'absence d'enchère à indiquer dans le champ BidResponse.no_bid_reason du protocole d'enchères Authorized Buyers.
|
| Attributs de création préciblés | Utilisé dans le champ supportedCreativeAttribute de la ressource PretargetingConfig exposée dans l'API REST de l'acheteur. Ce champ décrit les attributs de création qui doivent être présents dans toutes les créations correspondant à une seule configuration de préciblage. |
| Attributs de création excluables par l'éditeur | Utilisé dans le champ excluded_attribute de BidRequest. Ce champ décrit les types de créations non autorisés par l'éditeur. Par exemple, ils peuvent spécifier si l'utilisation des cookies est autorisée ou si les annonces multimédias et/ou textuelles sont autorisées. |
| Secteurs des éditeurs | Utilisé dans le champ detected_vertical de BidRequest. Ce champ permet d'indiquer les secteurs de la page sur lesquels l'annonce sera diffusée (comme les mots clés). Google génère ce champ en explorant la page et en déterminant les secteurs utilisés. |
| Fournisseurs | Utilisé dans le champ allowed_vendor_type de BidRequest. Ce champ indique les fournisseurs de contenu rich media, tels que Campaign Monitor et VoiceFive, autorisés pour la création diffusée, comme spécifié par l'éditeur. Inclut les fournisseurs du fichier de dictionnaire |
| Fournisseurs de données | Utilisé dans le champ SegmentData.id de BidRequest. Ce champ contient des informations sur l'entité qui a fourni les signaux fournis par l'éditeur. |
Tables de référence (cliquez pour télécharger les fichiers CSV) |
|
| Applications mobiles Android | Liste des applications mobiles Android pouvant être ciblées, avec leurs ID d'application, leurs ID de catégorie et leurs noms d'application lisibles. |
| Tables géographiques | Tableau utilisé pour décoder le champ geo_criteria_id de BidRequest. Pour en savoir plus, consultez Ciblage géographique. |
| Fournisseurs pour le LGPD |
Liste des fournisseurs de personnalisation des annonces autorisés à diffuser des annonces sur le trafic LGPD, avec leur ID, un nom lisible par l'humain, une URL de confidentialité et une liste de domaines pouvant être attribués au fournisseur. L'application de la LGPD est indiquée dans une demande d'enchère donnée via le champ BidRequest.adslot.regs_lgpd dans le protocole d'enchères Authorized Buyers et le champ BidRequest.regs.ext.lgpd dans le protocole d'enchères OpenRTB.
|
| Opérateurs mobiles | Liste des opérateurs mobiles. |
| Appareils mobiles | Liste des appareils mobiles. |
| Systèmes d'exploitation mobiles | Liste des systèmes d'exploitation pour mobile. |
| Fournisseurs | Mappe les ID des fournisseurs de personnalisation des annonces vers un nom lisible, une URL des règles de confidentialité et une liste de domaines pouvant être attribués au fournisseur.
Actuellement, les fournisseurs sont utilisés dans le champ BidRequest.AdSlot.consented_providers_settings pour le protocole AdX et BidRequest.User.UserExt.consented_providers_settings pour le protocole OpenRTB. Dans ces champs, le consentement de l'utilisateur est transmis par les éditeurs pour les utilisateurs situés dans les pays de l'Espace économique européen. |
Paramètres de l'éditeur
Demandez le fichier publisher-settings.pb.gz à votre responsable de compte.
Sujets liés aux règles concernant l'examen des créations
Vous pouvez utiliser les sujets de règles de ce fichier pour filtrer les créations lors de l' examen dans l'API Real-time Bidding.
Téléchargez les sujets de règles au format CSV.Dernière mise à jour: 18 avril 2022