Dynamische Anzeigenbereitstellung – Live-API für die Pod-Auslieferung

Mit der Dynamic Ad Insertion API kannst du Livestreams mit dynamischer Anzeigenbereitstellung anfordern und erfassen.

Dienst: dai.google.com

Alle URIs sind relativ zu https://dai.google.com.

Methode: stream

Methoden
stream POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

Registriert eine Livestreamsitzung mit dynamischer Anzeigenbereitstellung und Pod-Auslieferung.

HTTP-Anfrage

POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

Pfadparameter

Parameter
network_code string

Der Google Ad Manager-Netzwerkcode des Publishers.

custom_asset_key string

Die benutzerdefinierte Kennung, die diesem Ereignis in Google Ad Manager zugewiesen ist.

Anfragetext

Der Anfragetext hat den Typ application/x-www-form-urlencoded und enthält die folgenden Parameter:

Parameter
DFP-Targeting-Parameter Optional Zusätzliche Targeting-Parameter
Streamparameter überschreiben Optional Standardwerte eines Parameters für die Streamerstellung überschreiben.
HMAC-Authentifizierung Optional Mit einem HMAC-basierten Token authentifizieren.

Antworttext

Bei Erfolg enthält der Antworttext ein neues Stream-Objekt.

Open Measurement

Die DAI API enthält Informationen zur Open Measurement-Überprüfung im Feld Verifications. Dieses Feld enthält ein oder mehrere Verification-Elemente mit den Ressourcen und Metadaten, die zum Ausführen des Messcodes von Drittanbietern zur Überprüfung der Creative-Wiedergabe erforderlich sind. Nur JavaScriptResource wird unterstützt. Weitere Informationen finden Sie im IAB Tech Lab und in der VAST 4.1-Spezifikation.

Methode: Pod-Segment

Methoden
pod segment GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

Erstellt einen DAI-Stream für die angegebene Ereignis-ID.

HTTP-Anfrage

GET https://dai.google.com/linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

Pfadparameter

Parameter
network_code string

Der Google Ad Manager-Netzwerkcode des Publishers.

custom_asset_key string

Die benutzerdefinierte Kennung, die diesem Ereignis in Google Ad Manager zugewiesen ist.

pod_identifier

Die folgenden Formate werden unterstützt:

pod/{integer}

Die numerische Kennung für die aktuelle Werbeunterbrechung. Anzeigen-Pod-IDs werden für jedes Werbeunterbrechungsereignis inkrementell zugewiesen, beginnend mit 1.

ad_break_id/{string}

Die String-ID für die aktuelle Werbeunterbrechung.
profile_name string

Der Name des angeforderten Google Ad Manager-Codierungsprofils für die dynamische Anzeigenbereitstellung. Das Codierungsprofil muss eines der konfigurierten Codierungsprofile für das ausgewählte Ereignis sein.

segment_number integer

Der Index des angeforderten Segments im aktuellen Anzeigen-Pod, beginnend bei null.
segment_format string

Die Dateiendung, die dem angeforderten Segmentformat zugeordnet ist. Zulässige Erweiterungen sind: ts, mp4, vtt, aac, ac3 oder eac3.

Abfrageparameter

Parameter
stream_id required string

Die Stream-ID für die Sitzung des aktuellen Nutzers. Dieser Wert wird bei einer erfolgreichen Anfrage an den stream-Endpunkt zurückgegeben.
sd required1 integer

Die Dauer des angeforderten Segments in Millisekunden.
so optional

Der Offset des angeforderten Segments innerhalb des Anzeigen-Pods in Millisekunden. Wenn Sie den Parameter so weglassen, wird er berechnet, indem die Segmentdauer mit der Segmentnummer multipliziert wird.
pd erforderlich2 integer

Die Dauer des Anzeigen-Pods in Millisekunden.
auth-token required string

Ein signiertes, URL-codiertes HMAC-Token für den aktuellen Anzeigen-Pod.
last optional boolean

Gibt das letzte Segment in der Werbeunterbrechung an. Lassen Sie diesen Parameter für alle anderen Segmente weg.
scte35 optional string

Base64-codiertes SCTE-35-Signal für diese Werbeunterbrechung.
cust_params optional string

Mehrere Schlüssel/Wert-Paare, die für das Targeting einer Ad Manager-Kampagne verwendet werden. Diese Paare müssen als URL-codierter Abfragestring dargestellt werden.

