Các phần tử nguồn cấp dữ liệu MRSS cho Giải pháp video

Bảng sau đây liệt kê tất cả các trường mà Giải pháp video công nhận (trong một số trường hợp là kỳ vọng có) trong nguồn cấp dữ liệu XML của bạn. Chỉ những phần tử này mới được công nhận.

Đến một phần tử cụ thể trong danh sách

---

Phần tử bắt buộc

<atom:link> <item> <dfpvideo:contentId> <dfpvideo:lastModifiedDate> <dfpvideo:version> <title>

Phần tử không bắt buộc và phần tử nên dùng

<dfpvideo:cuepoints> <dfpvideo:keyvalues> <dfpvideo:thirdPartyContentId>

<media:content> <media:status>

<media:thumbnail> <pubDate>

Các phần tử Chèn quảng cáo động

_{Các phần tử này chỉ dùng trong tính năng Chèn quảng cáo động và cần được sử dụng kết hợp với các phần tử ở trên.}

<dfpvideo:ingestUrl> <dfpvideo:lastMediaModifiedDate> <dfpvideo:closedCaptionUrl> <dfpvideo:fw_caid>

---

Xem ví dụ về các phần tử theo bối cảnh trong mẫu nguồn cấp dữ liệu.

Mã nội dung hiện sẽ phân biệt chữ hoa chữ thường. Mã nội dung có cả chữ hoa và chữ thường được xem là tách biệt với mã đó nhưng chỉ có chữ thường. Điều này được phản ánh trong các báo cáo Ad Manager.

Phần tử bắt buộc

Phần tử	Phần tử con của	Yêu cầu
<atom:link>	<channel>	Bắt buộc
Phần mô tả Xác định thông tin phân trang của nguồn cấp dữ liệu. Ad Manager đọc phần tử này để biết hai thuộc tính: rel và href. rel chỉ ra cách URL trong thuộc tính href liên quan đến tập hợp kết quả của nguồn cấp dữ liệu. rel='next': Cho biết rằng URL href trỏ đến trang tiếp theo của tập hợp kết quả của nguồn cấp dữ liệu. Nếu nguồn cấp dữ liệu chứa thẻ <atom:link> có rel='next', thì thuộc tính này cho biết rằng còn có một trang kết quả khác. Nếu không thì trang hiện tại là trang kết quả cuối cùng. href chỉ định một URL xác định tài nguyên trong thẻ <atom:link>. Ví dụ <atom:link rel='next' href='http://www.feedprovider.com/video/account/vids?page3'/ Lưu ý quan trọng: Khi tạo một nguồn nội dung lần đầu, Ad Manager sẽ yêu cầu bộ URL nguồn cấp dữ liệu trả về tập hợp kết quả đầu tiên của nguồn cấp dữ liệu. Bạn nên thiết lập một tập hợp kết quả gồm 100 mục (100 mục trên mỗi trang). Nếu không có phần tử <atom:link> trên trang nguồn cấp dữ liệu, thì Ad Manager sẽ coi trang đó là trang cuối cùng của nguồn cấp dữ liệu.

Phần tử	Phần tử con của	Yêu cầu
<item>	<channel>	Bắt buộc
Phần mô tả Xác định một video trong nguồn cấp dữ liệu. Nguồn cấp dữ liệu video của Ad Manager có thể chứa một hoặc nhiều mục <item>. Mỗi mục trong số đó cần chứa ba phần tử để nhập siêu dữ liệu đúng cách: <dfpvideo:contentId>, <dfpvideo:lastModifiedDate> và <title>

Phần tử	Phần tử con của	Yêu cầu
<dfpvideo:contentId>	<item>	Bắt buộc
Phần mô tả Được lưu trữ dưới dạng mã nội dung CMS trong Ad Manager. Đây là thông số yêu cầu quan trọng, tạo thành một phần của yêu cầu quảng cáo để xác định quảng cáo nào Ad Manager có thể phân phát cho video tương ứng.   Giá trị Content ID phải là một chuỗi và có phân biệt chữ hoa chữ thường. Bạn có thể sử dụng giá trị này cho tham số vid trong một yêu cầu quảng cáo dạng video. Ví dụ <dfpvideo:contentId>sdjfbadfb8w3489y</dfpvideo:contentId>

