Proto & Données de référence

Affichez ou téléchargez les fichiers compatibles avec le protocole RTB.

Protos

Fichier Description Version Dernière mise à jour
cookie-bulk-upload.proto Utilisez ce message pour importer de manière groupée des données de ciblage des utilisateurs. v.25 27 mars 2024
openrtb.proto Google est compatible avec le protocole OpenRTB, en utilisant l'encodage JSON ou Protobuf. Ce proto est nécessaire si vous utilisez OpenRTB/Protobuf. Il inclut également la documentation sur les champs compatibles et leur mappage au protocole natif de Google. 2.6 15 octobre 2026
openrtb-adx.proto Le protocole OpenRTB de Google inclut certaines extensions, fournies dans un proto distinct. v.210 4 août 2026
publisher-settings.proto Ensemble de paramètres d'éditeur spécifiques à un réseau d'enchères en temps réel. v.14 5 février 2024

Protos 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 proto distinct. v.220 16 septembre 2026

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 qui ne sont pas autorisées par un éditeur. Par exemple, si l'éditeur ne souhaite pas héberger d'annonces liées aux services bancaires en ligne.
Catégories d'annonces restreintes 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 explicitement déclarées comme autorisées par un éditeur, par exemple les annonces contenant du contenu lié à l'alcool.
Catégories d'annonces sensibles 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 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 de la place de marché et ne reflète pas les annonceurs représentés par un acheteur donné.
Marques Liste des marques, utilisée 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.
Libellés de contenu Utilisé dans le champ detected_content_labels de BidRequest.
Codes d'état de la mise en correspondance des cookies Utilisé dans le champ cookieMatcherStatusRate des rapports sur les performances du protocole RTB. Les codes disponibles sont décrits dans le guide Cookie matching.
Codes d'état des créations

Utilisation

creative_status_code renvoyé dans les retours en temps réel.
Codes d'état de correspondance hébergée Utilisé dans le champ hostedMatchStatusRate des rapports sur les performances du protocole RTB.
Motifs d'absence d'enchère Valeurs standards de motif de non-enchère à indiquer dans le champ BidResponse.no_bid_reason du protocole d'enchère Authorized Buyers.
Attributs de création préciblables Utilisé dans le champ supportedCreativeAttribute de la ressource PretargetingConfig exposée dans l'API REST pour les acheteurs. Ce champ décrit les attributs de création qui doivent ê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 qui ne sont pas autorisés par l'éditeur. Par exemple, ils peuvent spécifier des restrictions concernant l'autorisation d'utiliser des cookies, ou l'autorisation de diffuser des annonces multimédias et/ou textuelles.
Fournisseurs Utilisé dans le champ allowed_vendor_type de BidRequest. Ce champ liste les fournisseurs de 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 gdn-vendors.txt obsolète.

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 lisibles par l'humain.
Tables géographiques Table utilisée pour décoder le champ geo_criteria_id de BidRequest. Pour en savoir plus, consultez Ciblage géographique.
Fournisseurs LGPD Liste des fournisseurs de personnalisation des annonces autorisés à diffuser des annonces sur le trafic soumis à la LGPD, avec leur ID, un nom lisible par l'humain, l'URL de leurs règles 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 du protocole d'enchère 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 à un nom lisible par l'humain, à l'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, les fournisseurs listés ont obtenu le consentement utilisateur, tel que transmis par les éditeurs pour les utilisateurs des 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 d'examen des créations

Vous pouvez utiliser les thèmes des règles de ce fichier pour filtrer les créations lors de l' examen dans l'API d'enchères en temps réel.

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

Dernière mise à jour : 18 avril 2022