Streamdaten für die dynamische Anzeigenbereitstellung in Echtzeit exportieren

Diese Alphafunktion ist möglicherweise nicht für Ihr Netzwerk verfügbar.

Themen in diesem Hilfeartikel

• Protokollbereitstellung
• Manifest-Bereitstellungsprotokoll
• Protokoll für ausgelieferte Werbeunterbrechungen
  • Struktur des Protokolls für ausgelieferte Werbeunterbrechungen
    • Anzeigenstatus
    • Slate-Status
• Ad-Server-Interaktionsprotokoll
   

Mithilfe von Echtzeitprotokollen für die dynamische Anzeigenbereitstellung können Sie Daten auf Streamebene nahezu in Echtzeit exportieren und so Probleme bei der Auslieferung im Blick behalten und beheben. In diesem Artikel werden die Spezifikationen der Bereitstellung von Protokolldateien, spezifische Felder und bekannte Probleme beschrieben.

Protokollbereitstellung

Die Protokolldateien werden etwa alle 5 Minuten an Publisher-spezifische Storage-Buckets in Google Cloud gesendet.

Der Bucket-Name lautet: gs://gdai-[NETWORK_CODE]

Hinweis: Wenn Sie Hilfe beim Zugriff auf den Google Cloud Storage-Bucket benötigen, können Sie sich an Ihr Account-Management-Team wenden. Sie müssen dann entweder eine Gruppe in Google Workspace angeben, die Ihr Unternehmen intern verwaltet, oder einen Nutzer in Ihrem Unternehmen benennen, der eine für Sie bereitgestellte Gruppe verwalten kann.

Dateinamen haben das folgende Format:

[Protokolltyp]_[Netzwerkcode]_[Streamtyp]_[Content ID]_[JJJJMMTT]_[HHMMSS]_
[Zufallszahl].gz

Dabei gilt:

• Protokolltyp: entweder DAIAdServerInteraction oder DAIManifest oder DAIServedBreak
• Netzwerkcode: Ad Manager-Netzwerkcode
• Streamtyp: entweder VOD (Video-on-Demand) oder Linear
• Content ID: ID der Contentquelle für VOD, Asset-Schlüssel für Livestreams
• JJMMTT, HHMMSS: Zeitpunkt der Protokollgenerierung in UTC
• Zufallszahl: eine zufällige Zahl

Die Dateien werden mit GZIP komprimiert und enthalten Daten als CSV-Werte in doppelten Anführungszeichen gemäß RFC4180. Bezüglich Abschnitt 2, Punkt 5 von RFC4180, in dem steht, dass jedes Feld in doppelte Anführungszeichen gesetzt werden kann, aber nicht muss, ist zu beachten, dass alle Daten in den Protokolldateien in doppelte Anführungszeichen gesetzt sind.

Dateien verbleiben 7 Tage im Bucket, bevor sie entfernt werden.

Hinweis: Die Felder können sich durch neue Releases ändern. Der Client sollte CSV-Dateien immer auf der Grundlage ihres Headers parsen für den Fall, dass neue Felder hinzugefügt oder alte entfernt werden.

Manifest-Bereitstellungsprotokoll

Dieses Protokoll enthält Informationen zur Bereitstellung von Video-Streams. Es enthält die folgenden Felder:

Feld**	Beschreibung
timestamp INTEGER	UTC-Zeitstempel der Anfrage (in Unixzeit)
entry_id STRING	Eindeutige ID für den Protokolleintrag Derzeit können Protokolleinträge in unserem System mehrmals vorkommen. Mit dieser ID lassen sich doppelte Einträge deduplizieren.
stream_id STRING	Eindeutige ID, die jedem Stream zugewiesen wird (auch als SAM-ID bezeichnet)
network_code INTEGER	Netzwerkcode des Publishers
dai_type STRING	Typ der dynamischen Anzeigenbereitstellung: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
content INTEGER	ID der Contentquelle
vid STRING	Video-ID
asset_key STRING	Asset-Schlüssel des Livestreams
custom_asset_key STRING	Vom Publisher definierter Asset-Schlüssel des Livestreams
manifest_type STRING	Typ des Videomanifests: MANIFEST_TYPE_HLS MANIFEST_TYPE_DASH
stream_type STRING	Streamtyp: STREAM_TYPE_VOD STREAM_TYPE_LINEAR
request_type STRING	Anfragetyp: REQUEST_TYPE_STREAM_CREATE REQUEST_TYPE_MASTER_PLAYLIST REQUEST_TYPE_MEDIA_PLAYLIST REQUEST_TYPE_MPD REQUEST_TYPE_SUBTITLES REQUEST_TYPE_INTERSTITIALS REQUEST_TYPE_IFRAME_PLAYLIST REQUEST_TYPE_AD_METADATA (ID3-Ereignisse) REQUEST_TYPE_SEGMENT_REDIRECT REQUEST_TYPE_POD_ASSET_LIST REQUEST_TYPE_POD_MULTIVARIANT REQUEST_TYPE_POD_VARIANT REQUEST_TYPE_POD_MPD REQUEST_TYPE_POD_TIMING_METADATA
beaconing_type STRING	Art des Anzeigen-Beaconings für den Stream: BEACONING_TYPE_SERVER_TRIGGERED: serverseitig BEACONING_TYPE_CLIENT_TRIGGERED: clientseitig (IMA SDK) BEACONING_TYPE_CLIENT_INITIATED_SERVER_TRIGGERED: clientseitig (DAI API; IMA SDK in naher Zukunft)
http_method STRING	In der HTTP-Anfrage verwendete Methode
user_agent STRING	User-Agent des Geräts
response_code INTEGER	HTTP-Antwortcode
response_time GLEITKOMMAZAHL	Latenz der Anfrage (in Sekunden)

