Krav för MSN-feedobjektmetadata
På den här sidan beskrivs obligatoriska och valfria metadatafält för artiklar, videor, gallerier och bilder i MSN-feeds. Använd den här guiden för att säkerställa att objekt uppfyller minimistandarder för förtäring och stöd för högkvalitativ återgivning i MSN.
Krav för feedobjekt gäller för alla marknader och alla utgivare, men vissa marknader eller affärsärende kan kräva ytterligare fält. Kontakta oss på partnerhubsupport@microsoft.com om du har ytterligare krav för feedobjekt.
Artikelinnehåll
Uppdatera tidigare intagna objekt
Artiklar
En artikel måste ha ett unikt ID, titel, publicerat datum, brödtext och länk-URL. Alla andra metadata är valfria.
Obligatoriska fält
| Fältnamn | Beskrivning |
|---|---|
| Unikt ID | En hållbar (icke-föränderlig) GUID för att unikt identifiera artikeln i feeden. Det kan också vara artikelns fullständiga unika URL. Det här värdet måste vara unikt för alla innehållsobjekt som kommer från samma partner. |
| Titel | Rubriken för innehållsobjektet måste bestå av mer än 20 tecken, men högst 150 tecken, såvida inte även en kort rubrik anges. Rubriker som överskrider 150 tecken utan en kort titel kan tas bort. Inga HTML-taggar tillåts. |
| Meddelandetext | Brödtext för innehållsobjekt. HTML är tillåtet för både RSS- och Atom-format. |
| Publicerat datum | Tidpunkten för publiceringen. Datumet måste vara inaktuellt och vara mindre än 365 dagar gammalt, annars intas det inte. De datumformat som stöds är RFC 822 Ja och RFC 3339. |
| Länk (webb-URL) | En URL som används för att unikt hitta feedobjektet på utgivarens webbplats. Den här länken kan användas för delning av sociala nätverk beroende på ditt avtal. |
Valfria fält men rekommenderas
| Fältnamn | Beskrivning |
|---|---|
| Abstrakt | Måste vara oformaterad text. Ingen HTML-kod stöds. |
| Uppdaterat datum | Om det här datumet anges används det för att identifiera om innehållet i det här feedobjektet är en nyare version av ett ursprungligt inmatat dokument med angivet Nej-id. I annat fall används "Publicerat datum" för detta ändamål. |
| Utgångsdatum | Feedobjekt tas bort från MSN Partner Hub-backend och frontends senast det angivna datumet. Om det här värdet inte anges förfaller innehållsobjektet om 365 dagar efter förtäringen. Förfallodatumet måste vara längre än 2 timmar i framtiden. |
| Underrubrik | En förklarande eller alternativ rubrik som används för att visas under rubriken i kampanjkort. |
| Kort rubrik | Värdet "kort rubrik", som även kallas "Webbrubrik", används när innehåll visas i kompakta inställningar, till exempel ett kampanjkort. Värdet i det här fältet ska vara högst 54 tecken. |
| Författare | Författaren eller deltagaren i en artikel. |
| Bilder | Om en avbildning refereras måste vissa metadata anges enligt avsnittet fält som krävs för avbildningen. Även om bilder är valfria krävs de för automatisk publicering. |
| Relaterade länkar | Relaterade länkar kan anges för att visas med innehåll. Minst tre relaterade länkar måste tillhandahållas per artikel. |
| Kategorier | Ange taggar som är relevanta för innehållet. Använd <category> element för att lägga till taggar i både RSS och ATOM. |
| Nyckelord | Sammanhangsberoende nyckelord per innehållsobjekt. Flera nyckelord kan anges i en enskild nod avgränsade med kommatecken. Om du vill ange det här värdet i RSS eller ATOM behöver du inte använda RSS-elementet <media:keywords> för media. |
| Inbäddat bildspel | Artiklar kan ha inbäddade bildspel. Mer information finns i exemplen på bildspel . |
| Inbäddad video | Artiklar kan ha inbäddade videor. Mer information finns i Videoexempel . |
| SubscriptionProductType | Vissa feedobjekt kan nås via en prenumerationsmodell. Om du vill ange Premium-feedobjekt i RSS/ATOM-feeden måste du använda <mi:SubscriptionProductType> elementet. T.ex. <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Bildspel
Ett bildspel måste ha en Rubrik, ett unikt ID och ett publicerat datum. Dessutom måste den innehålla flera bilder i ordning (två (2) är det lägsta antalet bilder, 200 är det högsta antalet) där varje bild består av ett bildobjekt. Identifiering av uppdaterade objekt följer samma algoritm som används för artiklar.
Obligatoriska fält
| Fältnamn | Beskrivning |
|---|---|
| Unikt ID | En hållbar (icke-föränderlig) GUID för att unikt identifiera bildspelet. Det kan också vara den fullständiga unika URL:en för bildspelet på utgivarens webbplats. Det här värdet måste vara unikt för alla innehållsobjekt som kommer från samma utgivare. |
| Titel | Rubriken för innehållsobjektet måste bestå av mer än 20 tecken, men högst 150 tecken, såvida inte även en kort rubrik anges. Rubriker som överskrider 150 tecken utan en kort titel kan tas bort. Inga HTML-taggar tillåts. |
| Publicerat datum | Tidpunkten för publiceringen. Datumet måste vara inaktuellt och vara mindre än 365 dagar gammalt, annars intas det inte. De datumformat som stöds är RFC 822 Ja och RFC 3339. |
| Bilder | Varje bildspel måste innehålla en matris med bilder. Varje bild i bildspelet skapas utifrån motsvarande bildmetadata. Framför allt:
|
| Länk (webb-URL) | En URL som används för att unikt hitta feedobjektet på utgivarens webbplats. Den här länken kan användas för delning av sociala nätverk beroende på avtal. |
Valfria fält men rekommenderas
| Fältnamn | Beskrivning |
|---|---|
| Abstrakt | En beskrivning av bildspelet. (Obligatoriskt om bildrubriken saknas) Måste vara oformaterad text. Ingen HTML-kod stöds. |
| Uppdaterat datum | Om det här datumet anges används det för att identifiera om innehållet i det här feedobjektet är en nyare version av ett ursprungligt inmatat dokument med angivet Nej-id. I annat fall används "Publicerat datum" för detta ändamål. |
| Utgångsdatum | Feedobjekt tas bort från MSN Partner Hub-backend och frontends senast det angivna datumet. Om det här värdet inte anges förfaller innehållsobjektet om 365 dagar efter förtäringen. Förfallodatumet måste vara längre än 2 timmar i framtiden. |
| Underrubrik | En förklarande eller alternativ rubrik som används för att visas under rubriken i kampanjkort. |
| Kort rubrik | Värdet "kort rubrik", som även kallas "Webbrubrik", används när innehåll visas i kompakta inställningar, till exempel kampanjkort. Värdet i det här fältet ska vara högst 54 tecken. |
| Författare | Bildspelets författare eller deltagare. |
| Relaterade länkar | Relaterade länkar kan anges för att visas med innehåll. Minst tre relaterade länkar måste tillhandahållas per artikel. |
| Kategorier | Ange taggar som är relevanta för innehållet. Använd <category> element för att lägga till taggar i både RSS och ATOM. |
| Nyckelord | Sammanhangsberoende nyckelord per innehållsobjekt. Flera nyckelord kan anges i en enskild nod avgränsade med kommatecken. Om du vill ange det här värdet i RSS eller ATOM behöver du inte använda RSS-elementet <media:keywords> för media. |
| SubscriptionProductType | Vissa feedobjekt kan nås via en prenumerationsmodell. Om du vill ange Premium-feedobjekt i RSS/ATOM-feeden måste du använda <mi:SubscriptionProductType> elementet. T.ex. <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Video
En video som anges i en feed för endast video måste ha ett unikt ID, URL, publicerat datum, titel, attribution och undertexter (endast om det krävs enligt lag på målmarknaderna). Om inget unikt ID anges eller om video är inbäddat i en artikel används URL:en som identifierare.
Obligatoriska fält
| Fältnamn | Beskrivning |
|---|---|
| Unikt ID | En hållbar (icke-föränderlig) GUID för att unikt identifiera videon. Det kan också vara den fullständiga unika URL:en för videon på utgivarens webbplats. Det här värdet måste vara unikt för alla innehållsobjekt som kommer från samma utgivare. |
| Titel | Videotitel. Det här används som sidhuvud/rubrik. |
| Publicerat datum | Tidpunkten för publiceringen. Datumet måste vara inaktuellt och vara mindre än 365 dagar gammalt, annars intas det inte. |
| Video-URL | Filsökväg för videokälla. URL måste vara absolut och alla former av relativa URL:er misslyckas. |
| Länk (webb-URL) | En URL som används för att unikt hitta feedobjektet på utgivarens webbplats. Den här länken kan användas för delning av sociala nätverk beroende på avtal. |
| Erkännande | Copyrightinformation för videon. |
| Undertexter | Undertexter visas på videoklippen tillsammans med videons varaktighet. Endast obligatoriskt om det krävs enligt lag på målmarknaderna. |
| Varaktighet | Krävs endast för 3PP-videor. |
| Miniatyrer |
Krävs endast för 3PP-videor. En miniatyrbild för att länka till videon. Du kan använda alla bildegenskaper här, men bara URL krävs för miniatyrbilden. Vi rekommenderar en enskild JPG-bild på:
|
Valfria fält men rekommenderas
| Fältnamn | Beskrivning |
|---|---|
| Beskrivning (abstrakt) | Text som ska visas under videon. |
| Varaktighet | Videons varaktighet i sekunder. (Krävs för 3PP-videor). |
| Uppdaterat datum | Om det här datumet anges används det för att identifiera om innehållet i det här feedobjektet är en nyare version av ett ursprungligt inmatat dokument med angivet Nej-id. I annat fall används "Publicerat datum" för detta ändamål. |
| Utgångsdatum | Feedobjekt tas bort från MSN Partner Hub-backend och frontends senast det angivna datumet. Om det här värdet inte anges förfaller innehållsobjektet om 365 dagar efter förtäringen. Förfallodatumet måste vara längre än 2 timmar i framtiden. |
| Underrubrik | En förklarande eller alternativ rubrik som används för att visas under rubriken i kampanjkort. |
| Kort rubrik | Värdet "kort rubrik", som även kallas "Webbrubrik", används när innehåll visas i kompakta inställningar, till exempel ett kampanjkort. Värdet i det här fältet ska vara högst 54 tecken. |
| Författare | Videons författare eller deltagare. |
| Miniatyrer | En miniatyrbild för att länka till videon. Du kan använda alla bildegenskaper här, men bara URL krävs för miniatyrbilden. Vi rekommenderar en enskild JPG-bild på:
|
| Undertexter | Undertexter visas på videoklippen tillsammans med videons varaktighet. Endast obligatoriskt om det krävs enligt lag på målmarknaderna. |
| Relaterade länkar | Relaterade länkar kan anges för att visas med innehåll. Minst tre relaterade länkar måste tillhandahållas per artikel. |
| Kategorier | Ange taggar som är relevanta för innehållet. Använda <category> element för att lägga till taggar i RSS |
| Nyckelord | Sammanhangsberoende nyckelord per innehållsobjekt. Flera nyckelord kan anges i en enskild nod avgränsade med kommatecken. Om du vill ange det här värdet i RSS eller ATOM behöver du inte använda RSS-elementet <media:keywords> för media. |
| Produkttyp för prenumeration | Vissa feedobjekt kan nås via en prenumerationsmodell. Om du vill ange Premium-feedobjekt i RSS/ATOM-feeden måste du använda <mi:SubscriptionProductType> elementet. T.ex. <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Bilder
Fullstora bilder i artiklar måste ha en giltig URL. Bilder i bildspel måste ha en rubrik och en URL. Miniatyrer för videor, relaterade länkar eller fullstora bilder behöver bara en URL. Image Syndication Rights krävs för automatisk publicering.
Obligatoriska fält
| Fältnamn | Beskrivning |
|---|---|
| URL | Källplatsen för avbildningen. URL måste vara absolut och alla formulär Ja för relativa URL:er misslyckas. |
| Titel | Bildrubrik. Används också som en bildtext som visas längs bilden. Krävs endast om bilden används som en bild i ett bildspel. |
| Rättigheter för bildsyndikation |
Krävs endast för automatisk publicering. Om du har syndikeringsrättigheter för dina bilder: Case 1: This field will default to True because most publishers have syndication rights for their images. Om du inte har syndikeringsrättigheter för bilder finns det två alternativ: Ärende 2: Skicka inte bilderna såvida du inte kan ange den information som krävs i ärende 3. Ärende 3: Du har licensierat avbildningen från en av bildleverantörerna som listas på sidan Bildlicensierings- och syndikeringsrättigheter :
|
| Bildlicens-ID | Imageld är det ID som används för att unikt identifiera en avbildning. Imagelds används av stora bildlicensgivare som Getty, Corbis och Associated Press för att spåra syndikeringen av deras bilder. |
| Bildlicensornamn | Namn på avbildningslicensgivaren. (Se sidan Licensierings- och syndikeringsrättigheter för bilder – om bilden inte är en av dessa kan du inte ange den) |
| Beskrivning | Textinformation om bildinnehållet. Det här värdet måste anges som oformaterad text, förutom när bilden används i ett bildspel. I så fall tillåts HTML. |
| Alternativtext för bild | Ett kort, beskrivande textalternativ för bilden. Används för att förbättra hjälpmedel och stöd för skärmläsare och kan också visas om bilden inte läses in. |
| Bildpunkt | Bildens fokuspunkt. Används när bilden beskärs Nej för att visas på olika enheter med olika storlek. |
Relaterade länkar
Relaterade länkar är inte rotinnehållstyper, men de kan bifogas i artiklar eller bildspel. En relaterad länk måste ha minst en giltig URL-, rubrik- och miniatyrbild .
Obligatoriska fält
| Fältnamn | Beskrivning |
|---|---|
| URL | URL för den relaterade länken. |
| Titel | Rubrik som ska visas som länktext. |
| Miniatyrbild | Du måste ange en miniatyr-URL i relaterade länkar, annars ignoreras de |
Valfria fält men rekommenderas
| Fältnamn | Beskrivning |
|---|---|
| Relation | För närvarande har vi endast stöd för text/html som typ. |
| Medietyp | Valfri rubrik att använda i URL:en för komprimerade inställningar för den relaterade länken. |
| Kort rubrik | Det här värdet anges som standard till "relaterat". |
Uppdatera tidigare intagna objekt
Uppdaterat innehåll måste flaggas för Microsoft Ingestion Services via ändringar av fälten Uppdaterat datum eller Publicera datum . Uppdaterat innehåll utan ändringar i något av dessa fält hoppas över. Kom ihåg att behålla samma unika ID.
Microsoft Ingestion Services tolkar feeden och delar upp den i objekt, beslutar om du vill publicera ett nytt objekt, uppdatera ett befintligt objekt eller hoppa över det.
Uppdatera infogade videor
Videor kan publiceras direkt via Media RSS eller HTML. Video-URL:en är dess unika ID. Alla HTML-videor med samma URL flaggas som dubbletter och hoppas över, men videor som använder Media RSS kan uppdateras om <dcterms:modified> de uppdateras. Om det här fältet inte uppdateras betraktas videon som en dubblett.
Uppdatera bildspel
Bildspel som publicerats via Media RSS kan ange <dcterms:modified> ett nytt datum för att ange att bildspelet har uppdaterats.
Uppdatera bilder
Käll-URL:en för en bild är dess unika ID. Bilder med samma URL flaggas som dubbletter och hoppas över.
Undvika dubbletter
Feedobjekt identifieras med sitt unika ID. Objekt med samma unika ID styrs som dubbletter och hoppas över om de inte har flaggats som uppdateringar via ändringar i fälten Uppdaterat datum eller Publiceringsdatum . Feeds som automatiskt uppdaterar unikt ID, uppdaterat datum eller publiceringsdatum varje gång feeden avsöks matas inte in.
Undvika defekter
Defekter som bristfällig formatering, ogiltiga datum eller medieinbäddning av låg kvalitet kan leda till en dålig användarupplevelse och kan begränsa innehållets räckvidd. Läs mer om vilka fel du kan undvika på rankningssidan för innehåll i avsnittet Publiceringsriktlinjer .
Datumformat
För att säkerställa att vårt innehåll är relevant för våra konsumenter måste vi se till att artiklarna vi visar dem är korrekt daterade. Datum måste uttryckas med datumformaten RFC 3339 eller RFC 822. All text i datumsträngen ska vara på engelska och tidszoner ska uttryckas i UTC i stället för i någon lokal tidszon, till exempel eastern, normaltid.
RFC3339
2022-12-28T07:20:50.52Z
2022-12-28T14:20:50.52+00:00
2022-12-28T03:20:50.52+00:00
RFC822
Ons, 02 okt 2002 13:00:00 GMT
Ons, 02 okt 2002 15:00:00 +0200