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 la curation en temps réel. L'objet SegmentRequest fournit des signaux contextuels ou des signaux d'audience 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.
Disponible uniquement 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.
Disponible uniquement 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.
Disponible uniquement 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
Disponible uniquement 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.
Disponible uniquement pour les partenaires de curation contextuelle. Ce champ est renseigné si l'impression est proposée en tant qu'opportunité d'annonce de bannière.
Disponible uniquement 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
Disponible uniquement pour les partenaires de curation contextuelle. Largeur en pixels indépendants de la densité (DIPS).
h
int
Disponible uniquement pour les partenaires de curation contextuelle. Hauteur en pixels indépendants de la densité (DIPS).
pos
int
Disponible uniquement 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
Disponible uniquement pour les partenaires de curation contextuelle. Largeur du lecteur vidéo en pixels indépendants de la densité (DIPS).
h
int
Disponible uniquement pour les partenaires de curation contextuelle. Hauteur du lecteur vidéo en pixels indépendants de la densité (DIPS).
pos
int
Disponible uniquement 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
Disponible uniquement 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 tous les chemins d'approvisionnement pour chaque bloc d'annonces sur une page. Consultez cet article.
Site
Attribut
Type
Description
page
chaîne
Disponible uniquement pour les partenaires de curation contextuelle. URL de la page affichant l'impression.
mobile
int
Disponible uniquement 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
Disponible uniquement 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 identifiant numérique.
Éditeur
Attribut
Type
Description
id
chaîne
Disponible uniquement pour les partenaires de curation contextuelle. Référence éditeur définie par le suffixe du code de la propriété Web. Par exemple, si le code de la propriété Web d'un éditeur est ca-pub-123, son ID sera défini sur pub-123.
Utilisateur
Attribut
Type
Description
id
chaîne
ID utilisateur Google.
buyeruid
chaîne
Données de correspondance hébergées importées avec le service de cookie matching. Par défaut, il est spécifié dans un encodage base64 sécurisé pour le Web, sans remplissage. Vous pouvez éventuellement configurer ce champ pour qu'il soit renseigné sans encodage en contactant votre responsable de compte.
consent
chaîne
Chaîne de consentement de la version 2 du Transparency and Consent Framework (TCF) de l'IAB, 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. Consultez la liste globale des fournisseurs de l'IAB sur vendor-list.consensu.org/v2/vendor-list.json pour en savoir plus sur les fournisseurs listés dans la chaîne de consentement.
Disponible uniquement pour les partenaires de curation d'audience. Instances d'ID étendus. Dans la curation, le champ eids correspond aux données que l'éditeur met à disposition, comme les signaux sécurisés.
EID
Attribut
Type
Description
source
chaîne
Disponible uniquement pour les partenaires de curation d'audience. 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.
Disponible uniquement pour les partenaires de curation contextuelle. Emplacement de l'appareil de l'utilisateur.
devicetype
int
Disponible uniquement 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
Disponible uniquement pour les partenaires de curation contextuelle. Système d'exploitation de l'appareil (par exemple, "iOS").
make
chaîne
Disponible uniquement pour les partenaires de curation contextuelle. Marque de l'appareil (par exemple, "Apple").
ifa
chaîne
Identifiant publicitaire de l'appareil non chiffré (non haché). Dans le protocole de curation en temps réel de Google, il s'agit généralement d'un UUID de 36 caractères, où les ID Android sont en minuscules et les IDFA en majuscules. Pour les appareils Samsung, il s'agit de valeurs alphanumériques de 32 caractères.
Données géographiques
Attribut
Type
Description
country
chaîne
Disponible uniquement pour les partenaires de curation contextuelle. Pays utilisant la norme ISO-3166-1 Alpha-3.
region
chaîne
Disponible uniquement pour les partenaires de curation contextuelle. Code de région utilisant la norme ISO-3166-2 ; code d'État à deux lettres si les États-Unis.
metro
chaîne
Disponible uniquement pour les partenaires de curation contextuelle. Code d'agglomération Google trouvé dans le fichier geo-table.csv.
city
chaîne
Disponible uniquement 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 à curatorDataSegmentId 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/09/23 (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/09/23 (UTC)."],[],[]]