Protokoll für ausgelieferte Werbeunterbrechungen

Dieses Protokoll enthält Informationen zu Werbeunterbrechungen, die an Clients mit dynamischer Anzeigenbereitstellung ausgeliefert wurden. Weitere Informationen und Beispiele dazu, wie die Informationen im Protokoll dargestellt werden, finden Sie unter Struktur des Protokolls für ausgelieferte Werbeunterbrechungen. 

Feld**	Beschreibung
timestamp INTEGER	UTC-Zeitstempel der Anfrage (in Unixzeit)
entry_id STRING	Eindeutige ID für den Protokolleintrag Derzeit können Protokolleinträge in unserem System mehrmals vorkommen. Mit dieser ID lassen sich doppelte Einträge deduplizieren.
stream_id STRING	Eindeutige ID, die jedem Stream zugewiesen wird (auch als SAM-ID bezeichnet)
network_code STRING	Netzwerkcode des Publishers
dai_type STRING	Typ der dynamischen Anzeigenbereitstellung: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
content INTEGER	ID der Contentquelle
vid STRING	Video-ID
asset_key STRING	Asset-Schlüssel des Livestreams
custom_asset_key STRING	Vom Publisher definierter Asset-Schlüssel des Livestreams
break_id STRING	ID der ausgelieferten Werbeunterbrechung Bei VOD ist dies eine Unterbrechungs-ID aus der VMAP-Datei (Video Multiple Ad Playlist), z. B. „preroll-1“ oder „midroll-2“. Bei Livestreams ist dies eine fortlaufende Unterbrechungsnummer, die dieser Werbeunterbrechung durch die dynamische Anzeigenbereitstellung zugewiesen wird, z. B. „0000000001“ oder „0000000024“.
expected_break_duration GLEITKOMMAZAHL	Der Zeitraum, für den die dynamische Anzeigenbereitstellung Anzeigen angefordert hat. Er basiert auf der erwarteten Dauer der Unterbrechung.
actual_break_duration GLEITKOMMAZAHL	Die Dauer, die die dynamische Anzeigenbereitstellung im Inhalt gefüllt hat. Das ist die summierte Dauer der Anzeigen, des Slates und der zugrunde liegenden Inhalte, die von der dynamischen Anzeigenbereitstellung in der Werbeunterbrechung gefüllt wurden.
ads_duration GLEITKOMMAZAHL	Die Länge der Anzeigenmedien in der Werbeunterbrechung. Bei VOD gibt dies auch die tatsächliche Dauer der Werbeunterbrechung an.
slate_duration GLEITKOMMAZAHL	Die Länge der Slate-Medien in der Werbeunterbrechung.
ads_status STRING	Der Status der Anzeigenbereitstellung in der Werbeunterbrechung. Weitere Informationen finden Sie unter Struktur des Protokolls für ausgelieferte Werbeunterbrechungen.
slate_status STRING	Der Status der Slate-Bereitstellung in der Werbeunterbrechung. Weitere Informationen finden Sie unter Struktur des Protokolls für ausgelieferte Werbeunterbrechungen.
complete BOOLESCH	Gibt an, ob der Anzeigen-Pod abgeschlossen wurde. Bei HLS-Streams (HTTP Live Streaming) bedeutet das, dass die dynamische Anzeigenbereitstellung eine Cue-in-Markierung eingefügt hat, der das Ende des Anzeigen-Pods signalisiert. Bei DASH-Streams (Dynamic Adaptive Streaming over HTTP) bedeutet das, dass der Anzeigenzeitraum geschlossen ist.