Phần tử	Phần tử con của	Yêu cầu
<dfpvideo:lastModifiedDate>	<item>	Bắt buộc
Mô tả Chỉ ra thời điểm gần nhất mà một thuộc tính bất kỳ của video hoặc siêu dữ liệu của video được sửa đổi. Để Ad Manager nhập nội dung đã sửa đổi, cần xác định lastModifiedDate và sắp xếp nguồn cấp dữ liệu theo ngày sửa đổi gần đây nhất ở trên cùng. Tất cả dấu thời gian đều phải phù hợp với quy cách RFC 822 hoặc theo định dạng IS0 8601. Nếu chuỗi dấu thời gian không có múi giờ, thì múi giờ sẽ mặc định là Giờ chuẩn Thái Bình Dương (PST). Ví dụ <dfpvideo:lastModifiedDate>2021-01-15T08:00:00+01:00</dfpvideo:lastModifiedDate> <dfpvideo:lastModifiedDate>Fri, 15 Jan 2021 08:00:00 EST </dfpvideo:lastModifiedDate> Xem ví dụ về từng định dạng ngày tháng Ví dụ RFC 822 Fri, 15 Jan 2021 08:00:00 EST Fri, 15 Jan 2021 13:00:00 GMT Fri, 15 Jan 2021 15:00:00 +0200 ISO 8601 2021-01-15T12:00:00Z 2021-01-15T08:00:00+01:00

Phần tử	Phần tử con của	Yêu cầu
<dfpvideo:version>	<channel>	Bắt buộc
Phần mô tả Cho biết phiên bản hiện tại của bản đặc tả MRSS mà nguồn cấp dữ liệu này sử dụng. Bạn phải điền giá trị bằng số nguyên và đặt giá trị một lần cho mỗi nguồn cấp dữ liệu. Hiện tại, giá trị hợp lệ duy nhất cho trường này là 2. Ví dụ <dfpvideo:version>2</dfpvideo:version>

Phần tử	Phần tử con của	Yêu cầu
<title>	<item>	Bắt buộc
Mô tả Tên của mục video. Ví dụ <title>My video</title>

Phần tử không bắt buộc và phần tử nên dùng

Phần tử	Phần tử con của	Yêu cầu
<dfpvideo:cuepoints>	<item>	Khác nhau *
Mô tả * Bắt buộc nếu video có chứa điểm chèn quảng cáo trong video. Xác định các điểm dừng tính bằng giây, phân tách bằng dấu phẩy. Điểm dừng là các thời điểm khi có thể chèn quảng cáo vào trong video. Hệ thống hỗ trợ lên tới 3 chữ số giây thập phân (ví dụ: 55.532 giây). Chữ số khác ngoài 3 chữ số này sẽ bị cắt bớt. Giới hạn số lượng điểm dừng tối đa trong video là 1.000. Sau khi một video đạt đến giới hạn này, chúng tôi sẽ cắt bớt tất cả điểm dừng. Ví dụ <dfpvideo:cuepoints>55.532,109</dfpvideo:cuepoints>

Phần tử	Phần tử con của	Yêu cầu
<dfpvideo:keyvalues>	<item>	Không bắt buộc
Phần mô tả Xác định mọi siêu dữ liệu tùy chỉnh cho video. Siêu dữ liệu có các thuộc tính sau: key, value và type (chỉ áp dụng với loại dữ liệu string ).   Các khóa-giá trị nhập qua nguồn cấp dữ liệu MRSS phải tuân theo các yêu cầu về định dạng giống như các khóa-giá trị đã xác định trong giao diện Ad Manager. Hãy đảm bảo các khoá-giá trị của bạn tuân thủ các yêu cầu về định dạng. Ví dụ <dfpvideo:keyvalues key="episode" value="5" type="string"/> <dfpvideo:keyvalues key="season" value="2" type="string"/> <dfpvideo:keyvalues key="title" value="Example Title" type="string"/> <dfpvideo:keyvalues key="recommended count" value="5" type="string"/> <dfpvideo:keyvalues key="description" value="A lot of text here" type="string"/>

Phần tử	Phần tử con của	Yêu cầu
<dfpvideo:thirdPartyContentId>	<item>	Không bắt buộc
Mô tả Bạn cần bật tính năng này trước khi sử dụng. Để sử dụng, hãy liên hệ với người quản lý tài khoản của bạn. Phần tử này được sử dụng nếu bạn có nguồn cấp dữ liệu MRSS tùy chỉnh có chứa video trên YouTube. Bạn không nên chỉ định hai nội dung MRSS trong mạng của mình cho cùng một video trên YouTube. Chỉ có một thuộc tính bắt buộc cho phần tử này, đó là: Thuộc tính "id": Thuộc tính này phải đề cập đến contentId trong nguồn nội dung của YouTube. Ví dụ <dfpvideo:thirdPartyContentId cms="youtube" id='vNclnVLp_c0'/>

