MRSS-Feed-Elemente für Videolösungen

Dies ist die neue Version der MRSS-Feed-Spezifikation für Video Solutions.
Diese Version vereinfacht die Aufnahme von MRSS-Inhaltsquellen und ermöglicht eine verbesserte Fehlerbehandlung und Synchronisierung. Die Tabelle listet alle Felder auf, die Video Solutions in Ihrem XML-Feed erkennt (und in einigen Fällen erwartet). Nur diese Elemente werden erkannt.

Zu einem bestimmten Element in der Liste springen

Erforderliche Elemente

_{<atom:link>
<item>
<dfpvideo:contentId>
<dfpvideo:lastModifiedDate>
<dfpvideo:version>
<title>}

Empfohlene und optionale Elemente

_{<dfpvideo:cuepoints>
<dfpvideo:keyvalues>
<dfpvideo:thirdPartyContentId>} _{<media:content>
<media:status>
<media:thumbnail>} _{<pubDate>
<tms:tmsId>
<tms:tmsSeriesId>}

Dynamische Anzeigeneinfügungselemente

_{Diese Elemente sind spezifisch für die dynamische Anzeigeneinfügung und sollten in Kombination mit den oben genannten Elementen verwendet werden.}

_{<dfpvideo:ingestUrl>
<dfpvideo:lastMediaModifiedDate>
<dfpvideo:closedCaptionUrl>
<dfpvideo:fw_caid>}

Sehen Sie sich ein Beispiel der Elemente im Kontext im Beispiel-Feed an.

Bei der Inhalts-ID wird jetzt zwischen Groß- und Kleinschreibung unterschieden. Eine Inhalts-ID mit Groß- und Kleinbuchstaben wird als getrennt von derselben ID mit nur Kleinbuchstaben betrachtet. Dies spiegelt sich in Ihren Ad Manager-Berichten wider.

Erforderliche Elemente

Element	Untergeordnetes Element von	Erfordernis
`<atom:link>`	`<channel>`	Erforderlich
Beschreibung Identifiziert die Paging-Informationen des Feeds. Ad Manager liest dieses Element für zwei Attribute: `rel` und `href` . `rel` gibt an, wie sich die URL im `href` Attribut auf die Ergebnismenge des Feeds bezieht. `rel='next'` : Gibt an, dass die `href` URL auf die nächste Seite der Ergebnismenge des Feeds verweist. Wenn der Feed ein `<atom:link>` -Tag mit `rel='next'` enthält, weist dies darauf hin, dass es eine weitere Seite mit Ergebnissen gibt. Andernfalls ist die aktuelle Seite die letzte Seite in der Ergebnismenge. `href` gibt eine URL an, die die Ressource im `<atom:link>` -Tag identifiziert. Beispiel: ^{<atom:link rel='next' href='http://www.feedprovider.com/video/account/vids?page3'/>} Wichtige Notizen: Wenn Ad Manager zum ersten Mal eine Inhaltsquelle erstellt, erwartet es, dass der Feed-URL-Satz den ersten Ergebnissatz des Feeds zurückgibt. Eine Ergebnismenge von 100 Elementen (pro Seite) wird empfohlen. Wenn das `<atom:link>` -Element auf einer Seite des Feeds fehlt, betrachtet Ad Manager diese Seite als letzte Seite des Feeds.

Element	Untergeordnetes Element von	Erfordernis
`<item>`	`<channel>`	Erforderlich
Beschreibung Identifiziert ein einzelnes Video im Feed. Ein Ad Manager-Videofeed kann einen oder mehrere `<item>` -Einträge enthalten. Jeder von ihnen muss drei Elemente für die ordnungsgemäße Aufnahme von Metadaten enthalten: `<dfpvideo:contentId>` , `<dfpvideo:lastModifiedDate>` und `<title>`

Element	Untergeordnetes Element von	Erfordernis
`<dfpvideo:version>`	`<channel>`	Erforderlich
Beschreibung Gibt die aktuelle Version der MRSS-Spezifikation an, die dieser Feed verwendet. Der Wert sollte mit einer Ganzzahl ausgefüllt und einmal pro Feed festgelegt werden. Der einzige derzeit gültige Wert für dieses Feld ist 2. Beispiel: `<dfpvideo:version>2</dfpvideo:version>`

Element	Untergeordnetes Element von	Erfordernis
`<title>`	`<item>`	Erforderlich
Beschreibung Der Name des Videoeintrags. Beispiel: `<title>My video</title>`