Struktur des Protokolls für ausgelieferte Werbeunterbrechungen

Protokolle für die über die dynamische Anzeigenbereitstellung ausgelieferten Werbeunterbrechungen enthalten Informationen darüber, wie bei der dynamischen Anzeigenbereitstellung Werbeunterbrechungen an Clients ausgeliefert werden. Die folgenden Tabellen für den Anzeigenstatus und den Slate-Status enthalten Informationen zu Protokollen für die über die dynamische Anzeigenbereitstellung ausgelieferten Werbeunterbrechungen für verschiedene Szenarien des Einfügens von Anzeigen. Weitere Informationen sind unter Protokolle für ausgelieferte Werbeunterbrechungen bei Livestreams verfügbar.

Anzeigenstatus

Nachfolgend finden Sie eine Liste der Anzeigenstatus und der jeweiligen Bedeutung.

Anzeigenstatus	Beschreibung
ADS_STATUS_INSERTED	Die Anzeigenbereitstellung war erfolgreich.
ADS_STATUS_DROPPED_UNKNOWN	Der Anzeigen-Pod wurde aus einem unbekannten Grund verworfen.
ADS_STATUS_ALL_ADS_MISSING	Der Anzeigen-Pod wurde verworfen, da alle Anzeigen im Pod fehlten.
ADS_STATUS_TOO_MANY_MIDROLLS	Der Anzeigen-Pod wurde verworfen, da vom Ad-Server mehr Mid-Roll-Pods zurückgegeben wurden als Werbeunterbrechungen, in die sie hätten eingefügt werden können.
ADS_STATUS_OUT_OF_WINDOW	Die Werbeunterbrechung liegt zum Zeitpunkt der Anfrage teilweise oder vollständig außerhalb des Zeitfensters, in dem Werbung eingefügt werden kann. Daher wird anstelle von Anzeigen der zugrunde liegende Inhalt eingefügt.
ADS_STATUS_DISABLED	Anzeigen wurden für diesen Stream deaktiviert.
ADS_STATUS_DROPPED_FOR_PREROLL	Dieser Mid-Roll-Anzeigen-Pod wurde aufgrund einer laufenden Pre-Roll-Werbeunterbrechung verworfen.
ADS_STATUS_EXPIRED	Der Anzeigen-Pod ist abgelaufen, weil die Anzeigenanfrage nicht rechtzeitig abgeschlossen wurde, um in den Inhalt eingefügt zu werden.
ADS_STATUS_HOLIDAY	Der Anzeigen-Pod wurde aufgrund eines laufenden Zeitraums ohne Anzeigen verworfen.
ADS_STATUS_DROPPED_SLATE_UNAVAILABLE	Anzeigen wurden aufgrund eines Fehlers beim Slate verworfen. Weitere Informationen finden Sie im Slate-Status.
ADS_STATUS_INTERNAL_ERROR	Bei der dynamischen Anzeigenbereitstellung ist beim Anfordern oder Einfügen von Anzeigen ein Fehler aufgetreten.
ADS_STATUS_INVALID_POD_REQUEST	Der Anzeigen-Pod wurde aufgrund einer ungültigen Pod-Anfrage verworfen.
ADS_STATUS_DROPPED_FOR_MIDROLL	Die angeforderte Pre-Roll-Werbeunterbrechung würde sich mit einer Mid-Roll-Werbeunterbrechung überschneiden.
ADS_STATUS_DROPPED_EXCEEDS_MAX_POD_FILLER_DURATION	Es sind zu viele Füllelemente für den Anzeigen-Pod erforderlich (nicht genügend Anzeigen ausgeliefert).
ADS_STATUS_DROPPED_BREAK_DURATION_TOO_SHORT	Die Dauer der Werbeunterbrechung war zu kurz, um Anzeigen anzufordern.
ADS_STATUS_DROPPED_STREAM_CREATED_AFTER_BREAK	Der Stream wurde nach dem Ende der Werbeunterbrechung erstellt.
ADS_STATUS_DROPPED_MEDIA_ANALYSIS_UNAVAILABLE	Informationen zum Contentstream, die zum Einfügen der Anzeigen erforderlich sind, fehlen oder sind nicht verfügbar.
ADS_STATUS_NO_ADS_AVAILABLE_BEFORE_DEADLINE	Bevor die Frist für die Anfrage abgelaufen ist, waren keine Anzeigen verfügbar.

Slate-Status

Im Folgenden finden Sie eine Liste der Slate-Status und ihrer Bedeutung.

