Thông số kỹ thuật về nội dung nguồn cấp dữ liệu trong Hub Đối tác trên MSN

Thông số kỹ thuật về nội dung nguồn cấp dữ liệu trong Hub Đối tác của MSN được thiết kế để đảm bảo nội dung từ các đối tác được nhập, xác thực và phát hành hiệu quả và chính xác. Những đặc tả này bao gồm các khía cạnh khác nhau của quản lý nội dung, bao gồm các loại nội dung, định dạng, quy tắc siêu dữ liệu và hướng dẫn được hỗ trợ để duy trì trạng thái và độ tin cậy của nguồn cấp dữ liệu.

MSN hỗ trợ:

  • Bài viết, Bộ sưu tập và Video
  • Nguồn cấp HTTPS. Chúng tôi khuyên bạn nên sử dụng TLS/SSL.

MSN không hỗ trợ:

  • Liên kết chứa tên người dùng hoặc mật khẩu trong tài nguyên hoặc tham số
  • Danh sách trắng IP
  • IP tĩnh

Trong bài viết này

Bài viết

Phòng trưng bày

Video

Hình ảnh

Các nối kết liên quan

Phương tiện truyền thông xã hội

Quy tắc siêu dữ liệu nguồn cấp dữ liệu

Xác thực nguồn cấp dữ liệu

Mã hóa tài liệu

Định dạng nguồn cấp được hỗ trợ

Nguồn cấp dữ liệu lớn

Giới hạn và xử lý lỗi

Mở rộng nguồn cấp với không gian tên

Bài viết

Bài viết là các bài đăng bao gồm văn bản, hình ảnh và video. Không bắt buộc phải có hình ảnh mà chỉ có bài viết bao gồm hình ảnh mới có thể tự động phát hành.

Hướng dẫn tiêu đề

  1. Chiều dài: Tiêu đề dài hơn 150 ký tự sẽ bị từ chối trừ khi tiêu đề ngắn cũng được cung cấp. Để tránh bị cắt bớt trên thẻ khuyến mãi trên MSN, hãy để tiêu đề dưới 75 ký tự.

    1. Đối với Copilot Discover, thẻ nội dung khuyến mãi yêu cầu dòng tiêu đề ngắn gồm 54 ký tự trở xuống.
    2. Để gửi tiêu đề ngắn, hãy sử dụng định dạng này:
      <mi:shortTitle>Short Title</mi:shortTitle>
    3. Nếu không có tiêu đề ngắn nào được cung cấp, MSN có thể tạo phiên bản ngưng tụ bằng cách sử dụng AI. Phiên bản này sẽ xuất hiện trên thẻ khuyến mãi, trong khi tiêu đề ban đầu của bạn vẫn còn trên trang bài viết.

  2. URL: Không bao gồm URL hoặc URL rút ngắn.

  3. Grammar: Tiêu đề phải chính xác về mặt ngữ pháp. Có thể chấp nhận các quy ước chung. Duy trì sự nhất quán. Câu hỏi hoặc câu lệnh gián tiếp được cho phép. Dấu ngoặc kép được chấp nhận ngay cả khi không đúng ngữ pháp.

  4. Viết hoa:

    1. Từ viết tắt phải nằm trong ALL CAPS.

    2. Từ có thể được viết BẰNG ALL CAPS để nhấn mạnh.

    3. Sử dụng một trong các kiểu sau:

      1. Trường hợp Tiêu đề
      2. Tất cả Từ
      3. Câu chữ hoa/thường

  5. Spelling: Phải không có lỗi chính tả. Có thể chấp nhận các biến thể khu vực. Tên ít được biết đến hơn phải luôn được chấp nhận.

  6. Dấu câu: Sử dụng dấu câu tối thiểu nhưng cần thiết. Có thể dùng hoán đổi các dấu chấm và dấu phẩy. Tránh dấu câu độc đáo trừ khi một phần của thương hiệu cụ thể. Tiêu đề không cần kết thúc bằng một dấu chấm.

Phòng trưng bày

Bộ sưu tập là trình chiếu bao gồm hình ảnh và chú thích. Bộ sưu tập phải có ảnh nhúng để phát hành.

Video

Bạn có thể đăng video riêng hoặc đưa vào các bài viết. Bài đăng video được đăng từ nguồn cấp dữ liệu của bạn sẽ được lưu trữ lại trên MSN, trong khi video được lưu trữ trên một trang web của bên thứ ba như YouTube hoặc DailyMotion sẽ được nhúng thông qua lưu trữ của site đó.

Video được lưu trữ trên MSN sẽ tạo ra nhiều bitrates để chuyển đổi nhiều thiết bị và phát trực tuyến thích ứng.