Beispiel:
Parameter
  • section = sports
  • Seite = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Fußnoten

  1. sd ist für Initialisierungssegmente nicht erforderlich. ↩
  2. pd ist für Ereignisse mit aktivierten werbungsfreien Werbeunterbrechungen nicht erforderlich. ↩

Beispiel

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbreak-2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

Antworttext

Bei Erfolg enthält der Antworttext ein abspielbares Streamsegment, das dem in der Anfrage angegebenen Format und den angegebenen Parametern entspricht.

Methode: HLS-Pod-Manifest

Ruft ein HLS-Manifest für einen Anzeigen-Pod eines Livestreams ab, das für das Laden und Abspielen durch einen Client-Videoplayer bereit ist.

Methoden
GET GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/{pod_identifier}.m3u8;

API zum Abrufen einer HLS-Playlist mit mehreren Varianten für einen Anzeigen-Pod.

HTTP-Anfrage

GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}.m3u8?stream_id={stream_id}&pd={pod_duration}

Pfadparameter

Parameter
network_code string

Der Google Ad Manager-Netzwerkcode des Publishers.
custom_asset_key string

Die benutzerdefinierte Kennung, die diesem Ereignis in Google Ad Manager zugewiesen ist
pod_identifier

Die folgenden Formate werden unterstützt:

pod/{integer}

Die numerische Kennung für die aktuelle Werbeunterbrechung. Anzeigen-Pod-IDs werden für jedes Werbeunterbrechungsereignis inkrementell zugewiesen, beginnend mit 1.

ad_break_id/{string}

Die String-ID für die aktuelle Werbeunterbrechung.

Abfrageparameter

Parameter
stream_id Erforderlich string

Die Stream-ID für die Sitzung des aktuellen Nutzers. Dieser Wert wird bei einer erfolgreichen Anfrage an den stream-Endpunkt zurückgegeben.
pd Erforderlich integer

Die Dauer des Anzeigen-Pods in Millisekunden.
scte35 optional string

Base64-codiertes SCTE-35-Signal für diese Werbeunterbrechung.
cust_params optional string

Mehrere Schlüssel/Wert-Paare, die für das Targeting einer Ad Manager-Kampagne verwendet werden. Diese Paare müssen als URL-codierter Abfragestring dargestellt werden.

Beispiel:
Parameter
  • section = sports
  • Seite = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Antworttext

Bei Erfolg enthält der Antworttext eine HLS-Playlist mit mehreren Varianten.

Methode: DASH-Pod-Manifest

Ruft ein MPEG-DASH-Anzeigen-Pod-Manifest eines Livestreams ab, das von einem Client-Videoplayer geladen und wiedergegeben werden kann.

Methoden
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/manifest.mpd

API zum Abrufen einer MPEG-DASH-MPD-Playlist für einen Anzeigen-Pod.

HTTP-Anfrage

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/stream/{stream_id}/pod/{pod_id}/manifest.mpd?pd={pod_duration}

Pfadparameter

Parameter
network_code string

Der Google Ad Manager-Netzwerkcode des Publishers.
custom_asset_key string

Die benutzerdefinierte Kennung, die diesem Ereignis in Google Ad Manager zugewiesen ist
stream_id string

Die Stream-ID für die Sitzung des aktuellen Nutzers. Dieser Wert wird bei einer erfolgreichen Anfrage an den stream-Endpunkt zurückgegeben.
pod_id integer

Die numerische Kennung für die aktuelle Werbeunterbrechung. Anzeigen-Pod-IDs werden für jedes Werbeunterbrechungsereignis inkrementell zugewiesen, beginnend mit 1.

Abfrageparameter

Parameter
pd Erforderlich integer

Die Dauer des Anzeigen-Pods in Millisekunden.
scte35 optional string

Base64-codiertes SCTE-35-Signal für diese Werbeunterbrechung.
cust_params optional string

Mehrere Schlüssel/Wert-Paare, die für das Targeting einer Ad Manager-Kampagne verwendet werden. Diese Paare müssen als URL-codierter Abfragestring dargestellt werden.

Beispiel:
Parameter
  • section = sports
  • Seite = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

Antworttext

Bei Erfolg enthält der Antworttext eine MPEG-DASH-mpd-Playlist.

Methode: DASH-Pod-Zeitraumvorlage

