Anzeigenmetadaten

In diesem Leitfaden wird die unterstützte Funktion für Anzeigenmetadaten der Video Stitcher API beschrieben. Anzeigenmetadaten werden aus einer VAST-Anzeige in einer Anzeigen-Tag-Antwort extrahiert, die Anzeigen-Tracking-Ereignisse und Anzeigen-Assets enthält. Die Ad-Tag-URL wird in der Anfrage zur Sitzungserstellung konfiguriert. Weitere Informationen findest du unter Livesitzung verwalten und VOD-Sitzung verwalten.

Hinweise

Sie müssen mit den einführenden Konzepten und der Terminologie der Video Stitcher API vertraut sein. Weitere Informationen finden Sie in der technischen Übersicht.

Einleitung

Anzeigenmetadaten enthalten Anzeigen-Tracking-Ereignisse und Anzeigen-Partneranzeigen, die mit einer zusammengeführten Anzeige verknüpft sind. Ein Ereignis für das Anzeigen-Tracking enthält einen Callback-Ping, mit dem die VAST-Anzeige und die Interaktionen der Zuschauer erfasst werden. Eine Companion-Anzeige ist eine Anzeige, die die übergeordnete VAST-Anzeige ergänzt. Im clientseitigen Tracking-Modus müssen Sie Ereignisse basierend auf dem Verhalten der Zuschauer auslösen.

Serverseitiges Anzeigen-Tracking

Im serverseitigen Tracking-Modus ist jeder Anzeigensegment-URI in einen Weiterleitungs-URI eingewickelt. Die Video Stitcher API verarbeitet Fortschrittsereignisse, wenn der Player diese Segmente anfordert. Aktivitätsereignisse wie pause werden jedoch nicht von der Video Stitcher API verarbeitet.

Clientseitiges Anzeigen-Tracking

Im clientseitigen Tracking-Modus ist der Client für das Auslösen der Ereignisse verantwortlich. Weitere Informationen finden Sie in der Dokumentation zu Ereignissen.

Fortschrittsereignisse sollten ausgelöst werden, wenn während der Anzeige die angegebene Zeit verstrichen ist. Das Ereignis Start sollte beispielsweise zu Beginn der Anzeige ausgelöst werden. Weitere Informationen zu Fortschrittsereignissen finden Sie im Hilfeartikel Fortschrittsereignisobjekt.

Aktivitätsereignisse sollten ausgelöst werden, wenn ein Zuschauer eine bestimmte Aktivität ausführt. Das Ereignis pause sollte beispielsweise ausgelöst werden, wenn der Zuschauer das Video der Anzeige pausiert. Weitere Informationen zu Aktivitätsereignissen finden Sie im Hilfeartikel Aktivitätsereignisobjekt.

Clientseitiges VOD-Anzeigen-Tracking

Ein Interstitial-Objekt wird in der Antwort auf eine Anfrage zum Erstellen einer VOD-Sitzung zurückgegeben. Eine Anleitung zum Erstellen einer VOD-Sitzung findest du unter VOD-Sitzung erstellen.

Interstitials enthalten die Metadaten für jede eingefügte Anzeige. Wenn der Modus für das Anzeigen-Tracking des Clients aktiviert ist, ist der Kunde dafür verantwortlich, bei Bedarf Tracking-Ereignisse auszulösen. Weitere Informationen finden Sie im Hilfeartikel zum Interstitial-Objekt.

Live-clientseitiges Anzeigen-Tracking

Die Video Stitcher API fügt kontinuierlich Anzeigen in einen Livestream ein. Metadaten zu Anzeigen werden jedes Mal generiert, wenn eine neue Anzeige eingefügt wird.

Bei HLS findest du das AdMetadataURI zum Abrufen von Anzeigenmetadaten im #EXT-X-DATERANGE-Tag.

Bei DASH findest du das AdMetadataURI zum Abrufen von Anzeigenmetadaten im <EventStream>-Element für jedes <Period>-Element.

Weitere Informationen finden Sie unter Live-Client-Tracking.

Companion-Anzeigen

Companion-Anzeigen sind zusätzliche Anzeigen, die zusammen mit eingefügten linearen Anzeigen ausgeliefert werden können. Weitere Informationen finden Sie im Hilfeartikel zum Objekt „Kompanion-Anzeigen“.

Nächste Schritte