Slate-Status	Beschreibung
SLATE_STATUS_INSERTED	Das Slate wurde eingefügt.
SLATE_STATUS_SKIPPED	Das Einfügen des Slates wurde aufgrund der Konfiguration des Livestream-Ereignisses übersprungen (deaktiviert, bei leeren Inhalten überspringen).
SLATE_STATUS_DROPPED_UNKNOWN	Das Slate wurde aus unbekannten Gründen nicht in diese Werbeunterbrechung eingefügt.
SLATE_STATUS_MINIMUM_INSERTED	Der Rest der Werbeunterbrechung wurde mit dem zugrunde liegenden Content gefüllt, wobei eine kleine Menge Slate eingefügt wurde, um den Übergang zwischen Werbung und Inhalt herzustellen.
SLATE_STATUS_INTERNAL_ERROR	Das Slate wurde aufgrund eines internen Fehlers nicht in diese Werbeunterbrechung eingefügt.

Ad-Server-Interaktionsprotokoll

Dieses Protokoll liefert Informationen über die Interaktionen mit einem Ad-Server, um Anzeigen abzurufen. Weitere Details und Beispiele dazu, wie die Informationen im Protokoll dargestellt werden, finden Sie unter Struktur des Ad-Server-Interaktionsprotokolls.

Feld**	Beschreibung
timestamp INTEGER	UTC-Zeitstempel der Anfrage (in Unixzeit)
entry_id STRING	Eindeutige ID für den Protokolleintrag Derzeit können Protokolleinträge in unserem System mehrmals vorkommen. Mit dieser ID lassen sich doppelte Einträge deduplizieren.
stream_id STRING	Eindeutige ID, die jedem Stream zugewiesen wird (auch als SAM-ID bezeichnet)
network_code INTEGER	Ad Manager-Netzwerkcode
dai_type STRING	Typ der dynamischen Anzeigenbereitstellung: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
content INTEGER	ID der Contentquelle
vid STRING	Video-ID
asset_key STRING	Asset-Schlüssel des Livestreams
custom_asset_key STRING	Vom Publisher definierter Asset-Schlüssel des Livestreams
pod_id INTEGER	ID der Werbeunterbrechung: Bei VOD ist dies die Werbeunterbrechungs-ID aus der VMAP-Datei. Bei Livestreams ist dies die sequenzielle Nummer der Werbeunterbrechung.
ad_server_host_name STRING	Domainname des Ad-Servers
response_time GLEITKOMMAZAHL	Latenz der Anfrage (in Sekunden)
response_type STRING	Antworttyp: VAST VMAP UNKNOWN: wird gesetzt, wenn eine ungültige Antwort empfangen wurde oder das Zeitlimit für die Antwort überschritten wurde
response_code INTEGER	HTTP-Antwortcode
row_type STRING	Typ des Protokolldateieintrags: PRIMARY_REQUEST AD_POD WRAPPER INLINE Sehen Sie sich die VMAP-Beispielantwort an. Sie enthält jeden Protokolldateityp.
vast_error_code STRING	VAST-Fehlercode
prefetch_stage STRING	Prefetch-Phase (wenn Prefetch aktiviert ist)
ad_position STRING	Position der ausgewählten Anzeige im Anzeigen-Pod Der Wert der ausgewählten Anzeigen beginnt bei 1. Dieses Feld ist für nicht verwendete eigenständige Fallback-Anzeigen und verworfene Anzeigen leer.
ad_id STRING	Anzeigen-ID*
ad_system STRING	Anzeigensystem*
ad_title STRING	Anzeigentitel*
creative_id STRING	Creative‑ID*
creative_ad_id STRING	Creative-Anzeigen-ID*
universal_ad_id_registry STRING	Registry für universelle Anzeigen-IDs*
universal_ad_id_value STRING	Wert der universellen Anzeigen-ID*
creative_duration GLEITKOMMAZAHL	Creative-Länge
mezzanine_uri STRING	Mezzanine-URI* Alles im URI wird maskiert, mit Ausnahme der Zeichen, die in RFC3986 als nicht reserviert definiert sind.
media_uri STRING	Dies ist das erste Element, das im Knoten MediaFiles gefunden wurde.* Alles im URI wird maskiert, mit Ausnahme der Zeichen, die in RFC3986 als nicht reserviert definiert sind.
break_start_uri STRING	Das Tracking-Element, das verwendet wird, um den Beginn einer Werbeunterbrechung zu erfassen. Diese Daten stammen aus der VMAP-Antwort. Alles im URI wird maskiert, mit Ausnahme der Zeichen, die in RFC3986 als nicht reserviert definiert sind.
google_video_id STRING	Eindeutige Kennung eines mit dieser Anzeige verknüpften Creatives.

* Diese Werte stammen aus VAST.

** Wenn ein Feld für eine Zeile nicht relevant ist, kann es unter Umständen leer bleiben.