Methoden
pods GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Hier wird eine DASH-Zeitraumvorlage von Google Ad Manager angefordert. Diese Vorlage enthält Makros, die Sie mit Ihren Streamparametern ausfüllen müssen. Sobald diese Makros ausgefüllt sind, wird die Vorlage zu deinem Werbeunterbrechungszeitraum und kann in dein DASH-Manifest eingefügt werden.

HTTP-Anfrage

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Pfadparameter

Parameter
network_code string

Der Google Ad Manager-Netzwerkcode des Publishers.

custom_asset_key string

Die benutzerdefinierte Kennung, die diesem Ereignis in Google Ad Manager zugewiesen ist.

Abfrageparameter

Parameter
stream_id required string

Die Stream-ID für die Sitzung des aktuellen Nutzers. Dieser Wert wird bei einer erfolgreichen Anfrage an den stream-Endpunkt zurückgegeben.

Antworttext

Bei Erfolg enthält der Antworttext ein neues PodTemplateResponse-Objekt.

Methode: Medienüberprüfung

Wenn während der Wiedergabe eine Anzeigen-Media-ID erkannt wird, sende sofort eine Anfrage mit der media_verification_url, die du oben über den stream-Endpunkt abgerufen hast. Diese Anfragen sind für serverseitige Beaconing-Streams nicht erforderlich, bei denen der Server die Medienüberprüfung initiiert.

Anfragen an den media verification-Endpunkt sind idempotent.

Methoden
media verification GET /{media_verification_url}/{ad_media_id}

Benachrichtigt die API über ein Ereignis der Medienüberprüfung.

HTTP-Anfrage

GET https://{media-verification-url}/{ad-media-id}

Antworttext

media verification gibt die folgenden Antworten zurück:

  • HTTP/1.1 204 No Content, wenn die Medienüberprüfung erfolgreich war und alle Pings gesendet wurden.
  • HTTP/1.1 404 Not Found, wenn die Medien aufgrund einer falschen URL-Formatierung oder eines Ablaufdatums nicht überprüft werden können.
  • HTTP/1.1 404 Not Found, wenn eine vorherige Bestätigungsanfrage für diese ID erfolgreich war.
  • HTTP/1.1 409 Conflict, wenn zu diesem Zeitpunkt bereits Pings von einer anderen Anfrage gesendet werden.

Anzeigenmedien-IDs

Anzeigenmedien-IDs werden in einem separaten Metadaten-Track codiert – zeitbezogene Metadaten für HLS-Transportstreams oder emsg für MP4-Dateien. IDs für Anzeigenmedien beginnen immer mit der Zeichenfolge google_.

Der gesamte Textinhalt des Metadateneintrags muss der URL für die Anzeigenüberprüfung vor jeder Anfrage zur Anzeigenüberprüfung angehängt werden.

Methode: metadata

Der Metadaten-Endpunkt unter metadata_url gibt Informationen zurück, die zum Erstellen einer Anzeigen-UI verwendet werden. Der Metadatenendpunkt ist nicht für serverseitige Beaconing-Streams verfügbar, bei denen der Server für die Initiierung der Überprüfung von Anzeigenmedien verantwortlich ist.

Methoden
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

Ruft Informationen zu Anzeigenmetadaten ab.

HTTP-Anfrage

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

Antworttext

Bei Erfolg gibt die Antwort eine Instanz von PodMetadata zurück.

Metadaten parsen

Metadaten haben drei separate Abschnitte: tags, ads und breaks. Der Einstiegspunkt in die Daten ist der Abschnitt tags. Gehe dann die Tags durch und suche nach dem ersten Eintrag, dessen Name ein Präfix für die Anzeigenmedien-ID im Videostream ist. Eine Anzeigenmedien-ID könnte beispielsweise so aussehen:

google_1234567890

Dann finden Sie ein Tag-Objekt mit dem Namen google_12345. In diesem Fall entspricht sie der Anzeigenmedien-ID. Nachdem du das richtige Anzeigen-Medien-Präfix-Objekt gefunden hast, kannst du Anzeigen-IDs, Werbeunterbrechungs-IDs und den Ereignistyp abrufen. Anzeigen-IDs werden dann zum Indexieren der ads-Objekte und Werbeunterbrechungs-IDs zum Indexieren der breaks-Objekte verwendet.

