Prvky zdroje MRSS pro Řešení pro práci s videoreklamami

V tabulce jsou uvedena všechna pole, která Řešení pro práci s videoreklamami ve zdroji XML rozpoznává (a v některých případech očekává). Jiné prvky služba nerozpozná.

Přeskočte na konkrétní prvek v seznamu

Povinné prvky

_{<atom:link>

<item>

<dfpvideo:contentId>

<dfpvideo:lastModifiedDate>

<dfpvideo:version>

<title>}

Doporučené a volitelné prvky

_{<dfpvideo:cuepoints>

<dfpvideo:keyvalues>

<dfpvideo:thirdPartyContentId>}

_{<media:content>

<media:status>}

_{<media:thumbnail>}
_<pubDate>

Prvky pro dynamické vkládání reklam

_{Tyto prvky jsou specifické pro dynamické vkládání reklam a musí být použity v kombinaci s výše uvedenými prvky.}

_{<dfpvideo:ingestUrl>

<dfpvideo:lastMediaModifiedDate>

<dfpvideo:closedCaptionUrl>

<dfpvideo:fw_caid>}

Pokud si prvky chcete prohlédnout v kontextu, podívejte se na vzorový zdroj.

V ID obsahu se nyní rozlišují velká a malá písmena. ID obsahu s velkými i malými písmeny je považováno za jiné než ID pouze s malými písmeny. V přehledech služby Ad Manager je to reflektováno.

Povinné prvky

Prvek	Nadřazený prvek	Požadavek
`<atom:link>`	`<channel>`	Povinné
Popis Poskytuje informace o stránkování zdroje. Služba Ad Manager u tohoto prvku zpracovává dva atributy: `rel` a `href`. Atribut `rel` udává, jak adresa URL v atributu `href` souvisí se sadou výsledků ve zdroji. `rel='next'`: Udává, že adresa URL v atributu `href` odkazuje na další stránku sady výsledků zdroje. Pokud zdroj obsahuje značku `<atom:link>` s atributem `rel='next'`, znamená to, že je k dispozici další stránka výsledků. Jinak je aktuální stránka poslední stránkou v sadě výsledků. Atribut `href` udává adresu URL, která identifikuje zdroj ve značce `<atom:link>`. Příklad `<atom:link rel='next' href='http://www.feedprovider.com/video/account/vids?page3'/` Důležité poznámky: Při počátečním vytváření zdroje obsahu služba Ad Manager očekává, že nastavená adresa URL odkazuje na první sadu výsledků ve zdroji. Doporučuje se používat sady výsledků se 100 položkami (na stránku). Pokud prvek `<atom:link>` na stránce zdroje chybí, považuje ji služba Ad Manager za poslední stránku zdroje.

Prvek	Nadřazený prvek	Požadavek
`<item>`	`<channel>`	Povinné
Popis Označuje jedno video ve zdroji. Zdroj videí služby Ad Manager může obsahovat jeden nebo více prvků `<item>`. Každý z nich kvůli správnému zpracování metadat musí obsahovat tři prvky: `<dfpvideo:contentId>`, `<dfpvideo:lastModifiedDate>` a `<title>`

Prvek	Nadřazený prvek	Požadavek
`<dfpvideo:version>`	`<channel>`	Povinné
Popis Udává aktuální verzi specifikace MRSS, kterou tento zdroj používá. Hodnota by měla být vyplněna celým číslem a měla by být ve zdroji nastavena pouze jednou. V současné době je v tomto poli platná pouze hodnota 2. Příklad `<dfpvideo:version>2</dfpvideo:version>`

Prvek	Nadřazený prvek	Požadavek
`<title>`	`<item>`	Povinné
Popis Název položky videa. Příklad `<title>Mé video</title>`

Prvek	Nadřazený prvek	Požadavek
`<dfpvideo:cuepoints>`	`<item>`	Různé *
Popis ^{* Povinné, pokud video obsahuje reklamní přestávky uprostřed videa.} Určuje signální body (oddělené čárkami). Signální body jsou místa v čase, na kterých lze do videa vložit reklamu. Je podporována přesnost na tisíciny sekundy (tj. tři desetinná místa, například `55.532`). Pokud hodnota obsahuje více než tři desetinná místa, budou číslice navíc oříznuty. Ve videích smí být maximálně 1000 signálních bodů. Po dosažení tohoto limitu budou všechny další signální body ve videu ignorovány. Příklad `<dfpvideo:cuepoints>55.532,109</dfpvideo:cuepoints>`

Prvek	Nadřazený prvek	Požadavek
`<dfpvideo:thirdPartyContentId>`	`<item>`	Volitelné
Popis Tato funkce musí být před použitím povolena. Pokud ji chcete použít, kontaktujte svého správce účtu. Tento prvek se používá, pokud máte vlastní zdroj MRSS, který obsahuje videa YouTube. Žádné dvě položky obsahu ve zdroji MRSS v síti nesmějí uvádět stejné video YouTube. Tento prvek má pouze jeden povinný atribut: Atribut `id`: Tento atribut musí odkazovat na `contentId` ve zdroji obsahu na YouTube. Příklad `<dfpvideo:thirdPartyContentId cms="youtube" id='vNclnVLp_c0'/>`

