Proto & Données de référence

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 des utilisateurs de manière groupée. v.23 12 jan. 2024
openrtb.proto Google accepte le protocole OpenRTB, avec l'encodage JSON ou Protobuf. Ce proto est nécessaire si vous utilisez OpenRTB/Protobuf. Il inclut également de la documentation sur les champs compatibles et leur mappage avec le protocole natif de Google. 2.6 10 jan. 2024
openrtb-adx.proto Le protocole OpenRTB de Google inclut certaines extensions, fournies dans un proto distinct. v.167 26 févr. 2024
publisher-settings.proto Il s'agit d'un ensemble de paramètres d'éditeur propres à un réseau d'enchères en temps réel. v.13 5 févr. 2024
realtime-bidding.proto via le protocole RTB d'Authorized Buyers. Il s'agit du message que Google utilise pour les demandes d'enchères. Un élément BidRequest inclut l'espace publicitaire associé à une seule impression. v.321 26 févr. 2024

Protos bêta ouverts

Fichier Description Version Dernière mise à jour
openrtb-adx.proto Le protocole OpenRTB de Google inclut certaines extensions, fournies dans un proto distinct. v.169 26 févr. 2024
realtime-bidding.proto via le protocole RTB d'Authorized Buyers. Il s'agit du message que Google utilise pour les demandes d'enchères. Un élément BidRequest inclut l'espace publicitaire associé à une seule impression. v.326 13 févr. 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 des catégories de produits et de services qui ne sont pas autorisées par un éditeur (par exemple, s'il ne souhaite pas héberger des annonces liées à la banque 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 normalement limitées, mais qui sont explicitement déclarées par un éditeur comme autorisées, par exemple les annonces dont le contenu est lié aux alcools.
Catégories sensibles des 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, si celui-ci ne souhaite pas héberger des annonces liées à la politique).
Annonceurs Utilisé dans le champ advertiser_id de SnippetStatusItem. Ce champ indique l'annonceur représenté par la création associée à l'extrait. Cette liste tient compte des annonceurs de la place de marché et non des 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 pour les créations, qui ne doivent pas apparaître dans le fichier excluded_attribute du fichier BidRequest.
Codes d'état des accroches 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 lecteur de cookies Utilisé dans le champ cookieMatcherStatusRate des rapports sur les performances du protocole RTB. Les codes disponibles sont décrits dans le guide Mise en correspondance des cookies.
Codes d'état des créations

Used in

creative_status_code a renvoyé des commentaires en temps réel.
Codes d'état de correspondance hébergés Utilisé dans le champ hostedMatchStatusRate des rapports sur les performances du protocole RTB.
Motifs de l'absence d'enchère Indiquez les valeurs standards des motifs d'absence d'enchère dans le champ BidResponse.no_bid_reason du protocole d'enchères Authorized Buyers.
Attributs de création avec préciblage Utilisé dans le champ supportedCreativeAttribute de la ressource PretargetingConfig exposée dans l'API REST pour acheteur. Ce champ décrit les attributs censés être présents dans toutes les créations correspondant à une même configuration de préciblage.
Attributs de création pouvant être exclus par 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 l'utilisation des cookies est autorisée ou si les annonces textuelles et/ou multimédias sont autorisées.
Secteurs des éditeurs Utilisé dans le champ detected_vertical de BidRequest. Ce champ permet d'indiquer les secteurs (semblables aux mots clés) de la page sur lesquels l'annonce sera diffusée. Google génère ce champ en explorant la page et en déterminant les secteurs utilisés.
ID des réseaux de vendeurs Utilisé dans le champ seller_network_id de BidRequest. Ce champ permet d'indiquer le réseau de vendeurs auquel l'éditeur appartient. 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) autorisés pour la diffusion de la création, comme spécifié par l'éditeur.

Inclut les fournisseurs du fichier de dictionnaire gdn-vendors.txt abandonné.

Tableaux de référence (fichiers CSV téléchargeables)

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'applications lisibles.
Tableaux géographiques Table utilisée pour décoder le champ geo_criteria_id de BidRequest. Pour en savoir plus, consultez la section Ciblage géographique.
Fournisseurs liés à la loi LGPD Liste des fournisseurs de personnalisation des annonces autorisés à diffuser des annonces liées au 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 LGPD est indiquée dans une demande d'enchère donnée via le champ BidRequest.adslot.regs_lgpd du protocole d'enchère 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 pour mobile Liste des systèmes d'exploitation mobiles.
Fournisseurs Mappe les ID de fournisseurs de personnalisation des annonces avec 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, les fournisseurs listés ont obtenu le consentement de l'utilisateur, tel que 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.

Thèmes des règles relatives à la vérification des créations

Vous pouvez utiliser les thèmes des règles de ce fichier pour filtrer les créations pendant leur examen dans l'API Real-time Bidding.

Téléchargez les sujets des règles au format CSV.

Dernière mise à jour: 18 avril 2022