Các định dạng bộ chứa video được hỗ trợ

AVI, MPEG, MP4, WMV, M4V

Codec video được hỗ trợ

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

Định dạng âm thanh được hỗ trợ

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

Các giao thức được hỗ trợ

HTTP, FTP

Đuôi tệp được hỗ trợ

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

Kích cỡ video

Video được khuyến nghị có độ phân giải tối thiểu là 720p, 3Mbps. Kích thước tệp video tối đa là 2GB. Có thể không nhập được các tệp lớn, chẳng hạn như video 4K và video dài hơn.

Lưu ý

Không hỗ trợ tăng cấp, vì vậy chất lượng tệp video cao được khuyến nghị.

Hình ảnh

Hình ảnh không thể được đăng riêng. Chúng phải được nhúng vào bài viết hoặc bộ sưu tập hoặc đính kèm vào bài đăng video dưới dạng hình thu nhỏ.

Định dạng ảnh được hỗ trợ

WebP, PNG, JPG, GIF

Lưu ý

Không thể sử dụng gif làm hình thu nhỏ. Việc sử dụng chúng trong nội dung chính không được khuyến khích do chất lượng hạn chế.

Kích cỡ hình ảnh

Hình ảnh nội dung

Chúng tôi khuyên bạn nên để hình ảnh có chiều cao hoặc chiều rộng tối thiểu là 720px. Kích thước tệp hình ảnh tối đa là 15 MB. Hình ảnh có thể là bất kỳ tỷ lệ khung ảnh nào nhưng có thể không hiển thị chính xác nếu tỷ lệ nhỏ hơn 0,5 hoặc lớn hơn 1,89.

Hình thu nhỏ

Hình thu nhỏ là hình ảnh chính đi kèm với tiêu đề nội dung. 

  • Các định dạng tệp được chấp nhận là JPG, GIF hoặc PNG
  • Kích thước hình ảnh được đề xuất là 1280x720px, với kích thước tối thiểu là 640x360px
  • Tỷ lệ khung ảnh mong muốn là 16:9
  • Kích thước tệp tối đa phải là 2MB

Bài đăng của tất cả các loại có thể có liên kết liên quan ở cuối nội dung. Các liên kết liên quan phải có vị trí liên kết, văn bản hiển thị và hình thu nhỏ mới xuất hiện.

Phương tiện truyền thông xã hội

MSN hỗ trợ nhúng từ:

  • Twitter
  • Facebook
  • Instagram
  • Pinterest
  • Infogram
  • Spotify
  • Phát triển
  • Google Maps
  • Giphy
  • Reddit
  • TikTok

MSN khuyên bạn nên sử dụng mã nhúng mặc định do trang web nguồn cung cấp. Bấm vào đây để xem ví dụ về mã nhúng cho các trang web truyền thông xã hội phổ biến.

Quy tắc siêu dữ liệu nguồn cấp dữ liệu

  • Publisher phải có quyền phân phối cho tất cả nội dung trong nguồn cấp. Nếu nhà xuất bản không có quyền cung cấp một số hình ảnh, họ PHẢI đặt "HasSyndicationRights" là sai.
  • Tất cả nguồn cấp dữ liệu phải mới và cập nhật thường xuyên trước khi phát trực tuyến.
  • Ánh xạ tùy chỉnh không được hỗ trợ, tất cả các trường phải được chỉ định theo ví dụ đã cho.
  • Điểm cuối của đối tác phải tĩnh/không thay đổi khi không có yêu cầu để xây dựng bất kỳ giá trị động nào chẳng hạn như phân đoạn định tuyến, giá trị chuỗi truy vấn và giá trị tiêu đề yêu cầu HTTP.
  • Tất cả các mục trong nguồn cấp phải ở cùng một ngôn ngữ được cấu hình cho nguồn cấp.
  • Mã hóa là UTF-8 theo mặc định trừ khi có quy định khác trong thẻ xml. Nguồn cấp dữ liệu có hỗn hợp hoặc mã hóa sẽ không ăn được.
  • Nguồn cấp dữ liệu không được chứa bất kỳ ký tự không hợp lệ không được thoát chẳng hạn như "&", "<", ">", dấu ngoặc kép và dấu nháy đơn. Các mục có ký tự điều khiển sẽ không thể nhập.
  • Microsoft có thể dải bất kỳ liên kết nào có bản chất quảng cáo chủ yếu.
  • Email của người liên hệ nhà xuất bản phải được lưu trữ khi thương hiệu của nhà xuất bản được lên kế hoạch sử dụng để thông báo cho nhà xuất bản nội dung về các sự cố site trực tiếp như nguồn cấp dữ liệu cũ.

