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.24 | 27 mars 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 | 23 mars 2024 |
| openrtb-adx.proto | Le protocole OpenRTB de Google inclut certaines extensions, fournies dans un proto distinct. | v.171 | 17 avril 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.324 | 17 avril 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.174 | 17 avril 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.331 | 17 avril 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 |
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