Découvrir la spécification de curation en temps réel

Google envoie une SegmentRequest en fonction des demandes d'annonces correspondant à votre inventaire ciblé à 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.

SegmentRequest

Attribut	Type	Description
site	Site	Uniquement disponible pour les partenaires de curation contextuelle. Descripteur du site Web. Le champ site est renseigné si le contenu avec annonces est un site Web plutôt qu'une application non liée à un navigateur.
app	Application	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.
pub	Éditeur	Uniquement disponible pour les partenaires de curation contextuelle. Descripteur de l'éditeur.
user	Utilisateur	Descripteur de l'utilisateur qui a lancé la demande de segment en parcourant le contenu de l'éditeur.
device	Appareil	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.

Site

Attribut	Type	Description
page	chaîne	Uniquement disponible pour les partenaires de curation contextuelle. URL de la page affichant l'impression.

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, un éditeur dont le code de propriété Web est ca-pub-123 verra son ID défini sur pub-123.

Utilisateur

Attribut	Type	Description
consent	chaîne	Chaîne de consentement basée sur le format base64 et compatible avec le Web, issue de la version 2 du Transparency and Consent Framework (TCF) de l'IAB, récupérée à partir de la plate-forme de gestion du consentement de l'IAB (CMP) 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.
eids	Tableau EID	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.
uids	UID array	Uniquement disponible pour les curateurs partenaires de signaux sécurisés. Tableau d'objets UID de la source donnée.

UID

Attribut	Type	Description
id	chaîne	Uniquement disponible pour les curateurs partenaires de signaux sécurisés. Identifiant. Dans la curation, le champ id est un signal sécurisé. Pour en savoir plus sur les signaux sécurisés, consultez Partager des signaux sécurisés avec des enchérisseurs et des curateurs partenaires dans Ad Manager.

Appareil

Attribut	Type	Description
geo	Données géographiques	Uniquement disponible pour les partenaires de curation contextuelle. Position de l'appareil de l'utilisateur.

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.

SegmentResponse

Attribut	Type	Description
segment	Tableau Segment	Descripteur d'un segment.

Segment

Attribut	Type	Description
segment_id	chaîne	ID du segment. L'ID doit correspondre à curatorDataSegmentId dans le nom du segment de la ressource curators.dataSegments de l'API Marketplace.