Požadavky na metadata položek informačního kanálu MSN
Tato stránka popisuje povinná a volitelná pole metadat pro články, videa, galerie a obrázky v informačních kanálech MSN. Pomocí tohoto průvodce zajistíte, aby položky splňovaly minimální standardy příjmu dat a podporovaly vysoce kvalitní vykreslování v rámci služby MSN.
Požadavky na položky informačního kanálu platí pro všechny trhy a všechny vydavatele, ale některé trhy nebo obchodní případy můžou vyžadovat další pole. Pokud máte další požadavky na položky informačního kanálu, kontaktujte nás na adrese partnerhubsupport@microsoft.com .
V tomto článku
Aktualizace dříve přijatých položek
Články
Článek musí mít jedinečné ID, název, datum publikování, text a adresu URL odkazu. Všechna ostatní metadata jsou volitelná.
Povinná pole
| Název pole | Popis |
|---|---|
| Jedinečné ID | Trvalý (neměnící se) IDENTIFIKÁTOR GUID, který jednoznačně identifikuje článek v informačním kanálu. Může to být také úplná jedinečná adresa URL článku. Tato hodnota musí být jedinečná pro všechny položky obsahu pocházející od stejného partnera. |
| Název | Název položky obsahu musí být delší než 20 znaků, ale nesmí být delší než 150 znaků, pokud není k dispozici také krátký název. Názvy delší než 150 znaků bez krátkého názvu mohou být odebrány. Nejsou povoleny žádné značky HTML. |
| Tělo zprávy | Text položky obsahu. Html je povolený pro formáty RSS i Atom. |
| Datum publikování | Čas publikování. Datum musí být v minulosti a musí být starší než 365 dnů, jinak nebude ingestované. Podporované formáty data jsou RFC 822 Yes a RFC 3339. |
| Odkaz (webová adresa URL) | Adresa URL sloužící k jedinečnému vyhledání položky informačního kanálu na webu vydavatele. Tento odkaz můžete použít při sdílení sociálních sítí v závislosti na vaší smlouvě. |
Volitelná pole, ale doporučená
| Název pole | Popis |
|---|---|
| Abstraktní | Musí být ve formátu prostého textu. Nepodporuje se žádný kód HTML. |
| Datum aktualizace | Pokud je toto datum zadané, použije se k identifikaci, jestli je obsah v této položce informačního kanálu novější verzí původně ingestovaného dokumentu se zadaným ID Ne. Pokud ne, použije se k tomuto účelu datum publikování. |
| Datum vypršení platnosti | Položka informačního kanálu bude odebrána z back-endu a front-endů partnerského centra MSN do zadaného data. Pokud tato hodnota není zadána, vyprší platnost položky obsahu za 365 dnů po ingestování. Datum vypršení platnosti musí být v budoucnu delší než 2 hodiny. |
| Titulků | Vysvětlující nebo alternativní název, který se používá k zobrazení pod nadpisem v propagačních kartách. |
| Krátký název | Hodnota "krátký název", označovaná také jako "Web Headline", se používá při zobrazení obsahu v kompaktním nastavení, jako je například propagační karta. Hodnota v tomto poli by měla být 54 znaků nebo menší. |
| Autor | Autor nebo přispěvatel článku. |
| Obrázky | Pokud se odkazuje na obrázek, musí být určitá metadata zadána podle oddílu povinná pole obrázku. I když jsou image volitelné, pro automatické publikování se vyžadují. |
| Související odkazy | Související odkazy je možné zadat tak, aby se zobrazovaly s obsahem. Pro každý článek je nutné zadat alespoň tři související odkazy. |
| Kategorie | Zadejte značky relevantní pro danou část obsahu. Pomocí <category> elementů můžete přidat značky v RSS i ATOM. |
| Klíčová slova | Kontextová klíčová slova na položku obsahu V jednom uzlu odděleném čárkami je možné zadat více klíčových slov. Chcete-li zadat tuto hodnotu v rss nebo ATOM, není nutné použít media RSS <media:keywords> element. |
| Vložená prezentace | Články můžou mít vložené prezentace. Další podrobnosti najdete v příkladech prezentací . |
| Vložené video | Články můžou obsahovat vložená videa. Další podrobnosti najdete v tématu Příklady videa . |
| SubscriptionProductType | Některé položky informačního kanálu můžou být přístupné prostřednictvím modelu předplatného. Pokud chcete v informačním kanálu RSS /ATOM zadat položky placeného kanálu Premium, musíte použít <mi:SubscriptionProductType> element . Např. <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType> |
Prezentace
Prezentace musí mít název, jedinečné ID a datum publikování. Kromě toho musí obsahovat více snímků v pořadí (dva (2) je nejmenší počet snímků, 200 je maximum), kde se každý snímek skládá z objektu obrázku. Při zjišťování aktualizovaných položek se používá stejný algoritmus, který se používá pro články.
Povinná pole
| Název pole | Popis |
|---|---|
| Jedinečné ID | Trvalý (neměnící se) IDENTIFIKÁTOR GUID pro jedinečnou identifikaci prezentace. Může to být také úplná jedinečná adresa URL prezentace na webu vydavatele. Tato hodnota musí být jedinečná pro všechny položky obsahu pocházející od stejného vydavatele. |
| Název | Název položky obsahu musí být delší než 20 znaků, ale nesmí být delší než 150 znaků, pokud není k dispozici také krátký název. Názvy delší než 150 znaků bez krátkého názvu mohou být odebrány. Nejsou povoleny žádné značky HTML. |
| Datum publikování | Čas publikování. Datum musí být v minulosti a musí být starší než 365 dnů, jinak nebude ingestované. Podporované formáty data jsou RFC 822 Yes a RFC 3339. |
| Snímky: | Každá prezentace musí obsahovat pole snímků (obrázků). Každý snímek v rámci prezentace je vytvořen z odpovídajících metadat obrázku; Zejména:
|
| Odkaz (webová adresa URL) | Adresa URL sloužící k jedinečnému vyhledání položky informačního kanálu na webu vydavatele. Tento odkaz může být použit při sdílení sociálních sítí v závislosti na smlouvě. |
Volitelná pole, ale doporučená
| Název pole | Popis |
|---|---|
| Abstraktní | Popis prezentace. (Vyžaduje se, pokud chybí název snímku.) Musí být ve formátu prostého textu. Nepodporuje se žádný kód HTML. |
| Datum aktualizace | Pokud je toto datum zadané, použije se k identifikaci, jestli je obsah v této položce informačního kanálu novější verzí původně ingestovaného dokumentu se zadaným ID Ne. Pokud ne, použije se k tomuto účelu datum publikování. |
| Datum vypršení platnosti | Položka informačního kanálu bude odebrána z back-endu a front-endů partnerského centra MSN do zadaného data. Pokud tato hodnota není zadána, vyprší platnost položky obsahu za 365 dnů po ingestování. Datum vypršení platnosti musí být v budoucnu delší než 2 hodiny. |
| Titulků | Vysvětlující nebo alternativní název, který se používá k zobrazení pod nadpisem v propagačních kartách. |
| Krátký název | Hodnota "krátký název", označovaná také jako "Nadpis webu", se používá při zobrazení obsahu v kompaktním nastavení, jako jsou propagační karty. Hodnota v tomto poli by měla být 54 znaků nebo menší. |
| Autor | Autor nebo přispěvatel prezentace. |
| Související odkazy | Související odkazy je možné zadat tak, aby se zobrazovaly s obsahem. Pro každý článek je nutné zadat alespoň tři související odkazy. |
| Kategorie | Zadejte značky relevantní pro danou část obsahu. Pomocí <category> elementů můžete přidat značky v RSS i ATOM. |
| Klíčová slova | Kontextová klíčová slova na položku obsahu V jednom uzlu odděleném čárkami je možné zadat více klíčových slov. Chcete-li zadat tuto hodnotu v rss nebo ATOM, není nutné použít media RSS <media:keywords> element. |
| SubscriptionProductType | Některé položky informačního kanálu můžou být přístupné prostřednictvím modelu předplatného. Pokud chcete v informačním kanálu RSS /ATOM zadat položky placeného kanálu Premium, musíte použít <mi:SubscriptionProductType> element . Např. <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType> |
Video
Video zadané v informačním kanálu pouze pro video musí mít jedinečné ID, adresu URL, datum publikování, název, přiřazení a skryté titulky (jenom v případě, že to vyžaduje zákon na cílových trzích). Pokud není zadané žádné jedinečné ID nebo pokud je do článku vložené video, použije se adresa URL jako identifikátor.
Povinná pole
| Název pole | Popis |
|---|---|
| Jedinečné ID | Trvalý (neměnící se) IDENTIFIKÁTOR GUID pro jedinečnou identifikaci videa. Může to být také úplná jedinečná adresa URL videa na webu vydavatele. Tato hodnota musí být jedinečná pro všechny položky obsahu pocházející od stejného vydavatele. |
| Název | Název videa. Používá se jako záhlaví nebo název stránky. |
| Datum publikování | Čas publikování. Datum musí být v minulosti a musí být starší než 365 dnů, jinak nebude ingestované. |
| Adresa URL videa | Umístění zdrojového souboru videa Adresa URL musí být absolutní a příjem všech typů relativních adres URL se nezdaří. |
| Odkaz (webová adresa URL) | Adresa URL sloužící k jedinečnému vyhledání položky informačního kanálu na webu vydavatele. Tento odkaz může být použit při sdílení sociálních sítí v závislosti na smlouvě. |
| Attribution | Informace o autorských právech k videu |
| Skryté titulky | Skryté titulky se zobrazují na videích spolu s dobou trvání videa. Vyžadováno pouze v případě, že je to na cílových trzích vyžadováno zákonem. |
| Trvání | Vyžaduje se pouze pro 3pp videa. |
| Miniatury |
Vyžaduje se pouze pro 3pp videa. Miniatura, která bude odkazovat na video. Tady můžete použít všechny vlastnosti obrázku, ale pro miniaturu se vyžaduje jenom adresa URL. Jeden obrázek ve formátu JPG doporučujeme na adrese:
|
Volitelná pole, ale doporučená
| Název pole | Popis |
|---|---|
| Popis (abstraktní) | Text, který se má zobrazit pod videem |
| Trvání | Doba trvání videa v sekundách. (Povinné pro 3PP videa). |
| Datum aktualizace | Pokud je toto datum zadané, použije se k identifikaci, jestli je obsah v této položce informačního kanálu novější verzí původně ingestovaného dokumentu se zadaným ID Ne. Pokud ne, použije se k tomuto účelu datum publikování. |
| Datum vypršení platnosti | Položka informačního kanálu bude odebrána z back-endu a front-endů partnerského centra MSN do zadaného data. Pokud tato hodnota není zadána, vyprší platnost položky obsahu za 365 dnů po ingestování. Datum vypršení platnosti musí být v budoucnu delší než 2 hodiny. |
| Titulků | Vysvětlující nebo alternativní název, který se používá k zobrazení pod nadpisem v propagačních kartách. |
| Krátký název | Hodnota "krátký název", označovaná také jako "Web Headline", se používá při zobrazení obsahu v kompaktním nastavení, jako je například propagační karta. Hodnota v tomto poli by měla být 54 znaků nebo menší. |
| Autor | Autor nebo přispěvatel videa. |
| Miniatury | Miniatura, která bude odkazovat na video. Tady můžete použít všechny vlastnosti obrázku, ale pro miniaturu se vyžaduje jenom adresa URL. Jeden obrázek ve formátu JPG doporučujeme na adrese:
|
| Skryté titulky | Skryté titulky se zobrazují na videích spolu s dobou trvání videa. Vyžadováno pouze v případě, že je to na cílových trzích vyžadováno zákonem. |
| Související odkazy | Související odkazy je možné zadat tak, aby se zobrazovaly s obsahem. Pro každý článek je nutné zadat alespoň tři související odkazy. |
| Kategorie | Zadejte značky relevantní pro danou část obsahu. Použití <category> elementů k přidání značek v RSS |
| Klíčová slova | Kontextová klíčová slova na položku obsahu V jednom uzlu odděleném čárkami je možné zadat více klíčových slov. Chcete-li zadat tuto hodnotu v rss nebo ATOM, není nutné použít media RSS <media:keywords> element. |
| SubscriptionProduct Type | Některé položky informačního kanálu můžou být přístupné prostřednictvím modelu předplatného. Pokud chcete v informačním kanálu RSS /ATOM zadat položky placeného kanálu Premium, musíte použít <mi:SubscriptionProductType> element . Např. <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType> |
Obrázky
Obrázky v plné velikosti v článcích musí mít platnou adresu URL. Obrázky v prezentacích musí mít název a adresu URL. Miniatury videí, souvisejících odkazů nebo obrázků v plné velikosti potřebují jenom adresu URL. Pro automatické publikování se vyžadují syndikační práva obrázků.
Povinná pole
| Název pole | Popis |
|---|---|
| URL | Umístění zdroje obrázku Adresa URL musí být absolutní a všechny tvary Ano relativních adres URL se nepodaří ingestovat. |
| Název | Název obrázku. Používá se také jako popis, která se zobrazuje podél obrázku. Vyžaduje se jenom v případě, že se obrázek použije jako snímek v prezentaci. |
| Syndikační práva obrázků |
Vyžaduje se pouze pro automatické publikování. Pokud máte syndikační práva k obrázkům: Případ 1: Toto pole bude ve výchozím nastavení true, protože většina vydavatelů má syndikační práva ke svým obrázkům. Pokud nemáte syndikační práva pro obrázky, máte dvě možnosti: Případ 2: Neodesílejte obrázky, pokud nemůžete zadat požadované informace v případu 3. Případ 3: Licencovali jste image od jednoho z poskytovatelů imagí uvedených na stránce Licencování a syndikace obrázků :
|
| ID licence image | Imageld je ID sloužící k jednoznačné identifikaci obrázku. Imagelds používají hlavní poskytovatelé licencí obrázků, jako jsou Getty, Corbis a Associated Press, ke sledování syndikace svých obrázků. |
| Obrázek s názvem poskytovatele licence | Jméno poskytovatele image. (Podívejte se na stránku s licenčními a syndikačními právy k obrázkům – pokud image mezi těmito právy není, nezadávejte ji.) |
| Popis | Textové informace o obsahu obrázku Tato hodnota musí být uvedena v prostém textu s výjimkou případů, kdy je obrázek použit v prezentaci; v tomto případě je povoleno HTML. |
| Alternativní text obrázku | Krátká popisná alternativa k obrázku. Používá se ke zlepšení přístupnosti a podpoře čtečky obrazovky a může se také zobrazit, pokud se obrázek nepodaří načíst. |
| Ústřední bod obrázku | Ústřední bod obrázku. Použije se při oříznutí obrázku Ne, aby se zobrazilo na zařízeních s různou velikostí. |
Související odkazy
Související odkazy nejsou typy kořenového obsahu, ale dají se připojit k článkům nebo prezentacím. Související odkaz musí mít minimálně platnou adresu URL, název a obrázek miniatury .
Povinná pole
| Název pole | Popis |
|---|---|
| URL | Adresa URL souvisejícího odkazu |
| Název | Název, který se zobrazí jako text odkazu. |
| Miniaturu | V souvisejících odkazech musíte zadat adresu URL miniatury, jinak budou ignorovány. |
Volitelná pole, ale doporučená
| Název pole | Popis |
|---|---|
| Relation | V současné době podporujeme jako typ pouze text/html. |
| Typ média | Volitelný název, který se má použít v adrese URL kompaktního nastavení souvisejícího odkazu. |
| Krátký název | Tato hodnota bude ve výchozím nastavení nastavena na "related". |
Aktualizace dříve přijatých položek
Aktualizovaný obsah se musí označit službou Microsoft Ingestion Services prostřednictvím změn polí Datum aktualizace nebo Datum publikování . Aktualizovaný obsah bez změn jednoho z těchto polí se přeskočí. Nezapomeňte zachovat stejné jedinečné ID.
Služba Ingestování dat analyzuje informační kanál a rozdělí ho na položky a rozhoduje, jestli chcete publikovat novou položku, aktualizovat existující položku nebo ji přeskočit.
Aktualizace vložených videí
Videa se dají publikovat přímo prostřednictvím informačního kanálu RSS nebo HTML. Adresa URL videa je jeho jedinečné ID. Jakékoli video HTML se stejnou adresou URL se označí příznakem jako duplicitní a přeskočí se, ale videa, která používají media RSS, se dají aktualizovat, pokud <dcterms:modified> se aktualizuje. Pokud se toto pole neaktualizuje, bude video považováno za duplicitní.
Aktualizace prezentací
Prezentace publikované prostřednictvím informačního kanálu RSS médií můžou nastavit <dcterms:modified> na nové datum, které označuje, že prezentace byla aktualizována.
Aktualizace imagí
Zdrojová adresa URL obrázku je jeho jedinečné ID. Obrázky se stejnou adresou URL se označí jako duplicitní a přeskočí.
Jak se vyhnout duplicitám
Položky informačního kanálu jsou identifikovány svým jedinečným ID. Položky se stejným jedinečným ID se označí jako duplicity a přeskočí se, pokud nebyly označeny jako aktualizace prostřednictvím změn v polích Datum aktualizace nebo Datum publikování . Informační kanály, které automaticky aktualizují jedinečné ID, aktualizované datum nebo datum publikování při každém dotazování informačního kanálu, nebudou ingestovány.
Jak se vyhnout vadám
Chyby, jako je chybné formátování, neplatná data nebo vložení médií s nízkou kvalitou, můžou vést k horšímu uživatelskému prostředí a omezit dosah vašeho obsahu. Další informace o tom, kterým vadám se vyhnout, najdete na stránce Hodnocení obsahu v části Pokyny pro publikování .
Formáty data
Abychom zajistili, že je obsah pro naše zákazníky relevantní, musíme zajistit, aby články, které zobrazujeme, byly přesně datované. Kalendářní data musí být vyjádřena pomocí formátu RFC 3339 nebo RFC 822. Jakýkoli text v řetězci data by měl být v angličtině a časová pásma by měla být vyjádřena ve standardu UTC, nikoli v místním časovém pásmu, jako je východní standardní čas.
RFC3339
2022-12-28T07:20:50.52Z
2022-12-28T14:20:50.52+00:00
2022-12-28T03:20:50.52+00:00
RFC822
Wed, 02 Oct 2002 13:00:00 GMT
Wed, 02 Oct 2002 15:00:00 +0200