MSN 파트너 허브의 피드 콘텐츠 사양

MSN 파트너 허브의 피드 콘텐츠 사양은 파트너의 콘텐츠가 효율적이고 정확하게 수집, 유효성 검사 및 게시되도록 설계되었습니다. 이러한 사양은 지원되는 콘텐츠 형식, 형식, 메타데이터 규칙 및 피드 상태 및 안정성 유지를 위한 지침을 포함하여 콘텐츠 관리의 다양한 측면을 다룹니다.

MSN은 다음을 지원합니다.

문서, 갤러리 및 비디오
HTTPS 피드 원본. TLS/SSL을 사용하는 것이 좋습니다.

MSN은 다음을 지원하지 않습니다.

리소스 또는 매개 변수의 사용자 이름 또는 암호를 포함하는 링크
IP 허용 목록
정적 IP

이 문서의 내용

문서

문서는 텍스트, 이미지 및 비디오로 구성된 게시물입니다. 아티클에는 이미지가 필요하지 않지만 이미지가 포함된 아티클만 자동으로 게시할 수 있습니다.

갤러리

갤러리는 이미지와 캡션으로 구성된 슬라이드 쇼입니다. 갤러리에는 게시할 이미지가 포함되어 있어야 합니다.

비디오

비디오는 직접 게시하거나 문서에 포함할 수 있습니다. 피드에서 수집된 비디오 게시물은 MSN에 다시 호스트되고, YouTube 또는 DailyMotion과 같은 타사 사이트에서 호스트되는 동영상은 해당 사이트의 호스팅을 통해 포함됩니다.

MSN에서 호스트되는 비디오는 다중 디바이스 트랜스코딩 및 적응 스트리밍을 위해 여러 비트 전송률을 생성합니다.

지원되는 비디오 컨테이너 형식

AVI, MPEG, MP4, WMV, M4V

지원되는 비디오 코덱

H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV(DVC, DVHD, DVSD, DVSL)

지원되는 오디오 형식

AC-3(Dolby Digital), AAC, MP3, Windows Media Audio

지원되는 프로토콜

HTTP, FTP

지원되는 파일 확장자

.mp4, .mpeg, .mpg, .wmv, .avi, .m4v

비디오 크기

비디오는 720p, 3Mbps 이상이어야 합니다. 최대 비디오 파일 크기는 2GB입니다. 4K 비디오 및 긴 비디오와 같은 대용량 파일은 수집에 실패할 수 있습니다.

참고: 업스케일링은 지원되지 않으므로 높은 비디오 파일 품질을 권장합니다.

이미지

이미지는 자체 게시물일 수 없습니다. 문서 또는 갤러리에 포함되거나 비디오 게시물에 썸네일로 첨부되어야 합니다.

지원되는 이미지 형식

WebP, PNG, JPG, GIF

참고: GIF는 썸네일 이미지로 사용할 수 없습니다. 제한된 품질로 인해 기본 콘텐츠에서 사용하는 것은 권장되지 않습니다.

이미지 크기

콘텐츠 내 이미지

이미지는 높이 또는 너비가 720px 이상인 것이 좋습니다. 최대 이미지 파일 크기는 15MB입니다. 이미지는 가로 세로 비율이 될 수 있지만 비율이 .5보다 작거나 1.89보다 크면 올바르게 표시되지 않을 수 있습니다.

썸네일 이미지

썸네일 이미지는 콘텐츠의 헤드라인과 함께 제공되는 기본 이미지입니다.

권장되는 이미지 크기는 1200x624px이며 최소 DPI는 72입니다.
원하는 이미지 가로 세로 비율은 1.91:1입니다.
최대 파일 크기는 2MB여야 합니다.

소셜 미디어

MSN은 다음의 포함을 지원합니다.

Twitter
Facebook
Instagram
Pinterest
Infogram
Spotify
번영하다
Google 지도
Giphy
레딧 ()
TikTok

MSN은 원본 사이트에서 제공하는 기본 포함 코드를 사용하는 것이 좋습니다. 일반적인 소셜 미디어 사이트에 대한 포함 코드의 예를 보려면 여기를 클릭하십시오.

피드 메타데이터 규칙

