Spezifikation für die Echtzeit-Kuration

Google sendet eine SegmentRequest basierend auf Anzeigenanfragen, die Ihrem Zielinventar entsprechen, an Ihre Echtzeit-Curation-Integration. Das SegmentRequest-Objekt enthält entweder kontextbezogene oder sichere Signale, mit denen Sie in der SegmentResponse ermitteln können, welche Ihrer Segmente auf das jeweilige Inventar angewendet werden. Die Echtzeit-Kuration unterstützt SegmentRequest- und SegmentResponse-Objekte, die im JSON-Format gesendet werden.

Dieser Leitfaden ist eine Referenz für das Echtzeit-Curation-Protokoll, das Ihnen beim Erstellen Ihrer Integration helfen kann.

SegmentRequest

Attribut	Typ	Beschreibung
site	Website	Nur für Partner mit kontextbezogener 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.
app	App	Nur für Partner mit kontextbezogener 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.
pub	Publisher	Nur für Partner mit kontextbezogener Kuration unterstützt. Ein Deskriptor des Publishers.
user	Nutzer	Ein Deskriptor des Nutzers, der Publisher-Inhalte aufgerufen und die Segmentanfrage initiiert hat.
device	Gerät	Nur für Partner mit kontextbezogener 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.

Website

Attribut	Typ	Beschreibung
page	String	Nur für Partner mit kontextbezogener Kuration unterstützt. URL der Seite, auf der die Impression ausgeliefert wurde.

App

Attribut	Typ	Beschreibung
bundle	String	Nur für Partner mit kontextbezogener Kuration unterstützt. Eine plattformspezifische Anwendungs-ID, die für die App eindeutig sein soll. Auf Android-Geräten ist das Feld bundle ein Set- oder Paketname. Auf iOS-Geräten ist die ID numerisch.

Publisher

Attribut	Typ	Beschreibung
id	String	Nur für Partner mit kontextbezogener Kuration unterstützt. Eine Publisher-ID, die durch das Publisher-Code-Suffix des Web-Property-Codes definiert wird. Beispiel: Ein Publisher mit dem Web-Property-Code ca-pub-123 hat die ID pub-123.

Nutzer

Attribut	Typ	Beschreibung
consent	String	Ein websicherer, base64-codierter Einwilligungsstring für das IAB Transparency & 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 eingebunden hat und diese CMP angibt, dass die DSGVO für die Anzeigenanfrage gilt, und einen gültigen Einwilligungsstring bereitstellt. Details 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.
eids	EID array	Wird nur für Kuratierungspartner für sichere Signale unterstützt. Instanzen mit erweiterter ID. Im Bereich „Curation“ sind die Daten im Feld eids Daten, die vom Publisher bereitgestellt werden, z. B. 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 enthaltenen Daten verantwortlich ist. Wird als Top-Level-Domain ausgedrückt.
uids	UID array	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. Bei der Kuration 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.

Gerät

Attribut	Typ	Beschreibung
geo	Region	Nur für Partner mit kontextbezogener Kuration unterstützt. Standort des Geräts des Nutzers.

Geo

Attribut	Typ	Beschreibung
country	String	Nur für Partner mit kontextbezogener Kuration unterstützt. Land gemäß ISO 3166-1 Alpha-3.
region	String	Nur für Partner mit kontextbezogener Kuration unterstützt. Regionscode gemäß ISO 3166-2; zweistelliger Bundesstaatscode, wenn es sich um die USA handelt.
metro	String	Nur für Partner mit kontextbezogener Kuration unterstützt. Google-Metro-Code in der Datei geo-table.csv gefunden.

SegmentResponse

Attribut	Typ	Beschreibung
segment	Segment-Array	Ein Deskriptor für ein Segment.

Segment

Attribut	Typ	Beschreibung
segment_id	String	Die ID für das Segment. Die ID sollte mit dem curatorDataSegmentId im Namen des Segments in der Ressource curators.dataSegments der Marketplace API übereinstimmen.