Phần tử	Phần tử con của	Yêu cầu
<media:content>	<item>	Khuyến nghị
Mô tả Phần tử này có các thuộc tính cung cấp thông tin siêu dữ liệu hữu ích, chẳng hạn như URL nguồn và thời lượng. Đây là một phần tử phụ tùy chọn của <item>. Ad Manager có thể đọc các thuộc tính sau của phần tử <media:content>: Thuộc tính "duration": Ad Manager chỉ công nhận một mục thời lượng cho mỗi <item>. Nếu nhiều mục được xác định, thì thời lượng sẽ được chọn trong một mục ngẫu nhiên, có thể khác với dự kiến. Giá trị thời lượng phải tính bằng giây (số tròn, không phải số thập phân). Thuộc tính duration là thuộc tính bắt buộc để phân phối quảng cáo trong video. Thuộc tính "url": URL trực tiếp của nguồn video, chỉ dùng để cho thấy đường liên kết trong phần chi tiết nội dung bên trong giao diện Ad Manager. Ví dụ <media:content url='http://www.feedprovider.com/video?8eqe7e' duration='39'/>

Phần tử	Phần tử con của	Yêu cầu
<media:status>	<media:content> or <item>	Không bắt buộc
Phần mô tả Xác định xem video được đánh dấu là đang hoạt động, không hoạt động hay được lưu trữ trong Ad Manager. Nếu không có phần tử này, thì trạng thái mặc định là hoạt động. Các giá trị có phân biệt chữ hoa chữ thường và có thể bao gồm trạng thái sau đây: hoạt động (được đánh dấu là "Hoạt động" trong Ad Manager) đã xoá (được đánh dấu "Đã lưu trữ" trong Ad Manager; các video mới ở trạng thái "đã xoá" không được nhập) bị chặn (được đánh dấu là "Không hoạt động" trong Ad Manager) Nếu người dùng thay đổi trạng thái cho một video trong Ad Manager, thì mọi thay đổi trạng thái tiếp theo từ nguồn cấp dữ liệu đó sẽ đều bị bỏ qua. Người dùng có thể xoá cơ chế ghi đè bằng cách nhấp vào Sử dụng cài đặt nguồn trong giao diện Ad Manager, sau đó Ad Manager sẽ tiếp tục sử dụng thông tin cập nhật trạng thái từ nguồn cấp dữ liệu đó. Các nhà xuất bản và đối tác CMS có thể ngăn Ad Manager điều chỉnh lại nội dung đã tải lên nhưng không hoạt động/không dùng nữa bằng cách thực hiện một trong những thao tác sau: (Nên dùng) Hỗ trợ <media:status state="deleted"/> trong nguồn cấp dữ liệu MRSS Giữ nội dung trong nguồn cấp dữ liệu, nhưng xoá tất cả phần tử liên quan đến tính năng Chèn quảng cáo động khỏi nội dung đó để hiển thị nội dung không đủ điều kiện truyền dẫn VOD. Chuyển tới mục phần tử Chèn quảng cáo động để biết các phần tử cụ thể cần xoá. Trạng thái phân phát khi phân phát qua tính năng Chèn quảng cáo động Trạng thái phân phát cho tính năng Chèn quảng cáo động được xác định bằng cách tính cả trạng thái của nguồn và chính nội dung. Đây là hành vi bạn có thể dự kiến khi cả hai giá trị được xem xét: Trạng thái nguồn nội dung Trạng thái nội dung           Trạng thái phân phát              Đang hoạt động Đang hoạt động Nội dung phân phát Đang hoạt động Không hoạt động Nội dung phân phát Đang hoạt động Được lưu trữ Nội dung không phân phát (lỗi 404) Không hoạt động Đang hoạt động Nội dung không phân phát (lỗi 404) Không hoạt động Không hoạt động Nội dung không phân phát (lỗi 404) Không hoạt động Được lưu trữ Nội dung không phân phát (lỗi 404) Được lưu trữ Đang hoạt động Nội dung không phân phát (lỗi 404) Được lưu trữ Không hoạt động Nội dung không phân phát (lỗi 404) Được lưu trữ Được lưu trữ Nội dung không phân phát (lỗi 404)   Đang hoạt động: Đủ điều kiện để phân phát quảng cáo. Không hoạt động: Không đủ điều kiện để phân phát quảng cáo.  Đã lưu trữ: Không đủ điều kiện để phân phát quảng cáo nhắm mục tiêu theo nội dung, nhưng vẫn có thể phân phát quảng cáo loạt mạng. Nếu trạng thái nguồn nội dung được đánh dấu là không hoạt động hoặc đã lưu trữ, hoặc trạng thái nội dung được đánh dấu là đã lưu trữ, thì nội dung đó sẽ không phân phát qua tính năng Chèn quảng cáo động. Ví dụ <media:status state="blocked" reason="http://www.reasonforblocking.com"/> <media:status state="deleted"/> <media:status state="active"/> (Ad Manager không nhập thuộc tính reason.)

