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-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 accepte le protocole OpenRTB, à l'aide de l'encodage JSON ou Protobuf. Ce proto est nécessaire si vous utilisez OpenRTB/Protobuf. Il inclut également une documentation sur les champs compatibles et leur mappage avec le protocole natif de Google. | 2.6 | 22 mai 2024 |
| openrtb-adx.proto | Le protocole OpenRTB de Google inclut certaines extensions, fournies dans un fichier .proto distinct. | v.174 | 21 mai 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 Il s'agit du message que Google utilise pour demander des enchères. Un BidRequest inclut l'espace publicitaire d'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.179 | 24 mai 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.338 | 24 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 et de services qui ne sont pas autorisées par un éditeur (par exemple, si celui-ci ne souhaite pas héberger des annonces liées à la banque en ligne). |
| Catégories limitées pour les annonces | Utilisé dans le champ allowed_restricted_category de BidRequest et dans le champ restricted_category de BidResponse. Le champ allowed_restricted_category décrit les catégories qui sont normalement soumises à des restrictions, mais déclarées explicitement par un éditeur comme autorisées, par exemple les annonces incluant du contenu lié aux alcools. |
| Catégories sensibles pour les annonces | Utilisé dans le champ excluded_sensitive_category de BidRequest et dans le champ category de BidResponse. Le champ excluded_sensitive_category décrit les catégories sensibles que l'éditeur n'autorise pas, par exemple si celui-ci ne souhaite pas héberger d'annonces à caractère 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 de code. Cette liste reflète les annonceurs de l'ensemble de la place de marché, mais 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 que l'acheteur peut déclarer pour 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 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 mise en correspondance des cookies. |
| Codes d'état des créations | Used in creative_status_code renvoyé dans 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 d'enchères en temps réel. |
| Motifs d'absence d'enchère | Valeurs standards de 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é-ciblant | 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 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 non autorisées par l'éditeur. Par exemple, ils peuvent spécifier des restrictions concernant l'autorisation de l'utilisation des cookies, ou l'autorisation des annonces multimédias et/ou textuelles. |
| Secteurs des éditeurs | Utilisé dans le champ detected_vertical de BidRequest. Ce champ permet d'indiquer les secteurs de contenu de la page (semblables aux mots clés) sur lesquels l'annonce sera diffusée. Google génère ce champ en explorant la page et en identifiant 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, qui sont autorisés pour la création en cours de diffusion, 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 les ID d'application, les ID de catégorie et les noms lisibles des applications. |
| 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 pour le LGPD |
Liste des fournisseurs de personnalisation des annonces 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 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 mobiles. |
| 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, 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 du règlement concernant la vérification des créations
Vous pouvez utiliser les thèmes des règles de ce fichier pour filtrer les créations lors de la vérification dans l'API Real-time Bidding.
Téléchargez les thèmes du règlement dans un fichier CSV.Dernière mise à jour: 18 avril 2022