게시자는 피드 내의 모든 콘텐츠에 대한 배포 권한이 있어야 합니다. 게시자가 일부 이미지를 신디케이트할 권한이 없는 경우 "HasSyndicationRights"를 false로 설정해야 합니다.
모든 피드는 라이브로 전환하기 전에 신선하고 정기적으로 업데이트되어야 합니다.
사용자 지정 매핑은 지원되지 않습니다. 모든 필드는 지정된 예제에 따라 지정해야 합니다.
파트너 엔드포인트는 경로 세그먼트, 쿼리 문자열 값 및 HTTP 요청 헤더 값과 같은 동적 값을 빌드할 필요가 없는 정적/비동기여야 합니다.
피드의 모든 항목은 피드에 대해 구성된 동일한 단일 언어에 있어야 합니다.
xml 태그에 달리 지정하지 않는 한 인코딩은 기본적으로 UTF-8입니다. 혼합 또는 인코딩이 있는 피드는 수집에 실패합니다.
피드에는 "&", "<", ">", 큰따옴표 및 작은따옴표와 같은 이스케이프되지 않은 잘못된 문자가 포함되어서는 안 됩니다. 컨트롤 문자가 있는 항목은 수집에 실패합니다.
Microsoft는 주로 홍보용 특성의 링크를 제거할 수 있습니다.
게시자의 브랜드가 부실 피드와 같은 라이브 사이트 문제를 콘텐츠 게시자에게 알리는 데 사용할 수 있도록 게시자 연락처 전자 메일을 저장해야 합니다.

피드 변경 검색

MSN은 새 콘텐츠 또는 업데이트된 콘텐츠가 있는 피드만 처리하여 수집 중에 리소스를 저장합니다. 변경 내용은 다음 두 가지 방법으로 플래그를 지정할 수 있습니다.

HTTP ETags

게시자는 피드 콘텐츠에 대한 체크섬처럼 작동하는 ETag 헤더를 사용하여 요청을 보낼 수 있습니다. 피드를 요청하는 동안 태그가 캐시되고 If-None-Match 헤더로 다시 전송됩니다.

마지막으로 수정한 시간

마지막으로 수정한 헤더와 함께 전송된 콘텐츠는 캐시되며 후속 요청은 If-Modified-Since 헤더를 받습니다. 마지막으로 수정한 날짜 이후 변경 내용이 없는 경우 피드 서버는 304 상태 코드로 응답합니다.

피드 인증

피드 인증은 필요하지 않습니다. 게시자는 원하는 경우 피드 원본 URL에 지나지 않고 콘텐츠를 수집할 수 있지만 MSN은 기본 인증 및 OAuth 2.0도 지원합니다. 피드 수집 프로세스를 자세히 설명하는 차트를 보려면 여기를 클릭하세요.

기본 인증

MSN은 RFC 7517에 지정된 대로 기본 인증을 지원합니다. 피드에 기본 인증을 추가하려면 다음을 제공합니다.

사용자 이름
암호
보안 피드 URL

OAuth 2.0

피드에 OAuth 2.0 인증을 추가하려면 다음을 제공합니다.

보안 토큰 서버 URL
Client_ID
Grant_Type
범위(선택 사항이며, 액세스 수준을 나타내는 데 사용됩니다. 이 값은 있는 그대로 전송됩니다.)
보안 피드 URL

문서 인코딩

MSN은 기본적으로 UTF-8 인코딩을 사용합니다. 프롤로그 노드의 인코딩 특성을 유효한 인코딩 값으로 변경하여 이를 재정의할 수 있습니다.

지원되는 피드 형식

MSN은 RSS, ATOM 및 Media RSS, Dublin Core 및 Media RSS에 자세히 설명된 기타 네임스페이스의 일부 하위 집합을 지원 합니다.

큰 피드

MSN은 항상 30개 미만의 새 항목의 피드 크기를 유지하는 것이 좋지만 ATOM의 피드 페이징 기능을 사용하여 피드의 슬라이딩 윈도우 수집을 사용하도록 설정할 수 있습니다.

제한 및 오류 처리

최대 피드 크기는 10MB 이고 최대 이미지 크기는 14MB입니다. 수집된 콘텐츠가 3일 이상 지난 경우 MSN은 자동으로 에스컬레이션을 트리거합니다. 콘텐츠 연령 요구 사항이 다른 경우 PartnerHubSupport@microsoft.com 문의하세요. MSN은 오류가 있는 피드를 다시 시도하지만 오류가 지속되면 조사하라는 알림이 표시됩니다. MSN은 장기간 오류 상태로 유지되는 피드에서 콘텐츠 수집을 자동으로 해제합니다.

네임스페이스를 사용하여 피드 확장

권장 접두사와 함께 XML 기반 피드에서 피드 어휘 및 용어를 확장할 수 있습니다. MSN은 나열된 코드 예제에 명시적으로 지정된 요소 및 특성만 인식합니다. 지원되지 않는 네임스페이스는 무시됩니다.

확장 이름	Prefix(접두사)	네임스페이스
미디어 RSS	미디어	http://search.yahoo.com/mrss/
더블린 코어 메타데이터	직류	http://purl.org/dc/elements/1.1/
더블린 핵심 약관	dcterms	http://purl.org/dc/terms/
독점 Microsoft 수집 서비스	미	http://schemas.ingestion.microsoft.com/common/