Element	Untergeordnetes Element von	Erfordernis
`<dfpvideo:cuepoints>`	`<item>`	Variiert *
Beschreibung ^{* Erforderlich, wenn das Video Mid-Roll-Werbeunterbrechungen enthält.} Identifiziert die Cue-Punkte in Sekunden, getrennt durch Kommas. Cue-Points sind zeitliche Orte, an denen eine Anzeige in das Video eingefügt werden kann. Sekundenbruchteile werden für bis zu 3 Ziffern unterstützt (z. B. `55.532` Sekunden). Weitere Ziffern nach 3 werden abgeschnitten. Beispiel: `<dfpvideo:cuepoints>55.532,109</dfpvideo:cuepoints>`

Element	Untergeordnetes Element von	Erfordernis
`<dfpvideo:thirdPartyContentId>`	`<item>`	Optional
Beschreibung Diese Funktion muss vor der Verwendung aktiviert werden. Wenden Sie sich zur Verwendung an Ihren Account Manager. Dieses Element wird verwendet, wenn Sie einen benutzerdefinierten MRSS-Feed haben, der YouTube-Videos enthält. Keine zwei MRSS-Inhalte in Ihrem Netzwerk sollten dasselbe YouTube-Video angeben. Für dieses Element gibt es nur ein erforderliches Attribut: `"id"` -Attribut: Dies muss sich auf die `contentId` in der YouTube-Inhaltsquelle beziehen. Beispiel: `<dfpvideo:thirdPartyContentId cms="youtube" id='vNclnVLp_c0'/>`

Element	Untergeordnetes Element von	Erfordernis
`<media:thumbnail>`	`<media:content>` oder `<item>`	Empfohlen
Beschreibung Ermöglicht die Anzeige des Thumbnails des Videos auf der Ad Manager-Oberfläche. Ad Manager benötigt derzeit nur das URL-Attribut dieses Elements, aber Sie können bei Bedarf zusätzliche Attribute angeben: Höhe, Breite und Zeit (die Zeit, die das durch das Thumbnail dargestellte Bild im Video angezeigt wird). Die Ad Manager-Oberfläche zeigt niemals ein Thumbnail an, das größer als 280 Pixel breit und 190 Pixel hoch ist. Wenn die URL auf ein größeres Bild verweist, verweist Ad Manager auf die Originalversion, skaliert das Bild jedoch visuell mit Inline-CSS für die Anzeige auf der Benutzeroberfläche. Beispiel: `<media:thumbnail url='http://www.myfeed.com/account/sdjfbadfb8w3489y/bigtn.jpg' width='280' height='190'/>`

Element	Untergeordnetes Element von	Erfordernis
`<pubDate>`	`<item>`	Optional
Beschreibung Gibt das Datum an, an dem der Inhalt veröffentlicht wurde. Dieses Element wird nur für Videoanzeigenregeln verwendet . Alle Zeitstempel müssen der RFC 822-Spezifikation entsprechen oder dem IS0 8601-Format folgen. Wenn die Zeitzone nicht in der Zeitstempelzeichenfolge enthalten ist, wird standardmäßig die Pacific Standard Time (PST) verwendet. Beispiele: `<pubDate>2006-02-19T04:22:39+05:00</pubDate>` `<pubDate>Sun, 19 Feb 2006 09:22:39 +0000</pubDate>` Siehe Beispiele für jedes Datumsformat RFC 822-Beispiele `Wed, 31 Oct 2016 08:00:00 EST` `Wed, 31 Oct 2016 13:00:00 GMT` `Wed, 31 Oct 2016 15:00:00 +0200` Beispiele für ISO 8601 `20161031` `2016-10-31` `2016-10-31T08:00:00+01:00`

Element	Untergeordnetes Element von	Erfordernis
`<tms:tmsId>`	`<item>`	Optional
Beschreibung Eine eindeutige 14-stellige alphanumerische ID für Premium-TV-Inhalte wie Fernsehsendungen und Filme, die verwendet wird, um das Programm mit Fernsehprogrammen oder Spielzeiten von Filmen zu verknüpfen. Diese IDs sind spezifisch für den Titel, die Beschreibungssprache und die Version eines Programms. Sie werden zum Erkennen und Synchronisieren von Entertainment-Assets verwendet. Der Wert für eine `tmsId` sollte mit `EP` (Episode), `MV` (Film) oder `SP` (Sport) beginnen. Erfahren Sie mehr über Gracenote (TMS)-IDs . Beispiele: `<tms:tmsId>EP123456789000</tms:tmsId>` `<tms:tmsId>MV123456789000</tms:tmsId>` `<tms:tmsId>SP123456789000</tms:tmsId>`

