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.

Proto

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.24 27 mars 2024
openrtb.proto Google accepte le protocole OpenRTB, à l'aide de JSON ou de Protobuf l'encodage. Ce proto est nécessaire si vous utilisez OpenRTB/Protobuf. Il y a aussi inclut la documentation des champs acceptés et leur correspondance avec les protocole natif. 2.6 22 mai 2024
openrtb-adx.proto Le protocole OpenRTB de Google inclut certaines extensions, fournies dans un fichier .proto distinct. v.175 15 juil. 2024
publisher-settings.proto Ensemble de paramètres éditeur spécifiques à un réseau d'enchères en temps réel. v.13 5 févr. 2024
realtime-bidding.proto Protocole RTB d'Authorized Buyers de Google Voici le message que Google utilise pour demander des enchères. Un BidRequest inclut l'espace publicitaire d'un une seule impression. v.328 21 mai 2024

Version bêta ouverte des prototypes

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.180 15 juil. 2024
realtime-bidding.proto Protocole RTB d'Authorized Buyers de Google Voici le message que Google utilise pour demander des enchères. Un BidRequest inclut l'espace publicitaire d'un une seule impression. v.338 21 mai 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 des services non autorisés par un éditeur, par exemple ne souhaite pas héberger des annonces relatives à des services bancaires en ligne.
Catégories limitées pour les annonces Utilisé dans le champ allowed_restricted_category de BidRequest et le champ restricted_category de BidResponse allowed_restricted_category décrit des catégories qui sont normalement restreintes, mais qui sont explicites déclaré par un éditeur comme autorisé, par exemple, les annonces contenant Contenu lié aux alcools
Catégories sensibles pour les annonces Utilisé dans le champ excluded_sensitive_category de BidRequest et le champ category de BidResponse excluded_sensitive_category décrit les catégories à caractère sensible que l'éditeur n'autorise pas. Par exemple, si l'éditeur ne souhaite pas héberger d'annonces politique.
Annonceurs Utilisé dans le champ advertiser_id de SnippetStatusItem. Ce spécifie l'annonceur représenté par la création associée à l'extrait. Cette liste reflète les annonceurs de l'ensemble de la place de marché. ne reflètent pas les annonceurs représentés par un seul acheteur.
Marques Liste de 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 pouvant être déclarés par l'acheteur sur les créations qui doivent n'apparaissent pas dans excluded_attribute dans BidRequest
Codes d'état des appels Codes d'état renvoyés par 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 du protocole d'enchères en temps réel rapports sur les performances. Les codes disponibles sont décrits dans la section Mise en correspondance des cookies .
Codes d'état des créations

Used in

creative_status_code renvoyés en temps réel commentaires.
Codes d'état de correspondance hébergés Utilisé dans le champ hostedMatchStatusRate du protocole d'enchères en temps réel rapports sur les performances.
Motifs d'absence d'enchère Valeurs standards de motif d'absence d'enchère à indiquer dans le champ BidResponse.no_bid_reason du le protocole d'enchères Authorized Buyers.
Attributs de création pré-ciblant Utilisé dans le champ supportedCreativeAttribute de la fonction Ressource PretargetingConfig exposée dans l'API REST pour acheteur. Ce champ décrit les attributs de création censés être présents dans toutes les créations correspondant à une seule 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 ne sont pas autorisées par l'éditeur. Par exemple, ils peuvent spécifier des restrictions sur l'autorisation de l'utilisation des cookies, ou sur le fait que les contenus multimédias et/ou textuels sont autorisées.
Secteurs des éditeurs Utilisé dans le champ detected_vertical de BidRequest Ce champ indique les secteurs d'activité (comme mots clés) de la page sur laquelle l'annonce sera diffusée. Google génère ces en explorant la page et en déterminant les secteurs utilisés.
Fournisseurs Utilisé dans le champ allowed_vendor_type de BidRequest Ce champ répertorie les fournisseurs rich media, tels que Campaign Monitor et VoiceFive sont autorisés pour la création en cours de diffusion. comme indiqué par l'éditeur.

Inclut les fournisseurs Fichier de dictionnaire gdn-vendors.txt.

Fournisseurs de données Utilisé dans le champ SegmentData.id de BidRequest Ce champ contient des informations sur l'entité qui a fourni le 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 les ID d'application, les ID de catégorie et des noms d'application intelligibles.
Tableaux géographiques La table utilisée pour décoder le champ geo_criteria_id de BidRequest Pour en savoir plus, consultez la section Ciblage géographique. des informations.
Fournisseurs pour le LGPD La liste des fournisseurs de personnalisation des annonces autorisés à diffuser des annonces sur le trafic lié à la loi LGPD avec son identifiant, un nom lisible, une URL de confidentialité et une liste de domaines qui peut être attribué au fournisseur. L'application de la LGPD est indiquée sur une demande d'enchère donnée via la BidRequest.adslot.regs_lgpd dans le protocole d'enchères Authorized Buyers et dans BidRequest.regs.ext.lgpd du 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 Mappe les ID des fournisseurs de personnalisation des annonces vers un nom lisible par l'humain, un paramètre de confidentialité l'URL de la règle et une liste des domaines pouvant être attribués au fournisseur. Actuellement, les fournisseurs sont utilisés Champ BidRequest.AdSlot.consented_providers_settings pour AdX protocole et BidRequest.User.UserExt.consented_providers_settings pour OpenRTB standard. Dans ces champs, les fournisseurs listés ont le consentement de l'utilisateur transmis par 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 à partir de votre compte commercial.

Thèmes du règlement concernant la vérification des créations

Vous pouvez utiliser les thèmes liés aux règles de ce fichier pour filtrer les créations pendant <ph type="x-smartling-placeholder"></ph> dans l'API Real-time Bidding.

Télécharger les sujets des règles sous forme de fichier CSV.

Dernière mise à jour: 18 avril 2022