Yêu cầu siêu dữ liệu mục nguồn cấp MSN
Trang này phác thảo các trường siêu dữ liệu bắt buộc và tùy chọn cho bài viết, video, bộ sưu tập và hình ảnh trong nguồn cấp MSN. Sử dụng hướng dẫn này để đảm bảo các mục đáp ứng tiêu chuẩn nhập tối thiểu và hỗ trợ hiển thị chất lượng cao trên MSN.
Yêu cầu mục nguồn cấp dữ liệu áp dụng cho tất cả thị trường và tất cả nhà phát hành, nhưng một số thị trường hoặc trường hợp kinh doanh nhất định có thể yêu cầu trường bổ sung. Hãy liên hệ với chúng tôi partnerhubsupport@microsoft.com theo số nếu bạn có thêm yêu cầu về mặt hàng nguồn cấp dữ liệu.
Trong bài viết này
Cập nhật các mục đã nhập trước đó
Bài viết
Bài viết phải có ID Duy nhất, Tiêu đề, Ngày phát hành, Nội dung và URL Liên kết. Tất cả các siêu dữ liệu khác là tùy chọn.
Trường bắt buộc
| Tên trường | Mô tả |
|---|---|
| ID duy nhất | GUID bền vững (không thay đổi) để nhận dạng duy nhất bài viết trong nguồn cấp dữ liệu. Nó cũng có thể là URL duy nhất đầy đủ của bài viết. Giá trị này phải là duy nhất trên tất cả các mục nội dung đến từ cùng một đối tác. |
| Tiêu đề | Tiêu đề mục nội dung phải nhiều hơn 20 ký tự nhưng không được vượt quá 150 ký tự trừ khi tiêu đề ngắn cũng được cung cấp. Tiêu đề vượt quá 150 ký tự mà không có tiêu đề ngắn có thể bị loại bỏ. Không cho phép thẻ HTML. |
| Nội dung | Nội dung mục nội dung. HTML được cho phép cho cả định dạng RSS và Atom. |
| Ngày phát hành | Thời gian xuất bản. Ngày phải là quá khứ và dưới 365 ngày, nếu không nó sẽ không được tiêu hóa. Các định dạng ngày được hỗ trợ là RFC 822 Có và RFC 3339. |
| Liên kết (URL web) | MỘT URL được sử dụng để định vị duy nhất mục nguồn cấp trên website của nhà phát hành. Liên kết này có thể được sử dụng trong chia sẻ mạng xã hội tùy thuộc vào hợp đồng của bạn. |
Trường tùy chọn nhưng được đề xuất
| Tên trường | Mô tả |
|---|---|
| Trừu tượng | Phải ở dạng văn bản thuần. Không hỗ trợ HTML. |
| Ngày cập nhật | Nếu ngày này được cung cấp, nó sẽ được sử dụng để xác định xem nội dung trong mục nguồn cấp dữ liệu này có phải là phiên bản mới hơn của tài liệu được nhập ban đầu với id Không được chỉ định không. Nếu không, "Ngày Phát hành" sẽ được sử dụng cho mục đích này. |
| Ngày hết hạn | Mục nguồn cấp dữ liệu sẽ bị xóa khỏi mục phụ trợ và phụ trợ hub đối tác trên MSN vào ngày được chỉ định. Nếu giá trị này không được cung cấp, mục nội dung sẽ hết hạn sau 365 ngày sau khi nhập. Ngày hết hạn phải lớn hơn 2 giờ trong tương lai. |
| Subtitle | Một tiêu đề giải thích hoặc thay thế được sử dụng để hiển thị dọc theo bên dưới tiêu đề trong Thẻ Khuyến mãi. |
| Tiêu đề ngắn | Giá trị "tiêu đề ngắn", còn được gọi là "Tiêu đề Web" được sử dụng khi hiển thị nội dung trên thiết đặt thu gọn, chẳng hạn như thẻ khuyến mãi. Giá trị trong trường này phải có 54 ký tự trở xuống. |
| Tác giả | Tác giả hoặc người đóng góp của bài viết. |
| (Các) hình ảnh | Nếu một hình ảnh được tham chiếu, một số siêu dữ liệu nhất định phải được chỉ định theo phần trường bắt buộc của hình ảnh. Mặc dù hình ảnh là tùy chọn nhưng chúng được yêu cầu để tự động phát hành. |
| Các nối kết liên quan | Liên kết liên quan có thể được xác định để hiển thị cùng với nội dung. Ít nhất ba liên kết liên quan phải được cung cấp cho mỗi bài viết. |
| Thể loại | Xác định các thẻ liên quan đến phần nội dung. Sử <category> dụng các yếu tố để thêm thẻ trong cả RSS và ATOM. |
| Từ khóa | Từ khóa ngữ cảnh cho mỗi mục nội dung. Nhiều từ khóa có thể được chỉ định trong một nút duy nhất được phân tách bởi dấu phẩy. Để chỉ định giá trị này trong RSS hoặc ATOM, bạn Không cần sử dụng thành phần Media RSS <media:keywords> . |
| Trình chiếu nhúng | Các bài viết có thể đã nhúng trình chiếu. Tham khảo ví dụ về Trình chiếu để biết thêm chi tiết. |
| Video nhúng | Bài viết có thể có video nhúng. Tham khảo Ví dụ về video để biết thêm chi tiết. |
| SubscriptionProductType | Bạn có thể truy nhập một số mục nguồn cấp dữ liệu thông qua mô hình đăng ký. Để chỉ định các mục nguồn cấp dữ liệu trả phí Premium trong nguồn cấp RSS /ATOM, bạn cần sử dụng thành <mi:SubscriptionProductType> phần. Ví dụ: <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Slideshows
Trình chiếu phải có Tiêu đề, ID Duy nhất và ngày Phát hành. Ngoài ra, trang chiếu phải chứa nhiều trang chiếu theo thứ tự (hai (2) là số trang chiếu tối thiểu, 200 là số trang chiếu tối đa) trong đó mỗi trang chiếu được tạo thành từ một đối tượng hình ảnh. Phát hiện các mục đã cập nhật tuân theo thuật toán tương tự được sử dụng cho các bài viết.
Trường bắt buộc
| Tên trường | Mô tả |
|---|---|
| ID duy nhất | GUID bền vững (không thay đổi) để xác định duy nhất Trình chiếu. Nó cũng có thể là URL duy nhất đầy đủ của Trình chiếu trên trang web của nhà xuất bản. Giá trị này phải là duy nhất trên tất cả các mục nội dung đến từ cùng một nhà phát hành. |
| Tiêu đề | Tiêu đề mục nội dung phải nhiều hơn 20 ký tự nhưng không được vượt quá 150 ký tự trừ khi tiêu đề ngắn cũng được cung cấp. Tiêu đề vượt quá 150 ký tự mà không có tiêu đề ngắn có thể bị loại bỏ. Không cho phép thẻ HTML. |
| Ngày phát hành | Thời gian xuất bản. Ngày phải là quá khứ và dưới 365 ngày, nếu không nó sẽ không được tiêu hóa. Các định dạng ngày được hỗ trợ là RFC 822 Có và RFC 3339. |
| Trang chiếu | Mỗi Trình chiếu phải có một loạt trang chiếu (hình ảnh). Mỗi trang chiếu trong Trình chiếu được xây dựng từ siêu dữ liệu hình ảnh tương ứng; đáng chú ý nhất:
|
| Nối kết (URL Web) | MỘT URL được sử dụng để định vị duy nhất mục nguồn cấp trên website của nhà phát hành. Liên kết này có thể được sử dụng trong chia sẻ mạng xã hội tùy thuộc vào hợp đồng. |
Trường tùy chọn nhưng được đề xuất
| Tên trường | Mô tả |
|---|---|
| Trừu tượng | Mô tả về Trình chiếu. (Bắt buộc nếu thiếu tiêu đề trang chiếu) Phải ở dạng văn bản thuần. Không hỗ trợ HTML. |
| Ngày cập nhật | Nếu ngày này được cung cấp, nó sẽ được sử dụng để xác định xem nội dung trong mục nguồn cấp dữ liệu này có phải là phiên bản mới hơn của tài liệu được nhập ban đầu với id Không được chỉ định không. Nếu không, "Ngày Phát hành" sẽ được sử dụng cho mục đích này. |
| Ngày hết hạn | Mục nguồn cấp dữ liệu sẽ bị xóa khỏi mục phụ trợ và phụ trợ hub đối tác trên MSN vào ngày được chỉ định. Nếu giá trị này không được cung cấp, mục nội dung sẽ hết hạn sau 365 ngày sau khi nhập. Ngày hết hạn phải lớn hơn 2 giờ trong tương lai. |
| Subtitle | Một tiêu đề giải thích hoặc thay thế được sử dụng để hiển thị dọc theo bên dưới tiêu đề trong Thẻ Khuyến mãi. |
| Tiêu đề ngắn | Giá trị "tiêu đề ngắn", còn được gọi là "Tiêu đề Web" được sử dụng khi hiển thị nội dung trên thiết đặt thu gọn, chẳng hạn như thẻ khuyến mãi. Giá trị trong trường này phải có 54 ký tự trở xuống. |
| Tác giả | Tác giả hoặc người đóng góp của trình chiếu. |
| Các nối kết liên quan | Liên kết liên quan có thể được xác định để hiển thị cùng với nội dung. Ít nhất ba liên kết liên quan phải được cung cấp cho mỗi bài viết. |
| Thể loại | Xác định các thẻ liên quan đến phần nội dung. Sử <category> dụng các yếu tố để thêm thẻ trong cả RSS và ATOM. |
| Từ khóa | Từ khóa ngữ cảnh cho mỗi mục nội dung. Nhiều từ khóa có thể được chỉ định trong một nút duy nhất được phân tách bởi dấu phẩy. Để chỉ định giá trị này trong RSS hoặc ATOM, bạn Không cần sử dụng thành phần Media RSS <media:keywords> . |
| SubscriptionProductType | Bạn có thể truy nhập một số mục nguồn cấp dữ liệu thông qua mô hình đăng ký. Để chỉ định các mục nguồn cấp dữ liệu trả phí Premium trong nguồn cấp RSS /ATOM, bạn cần sử dụng thành <mi:SubscriptionProductType> phần. Ví dụ: <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Video
Video được chỉ định trong nguồn cấp chỉ video phải có ID duy nhất, URL, ngày Phát hành, Tiêuđề, Ghi nhận tác giả và Phụ đề chi tiết (chỉ khi luật pháp ở thị trường đích yêu cầu). Nếu không có ID duy nhất nào được cung cấp hoặc nếu video được nhúng trong một bài viết, THÌ URL đó sẽ được sử dụng làm mã định danh.
Trường bắt buộc
| Tên trường | Mô tả |
|---|---|
| ID duy nhất | GUID bền bỉ (không thay đổi) để nhận dạng độc đáo video. Nó cũng có thể là URL duy nhất đầy đủ của video trên trang web của nhà xuất bản. Giá trị này phải là duy nhất trên tất cả các mục nội dung đến từ cùng một nhà phát hành. |
| Tiêu đề | Tiêu đề video. Thông tin này được dùng làm tiêu đề/tiêu đề trang. |
| Ngày phát hành | Thời gian xuất bản. Ngày phải là quá khứ và dưới 365 ngày, nếu không nó sẽ không được tiêu hóa. |
| Video URL | Vị trí tệp nguồn video. URL phải tuyệt đối và tất cả các hình thức URL tương đối sẽ không nhập được. |
| Nối kết (URL Web) | MỘT URL được sử dụng để định vị duy nhất mục nguồn cấp trên website của nhà phát hành. Liên kết này có thể được sử dụng trong chia sẻ mạng xã hội tùy thuộc vào hợp đồng. |
| Ghi | Thông tin bản quyền cho video. |
| Phụ đề chi tiết | Phụ đề chi tiết được hiển thị trên video cùng với thời lượng của video. Chỉ yêu cầu nếu luật pháp quy định tại thị trường mục tiêu. |
| Thời gian | Chỉ bắt buộc đối với video 3PP. |
| (Các) hình thu nhỏ |
Chỉ bắt buộc đối với video 3PP. Hình thu nhỏ để nối kết đến video. Bạn có thể sử dụng tất cả các thuộc tính hình ảnh ở đây nhưng chỉ cần URL cho hình thu nhỏ. Chúng tôi khuyên bạn nên sử dụng một hình ảnh JPG duy nhất tại:
|
Trường tùy chọn nhưng được đề xuất
| Tên trường | Mô tả |
|---|---|
| Mô tả (Tóm tắt) | Văn bản để hiển thị bên dưới video. |
| Thời gian | Thời lượng video tính bằng giây. (Bắt buộc đối với video 3PP). |
| Ngày cập nhật | Nếu ngày này được cung cấp, nó sẽ được sử dụng để xác định xem nội dung trong mục nguồn cấp dữ liệu này có phải là phiên bản mới hơn của tài liệu được nhập ban đầu với id Không được chỉ định không. Nếu không, "Ngày Phát hành" sẽ được sử dụng cho mục đích này. |
| Ngày hết hạn | Mục nguồn cấp dữ liệu sẽ bị xóa khỏi mục phụ trợ và phụ trợ hub đối tác trên MSN vào ngày được chỉ định. Nếu giá trị này không được cung cấp, mục nội dung sẽ hết hạn sau 365 ngày sau khi nhập. Ngày hết hạn phải lớn hơn 2 giờ trong tương lai. |
| Subtitle | Một tiêu đề giải thích hoặc thay thế được sử dụng để hiển thị dọc theo bên dưới tiêu đề trong Thẻ Khuyến mãi. |
| Tiêu đề ngắn | Giá trị "tiêu đề ngắn", còn được gọi là "Tiêu đề Web" được sử dụng khi hiển thị nội dung trên thiết đặt thu gọn, chẳng hạn như thẻ khuyến mãi. Giá trị trong trường này phải có 54 ký tự trở xuống. |
| Tác giả | Tác giả hoặc người đóng góp của video. |
| (Các) hình thu nhỏ | Hình thu nhỏ để nối kết đến video. Bạn có thể sử dụng tất cả các thuộc tính hình ảnh ở đây nhưng chỉ cần URL cho hình thu nhỏ. Chúng tôi khuyên bạn nên sử dụng một hình ảnh JPG duy nhất tại:
|
| Phụ đề chi tiết | Phụ đề chi tiết được hiển thị trên video cùng với thời lượng của video. Chỉ yêu cầu nếu luật pháp quy định tại thị trường mục tiêu. |
| Các nối kết liên quan | Liên kết liên quan có thể được xác định để hiển thị cùng với nội dung. Ít nhất ba liên kết liên quan phải được cung cấp cho mỗi bài viết. |
| Thể loại | Xác định các thẻ liên quan đến phần nội dung. Sử dụng <category> các thành phần để thêm thẻ trong RSS |
| Từ khóa | Từ khóa ngữ cảnh cho mỗi mục nội dung. Nhiều từ khóa có thể được chỉ định trong một nút duy nhất được phân tách bởi dấu phẩy. Để chỉ định giá trị này trong RSS hoặc ATOM, bạn Không cần sử dụng thành phần Media RSS <media:keywords> . |
| Loại Sản phẩm Đăng ký | Bạn có thể truy nhập một số mục nguồn cấp dữ liệu thông qua mô hình đăng ký. Để chỉ định các mục nguồn cấp dữ liệu trả phí Premium trong nguồn cấp RSS /ATOM, bạn cần sử dụng thành <mi:SubscriptionProductType> phần. Ví dụ: <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Hình ảnh
Hình ảnh kích thước đầy đủ trong bài viết phải có URL hợp lệ. Hình ảnh trong trình chiếu phải có tiêu đề và URL. Hình thu nhỏ dành cho video, liên kết liên quan hoặc hình ảnh kích cỡ đầy đủ chỉ cần URL. Quyền Cung ứng Hình ảnh được yêu cầu để tự động phát hành.
Trường bắt buộc
| Tên trường | Mô tả |
|---|---|
| URL | Vị trí nguồn của hình ảnh. URL phải tuyệt đối và tất cả các biểu mẫu Có của URL tương đối sẽ không nhập được. |
| Tiêu đề | Tiêu đề hình ảnh. Ngoài ra, được sử dụng làm chú thích được hiển thị dọc theo hình ảnh. Chỉ bắt buộc nếu hình ảnh được sử dụng làm trang chiếu trong trình chiếu. |
| Quyền Cung ứng Hình ảnh |
Chỉ bắt buộc để tự động phát hành. Nếu bạn có Quyền Cung ứng cho hình ảnh của bạn: Trường hợp 1: Trường này sẽ được đặt mặc định là True vì hầu hết nhà phát hành có quyền cung ứng cho hình ảnh của họ. Nếu bạn không có Quyền Cung ứng cho hình ảnh, có hai tùy chọn: Trường hợp 2: Không gửi hình ảnh trừ khi bạn có thể cung cấp thông tin cần thiết trong Trường hợp 3. Trường hợp 3: Bạn đã cấp phép hình ảnh từ một trong các nhà cung cấp hình ảnh được liệt kê trong trang Quyền cấp phép và cung ứng hình ảnh:
|
| ID giấy phép hình ảnh | Imageld là ID được sử dụng để nhận dạng một hình ảnh duy nhất. Imagelds được sử dụng bởi các nhà cấp phép hình ảnh chính như Getty, Corbis, và Associated Press để theo dõi việc cung cấp hình ảnh của họ. |
| Tên người cấp phép hình ảnh | Tên của người cấp phép hình ảnh. (Hãy xem trang Quyền cấp phép hình ảnh và cung ứng - nếu hình ảnh không phải là một trong những quyền này, đừng cung cấp hình ảnh đó) |
| Mô tả | Thông tin văn bản về nội dung hình ảnh. Giá trị này phải được cung cấp ở dạng văn bản thuần trừ khi hình ảnh được sử dụng trong trình chiếu; trong trường hợp này, HTML được cho phép. |
| Văn bản thay thế hình ảnh | Văn bản mô tả ngắn thay thế cho hình ảnh. Được dùng để cải thiện khả năng truy nhập và hỗ trợ bộ đọc màn hình, đồng thời cũng có thể hiển thị nếu hình ảnh không tải được. |
| Tiêu điểm ảnh | Tiêu điểm của ảnh. Để được sử dụng khi xén hình ảnh Không để hiển thị trên các thiết bị có kích cỡ khác nhau. |
Các nối kết liên quan
Các liên kết liên quan không phải là kiểu nội dung gốc nhưng có thể đính kèm chúng vào bài viết hoặc trình chiếu. Một nối kết liên quan phải có URL, Tiêu đề và hình ảnh thu nhỏ hợp lệ ở mức tối thiểu.
Trường bắt buộc
| Tên trường | Mô tả |
|---|---|
| URL | URL của liên kết liên quan. |
| Tiêu đề | Tiêu đề để hiển thị dưới dạng văn bản liên kết. |
| Hình thu nhỏ | Bạn phải cung cấp URL hình thu nhỏ trong các nối kết liên quan nếu không chúng sẽ bị bỏ qua |
Trường tùy chọn nhưng được đề xuất
| Tên trường | Mô tả |
|---|---|
| Relation | Hiện tại chúng tôi chỉ hỗ trợ "văn bản/html" dưới dạng loại. |
| Loại phương tiện | Tiêu đề tùy chọn để sử dụng trong URL thiết đặt thu gọn của liên kết liên quan. |
| Tiêu đề ngắn | Theo mặc định, giá trị này sẽ được đặt thành "liên quan". |
Cập nhật các mục đã nhập trước đó
Nội dung cập nhật phải được gắn cờ cho Dịch vụ Nhập của Microsoft thông qua các thay đổi đối với trường Ngày cập nhậthoặc Phát hành ngày. Nội dung cập nhật mà không thay đổi đối với một trong các trường này sẽ bị bỏ qua. Hãy nhớ giữ nguyên ID Duy nhất.
Microsoft Ingestion Services phân tích nguồn cấp và tách nguồn cấp thành các mục, quyết định xem nên phát hành mục mới, cập nhật mục hiện có hay bỏ qua mục đó.
Cập nhật video tại chỗ
Video có thể được phát hành tại chỗ thông qua Media RSS hoặc HTML. URL video là ID duy nhất của nó. Bất kỳ video HTML nào có cùng URL đều sẽ được gắn cờ là video trùng lặp và bị bỏ qua nhưng video sử dụng Media RSS có thể được cập nhật nếu <dcterms:modified> được cập nhật. Nếu trường này không được cập nhật, video sẽ được coi là bản trùng lặp.
Cập nhật trình chiếu
Trình chiếu được phát hành qua Media RSS có thể đặt <dcterms:modified> thành ngày mới để cho biết rằng trình chiếu đã được cập nhật.
Cập nhật hình ảnh
URL nguồn của hình ảnh là ID duy nhất của hình ảnh đó. Hình ảnh có cùng MỘT URL sẽ được gắn cờ là trùng lặp và bị bỏ qua.
Tránh trùng lặp
Các mục nguồn cấp được xác định bằng ID Duy nhất của chúng. Các mục có CÙNG ID Duy nhất được quy tắc là các mục trùng lặp và bị bỏ qua trừ khi chúng đã được gắn cờ là cập nhật thông qua các thay đổi đối với trường Ngày cập nhật hoặc Phát hành ngày. Nguồn cấp tự động cập nhật ID Duy nhất, Ngày cập nhật hoặc Ngày phát hành mỗi khi nguồn cấp được bỏ phiếu sẽ không được nhập vào.
Tránh các khuyết tật
Các lỗi như định dạng thiếu sót, ngày không hợp lệ hoặc nhúng phương tiện chất lượng thấp có thể dẫn đến trải nghiệm người dùng kém và có thể giới hạn tiếp cận nội dung của bạn. Tìm hiểu thêm về những khiếm khuyết cần tránh trên trang Xếp hạng nội dung trong mục Hướng dẫn phát hành.
Định dạng ngày
Để đảm bảo nội dung của chúng tôi có liên quan đến người tiêu dùng, chúng tôi phải đảm bảo rằng các bài viết chúng tôi hiển thị cho họ được cập nhật chính xác. Ngày phải được thể hiện bằng cách sử dụng định dạng ngày RFC 3339 hoặc RFC 822. Bất kỳ văn bản nào trong chuỗi ngày phải bằng tiếng Anh và múi giờ phải được thể hiện bằng UTC chứ không phải bất kỳ múi giờ địa phương nào như Giờ Standard Phương.
RFC3339
2022-12-28T07:20:50.52Z
2022-12-28T14:20:50.52+00:00
2022-12-28T03:20:50.52+00:00
RFC822
Thứ Năm, 02/10/2002 13:00:00 GMT
Thứ Năm, 02/10/2002 15:00:00 +0200