Phần tử	Phần tử con của	Yêu cầu
<media:thumbnail>	<media:content> or <item>	Khuyến nghị
Phần mô tả Cho phép hình thu nhỏ của video xuất hiện trong giao diện Ad Manager. Ad Manager hiện chỉ cần thuộc tính URL của phần tử này, nhưng bạn có thể cung cấp thêm các thuộc tính khác nếu muốn: chiều cao, chiều rộng và thời gian (khoảng thời gian mà hình ảnh ở dạng hình thu nhỏ xuất hiện trong video). Giao diện Ad Manager không bao giờ hiển thị hình thu nhỏ có chiều rộng hơn 280 pixel và chiều cao hơn 190 pixel. Nếu URL liên kết tới một hình ảnh lớn hơn, thì Ad Manager liên kết đến phiên bản gốc nhưng thu nhỏ hình ảnh theo tỷ lệ với CSS cùng dòng để hiển thị trong giao diện người dùng. Ví dụ <media:thumbnail url='http://www.myfeed.com/account/sdjfbadfb8w3489y/bigtn.jpg' width='280' height='190'/>

Phần tử	Phần tử con của	Yêu cầu
<pubDate>	<item>	Không bắt buộc
Mô tả Xác định ngày xuất bản nội dung. Phần tử này chỉ được dùng cho các quy tắc đối với quảng cáo dạng video. Tất cả dấu thời gian đều phải phù hợp với quy cách RFC 822 hoặc theo định dạng IS0 8601. Nếu chuỗi dấu thời gian không có múi giờ, thì múi giờ sẽ mặc định là Giờ chuẩn Thái Bình Dương (PST). Ví dụ <pubDate>2006-02-19T04:22:39+05:00</pubDate> <pubDate>Sun, 19 Feb 2006 09:22:39 +0000</pubDate> Xem ví dụ về từng định dạng ngày tháng Ví dụ RFC 822 Wed, 31 Oct 2016 08:00:00 EST thứ Tư ngày 31 tháng 10 năm 2016 13:00:00 GMT Wed, 31 Oct 2016 15:00:00 +0200 ISO 8601 20161031 2016-10-31 2016-10-31T08:00:00+01:00

Các phần tử cụ thể cho tính năng Chèn quảng cáo động

Phần tử	Phần tử con của	Yêu cầu
<dfpvideo:ingestUrl>	<item>	Bắt buộc
Mô tả * Bắt buộc đối với tính năng Chèn quảng cáo động. Nút để xác định URL nhập video vào tệp m3u8 chính được dùng để điều chỉnh và tạo danh sách phát. "type" attribute: phải đặt thành application/x-mpegURL cho HLS hoặc application/dash+xml cho DASH. Thuộc tính "preconditioned": cần được đặt thành true hoặc false để cho biết liệu ingestURL cho nội dung này có được điều chỉnh cho quảng cáo trong video hay không. Tức là các phân đoạn của bạn đã được chia nhỏ tại thời điểm chèn quảng cáo. Thuộc tính này mặc định là false nếu không được đặt rõ ràng. Nội dung được coi là "được điều chỉnh" nếu các phân đoạn video trong luồng của bạn được đặt thời gian chính xác cho các điểm dừng để chèn quảng cáo. Nếu vậy, cần có một điểm đánh dấu #EXT-X-PLACEMENT-OPPORTUNITY trong luồng HLS để chỉ báo cho Ad Manager biết rằng nên chèn một quảng cáo xen giữa tại thời điểm này trong nội dung video. Tìm hiểu thêm về nội dung được điều chỉnh và điều chỉnh trước đối với hoạt động chèn quảng cáo trong video. Ví dụ Đối với HLS <dfpvideo:ingestUrl type="application/x-mpegURL" preconditioned="false">https://cdn.example.com/?v=123.m3u8</dfpvideo:ingestUrl> Đối với DASH <dfpvideo:ingestUrl type="application/dash+xml" preconditioned="true"> https://cdn.example.com//playlist.mpd </dfpvideo:ingestUrl> Mỗi đoạn nội dung video có thể có cả HLS và DASH. Bạn nên sử dụng URL nhập an toàn (https).

