Spezifikation für die Echtzeit-Kuration
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Google sendet eine
SegmentRequest
basierend auf Anzeigenanfragen, die Ihrem Zielinventar entsprechen, an Ihre Real-time
Curation-Integration. Das SegmentRequest Objekt enthält entweder kontextbezogene
Signale oder sichere Signale, mit denen Sie ermitteln können, welche Ihrer Segmente
auf das angegebene Inventar in der
SegmentResponse angewendet werden.
Real-time Curation unterstützt SegmentRequest- und SegmentResponse-Objekte, die im JSON-Format gesendet werden.
Diese Anleitung ist eine Referenz für das Real-time Curation-Protokoll, mit der Sie Ihre Integration erstellen können.
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Eine Beschreibung der Website. Das Feld site wird ausgefüllt, wenn es sich bei den Inhalten mit Anzeigenunterstützung um eine Website und nicht um eine Nicht-Browser-Anwendung handelt.
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Eine Beschreibung der App. Das Feld app wird ausgefüllt, wenn es sich bei den Inhalten mit Anzeigenunterstützung um eine Nicht-Browser-Anwendung und nicht um eine Website handelt.
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Eine Beschreibung des Geräts des Nutzers.
segment_request_id
String
Eine eindeutige Kennung, mit der die Segmentanfrage unabhängig von allen anderen Segmentanfragen identifiziert wird.
Impr.
Attribut
Typ
Beschreibung
id
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Eine eindeutige Kennung für diese Impression im Kontext der Segmentanfrage. Der Wert beginnt bei 1 und wird für n Impressionen auf n erhöht.
Dieses Feld wird mit Erweiterungen für das Objekt Imp ausgefüllt.
Banner
Attribut
Typ
Beschreibung
w
int
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Breite in geräteunabhängigen Pixeln (DIPs).
h
int
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Höhe in geräteunabhängigen Pixeln (DIPs).
pos
int
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Anzeigenposition auf dem Bildschirm. Weitere Informationen zu möglichen Platzierungspositionen finden Sie unter Liste: Platzierungspositionen in AdCOM 1.0.
Video
Attribut
Typ
Beschreibung
w
int
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Breite des Videoplayers in geräteunabhängigen Pixeln (DIPs).
h
int
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Höhe des Videoplayers in geräteunabhängigen Pixeln (DIPs).
pos
int
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Anzeigenposition auf dem Bildschirm. Weitere Informationen zu möglichen Platzierungspositionen finden Sie unter Liste: Platzierungspositionen in AdCOM 1.0.
ImpExt
Attribut
Typ
Beschreibung
gpid
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Beschreibt die globale Placement-ID. Eine eindeutige, dauerhafte ID, die vom Publisher angegeben wird und für alle Angebotswege für jeden Anzeigenblock auf einer Seite gleich ist. Weitere Informationen in diesem Artikel.
Website
Attribut
Typ
Beschreibung
page
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. URL der Seite, auf der die Impression zu sehen ist.
mobile
int
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Gibt an, ob die Website für die Anzeige auf Mobilgeräten optimiert wurde. 0 = nein, 1 = ja.
App
Attribut
Typ
Beschreibung
bundle
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Eine plattformspezifische Anwendungs-ID, die für die App eindeutig sein soll. Unter Android ist das Feld bundle ein Bundle- oder Paketname. Unter iOS ist es eine numerische ID.
Publisher
Attribut
Typ
Beschreibung
id
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Eine Publisher-ID, die durch das Suffix des Publisher-Codes des Web-Property-Codes definiert wird. Ein Publisher mit dem Web-Property-Code ca-pub-123 hat beispielsweise die ID pub-123.
Nutzer
Attribut
Typ
Beschreibung
consent
String
Ein websicherer, base64-codierter Einwilligungsstring gemäß IAB Transparency and Consent Framework (TCF) v2, der von der IAB Consent Management Platform (CMP) des Publishers abgerufen wurde. Das Feld consent wird ausgefüllt, wenn der Publisher eine CMP für TCF v2 eingebunden hat und diese CMP angibt, dass die DSGVO für die Anzeigenanfrage gilt, und einen gültigen Einwilligungsstring bereitstellt. Weitere Informationen zu den im Einwilligungsstring aufgeführten Anbietern finden Sie in der globalen Anbieterliste des IAB unter vendor-list.consensu.org/v2/vendor-list.json.
Wird nur für Kuratierungspartner für sichere Signale unterstützt. Erweiterte ID-Instanzen. In Curation sind die Daten im Feld eids vom Publisher bereitgestellte Daten wie sichere Signale.
EID
Attribut
Typ
Beschreibung
source
String
Wird nur für Kuratierungspartner für sichere Signale unterstützt. Quelle oder Technologieanbieter, der für die Gruppe der enthaltenen Daten verantwortlich ist. Wird als Top-Level-Domain ausgedrückt.
Wird nur für Kuratierungspartner für sichere Signale unterstützt. Array von UID-Objekten aus der angegebenen Quelle.
UID
Attribut
Typ
Beschreibung
id
String
Wird nur für Kuratierungspartner für sichere Signale unterstützt. Die Kennung. In Curation ist das Feld id ein sicheres Signal. Weitere Informationen zu sicheren Signalen finden Sie im Ad Manager-Hilfeartikel Sichere Signale für Bieter und Kuratierungspartner freigeben.
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Standort des Geräts des Nutzers.
devicetype
int
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Der allgemeine Gerätetyp. Weitere Informationen zu möglichen Gerätetypen finden Sie unter Liste: Gerätetypen in AdCOM 1.0.
os
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Betriebssystem des Geräts (z.B. „iOS“).
make
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Gerätehersteller (z.B. „Apple“).
Region
Attribut
Typ
Beschreibung
country
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Land gemäß ISO 3166-1 Alpha-3.
region
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Regionscode gemäß ISO 3166-2; 2-stelliger Staatscode, wenn USA.
metro
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Google-Metro-Code aus der Datei geo-table.csv.
city
String
Wird nur für kontextbezogene Kuratierungspartner unterstützt. Stadt gemäß UN/LOCODE.
Die ID für das Segment. Die ID muss mit der curatorDataSegmentId übereinstimmen, die im Namen des Segments in der Marketplace API-Ressource curators.dataSegments zu finden ist.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2026-03-31 (UTC)."],[],[]]