Element	Untergeordnetes Element von	Erfordernis
`<tms:tmsSeriesId>`	`<item>`	Optional
Beschreibung Ähnlich wie beim `<tmsId>` -Element ist dies eine eindeutige 14-stellige alphanumerische ID eines Serien-Elternprogramms. Der Wert für eine `tmsSeriesId` sollte mit `SH` (show) beginnen. Erfahren Sie mehr über Gracenote (TMS)-IDs . Beispiel: `<tms:tmsSeriesId>SH12345678000</tms:tmsSeriesId>`

Element	Untergeordnetes Element von	Erfordernis
`<dfpvideo:lastMediaModifiedDate>`	`<item>`	Empfohlen
Beschreibung Gibt an, wann die Videodatei, auf die in `<dfpvideo:ingestUrl>` verwiesen wird, zuletzt geändert wurde. Wenn dieser Wert jemals im Feed aktualisiert wird, muss auch `lastModifiedDate` für den Inhalt aktualisiert werden. Alle Zeitstempel müssen der RFC 822-Spezifikation entsprechen oder dem IS0 8601-Format folgen. Wenn die Zeitzone nicht in der Zeitstempelzeichenfolge enthalten ist, wird standardmäßig die Pacific Standard Time (PST) verwendet. Beispiele: `<dfpvideo:lastMediaModifiedDate>2006-02-19T04:22:39+05:00</dfpvideo:lastMediaModifiedDate>` `<dfpvideo:lastMediaModifiedDate>Sun, 19 Feb 2006 09:22:39 +0000</dfpvideo:lastMediaModifiedDate>` Siehe Beispiele für jedes Datumsformat RFC 822-Beispiele `Wed, 31 Oct 2016 08:00:00 EST` `Wed, 31 Oct 2016 13:00:00 GMT` `Wed, 31 Oct 2016 15:00:00 +0200` Beispiele für ISO 8601 `20161031` `2016-10-31` `2016-10-31T08:00:00+01:00`

Element	Untergeordnetes Element von	Erfordernis
`<dfpvideo:closedCaptionUrl>`	`<item>`	Variiert *
Beschreibung ^{* Nur erforderlich, wenn Sie Untertitel in der Benutzeroberfläche aktiviert haben.} Knoten zum Angeben der URL zur Untertitel-/Untertiteldatei. Alle verfügbaren Untertiteldateien sollten im Feed als mehrere `closedCaptionUrl` Elemente bereitgestellt werden – eine Untertiteldatei pro Sprache. HLS-Manifest-Untertitel für Video-on-Demand Wenn dieses Feedelement vorhanden ist, werden nur Untertitel aus dem Feed aufgenommen und im HLS-Manifest angegebene Untertitel ignoriert. HLS-Manifest-Untertitel werden nur aufgenommen, wenn keine Untertitel-Feed-Elemente vorhanden sind. Die unterstützten Formate sind TTML/DXFP ( `application/ttaf+xml` ) und WebVTT ( `text/vtt` ). Attribut `"language"` : erforderlich (darf nicht leer sein) und sollte auf die Sprache der Untertiteldatei gesetzt werden. Es muss mit RFC5646 konform sein und darf nicht die Zeichenfolge `"$$$$$"` enthalten. Dieses Attribut wird ähnlich wie das im XML beschriebene `xml:lang` Attribut verwendet. Attribut `"name"` : darf die Zeichenfolge `"$$$$$"` nicht enthalten. Attribut `"type"` : sollte auf den MIME-Typ der Untertiteldateien gesetzt werden. Attribut `"characteristics"` : sollte auf einen der folgenden Werte gesetzt werden (oder kann leer sein): `"public.accessibility.transcribes-spoken-dialog"` `"public.accessibility.describes-music-and-sound"` `"public.easy-to-read"` _{ Eine Warnung wird angezeigt, wenn "characteristics" nicht auf die oben genannten eingestellt sind, funktioniert aber trotzdem.} Bei einer einzelnen Inhaltsquelle sollte die Kombination aus `language` und `name` für jede Untertiteldatei eindeutig sein. Beispiel: [ `language="en", name="English"` ] und [ `language="en", name="English (CC)"` ]. Beispiele: `<dfpvideo:closedCaptionUrl language="en" name="English" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl>` `<dfpvideo:closedCaptionUrl language="en" name="English (CC)" characteristics="public.accessibility.describes-music-and-sound" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl>`

Element	Untergeordnetes Element von	Erfordernis
`<dfpvideo:fw_caid>`	`<item>`	Variiert *
Beschreibung ^{* Nur für Freewheel-Benutzer erforderlich.} Knoten zum Angeben der benutzerdefinierten Freewheel-Asset-ID, die für das Anzeigen-Targeting verwendet wird. Beispiel: `<dfpvideo:fw_caid>621160003648<dfpvideo:fw-caid>`

Sunday, April 9, 2023