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 Echtzeit-Curation-Integration. Das SegmentRequest-Objekt enthält entweder kontextbezogene Signale oder Zielgruppensignale, mit denen Sie ermitteln können, welche Ihrer Segmente für das angegebene Inventar in der SegmentResponse gelten.
Die Echtzeit-Kuratierung unterstützt SegmentRequest- und SegmentResponse-Objekte, die im JSON-Format gesendet werden.
Diese Anleitung ist eine Referenz für das Echtzeit-Curation-Protokoll, das Ihnen beim Erstellen Ihrer Integration helfen kann.
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Ein Deskriptor der Website. Das Feld site wird ausgefüllt, wenn es sich bei den werbeunterstützten Inhalten um eine Website und nicht um eine Nicht-Browser-Anwendung handelt.
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Eine Beschreibung der App. Das Feld app wird ausgefüllt, wenn es sich bei den werbeunterstützten Inhalten um eine Nicht-Browser-Anwendung und nicht um eine Website handelt.
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Ein Deskriptor 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 Partner für die kontextbezogene Kuration unterstützt. Eine eindeutige Kennung für diesen Impression im Kontext der Segmentanfrage. Der Wert beginnt bei 1 und wird für n Impressionen auf n erhöht.
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Dieses Feld wird ausgefüllt, wenn die Impression als Banneranzeigen-Chance angeboten wird.
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Dieses Feld wird ausgefüllt, wenn der Impression als Videoanzeigen-Empfehlung angeboten wird.
Dieses Feld wird mit Erweiterungen für das Imp-Objekt gefüllt.
Banner
Attribut
Typ
Beschreibung
w
int
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Breite in geräteunabhängigen Pixeln (DIPs).
h
int
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Höhe in geräteunabhängigen Pixeln (DIPs).
pos
int
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Anzeigenposition auf dem Bildschirm. Weitere Informationen zu möglichen Platzierungspositionen finden Sie in AdCOM 1.0 unter Liste: Platzierungspositionen.
Video
Attribut
Typ
Beschreibung
w
int
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Breite des Videoplayers in geräteunabhängigen Pixeln (DIPs).
h
int
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Höhe des Videoplayers in geräteunabhängigen Pixeln (DIPs).
pos
int
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Anzeigenposition auf dem Bildschirm. Weitere Informationen zu möglichen Platzierungspositionen finden Sie in AdCOM 1.0 unter Liste: Platzierungspositionen.
ImpExt
Attribut
Typ
Beschreibung
gpid
String
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Beschreibt die globale Placement-ID. Eine eindeutige, dauerhafte ID, die vom Publisher angegeben wird und für alle Angebotsquellen für jeden Anzeigenblock auf einer Seite einheitlich ist. Weitere Informationen
Website
Attribut
Typ
Beschreibung
page
String
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Die URL der Seite, auf der die Impression angezeigt wird.
mobile
int
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Gibt an, ob die Website so programmiert wurde, dass das Layout für die Anzeige auf Mobilgeräten optimiert wird. 0 = Nein, 1 = Ja.
Anwendung
Attribut
Typ
Beschreibung
bundle
String
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Eine plattformspezifische Anwendungs-ID, die für die App eindeutig sein soll. Unter Android ist das Feld bundle ein Bundle- oder Paketname. Auf iOS-Geräten ist die ID numerisch.
Publisher
Attribut
Typ
Beschreibung
id
String
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Eine Publisher-ID, die durch das Publisher-Code-Suffix des Web-Property-Codes definiert wird. Wenn ein Publisher beispielsweise den Web-Property-Code ca-pub-123 hat, wird seine ID auf pub-123 festgelegt.
Nutzer
Attribut
Typ
Beschreibung
id
String
Die Google-Nutzer-ID.
buyeruid
String
Gehostete Abgleichsdaten, die mit dem Cookie Matching Service hochgeladen wurden. Standardmäßig wird dies in websicherer Base64-Codierung ohne Padding angegeben. Sie können dieses Feld optional so konfigurieren, dass es ohne Codierung ausgefüllt wird. Wenden Sie sich dazu an Ihren Account Manager.
consent
String
Ein websicherer, Base64-codierter Einwilligungsstring für das IAB Transparency and Consent Framework (TCF) v2, der von der IAB-Plattform zur Einwilligungsverwaltung (Consent Management Platform, CMP) des Publishers abgerufen wird. Das Feld consent wird ausgefüllt, wenn der Publisher eine CMP für TCF 2.0 integriert hat und diese CMP angibt, dass die DSGVO für die Anzeigenanfrage gilt, und einen gültigen Einwilligungsstring bereitstellt. Weitere Informationen zu den im Consent-String aufgeführten Anbietern finden Sie in der IAB Global Vendor List unter vendor-list.consensu.org/v2/vendor-list.json.
Nur für Partner für die Zielgruppenzusammenstellung unterstützt. Instanzen mit erweiterter ID. Im Bereich „Curation“ sind die Daten im Feld eids Daten, die der Publisher zur Verfügung stellt, z. B. sichere Signale.
EID
Attribut
Typ
Beschreibung
source
String
Nur für Partner für die Zielgruppenzusammenstellung unterstützt. Quelle oder Technologieanbieter, der für die enthaltenen Daten verantwortlich ist. Wird als Top-Level-Domain angegeben.
Nur für Partner für die Zielgruppenzusammenstellung unterstützt. Array von UID-Objekten aus der angegebenen Quelle.
UID
Attribut
Typ
Beschreibung
id
String
Nur für Partner für die Zielgruppenzusammenstellung unterstützt. Die Kennung. Bei der Kuratierung 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 Partner für die kontextbezogene Kuration unterstützt. Standort des Nutzergeräts.
devicetype
int
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Der allgemeine Gerätetyp. Weitere Informationen zu möglichen Gerätetypen finden Sie in AdCOM 1.0 in der Liste: Gerätetypen.
os
String
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Betriebssystem des Geräts (z.B. „iOS“).
make
String
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Gerätehersteller (z. B. „Apple“)
ifa
String
Nicht verschlüsselte Geräte-Werbe-ID (nicht gehasht). Im Real-time Curation-Protokoll von Google ist dies in der Regel eine 36‑stellige UUID, wobei Android-IDs in Kleinbuchstaben und IDFAs in Großbuchstaben angegeben werden. Bei Samsung-Geräten sind das alphanumerische Werte mit 32 Zeichen.
Geo
Attribut
Typ
Beschreibung
country
String
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Land gemäß dem ISO-3166-1-Alpha-3-Standard.
region
String
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Regionscode gemäß ISO 3166-2; zweistelliger Bundesstaatscode, wenn es sich um die USA handelt.
metro
String
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Google-Großraum-Code in der Datei geo-table.csv gefunden.
city
String
Wird nur für Partner für die kontextbezogene Kuration unterstützt. Stadt mit dem UN-Code für Handels- und Transportstandorte.
Die ID für das Segment. Die ID sollte mit der curatorDataSegmentId im Namen des Segments in der curators.dataSegments-Ressource der Marketplace API übereinstimmen.
[[["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-09-23 (UTC)."],[],[]]