Phát hiện thay đổi nguồn cấp dữ liệu

MSN tiết kiệm tài nguyên trong quá trình nhập bằng cách chỉ xử lý nguồn cấp có nội dung mới hoặc cập nhật. Các thay đổi có thể được gắn cờ theo hai cách:

HTTP ETags

Nhà xuất bản có thể gửi yêu cầu có tiêu đề ETag, hoạt động như kiểm tra nội dung nguồn cấp. Thẻ sẽ được lưu vào bộ đệm ẩn và được gửi lại về tiêu đề If-None-Match trong khi yêu cầu nguồn cấp.

Sửa đổi lần cuối

Nội dung được gửi kèm theo tiêu đề Sửa đổi Lần cuối sẽ được lưu vào bộ đệm ẩn, với yêu cầu tiếp theo nhận được tiêu đề If-Modified-Since . Máy chủ nguồn cấp dữ liệu sẽ phản hồi với mã trạng thái 304 nếu không có thay đổi nào được thực hiện kể từ ngày sửa đổi gần nhất.

Xác thực nguồn cấp dữ liệu

Không bắt buộc phải xác thực nguồn cấp dữ liệu. Nhà xuất bản có thể nhập nội dung không có gì ngoài URL nguồn cấp dữ liệu nếu họ muốn, nhưng MSN cũng hỗ trợ Xác thực cơ bản và OAuth 2.0. Bấm vào đây để xem biểu đồ trình bày chi tiết quy trình nhập nguồn cấp dữ liệu.

Xác thực Cơ bản

MSN hỗ trợ xác thực cơ bản như được chỉ định trong RFC 7517. Để thêm xác thực cơ bản vào nguồn cấp dữ liệu của bạn, hãy cung cấp:

  • Tên người dùng
  • Mật khẩu
  • URL Nguồn cấp bảo mật

OAuth 2.0

Để thêm xác thực OAuth 2.0 vào nguồn cấp dữ liệu của bạn, hãy cung cấp:

  • URL Máy chủ Mã thông báo Bảo mật
  • Client_ID
  • Grant_Type
  • Phạm vi (Tùy chọn, được dùng để chỉ báo mức truy nhập. Giá trị này sẽ được gửi như hiện tại.)
  • URL Nguồn cấp bảo mật

Mã hóa tài liệu

MSN sử dụng mã hóa UTF-8 theo mặc định. Bạn có thể ghi đè lên thuộc tính này bằng cách thay đổi thuộc tính mã hóa của nút prolog thành giá trị mã hóa hợp lệ.

Định dạng nguồn cấp được hỗ trợ

MSN hỗ trợ RSS, ATOM và một số tập con của Media RSS, Dublin Core và các không gian tên khác được nêu chi tiết trong Media RSS.

Nguồn cấp dữ liệu lớn

MSN khuyên bạn nên duy trì kích thước nguồn cấp dữ liệu dưới 30 mặt hàng mới tại mọi thời điểm, nhưng bạn có thể sử dụng tính năng phân trang Nguồn cấp dữ liệu của ATOM để bật chức năng nhập cửa sổ trượt của nguồn cấp dữ liệu.

Giới hạn và xử lý lỗi

Kích thước nguồn cấp dữ liệu tối đa là 10 MB và kích thước hình ảnh tối đa là 14 MB. MSN tự động kích hoạt báo cáo nếu nội dung được nhập cách đây hơn ba ngày. Nếu bạn có các yêu cầu về độ tuổi nội dung khác, hãy liên hệ với chúng tôi tại PartnerHubSupport@microsoft.com. MSN thử lại nguồn cấp có lỗi, nhưng nếu lỗi vẫn tiếp diễn, bạn sẽ được thông báo để điều tra. MSN tự động tắt tính năng nhập nội dung từ nguồn cấp dữ liệu còn ở trạng thái lỗi trong một khoảng thời gian dài.

Mở rộng nguồn cấp với không gian tên

Bạn có thể mở rộng từ vựng và thuật ngữ nguồn cấp trong nguồn cấp dựa trên XML cùng với tiền tố được đề xuất của chúng. MSN chỉ nhận dạng các phần tử và thuộc tính được chỉ định rõ ràng trong các ví dụ về mã được liệt kê. Mọi không gian tên không được hỗ trợ sẽ bị bỏ qua.

Tên Phần mở rộng Tiền tố Tên
Media RSS media http://search.yahoo.com/mrss/
Siêu dữ liệu Lõi Dublin Dc http://purl.org/dc/elements/1.1/
Điều khoản Cốt lõi của Dublin số từ http://purl.org/dc/terms/
Dịch vụ Nhập độc quyền của Microsoft Mi http://schemas.ingestion.microsoft.com/common/