Antwortdaten

Stream

Mit „Stream“ wird eine Liste von Ressourcen für einen neu erstellten Stream im JSON-Format gerendert.
JSON-Darstellung
{
  "stream_id": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "heartbeat_url": string,
  "polling_frequency": number,
  "pod_manifest_url": string,
  "manifest_format": string,
}
Felder
stream_id string

Die GAM-Stream-ID.
media_verification_url string

Die URL für die Medienüberprüfung, die als Basisendpunkt für das Erfassen von Wiedergabeereignissen verwendet wird.
metadata_url string

Metadaten-URL, über die regelmäßig Informationen zu bevorstehenden Anzeigenereignissen im Stream abgerufen werden.
session_update_url string

Die Aktualisierungs-URL der Sitzung, mit der die Targeting-Parameter für diesen Stream aktualisiert werden. Die ursprünglichen Werte für die Targeting-Parameter werden bei der ersten Anfrage zum Erstellen des Streams erfasst.
heartbeat_url string

Die Heartbeat-URL, die dazu dient, den serverseitigen Beaconing-Stream aktiv zu halten. Sie muss alle {PollingFrequency} Sekunden gepingt werden. Wird für serverseitige Beaconing-Streams ausgefüllt.
polling_frequency number

Die Abfragehäufigkeit in Sekunden, wenn „metadata_url“ oder „heartbeat_url“ angefordert wird.
pod_manifest_url string

Mit der URL-Vorlage für das Pod-Manifest wird die URL generiert, über die das Pod-Manifest eines Streams abgerufen wird. Sie entspricht der URL der mehrvariantigen Playlist in HLS oder der MPD in DASH. Wird für Livestream-Ereignisse vom Typ „Dynamic Ad Insertion“ (POD_SERVING_MANIFEST) ausgefüllt. https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType
manifest_format string

Manifestformat ist das Format des Manifests, das von pod_manifest_url abgerufen wird, entweder dash oder hls.

PodMetadata

„PodMetadata“ enthält Metadaten zu Anzeigen, Werbeunterbrechungen und Media-ID-Tags.
JSON-Darstellung
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}
Felder
tags map[string, object(TagSegment)]

Zuordnung von Tag-Segmenten, die nach Tag-Präfix indexiert sind
ads map[string, object(Ad)]

Karte mit Anzeigen, die nach Anzeigen-ID indexiert sind.
ad_breaks map[string, object(AdBreak)]

Zuordnung von Werbeunterbrechungen, die nach der ID der Werbeunterbrechung indexiert sind.

TagSegment

„TagSegment“ enthält einen Verweis auf eine Anzeige, ihre Werbeunterbrechung und den Ereignistyp. Für TagSegmente vom Typ „progress“ sollte kein Ping an den Endpunkt zur Überprüfung von Anzeigenmedien gesendet werden.
JSON-Darstellung
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
Felder
ad string

Die ID der Anzeige dieses Tags.
ad_break_id string

Die ID der Werbeunterbrechung dieses Tags.
type string

Der Ereignistyp dieses Tags.

AdBreak

„AdBreak“ beschreibt eine einzelne Werbeunterbrechung im Stream. Sie enthält eine Dauer, einen Typ (Mitte/Vor/Nach) und die Anzahl der Anzeigen.
JSON-Darstellung
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
Felder
type string

Gültige Werbeunterbrechungstypen sind „pre“, „mid“ und „post“.
duration number

Gesamtdauer der Anzeigen in dieser Werbeunterbrechung in Sekunden.
expected_duration number

Voraussichtliche Dauer der Werbeunterbrechung (in Sekunden), einschließlich aller Anzeigen und Slates.
ads number

Anzahl der Anzeigen in der Werbeunterbrechung.
„Anzeige“ beschreibt eine Anzeige im Stream.
JSON-Darstellung
{
  "ad_break_id": string,
  "position": number,
  "duration": number,
  "title": string,
  "description": string,
  "advertiser": string,
  "ad_system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
  "clickthrough_url": string,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}
Felder
ad_break_id string

Die ID der Werbeunterbrechung dieser Anzeige.
position number

Position dieser Anzeige in der Werbeunterbrechung, beginnend bei 1.
duration number

Dauer der Anzeige in Sekunden.
title string

Optionaler Titel der Anzeige.
description string

Optionale Beschreibung der Anzeige.
advertiser string