Phần tử	Phần tử con của	Yêu cầu
<dfpvideo:lastMediaModifiedDate>	<item>	Khuyến nghị
Mô tả Chỉ ra thời điểm gần nhất sửa đổi tệp video được tham chiếu trong <dfpvideo:ingestUrl>. Nếu giá trị này từng được cập nhật trong nguồn cấp dữ liệu, thì bạn cũng cần cập nhật lastModifiedDate cho nội dung. Tất cả dấu thời gian đều phải phù hợp với quy cách RFC 822 hoặc theo định dạng IS0 8601. Nếu chuỗi dấu thời gian không có múi giờ, thì múi giờ sẽ mặc định là Giờ chuẩn Thái Bình Dương (PST). Ví dụ <dfpvideo:lastMediaModifiedDate>2006-02-19T04:22:39+05:00</dfpvideo:lastMediaModifiedDate> <dfpvideo:lastMediaModifiedDate>Sun, 19 Feb 2006 09:22:39 +0000</dfpvideo:lastMediaModifiedDate> Xem ví dụ về từng định dạng ngày tháng Ví dụ RFC 822 Wed, 31 Oct 2016 08:00:00 EST thứ Tư ngày 31 tháng 10 năm 2016 13:00:00 GMT Wed, 31 Oct 2016 15:00:00 +0200 ISO 8601 20161031 2016-10-31 2016-10-31T08:00:00+01:00

Phần tử	Phần tử con của	Yêu cầu
<dfpvideo:closedCaptionUrl>	<item>	Khác nhau *
Mô tả * Chỉ yêu cầu khi bạn đã kích hoạt phụ đề trong giao diện. Nút xác định URL cho tệp phụ đề/phụ đề chi tiết. Tất cả các tệp phụ đề hiện có cần được cung cấp trong nguồn cấp dữ liệu ở dạng nhiều phần tử closedCaptionUrl, một tệp phụ đề cho mỗi ngôn ngữ. Phụ đề tệp kê khai HLS cho video theo yêu cầu Nếu có phần tử nguồn cấp dữ liệu này, thì chỉ phụ đề từ nguồn cấp dữ liệu được nhập và phụ đề được chỉ định trong tệp kê khai HLS sẽ bị bỏ qua. Hệ thống chỉ nhập phụ đề tệp kê khai HLS nếu không có phần tử nguồn cấp dữ liệu phụ đề. Bạn có thể sử dụng các định dạng TTML/DXFP (application/ttaf+xml) và WebVTT (text/vtt). Thuộc tính "language": bắt buộc (không được để trống) và phải đặt theo ngôn ngữ của tệp phụ đề. Thuộc tính này phải tuân thủ RFC5646 và không được chứa chuỗi "$$$$$". Sử dụng thuộc tính này tương tự như thuộc tính xml:lang nêu chi tiết trong XML. Thuộc tính "name": không được chứa chuỗi "$$$$$". Thuộc tính "type": phải được đặt thành loại MIME của tệp phụ đề. Thuộc tính "characteristics": phải được đặt thành một trong các dạng sau (hoặc có thể để trống):** "public.accessibility.transcribes-spoken-dialog" "public.accessibility.describes-music-and-sound" "public.easy-to-read" ** Hệ thống sẽ hiển thị cảnh báo nếu thuộc tính "characteristics" không được đặt theo các dạng trên, nhưng vẫn có tác dụng. Đối với nguồn nội dung đơn lẻ, tổ hợp language và name phải là duy nhất đối với mỗi tệp phụ đề. Ví dụ: [language="en", name="English"] and [language="en", name="English (CC)"]. Ví dụ <dfpvideo:closedCaptionUrl language="en" name="English" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl> <dfpvideo:closedCaptionUrl language="en" name="English (CC)" characteristics="public.accessibility.describes-music-and-sound" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl

Phần tử	Phần tử con của	Yêu cầu
<dfpvideo:fw_caid>	<item>	Khác nhau *
Mô tả * Chỉ yêu cầu đối với người dùng Freewheel. Nút xác định mã thành phần chỉnh Freewheel được sử dụng cho việc nhắm mục tiêu quảng cáo. Ví dụ <dfpvideo:fw_caid>621160003648<dfpvideo:fw-caid>

Đối với mọi vấn đề liên quan đến việc khắc phục sự cố hoặc gián đoạn dịch vụ DAI (chèn quảng cáo động), hãy liên hệ với bộ phận hỗ trợ của nhà xuất bản.