Proto & Données de référence

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Affichez ou téléchargez des fichiers compatibles avec le protocole d'enchères en temps réel.

Protos

Fichier Description Version Dernière mise à jour
cookie-bulk-upload.proto Utilisez ce message pour importer des données de ciblage d'utilisateurs de manière groupée. Version 19 23 août 2022
openrtb.proto Google accepte le protocole OpenRTB, via l'encodage JSON ou Protobuf. Ce proto est nécessaire si vous utilisez OpenRTB/Protobuf. Il contient également une documentation sur les champs compatibles et leur mappage au protocole natif de Google. 2.6 29 nov. 2022
openrtb-adx.proto Le protocole OpenRTB de Google inclut certaines extensions, fournies dans un proto distinct. version 118 3 oct. 2022
publisher-settings.proto Ensemble de paramètres éditeur propres à un réseau d'enchères en temps réel. version 12 19 janvier 2022
realtime-bidding.proto, Protocole RTB Authorized Buyers de Google. Il s'agit du message utilisé par Google pour demander des enchères. Un BidRequest inclut l'espace publicitaire d'une seule impression. v.258 9 nov. 2022
snippet-status-report.proto Il s'agit du message que Google utilise pour communiquer les rapports sur l'état des créations. Version 34 19 janvier 2022

Données de référence

Dictionnaires (fichier .txt à télécharger)

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 qui ne sont pas autorisées par un éditeur, par exemple, si l'éditeur ne souhaite pas héberger sur son site des annonces liées à des services bancaires en ligne.
Catégories limitées d'annonces 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 qui sont normalement limitées, mais qui ont été explicitement déclarées par un éditeur comme autorisées, par exemple les annonces dont le contenu est lié aux alcools.
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 des catégories sensibles que l'éditeur n'autorise pas, par exemple, si l'éditeur 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 sur l'échange et ne reflète pas les annonceurs représentés par un acheteur.
Agences Utilisé dans le champ agency_id de BidResponse. Ce champ permet de déclarer l'agence associée à l'annonce renvoyée.
Marques Liste des marques utilisées dans l'API Client Access.
Attributs de création pouvant être déclarés par l'acheteur Utilisé pour le champ attribute dans BidResponse. Ce champ décrit les attributs déclarables par l'acheteur pour les créations qui ne doivent pas apparaître dans excluded_attribute dans BidRequest.
Codes d'état des accroches Codes d'état renvoyés par l'appel de méthode performancereport.
Libellés de contenu Utilisé dans le champ detected_content_labels de BidRequest.
Codes d'état du lecteur de 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 lecture des cookies.
Codes d'état de création

Used in

Codes d'état de la correspondance hébergée Utilisé dans le champ hostedMatchStatusRate des rapports sur les performances du protocole d'enchères en temps réel.
Aucun motif d'enchère Valeurs de motif standards sans enchère à indiquer dans le champ BidResponse.no_bid_reason du protocole d'enchères Authorized Buyers.
Attributs de création pouvant être ciblés Utilisé dans le champ supportedCreativeAttribute de la ressource PretargetingConfig exposée dans l'API REST pour acheteur. Ce champ décrit les attributs de création prévus dans toutes les créations correspondant à une seule configuration de préciblage.
Attributs de création exclus de l'éditeur Utilisé dans le champ excluded_attribute de BidRequest. Ce champ décrit les types de créations non autorisées par l'éditeur. Par exemple, ils peuvent spécifier si les cookies sont autorisés, 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'identifier les secteurs de contenu de la page susceptibles de déclencher la diffusion de l'annonce (processus semblable aux mots clés). Google génère ce champ en explorant la page et en identifiant les secteurs utilisés.
ID des réseaux de vendeurs Utilisé dans le champ seller_network_id de BidRequest. Ce champ indique le réseau de vendeurs auquel appartient l'éditeur. Le contenu de ce fichier est classé par ordre croissant en fonction de la valeur de l'ID de réseau du vendeur.
Fournisseurs Utilisé dans le champ allowed_vendor_type de BidRequest. Ce champ répertorie les fournisseurs rich media (tels que Campaign Monitor et VoiceFive) qui sont autorisés pour la création diffusée, comme spécifié par l'éditeur.

Inclut les fournisseurs du fichier de dictionnaire gdn-vendors.txt obsolète.

Tableaux de référence (cliquer pour télécharger les fichiers CSV)

Applications mobiles Android Liste des applications mobiles Android pouvant être ciblées, avec des ID d'application, des ID de catégories et des noms d'application lisibles.
Tables géographiques La table utilisée pour décoder le champ geo_criteria_id de BidRequest Pour en savoir plus, consultez la page Ciblage géographique.
Fournisseurs de services liés à la loi LGPD Liste des fournisseurs autorisés à diffuser des annonces sur le trafic lié à la loi LGPD, avec leur ID, un nom lisible, une URL de confidentialité et une liste de domaines pouvant être attribués au fournisseur. L'application de la loi LGPD est indiquée sur une demande d'enchère donnée via le champ BidRequest.adslot.regs_lgpd du 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 mobiles.
Fournisseurs associe les ID de fournisseur de personnalisation des annonces à un nom lisible, une URL de 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 nom des fournisseurs répertoriés a obtenu le consentement des utilisateurs, tel qu'il a été 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 au représentant de votre compte.