Optionale Werbetreibenden-ID.
ad_system string

Optionales Anzeigensystem
ad_id string

Optionale Anzeigen-ID.
creative_id string

Optionale Creative-ID.
creative_ad_id string

Optionale Creative-Anzeigen-ID.
deal_id string

Optionale Deal-ID.
clickthrough_url string

Optionale Klick-URL
click_tracking_urls string

Optionale Klick-Tracking-URLs
verifications [object(Verification)]

Optionale Open Measurement-Bestätigungseinträge, die die Ressourcen und Metadaten enthalten, die zum Ausführen des Messcodes von Drittanbietern zur Überprüfung der Creative-Wiedergabe erforderlich sind.
slate boolean

Optionaler boolescher Wert, der angibt, ob der aktuelle Eintrag ein Slate ist.
icons [object(Icon)]

Eine Liste von Symbolen, die bei leerem Wert weggelassen wird.
wrappers [object(Wrapper)]

Eine Liste von Wrappern, die bei leerer Angabe weggelassen wird.
universal_ad_id object(UniversalAdID)

Optionale universelle Anzeigen-ID.
extensions string

Optionale Liste aller <Extension>-Knoten im VAST.
companions [object(Companion)]

Optionale Companion-Anzeigen, die zusammen mit dieser Anzeige ausgeliefert werden können.
interactive_file object(InteractiveFile)

Optionales interaktives Creative (SIMID), das während der Anzeigenwiedergabe eingeblendet werden soll.

PodTemplateResponse

„PodTemplateResponse“ ist die JSON-Nutzlast, die an eine VTP für das Stitching von Pods zurückgegeben wird.
JSON-Darstellung
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
Felder
dash_period_template string

DashPeriodTemplate ist die XML-Vorlage für den Zeitraum, der vor dem Zusammenführen mit entsprechenden Daten gefüllt werden muss.
segment_duration_ms int64

SegmentDurationMS ist die Dauer der Zeitsegmente in Millisekunden.

AdpodTimingMetadataResponse

„AdpodTimingMetadataResponse“ enthält Informationen zum Anzeigen-Pod und dazu, wie Segment-URLs dafür erstellt werden.
JSON-Darstellung
{
  "status": string,
  "ads": [object(AdRendering)],
  "slate": object(SlateRendering),
  "dash_representations": map[string, object(DASHRepresentation)],
  "dash_adaptation_sets": map[string, object(DASHAdaptationSet)],
}
Felder
status string

Entscheidungsstatus für den Anzeigen-Pod.
ads [object(AdRendering)]

Array mit Anzeigenobjekten, das beschreibt, wie die URLs der Anzeigensegmente gerendert werden sollen, beginnend mit der Indexierung 0.
slate object(SlateRendering)

Slate, in dem beschrieben wird, wie die Slate-Segment-URLs gerendert werden.
dash_representations map[string, object(DASHRepresentation)]

Liste der DASH-Darstellungen für diesen Anzeigen-Pod, die in DASH-Manifesten gerendert werden sollen.
dash_adaptation_sets map[string, object(DASHAdaptationSet)]

Liste der DASH-Anpassungssätze für diesen Anzeigen-Pod, die in DASH-Manifesten gerendert werden sollen.

AdRendering

Unter „Anzeigenrendering“ wird beschrieben, wie eine Anzeige gerendert wird, für die eine Entscheidung getroffen wurde.
JSON-Darstellung
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
Felder
duration_ms number

Dauer der Anzeige in Millisekunden (int).
variants map[string, object(VariantRendering)]

Dictionary of Variant objects (siehe unten), indexiert nach der Variante/Profil-ID, wie in der Benutzeroberfläche konfiguriert.

SlateRendering

Unter „Slate-Rendering“ wird beschrieben, wie Slate-Inhalte gerendert werden.
JSON-Darstellung
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
Felder
duration_ms number

Dauer des Slates in Millisekunden (int).
variants map[string, object(VariantRendering)]

Dictionary of Variant objects, indexed by variant/profile ID. Die Dauer des Slates muss so lange wiederholt werden, bis die erforderliche Slate-Länge erreicht ist. Dabei können zwischen den Iterationen HLS-Unterbrechungen eingefügt oder neue Zeiträume für MPEG-DASH wiederholt werden.

VariantRendering