Prvek	Nadřazený prvek	Požadavek
`<media:thumbnail>`	`<media:content>` nebo `<item>`	Doporučeno
Popis Umožňuje zobrazení miniatury videa v rozhraní služby Ad Manager. Služba Ad Manager v současné době potřebuje pouze atribut url tohoto prvku. Můžete však zadat i další atributy: height (výška), width (šířka) a time (čas, ve kterém se ve videu snímek z miniatury zobrazuje). V uživatelském rozhraní služby Ad Manager se nikdy nezobrazí miniatury větší než 280 pixelů na šířku a 190 pixelů na výšku. Pokud atribut url odkazuje na větší obrázek, služba Ad Manager bude odkazovat na původní verzi, ale pomocí vložených stylů CSS obrázek k zobrazení v uživatelském rozhraní zmenší. Příklad `<media:thumbnail url='http://www.myfeed.com/account/sdjfbadfb8w3489y/bigtn.jpg' width='280' height='190'/>`

Prvek	Nadřazený prvek	Požadavek
`<pubDate>`	`<item>`	Volitelné
Popis Udává datum publikování obsahu. Tento prvek se používá pouze pro pravidla videoreklamy. Časové razítko musí odpovídat specifikaci RFC 822 nebo formátu IS0 8601. Pokud v řetězci časového razítka není uvedeno časové pásmo, použije se severoamerický pacifický standardní čas (PST). Příklady `<pubDate>2006-02-19T04:22:39+05:00</pubDate>` `<pubDate>Sun, 19 Feb 2006 09:22:39 +0000</pubDate>` Příklady jednotlivých formátů dat Příklady RFC 822 `Wed, 31 Oct 2016 08:00:00 EST` `Wed, 31 Oct 2016 13:00:00 GMT` `Wed, 31 Oct 2016 15:00:00 +0200` ISO 8601 `20161031` `2016-10-31` `2016-10-31T08:00:00+01:00`

Prvek	Nadřazený prvek	Požadavek
`<dfpvideo:lastMediaModifiedDate>`	`<item>`	Doporučeno
Popis Udává, kdy byl naposledy upraven videosoubor, na který odkazuje pole `<dfpvideo:ingestUrl>`. Pokud tuto hodnotu ve zdroji aktualizujete, musíte pro obsah aktualizovat i pole `lastModifiedDate`. Časové razítko musí odpovídat specifikaci RFC 822 nebo formátu IS0 8601. Pokud v řetězci časového razítka není uvedeno časové pásmo, použije se severoamerický pacifický standardní čas (PST). Příklady `<dfpvideo:lastMediaModifiedDate>2006-02-19T04:22:39+05:00</dfpvideo:lastMediaModifiedDate>` `<dfpvideo:lastMediaModifiedDate>Sun, 19 Feb 2006 09:22:39 +0000</dfpvideo:lastMediaModifiedDate>` Příklady jednotlivých formátů dat Příklady RFC 822 `Wed, 31 Oct 2016 08:00:00 EST` `Wed, 31 Oct 2016 13:00:00 GMT` `Wed, 31 Oct 2016 15:00:00 +0200` ISO 8601 `20161031` `2016-10-31` `2016-10-31T08:00:00+01:00`

Prvek	Nadřazený prvek	Požadavek
`<dfpvideo:closedCaptionUrl>`	`<item>`	Různé *
Popis ^{* Povinné, pouze pokud jste v rozhraní aktivovali titulky.} Prvek k zadání adresy URL, na které se nachází soubor s titulky. Všechny dostupné soubory skrytých titulků by ve zdroji měly být zadány jako několik prvků `closedCaptionUrl` – pro každý jazyk jeden soubor titulků. Titulky v manifestu HLS pro video na vyžádání Pokud je ve zdroji přítomen tento prvek, zpracují se pouze titulky ze zdroje a titulky zadané v manifestu HLS jsou ignorovány. Titulky v manifestu HLS se zpracovávají pouze v případě, že ve zdroji nejsou přítomny žádné prvky titulků. Jsou podporovány formáty TTML/DXFP (`application/ttaf+xml`) a WebVTT (`text/vtt`). Atribut `language` je povinný (nesmí být prázdný) a musí být nastaven na jazyk souboru s titulky. Musí být v souladu se specifikací RFC5646 a nesmí obsahovat řetězec `$$$$$`. Tento atribut se používá podobně jako atribut `xml:lang` uvedený v kódu XML. Atribut `name` nesmí obsahovat řetězec `$$$$$`. Atribut `type` by měl být nastaven na typ MIME souborů s titulky. Atribut `characteristics` je potřeba nastavit na některou z následujících hodnot (případně ho lze ponechat prázdný): `"public.accessibility.transcribes-spoken-dialog"` `"public.accessibility.describes-music-and-sound"` `"public.easy-to-read"` _{ Pokud atribut characterstics není nastaven na žádnou z výše uvedených hodnot, zobrazí se upozornění, ale zdroj přesto bude fungovat.} V případě jednoho zdroje obsahu by kombinace atributů `language` a `name` měla být pro každý soubor skrytých titulků jedinečná. Například [`language="en", name="English"`] a [`language="en", name="English (CC)"`]. Příklady `<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`

Prvek	Nadřazený prvek	Požadavek
`<dfpvideo:fw_caid>`	`<item>`	Různé *
Popis ^{* Povinné pouze u uživatelů služby Freewheel.} Prvek k zadání vlastního ID podkladu Freewheel, které se používá k cílení reklam. Příklad `<dfpvideo:fw_caid>621160003648<dfpvideo:fw-caid>`

Prvky zdroje MRSS pro Řešení pro práci s videoreklamami

Přeskočte na konkrétní prvek v seznamu

Povinné prvky

Doporučené a volitelné prvky

Prvky specifické pro dynamické vkládání reklam

Pomohly vám tyto informace?

Potřebujete další pomoc?

Vyzkoušejte tyto další kroky: