Découvrir la spécification de curation en temps réel
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Google envoie une SegmentRequest en fonction des demandes d'annonces correspondant à votre inventaire ciblé pour votre intégration de curation en temps réel. L'objet SegmentRequest fournit des signaux contextuels ou sécurisés que vous pouvez utiliser pour identifier les segments qui s'appliquent à l'inventaire donné dans SegmentResponse.
La curation en temps réel est compatible avec les objets SegmentRequest et SegmentResponse envoyés au format JSON.
Ce guide de référence sur le protocole de curation en temps réel peut vous aider à créer votre intégration.
Uniquement disponible pour les partenaires de curation contextuelle. Descripteur du site Web. Le champ site est renseigné si le contenu financé par la publicité est un site Web plutôt qu'une application non liée à un navigateur.
Uniquement disponible pour les partenaires de curation contextuelle. Description de l'application. Le champ app est renseigné si le contenu avec annonces est une application autre qu'un navigateur, et non un site Web.
Uniquement disponible pour les partenaires de curation contextuelle. Descripteur de l'appareil de l'utilisateur.
segment_request_id
chaîne
Identifiant unique utilisé pour identifier la demande de segment indépendamment de toutes les autres demandes de segment.
Imp.
Attribut
Type
Description
id
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. Identifiant unique de cette impression dans le contexte de la demande de segment. La valeur commence à 1 et augmente jusqu'à n pour n impressions.
Uniquement disponible pour les partenaires de curation contextuelle. Ce champ est renseigné si l'impression est proposée comme une opportunité d'annonce display.
Uniquement disponible pour les partenaires de curation contextuelle. Ce champ est renseigné si l'impression est proposée comme une opportunité d'annonce vidéo.
Il est renseigné avec les extensions de l'objet Imp.
Bannière
Attribut
Type
Description
w
int
Uniquement disponible pour les partenaires de curation contextuelle. Largeur en pixels indépendants de la densité (DIPS).
h
int
Uniquement disponible pour les partenaires de curation contextuelle. Hauteur en pixels indépendants du périphérique (DIP).
pos
int
Uniquement disponible pour les partenaires de curation contextuelle. Position de l'annonce à l'écran. Pour en savoir plus sur les positions d'emplacement possibles, consultez Liste : Positions d'emplacement dans AdCOM 1.0.
Vidéo
Attribut
Type
Description
w
int
Uniquement disponible pour les partenaires de curation contextuelle. Largeur du lecteur vidéo en pixels indépendants de la densité (DIPS).
h
int
Uniquement disponible pour les partenaires de curation contextuelle. Hauteur du lecteur vidéo en pixels indépendants de la densité (DIPS).
pos
int
Uniquement disponible pour les partenaires de curation contextuelle. Position de l'annonce à l'écran. Pour en savoir plus sur les positions d'emplacement possibles, consultez Liste : Positions d'emplacement dans AdCOM 1.0.
ImpExt
Attribut
Type
Description
gpid
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. Décrit l'ID d'emplacement global. ID distinct et persistant, spécifié par l'éditeur, qui est cohérent sur les différents chemins d'approvisionnement pour chaque bloc d'annonces sur une page. Consultez cet article.
Site
Attribut
Type
Description
page
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. URL de la page affichant l'impression.
mobile
int
Uniquement disponible pour les partenaires de curation contextuelle. Indique si le site a été programmé pour optimiser la mise en page lorsqu'il est consulté sur des appareils mobiles (0 = non, 1 = oui).
Application
Attribut
Type
Description
bundle
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. Identifiant d'application spécifique à la plate-forme, destiné à être unique à l'application. Sur Android, le champ bundle est un nom de bundle ou de package. Sur iOS, il s'agit d'un ID numérique.
Éditeur
Attribut
Type
Description
id
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. Référence éditeur définie par le suffixe du code de propriété Web. Par exemple, si le code de propriété Web d'un éditeur est ca-pub-123, son ID sera défini sur pub-123.
Utilisateur
Attribut
Type
Description
consent
chaîne
Chaîne de consentement IAB Transparency and Consent Framework (TCF) v2 encodée en base64 et compatible avec le Web, récupérée à partir de la plate-forme de gestion du consentement (CMP) de l'IAB de l'éditeur. Le champ consent est renseigné si l'éditeur a intégré une CMP pour le TCF v2 et que cette CMP indique que le RGPD s'applique à la demande d'annonce et fournit une chaîne de consentement valide. Pour en savoir plus sur les fournisseurs listés dans la chaîne de consentement, consultez la liste globale des fournisseurs de l'IAB à l'adresse vendor-list.consensu.org/v2/vendor-list.json.
Uniquement disponible pour les curateurs partenaires de signaux sécurisés. Instances d'ID étendus. Dans la curation, le champ eids correspond aux données mises à disposition par l'éditeur, comme les signaux sécurisés.
EID
Attribut
Type
Description
source
chaîne
Uniquement disponible pour les curateurs partenaires de signaux sécurisés. Fournisseur de la source ou de la technologie responsable de l'ensemble des données incluses. Exprimé sous la forme d'un domaine de premier niveau.
Uniquement disponible pour les partenaires de curation contextuelle. Position de l'appareil de l'utilisateur.
devicetype
int
Uniquement disponible pour les partenaires de curation contextuelle. Type général d'appareil. Pour en savoir plus sur les types d'appareils possibles, consultez Liste : types d'appareils dans AdCOM 1.0.
os
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. Système d'exploitation de l'appareil (par exemple, "iOS").
make
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. Marque de l'appareil (par exemple, "Apple").
Données géographiques
Attribut
Type
Description
country
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. Pays utilisant la norme ISO-3166-1 Alpha-3.
region
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. Code de région utilisant la norme ISO-3166-2 ; code d'État à deux lettres si le pays est les États-Unis.
metro
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. Code de zone métropolitaine Google trouvé dans le fichier geo-table.csv.
city
chaîne
Uniquement disponible pour les partenaires de curation contextuelle. Ville utilisant le code des Nations Unies pour les lieux de commerce et de transport.
ID du segment. L'ID doit correspondre à l'curatorDataSegmentId figurant dans le nom du segment de la ressource curators.dataSegments de l'API Marketplace.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2026/03/31 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2026/03/31 (UTC)."],[],[]]