„VariantRendering“ beschreibt eine Variante/ein Profil innerhalb der Anzeige/Liste.
JSON-Darstellung
{
  "segment_extension": string,
  "segment_durations": object(SegmentDurations),
}
Felder
segment_extension string

String, eine der folgenden Optionen: ts, mp4, aac, ac3, ec3, m4a, m4v. Dateiendung der Segment-URLs.
segment_durations object(SegmentDurations)

SegmentDurations-Objekte. Jede Segmentdauer kann in eine Segment-URL umgewandelt werden.

SegmentDurations

„SegmentDurations“ gibt die Dauer einer Sequenz von Segmenten in einer bestimmten Zeiteinheit an.
JSON-Darstellung
{
  "timescale": number,
  "values": [],
}
Felder
timescale number

Zeitachse ist die Anzahl der Einheiten pro Sekunde (int) Erforderlich: 1.000 für HLS (Millisekunden) 90.000 für DASH-Video (PTS) Audio-Stichprobenrate für DASH-Audio.
values number

Array mit Segmentdauern in Zeiteinheiten.

DASHRepresentation

DASHRepresentation beschreibt Darstellungsknoten, die in DASH-Manifesten gerendert werden.
JSON-Darstellung
{
  "codecs": string,
  "bandwidth": number,
  "width": number,
  "height": number,
  "frame_rate": string,
  "audio_sampling_rate": number,
  "audio_channel_config": object(SchemeIDURIAndValue),
}
Felder
codecs string

Codecs der Darstellung.
bandwidth number

Bandbreite der Darstellung.
width number

Breite der Darstellung.
height number

Höhe der Darstellung.
frame_rate string

Framerate der Darstellung.
audio_sampling_rate number

Audio-Abtastrate der Darstellung.
audio_channel_config object(SchemeIDURIAndValue)

Audiokanalkonfiguration der Darstellung.

DASHAdaptationSet

DASHAdaptationSet beschreibt AdaptationSet-Knoten, die in DASH-Manifesten gerendert werden.
JSON-Darstellung
{
  "content_type": string,
  "mime_type": string,
  "role": object(SchemeIDURIAndValue),
  "inband_event_stream": object(SchemeIDURIAndValue),
  "min_frame_rate": string,
  "max_frame_rate": string,
  "scan_type": string,
  "start_with_sap": string,
  "segment_alignment": boolean,
  "representations": [],
}
Felder
content_type string

Inhaltstyp des Anpassungssatzes.
mime_type string

MIME-Typ des Anpassungssatzes.
role object(SchemeIDURIAndValue)

Rolle des Anpassungssatzes.
inband_event_stream object(SchemeIDURIAndValue)

In-Band-Ereignisstream des Anpassungssatzes.
min_frame_rate string

Mindest-Framerate des Anpassungssets.
max_frame_rate string

Maximale Framerate des Anpassungssets.
scan_type string

Scantyp des Anpassungssatzes.
start_with_sap string

Beginnen Sie mit dem SAP des Anpassungssatzes.
segment_alignment boolean

Segmentausrichtung des Anpassungssatzes
representations string

Darstellungen des Anpassungssatzes.

SchemeIDURIAndValue

„SchemeIDURIAndValue“ ist ein Paar aus einer Schema-ID und ihrem Wert.
JSON-Darstellung
{
  "scheme_id_uri": string,
  "value": string,
}
Felder
scheme_id_uri string

URI der Schema-ID des Werts.
value string

Wert der URI der Schema-ID.

Symbol

Das Symbol enthält Informationen zu einem VAST-Symbol.
JSON-Darstellung
{
  "click_data": object(ClickData),
  "creative_type": string,
  "click_fallback_images": [object(FallbackImage)],
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "x_position": string,
  "y_position": string,
  "program": string,
  "alt_text": string,
}
Felder
click_data object(ClickData)

creative_type string

click_fallback_images [object(FallbackImage)]

height int32

width int32

resource string

type string

x_position string

y_position string

program string

alt_text string

ClickData

„ClickData“ enthält Informationen zu einem Klick auf ein Symbol.
JSON-Darstellung
{
  "url": string,
}
Felder
url string

FallbackImage

FallbackImage enthält Informationen zu einem VAST-Fallback-Bild.
JSON-Darstellung
{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}
Felder
creative_type string

height int32

width int32

resource string

alt_text string

Wrapper

