Professional Documents
Culture Documents
Version 2.25: Feed guidelines for ingestion of article, video, and slideshow content
A number of changes were made to the content specification for this version (2.25); in order to help find the changes easily, the rows that have
changed in each Key Metadata table have been highlighted in yellow.
Contents
Feed Requirements .................................................................................................................................................................. 3
Content ................................................................................................................................................................................ 3
Supported Protocols ............................................................................................................................................................ 3
Supported Feed Formats ..................................................................................................................................................... 3
Feed Size ............................................................................................................................................................................ 43
Key Article Metadata ............................................................................................................................................................. 43
Article Body ........................................................................................................................................................................ 76
Image ................................................................................................................................................................................. 76
Use of Syndicated Images .............................................................................................................................................. 87
Specifications for In-Line Tweets ....................................................................................................................................... 98
Related Links ...................................................................................................................................................................... 98
Linking to Partner-Supplied Related Articles within the Article using NewsML ......................................................... 108
Linking to Partner-Supplied Related Articles within the Article using RSS/Atom ....................................................... 109
Linking to Partner-Supplied Related Articles within the Article using JSON ...............................................................119
Deep Linking Content to Your App ................................................................................................................................1110
Key Video Metadata .......................................................................................................................................................... 1211
Video URL ....................................................................................................................................................................... 3312
Specifications for In-Line Videos .................................................................................................................................... 3413
Supported Video Thumbnail Images .............................................................................................................................3514
Avoiding Duplication of Videos from the Same Provider ..............................................................................................3514
Deep-Link ....................................................................................................................................................................... 3514
Key Slideshow Metadata ................................................................................................................................................... 3515
Slideshow Image ............................................................................................................................................................3816
Related Links .................................................................................................................................................................. 3817
Linking to Partner-Supplied Related Articles within the Slideshow with NewsML ................................................... 3817
Linking to Partner-Supplied Related Articles within the Slideshow with RSS/Atom ................................................. 3918
Linking to Partner-Supplied Related Articles within the Slideshow with JSON ......................................................... 3918
Deep-Link ....................................................................................................................................................................... 4019
Detecting Updates to Previously Published Content..................................................................................................... 4019
1
Feed Requirements
Content
Publisher must have distribution rights for all content within the feed.
If images are included in the feed, image attribution and image caption are required.
Feeds must be fresh content freshness critical and is a release criterion before going live.
Any change to the structure of a feed must be communicated to MSN Editorial Engineering 30 days in advance
of the change.
Partner endpoints must be static/unchanging where there is no requirement to build any dynamic values such as
route segments, query string values and HTTP request header values.
Con formato: Fuente: (Asitica) +Cuerpo asitico
(Times New Roman), Fuente de escritura compleja:
+Cuerpo en alfabeto complejo (Times New Roman)
Supported Protocols
HTTP
HTTP with username & password
HTTPS
FTP
FTP with username & password
UTF-8 encoding is highly recommended. For those Content Partners restricting feed access using IP Whitelists, the MSN
Content Ingestion Server IP address can be provided upon request.
Con formato: Fuente: (Asitica) +Cuerpo asitico
(Times New Roman), Fuente de escritura compleja:
+Cuerpo en alfabeto complejo (Times New Roman)
Video feeds
Slideshow feeds
Supported
formats
RSS,
version
2.0 or
lower
Atom,
version
1.0 or
lower
NewsML,
version
2.12 or
lower
JSON
mRSS,
version
2.0 or
lower
NewsML,
version
2.12 or
lower
JSON
mRSS,
version
2.0 or
lower
NewsML,
version
2.12 or
lower
JSON
Feed Size
Required?
Yes
Abstract
Yes
Body*
Yes
Author
Yes
Image*
No
HaveImageSyndicationRig
hts
ImageLicsensorId
...
Con formato
Required, if
HaveImageSyndicationRig
hts is False.
Optional, if
HaveImageSyndicationRig
...
Image Attribution
...
Con formato
Tabla con formato
Value
Title
Con formato
Description
Content Item title.
Title must be 1-150
characters. No HTML
tags allowed.
Content Item description.
Max Value: 650 characters.
HTML tags will be removed
Content Item body. HTML
tags are allowed,
except for <embed>,
<script>,and CSS tags.
Minimum 450 characters
should be supplied in
the body otherwise the
article will be
rejected during
ingestion.
The author or contributor of
the article.
Image file location. Image
URL should be a complete
URL with the file extension
of .jpg or .png in the URL.
<img> tags are supported if
the images are within the
body content. Note: MSN
recommends providing an
image even if you dont have
syndication rights. However,
MSN requires you to set the
HaveImageSyndicationRigh
ts field to indicate you do
not have syndication rights
for this image.
Name of the photographer
who took the image. This is
displayed below the photo.
Boolean flag. 0 = False,
provider has does NOT have
rights to syndicate the image.
1 = True, provider does NOT
have rights to syndicate the
image.
The ImageId is the ID used
to uniquely identify an
image. ImageIds are used by
major image licsensors such
as Getty, Corbis, and
Example
Top 50 Cities to Live in
the World
Default
N/A
Con formato
...
...
First 450
characters
of article
body
N/A
...
Con formato
...
Con formato
...
...
Con formato
...
Con formato
...
Partner
name
N/A
...
Con formato
...
Con formato
...
John Doe
Provided
by
<Partner
name>
Con formato
...
Con formato
...
Con formato
...
...
...
Con formato
...
486444068
...
No
ImageLicensorName
Video URL*
Slide title*
Slide URL*
Slide Attribution*
Slide description*
Slide Focal Point
Tweet*
Tweet status URL*
Published Date
No
No
Photo credit
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
N/A
Con formato
...
Provided
by
<Provider
>
N/A
N/A
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Getty, AP, or
photographers own name.
http://contoso.com/slide.
jpg
Contoso Photos
Seattle view
"focalRegion": {
"x1": 246,
"y1": 140,
"x2": 246,
"y2": 140
}
N/A
N/A
N/A
N/A
N/A
20130718T085600-0500
Ingested
Date
Updated Date
Expiration Date
Unique ID
Web URL
Related Links*
Short Title
Yes
No
Yes
No
No
Content with a
<publishedDate> value
occurring more than 365
days in the past will
be rejected
A string specifying the date
and time of the most recent
update in a format readable
by the System.DateTime
structure in .NET and
formatted according to the
ISO 8601 standard.
Used to sort by updated
date. Also used to
determine if the
content in the feed is
newer than the most
recently ingested
version
A string specifying the
data and time the
article should expire,
given in a format readable
by the System.DateTime
structure in .NET and
formatted according to the
ISO 8601 standard.
A durable (nonchanging) GUID to
uniquely identify the
article in the feed.
Used to update content
items
A canonical URL to the
article on a web site. Used
when sharing content and for
SEO attribution
20130718T105600-0500
20130718T105600-0500
2836489202
http://contoso.com/
articleid=2836489202
http://contoso.com/image.
jpg
Budapest skyline shines
in the night
Top 50 Cities
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
N/A
Con formato
...
N/A
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Ingested
Date
Default
date of
365 days
after
ingestion
N/A
For
Sharing,
default to
MSN
URL. For
SEO, no
default.
N/A
N/A
Deep Link
Yes
No
20130718T105600-0500
N/A
N/A
Divisions
Videos
Tweets
...
...
Con formato
...
Type
...
Con formato
Font size
...
Con formato
Con formato
msnnews://content/AaBcDe
Article Body
Headings
Con formato
Links
Images
Tables
Con formato
...
Tags
<a>
<img>
<table>, <tr>,
<td>, <thead>,
<tbody>,
<tfoot>, <col>,
<caption>,
<colgroup>
<h1>, <h2>,
<h3>
<sub>, <sup>,
<small>
<b>, <i>, <em>,
<strong>
<p>, <br>
(ignored if at end of
content)
<iframe> Allowed
for the 3PP videos
like YouTube, Daily
Motion, etc.
<blockquote
class="twittertweet">
...
If the article text contains CSS tags, these will be removed. Tags <script> and <embed> will cause the article to be rejected.
Other elements not in the table above will be ignored.
Hyperlinks will be stripped in the article unless specified, this is bases on the contract for allowing the inline links and can
be done by market PMs using CPR.
Image
Supported sizes and file formats
Maximum file size
Suggested dimensions
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
...
Con formato
...
Con formato
...
Images in articles may be inserted in the article body text by using the <img> tag with src, alt and data-portal-copyright as the
only required attributes. Data-portal-copyright is used to store the image credit and copy-right information.
Example
<img
src="http://images.mentalfloss.com/sites/default/files/styles/insert_main_wide_image/public/sheep_teeth_4433.jpg"
width="620" height="569" alt="Image title here" data-portal-copyright="Brian Lockwood" />
<img
src="http://images.mentalfloss.com/sites/default/files/styles/insert_main_wide_image/public/s
heep_teeth_4433.jpg" width="620" height="569" alt="Image title here" data-portalcopyright="Brian Lockwood" data-has-syndication-rights="1" data-license-id="698526" datalicensor-name="Licensor name" data-focal-region="x1:246,y1:140,x2:246,y2:140" />
Images in the article body can also be supported with <media:content> or <img> tag, but not both in the body content for
the images.
PlainPicture
Reuters
REX Features
Science Photo Library
Splash News
Shutterstock
USA Today Sports
Market-Specific Image Licensors:
Canadian Press
Gallo Images
GTres
Hollandse Hoogte
Image clicker
Imagine China
Indiasyndicate.com Pvt Ltd.
ITAR-TASS Photo
Noticias Argentinas S.A.
Olycom SPA
Orange Creek
Polska Agencja Prasowa SA
Setford News Photo Agency
Canada
South Africa
Spain
Netherlands
India
Southeast Asia
India
Russia
Argentina
Italy
Netherlands
Poland
New Zealand
Example
<blockquote class ="twitter-tweet" align="center" width="350">
<p>James Harden is the first player to knock down 22 free-throws in one game since... James
Harden in December of 2013</p> Tommy Beer (@TommyBeer)
<a href="https://twitter.com/TommyBeer/status/578750299579551745">March 20, 2015</a>
</blockquote>
Related Links
Articles can contain related articles links if provided via the following methods:
Automatically populate most recent articles Microsoft will display links to the most recent stories that it has
ingested amongst the feeds supplied from the provider. Similar to above, it will use the canonical link by default
but if not provided, Microsoft will not display this link.
Supply related links with article see below for examples on how to do this. If this option is selected, the
Partner must supply at least three related links with each content item in the feed.
NOTE: Title and the href are the mandatory attributes for the related links provided in the feeds. Thumbnail images
can be part of the related link item with the image URL and the image title.
9
A reference to a NewsItem with which the current one is associated (for example, a series of articles, or collection of
photos, of which it is a part).
The NewsItem attribute identifies the relevant NewsItem. In this, the link can be an http URL to the article link of the
associating article.
Example
<AssociatedWith
FormalName="SeeAlso"
NewsItem="http://www. contoso.com/news/prop_irs_1.html"/>
Comment Tag can also be associated with the article to provide additional information in natural language such as a title
associated with the target NewsItem or a type/genre associated with the target NewsItem.
Example
<AssociatedWith
FormalName="SeeAlso"
NewsItem="http://www.contoso.com/news/prop_irs_1.html">
<Comment xml:lang="en" FormalName="Title">New IRS Proposal</Comment>
<Comment xml:lang="en" FormalName="Genre">Political</Comment>
<media media-type="image">
<media-reference mime-type="image/jpg" source="http://contoso.com/image.jpg" alternate-text="
Thumbnail description" copyright=" Thumbnail author"/>
<media-caption> Thumbnail title</media-caption>
</media>
</AssociatedWith>
10
<media:group>
<media:content url="http://www.contoso.com/slide1.jpg" type="image/jpeg" description="Alt text">
<media:credit>Attribution</media:credit>
<media:title>"Slide 1"</media:title>
</media:content>
<media:content url="http://www.contoso.com/slide2.jpg" type="image/jpeg" description="Alt text">
<media:credit>Attribution</media:credit>
<media:title>"Slide 2"</media:title>
</media:content>
<media:content url="http://www.contoso.com/slide3.jpg" type="image/jpeg" description="Alt text">
<media:credit>Attribution</media:credit>
<media:title>"Slide 3"</media:title>
</media:content>
</media:group>
3. In any XML-based feed (ATOM, XML, RSS, mRSS), a content Provider will add the following namespace alias
definition to the header:
<rss version="2.0" xmlns:dl="urn:schemas-microsoft-com:universal-store:deeplink-rss:1.0">
Where
<<deeplink>>: is the custom schema for launching content in the Providers Windows Universal app.
Example:
"link": [
{"rel": "deeplink",
"href": "msnnews://content/AaBcDe"
}
]
Once these prerequisites are met, please work with your MSN contact to have your App associated with your Provider
information in the MSN system, and to have your feeds deep-links mapped in the MSN system.
Video title
R
e
q
ui
re
d
?
Y
es
D
es
cr
ip
ti
o
n
T
h
e
t
i
t
l
e
o
f
t
h
e
v
i
d
e
o
.
Example
D
ef
a
ul
t
N
/
A
12
Video Attribution
Video URL*
Thumbnail Image*
Y
es
Y
es
Y
es
Y
es
C
o
p
yr
ig
ht
in
fo
r
m
at
io
n
fo
r
th
e
vi
d
e
o.
V
id
e
o
so
ur
ce
fil
e
lo
ca
ti
o
n
A
th
u
m
b
n
ai
l
i
m
a
g
e
to
li
n
k
to
th
e
vi
d
e
o.
C
o
p
yr
ig
John Smith
http://contoso.com/video.mp4
P
ar
tn
er
n
a
m
e
N
/
A
http://contoso.com/thumb.jpg
13
N
/
A
S
a
m
e
as
N
o
ht
in
fo
r
m
at
io
n
fo
r
th
e
th
u
m
b
n
ai
l.
T
h
e
fo
ca
l
p
oi
nt
fo
r
th
e
i
m
a
g
e.
T
o
b
e
us
e
d
w
h
e
n
i
m
a
g
e
is
cr
o
p
p
e
d
to
V
id
e
o
A
ttr
ib
ut
io
n
"focalRegion": {
"x1": 246,
"y1": 140,
"x2": 246,
"y2": 140
}
N
/
A
14
Length
Caption
Y
es
Y
es
di
sp
la
y
o
n
di
ff
er
e
nt
si
ze
d
e
vi
ce
s
T
h
e
d
ur
at
io
n
of
th
e
vi
d
e
o
in
se
c
o
n
ds
.
C
a
pt
io
n
te
xt
to
di
sp
la
y
u
n
d
er
th
e
vi
d
e
o.
N
/
A
N
/
A
15
Published Date
Y
es
A
st
ri
n
g
sp
ec
if
yi
n
g
th
e
d
at
e
a
n
d
ti
m
e
of
p
u
bl
ic
at
io
n
in
a
fo
r
m
at
re
a
d
a
bl
e
b
y
th
e
S
ys
te
m
.
D
at
e
Ti
m
e
st
ru
ct
ur
e
in
.
20130718T085600-0500
In
g
es
te
d
D
at
e
16
N
E
T
a
n
d
fo
r
m
at
te
d
ac
c
or
di
n
g
to
th
e
IS
O
8
6
0
1
st
a
n
d
ar
d.
U
s
e
d
t
o
s
o
r
t
b
y
u
p
d
a
t
e
d
d
a
t
e
N
O
T
17
E
:
C
o
n
t
e
n
t
w
i
t
h
a
<
p
u
b
l
i
s
h
e
d
D
a
t
e
>
v
a
l
u
e
o
c
c
u
r
r
i
n
g
m
o
r
e
t
h
a
n
2
4
h
o
u
18
r
s
i
n
t
h
e
f
u
t
u
r
e
w
i
l
l
b
e
r
e
j
e
c
t
e
d
.
C
o
n
t
e
n
t
w
i
t
h
a
<
p
u
b
l
i
s
h
e
d
D
a
t
e
>
v
19
Updated Date
Y
es
a
l
u
e
o
c
c
u
r
r
i
n
g
m
o
r
e
t
h
a
n
3
6
5
d
a
y
s
i
n
t
h
e
p
a
s
t
w
i
l
l
b
e
r
e
j
e
c
t
e
d
A
s
t
r
i
20
P
u
bl
is
h
e
n
g
s
p
e
c
i
f
y
i
n
g
t
h
e
d
a
t
a
a
n
d
t
i
m
e
t
h
e
v
i
d
e
o
w
a
s
u
p
d
a
t
e
d
,
g
i
v
e
n
in
a
fo
r
m
at
re
d
D
at
e
21
a
d
a
bl
e
b
y
th
e
S
ys
te
m
.
D
at
e
Ti
m
e
st
ru
ct
ur
e
in
.
N
E
T
a
n
d
fo
r
m
at
te
d
ac
c
or
di
n
g
to
th
e
IS
O
8
6
0
1
st
a
n
d
ar
d.
U
s
22
Expiration Date
N
o
e
d
t
o
s
o
r
t
b
y
u
p
d
a
t
e
d
d
a
t
e
.
A
s
t
r
i
n
g
s
p
e
c
i
f
y
i
n
g
t
h
e
d
a
t
a
a
n
d
t
i
m
e
t
h
e
20130718T105600-0500
23
E
x
pi
ra
ti
o
n
D
at
e
D
ef
a
ul
t
d
at
e
of
3
6
5
d
a
ys
af
te
r
in
g
es
ti
o
n
v
i
d
e
o
s
h
o
u
l
d
e
x
p
i
r
e
,
g
i
v
e
n
in
a
fo
r
m
at
re
a
d
a
bl
e
b
y
th
e
S
ys
te
m
.
D
at
e
Ti
m
e
st
ru
ct
ur
e
in
.
N
E
T
a
24
Unique ID
Y
es
n
d
fo
r
m
at
te
d
ac
c
or
di
n
g
to
th
e
IS
O
8
6
0
1
st
a
n
d
ar
d.
A
d
u
r
a
b
l
e
(
n
o
n
c
h
a
n
g
i
n
g
)
G
U
I
D
u
s
e
d
2836489202
N
/
A
25
t
o
u
n
i
q
u
e
l
y
i
d
e
n
t
i
f
y
e
a
c
h
v
i
d
e
o
i
n
t
h
e
f
e
e
d
.
T
h
i
s
i
s
a
l
s
o
u
s
e
d
t
o
u
p
d
26
a
t
e
c
o
n
t
e
n
t
i
t
e
m
s
.
F
o
r
Y
o
u
T
u
b
e
v
i
d
e
o
s
,
t
h
e
Y
o
u
T
u
b
e
v
i
d
e
o
I
D
v
a
l
u
e
s
27
Web URL
Y
es
(b
as
e
d
o
n
th
e
c
o
nt
ra
ct
fo
r
sh
ar
in
g
li
n
ks
)
h
o
u
l
d
b
e
p
r
o
v
i
d
e
d
a
s
U
n
i
q
u
e
I
D
A
ca
n
o
ni
ca
l
U
R
L
to
th
e
vi
d
e
o
o
n
a
w
e
b
si
te
.
U
se
d
w
h
e
n
sh
ar
in
http://contoso.com/
videoid=2836489202
28
F
or
S
h
ar
in
g,
d
ef
a
ul
t
to
M
S
N
U
R
L.
F
or
S
E
O
,
n
o
d
ef
a
ul
t.
Closed Captions
N
o
g
c
o
nt
e
nt
a
n
d
fo
r
S
E
O
at
tri
b
ut
io
n
C
lo
se
d
ca
pt
io
ns
ar
e
di
sp
la
y
e
d
o
n
th
e
vi
d
e
os
al
o
n
g
w
it
h
th
e
d
ur
at
io
n
of
th
e
vi
d
<msn:closedcaptions (msn:closedcaptions)>
<msn:closedcaption locale="en-US"
url="http://contoso.com/caption.ttml (msn:clo
sedcaption%20locale=%22enUS%22%20url=%22http://contoso.com/caption.ttm
l%22%20/)" />
N
/
A
29
e
o.
T
hi
s
sh
o
ul
d
b
e
in
ht
m
l
fo
r
m
at
a
n
d
sh
o
ul
d
h
a
v
e
a
lo
ca
le
p
ar
a
m
et
er
.
T
hi
s
lo
ca
le
p
ar
a
m
et
er
w
ill
b
e
us
e
d
b
y
th
30
N
o
e
vi
d
e
o
re
n
d
er
in
g
so
ft
w
ar
e.
C
o
nt
e
xt
u
al
k
e
y
w
or
ds
p
er
c
o
nt
e
nt
it
e
m
.
M
ul
ti
pl
e
k
e
y
w
or
ds
ca
n
b
e
sp
ec
ifi
e
d
in
a
si
n
N
/
A
31
Deep-Link*
N
o
gl
e
n
o
d
e
se
p
ar
at
e
d
b
y
c
o
m
m
as
.
A
U
RI
th
at
al
lo
w
s
a
M
S
N
us
er
to
o
p
e
n
th
e
pi
ec
e
of
c
o
nt
e
nt
in
th
e
c
o
nt
e
nt
Pr
o
msnnews://content/AaBcDe
N
/
A
32
vi
d
er
s
a
p
p
Video URL
Supported Video Codecs
1.
2.
3.
4.
5.
6.
7.
1.
2.
3.
4.
1.
2.
3.
4.
H.264 (Baseline,
Main, and High
Profiles)
MPEG-1
MPEG-2 (Simple and
Main Profile)
MPEG-4 v2 (Simple
Visual Profile and
Advanced Simple
Profile)
VC-1 (Simple, Main,
and Advanced
Profiles)
Windows Media
Video (Simple, Main,
and Advanced
Profiles)
DV (DVC, DVHD,
DVSD, DVSL)
33
One of the following video formats should be available for apps/xplat. It is preferred to have all formats so that
Windows Desktop and Windows Mobile apps can provide the best experience based on available bandwidth.
Format
Code
101
102
103
104
Name
Video
Audio
Protocol
Width
Height
H.264
Low
H.264
SD
H.264
HQ
H.264
HD
H264
AACLC
AACLC
AACLC
AACLC
http
640
http
852
H264
H264
H264
http
http
1280
1920
Ext
Description
480
BitRate
kbps
1800
.mp4
480
2200
.mp4
H.264 Low
Profile
H.264 SD
Profile
H.264 HQ
Profile
H.264 HD
Profile
720
4500
1080
6750
.mp4
.mp4
For videos to be hosted by Microsoft, the guidance is to provide the highest quality video file so that Microsoft
can transcode to the proper streams per device. Minimum quality of 720p, 3Mbps is recommended.
Videos can be embedded within the article if a video link is provided as a media element. <iframe> tags and the
videos with the <media:content> element are supported for the inline videos.
MSN supports in-line embedded videos in the <iframe> tags as well, this support is for both 1PP and the 3PP
videos like YouTube, daily motion videos etc., and more than one 3PP inline video can be supported for an
article.
<iframe> tags and the videos with the <media:content> element are supported for the inline YouTube URLs.
Multiple in-line videos can appear in a single article.
The video URL should be placed in-line within an articles body. The video will be placed according to placement
of URL in body of article in feed. If the video media content sections are outside of article section, these videos
will be placed randomly in the article body.
MSN supports one type of video player per Provider; either a First Party Player (1PP) or a Third Party Player
(3PP). For providers who have an existing video feed, any articles from that provider must use the same type of
video player as the videos in the video feed. For example, if the Provider is configured to use a 1PP (First Party
Video Player), then in-line videos should also be 1PP. If the Providers video feed is configured to use a 3PP
(Third Party Video Player) then inline videos should also be 3PP and will be played in same player.
YouTube videos are 3PP videos, and YouTube in-line videos are supported either in <iframe> or in the
<media:content> section.
34
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Sample RSS feed example for a video embedded in the body content.
<media:content isDefault="false"
url="http://media2.foxnews.com/110113/110113_yw_tsa_FNC_HIGH.mp4" id=123456 duration="91"
bitrate="1500" fileSize="17791133" type="video/mp4">
<media:copyright>2013 Fox News Channel</media:copyright>
<media:title type="plain">Report: LAX shooter is 23-year-old Paul Ciancia</media:title>
<media:description type="plain">Reported 'rant' about TSA workers</media:description>
</media:content>
Deep-Link
Please see the information in the Article section, Deep Linking Content to Your App.
Required?
Yes
Description
The title of the
slideshow. Must be 1150 characters.
35
Example
Top 50 Cities to Live in
the World
Default
N/A
Slideshow description
No
Yes
Yes
HaveImageSyndicationRig
hts
ImageLicsensorId
ImageLicensorName
Published Date
Yes
Required, if
HaveImageSyndicationRig
hts is False.
Optional, if
HaveImageSyndicationRig
hts is True.Yes, even if
syndication rights are not
available.
Required, if
HaveImageSyndicationRig
hts is False.
Optional, if
HaveImageSyndicationRig
hts is True.Yes, even if
syndication rights are not
available.
No
No
No
No
Yes
A description of the
slideshow.
The title of the individual
slide.
Image file location. Image
URL should be a complete
URL with the file extension
of .jpg or .png in the URL.
<img> tags are supported if
the images are within the
body content. Note: MSN
recommends providing an
image even if you dont have
syndication rights. However,
MSN requires you to set the
HaveImageSyndicationRig
hts field to indicate you do
not have syndication rights
for this image.
Name of the photographer
who took the image. This is
displayed below the photo.
...
Con formato
...
Con formato
...
Con formato
...
http://contoso.com/slide.
jpg
N/A
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Contoso Photos
Getty, AP, or
photographers own name.
36
...
Con formato
N/A
486444068
...
Con formato
Second runner-up
Con formato
Provided
by
<Partner
Name>
N/A
N/A
N/A
Ingested
Date
Updated Date
Expiration Date
Unique ID
Web URL
Yes
No
Yes
No
Related Links*
No
Content with a
<publishedDate> value
occurring more than 365
days in the past will
be rejected
A string specifying the
data and time the
slideshow was updated,
given in a format readable
by the System.DateTime
structure in .NET and
formatted according to the
ISO 8601 standard.
...
Con formato
...
http://contoso.com/
videoid=2836489202
Image description
Con formato
Ingested
Date
Expiration
DateDefau
lt date of
365 days
after
ingestion
N/A
...
...
Con formato
...
Con formato
...
...
Con formato
...
...
Con formato
...
37
...
...
Deep-Link*
No
msnnews://content/AaBcDe
N/A
Slideshows can be embedded within article if a set of images are provided under a <media:group> element
Slideshow Image
1366x768 (16:9)
1190x768 (3:2)
1190x1190 (1:1)
Related Links
Articles can contain related articles links if provided via the following methods:
Automatically populate most recent articles Microsoft will display links to the most recent stories that it has
ingested amongst the feeds supplied from the provider. Similar to above, it will use the canonical link by default
but if not provided, Microsoft will not display this link.
Supply related links with article see below for examples on how to do this.
NOTE: Title and the href are the mandatory attributes for the related links provided in the feeds. Thumbnail images
can be part of the related link item with the image URL and the image title
<AssociatedWith> is the tag that is supported by NewsML for linking related articles.
A reference to a NewsItem with which the current one is associated (for example, a series of articles, or collection of
photos, of which it is a part).
The NewsItem attribute identifies the relevant NewsItem. In this, the link can be an http URL to the article link of the
associating article.
Example
<AssociatedWith
FormalName="SeeAlso"
NewsItem="http://www. contoso.com/news/prop_irs_1.html"/>
Comment Tag can also be associated with the article to provide additional information in natural language such as a title
associated with the target NewsItem or a type/genre associated with the target NewsItem.
38
Example
<AssociatedWith
FormalName="SeeAlso"
NewsItem="http://www.contoso.com/news/prop_irs_1.html">
<Comment xml:lang="en" FormalName="Title">New IRS Proposal</Comment>
<Comment xml:lang="en" FormalName="Genre">Political</Comment>
<media media-type="image">
<media-reference mime-type="image/jpg" source="http://contoso.com/image.jpg" alternatetext=" Thumbnail description" copyright=" Thumbnail author"/>
<media-caption> Thumbnail title</media-caption>
</media>
</AssociatedWith>
The element must have an href attribute that contains the URL of the related resource and can contain the following
attributes: hreflang, length, title, type.
For related content. The element can indicate rel attribution which contains a keyword that provides the nature of
the relationship between the linked resource and the element.
Example
<link rel="related"
type="text/html"
href="http://contoso.com/news/prop_irs_1.html"
title="New IRS proposal">
<media:thumbnail url="http://contoso.com/image.jpg" type="image/jpeg"/>
<media:credit>Thumbnail Attribution</media:credit>
<media:title> Thumbnail title</media:title>
<media:text> Thumbnail description</media:text>
</link>
"relatedLinks": [
39
{
"rel": "related",
"href": "http://www.contoso.com/news/prop_irs_1.html",
"mediaType": "text/html",
"thumbnail": "http://contoso.com/image.jpg",
"title": " Thumbnail title",
"author": " Thumbnail author",
"description": " Thumbnail description"
}]
Deep-Link
Please see the information in the Article section, Deep Linking Content to Your App.
The <UniqueID> element should have the same value as original content. Any re-use of the <UniqueID> value will
result in the original content being overwritten.
The <publishedDate> element should have the same value as when the content was originally published.
The <updatedDate> element should have a value of the current date (different from the <publishedDate> value). For
the initial publish this will be the same value as <published> (this might be a different element for this feed i.e.
<updateDate>)
NOTE: Any change to a partners UniqueID scheme must be communicated to MSN Editorial Engineering 30 days in
advance of the change. This allows enough time to either re-map or re-ingest videos using the new scheme.
40
Design Input
The following information empowers our designers to create the best branded experience(s) for you. While only the logos are required, the more
information provided, the better we can fine tune to meet your branding needs.
Rectangular vector logo. Typically, this is the logo/mark + the company name/logotype side by side.
Square vector logo designed for larger sizes (50x50, 100x100)
Vector logo for favicon: Square, works well at a small size (16x16, 24x24)
Partner Upsell Ad used as a promotional module for partners to advertise their brand alongside their content. The partner upsell ad is
composed of a 300x250 image (acceptable formats: .png, .jpg, .gif) with a click-thru URL. It may be updated at the partners request.
o Along with this form, please send your image.
Link to Partner Website used to link to Partners full website alongside its content. Partner can configure both the text to display (e.g.
Go to full site) and the URL.
Description
Partner Upsell Ad Click-thru URL
Partner Link Text (default: Go to full site
Partner Link URL
Value
Custom Font
Along with this form, please send your font for branding purposes. Preferred format is .ttf (True Type).
Branding Guidelines
If easier, please feel free to provide the below branding guidelines in document form.
Branding
Color Palette (Hex values)
e.g. Accent color #333333
Typography treatment
e.g. Fonts, Bolding, etc.
Other
Value
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
41
Con formato
...
Con formato
...
Con formato
...
Feed Info
o Feed URL URL of discrete feed
o Update Frequency how often content is updated within the feed. Bing will pull for updated content according to this value.
o Staleness Threshold max threshold for content age before we should trigger a live site escalation. i.e. if the most recent content
is >3 days, escalate to determine whether there is a technical issue with ingestion.
o Credentials any information needed to access the feed, e.g. username/password
Branded Experience required information if feed is used to program a branded experience (e.g. partner pano, standalone app)
o Section Title self-explanatory, used in home pano, top navigation bar, semantic zoom, and other areas where we reference
sections of the branded experience
o Sort order order to display content in branded experience. Supported sorts:
Feed URL
http://contoso.co
m/news.xml
Update
Frequency
1 hr
Feed Info
Staleness
Threshold
3 days
Credentials
Branded Experience
Section Title
Sort Order
N/A
Top News
FIFO
Notes
Inline video in
articles, please
make sure ingested
properly
Contacts
Contact Type
Example
Name
e.g.
John
Smith
Email Address
e.g.
smith@publisher.com
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
...
Con formato
...
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...
Con formato
...