Der Wrapper enthält Informationen zu einer Wrapper-Anzeige. Eine Deal-ID ist nicht enthalten, wenn keine vorhanden ist.
JSON-Darstellung
{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}
Felder
system string

ID des Anzeigensystems.
ad_id string

Die Anzeigen-ID, die für die Wrapper-Anzeige verwendet wird.
creative_id string

Creative-ID, die für die Wrapper-Anzeige verwendet wird.
creative_ad_id string

Creative-Anzeigen-ID, die für die Wrapper-Anzeige verwendet wird.
deal_id string

Optionale Deal-ID für die Wrapper-Anzeige.

Überprüfung

Die Bestätigung enthält Informationen für Open Measurement, die die Sichtbarkeits- und Überprüfungsmessung durch Drittanbieter erleichtern. Derzeit werden nur JavaScript-Ressourcen unterstützt. Weitere Informationen finden Sie unter https://iabtechlab.com/standards/open-measurement-sdk/.
JSON-Darstellung
{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}
Felder
vendor string

Der Überprüfungsanbieter.
java_script_resources [object(JavaScriptResource)]

Liste der JavaScript-Ressourcen für die Überprüfung.
tracking_events [object(TrackingEvent)]

Liste der Tracking-Ereignisse für die Bestätigung.
parameters string

Ein undurchsichtiger String, der an den Bootstrap-Bestätigungscode übergeben wird.

JavaScriptResource

„JavaScriptResource“ enthält Informationen zur Überprüfung über JavaScript.
JSON-Darstellung
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
Felder
script_url string

URI zum JavaScript-Nutzlast
api_framework string

APIFramework ist der Name des Video-Frameworks, das den Bestätigungscode verwendet.
browser_optional boolean

Ob dieses Script außerhalb eines Browsers ausgeführt werden kann.

TrackingEvent

„TrackingEvent“ enthält URLs, die in bestimmten Situationen vom Client gepingt werden sollen.
JSON-Darstellung
{
  "event": string,
  "uri": string,
}
Felder
event string

Der Typ des Tracking-Ereignisses.
uri string

Das Tracking-Ereignis, an das ein Ping gesendet werden soll.

UniversalAdID

Mit der UniversalAdID wird eine eindeutige Creative-ID bereitgestellt, die in allen Werbesystemen verwendet wird.
JSON-Darstellung
{
  "id_value": string,
  "id_registry": string,
}
Felder
id_value string

Die universelle Anzeigen-ID des ausgewählten Creatives für die Anzeige.
id_registry string

Ein String, der die URL für die Registrierungswebsite angibt, auf der die Universal-Anzeigen-ID des ausgewählten Creatives katalogisiert wird.

Companion

„Companion“ enthält Informationen zu Companion-Anzeigen, die zusammen mit der Anzeige ausgeliefert werden können.
JSON-Darstellung
{
  "click_data": object(ClickData),
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}
Felder
click_data object(ClickData)

Die Klickdaten für dieses Companion-Creative.
creative_type string

Das CreativeType-Attribut im <StaticResource>-Knoten im VAST-Tag, wenn es sich um ein Companion-Creative vom Typ „static“ handelt.
height int32

Die Höhe dieses Companion-Elements in Pixeln.
width int32

Die Breite dieses Companion-Elements in Pixeln.
resource string

Bei statischen und iFrame-Anzeigen ist dies die URL, die geladen und angezeigt wird. Bei HTML-Companions ist dies das HTML-Snippet, das als Companion angezeigt werden soll.
type string

Typ dieses Companion. Sie kann entweder statisch, iFrame oder HTML sein.
ad_slot_id string

Die Slot-ID für diesen Companion.
api_framework string

Das API-Framework für diesen Companion.
tracking_events [object(TrackingEvent)]

Liste der Tracking-Ereignisse für diesen Companion.

InteractiveFile

„InteractiveFile“ enthält Informationen für interaktive Creatives (z.B. SIMID), die während der Wiedergabe der Anzeige angezeigt werden sollen.
JSON-Darstellung
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
Felder
resource string

Die URL zum interaktiven Creative.
type string

Der MIME-Typ der als Ressource bereitgestellten Datei.
variable_duration boolean

Ob für dieses Creative die Dauer verlängert werden kann.
ad_parameters string

Der Wert des Knotens <AdParameters> im VAST-Tag.