Quảng cáo dạng video

Hướng dẫn này trình bày các yêu cầu tích hợp, cấu hình và các trường giao thức OpenRTB có liên quan mà bạn có thể sử dụng khi đặt giá thầu trên khoảng không quảng cáo dạng video. Giao thức RTB của Google không còn được dùng nữa và sẽ không được đề cập trong hướng dẫn này. Để biết thông tin về quảng cáo video trong giao thức RTB của Google, hãy xem hướng dẫn Quảng cáo video trong Google RTB.

Google hỗ trợ quảng cáo video trong luồng, quảng cáo gốc và quảng cáo xen kẽ dạng video. Hãy xem hướng dẫn về định dạng quảng cáo GốcXen kẽ để biết thêm thông tin chi tiết về các định dạng đó.

Yêu cầu đối với người mua

Giao thức RTB

Hướng dẫn này thường đề cập đến định dạng Protobuf, nhưng tên trường và đường dẫn tương đương giữa định dạng đó và định dạng JSON trừ phi có quy định khác.

Bạn có thể tìm thấy proto OpenRTB và phần mở rộng OpenRTB của riêng Google trong Trang Giao diện và dữ liệu tham chiếu. Để thêm thông tin về cách phát triển bên đặt giá thầu, hãy xem Xử lý yêu cầuTạo Phản hồi.

Xem xét mẫu quảng cáo

Bạn nên gửi mẫu quảng cáo để được phê duyệt trước khi đặt giá thầu bằng mẫu quảng cáo đó. Bạn có thể sử dụng Tài nguyên về mẫu quảng cáo để bắt đầu quy trình xem xét.

Cấu hình nhắm mục tiêu trước

Để nhận khoảng không quảng cáo trong video, tài khoản Authorized Buyers của bạn phải tạo một cấu hình nhắm mục tiêu trước bao gồm cả khoảng không quảng cáo trong video.

Macro

Bạn có thể chỉ định macro trong liên kết URL video hoặc VAST XML được chỉ định trong BidResponse.seatbid.bid.adm. Ngoài ra, nếu bạn chỉ định một video URL, bạn cũng có thể đặt macro trong tài liệu VAST XML được liên kết. Các macro sau đây được hỗ trợ cho mẫu quảng cáo dạng video:

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

Các macro nhấp chuột như CLICK_URL_ESC không được hỗ trợ vì Authorized Buyers đưa trình theo dõi lượt nhấp vào một trình bao bọc VAST. Để biết thêm thông tin về các macro được hỗ trợ, hãy xem phần Chỉ định macro.

Chi tiết chú thích

Bạn có thể sử dụng trường BidRequest.imp.video của OpenRTB để xác định xem yêu cầu giá thầu sắp tới là dành cho khoảng không quảng cáo trong luồng hay quảng cáo xen kẽ trong video, đồng thời tìm thêm thông tin cụ thể về video liên quan đến yêu cầu đó. Ngoài ra, đối với khoảng không quảng cáo gốc, bạn có thể sử dụng BidRequest.imp.native.{request/request_native}.assets.video cho thông tin tương tự về video.

BidRequest.{app/site}.content.producer.domain

URL (đã xoá các tham số) của trang mô tả nội dung video. Nhà xuất bản gửi URL này cho Google. Ví dụ:

http://www.publisher.com/watchpagelink
banner.vcm
Nếu đặt thành true, thì quảng cáo đồng hành có thể được chọn để hiển thị dưới dạng hình tĩnh (thẻ thông tin) trong vùng video sau khi quảng cáo video kết thúc đang phát. Nếu không, quảng cáo đồng hành sẽ không được hiển thị dưới dạng phần kết thúc.
BidRequest.imp.rwdd
Nếu được đặt thành true, thì giá trị này cho biết người dùng nhận được phần thưởng khi xem quảng cáo dạng video. Thường thì bạn có thể đọc bài viết bổ sung miễn phí, nhận thêm mạng trong trò chơi hoặc nhận buổi nghe nhạc được tài trợ, không có quảng cáo.
BidRequest.imp.video.maxduration

Thời lượng tối đa được phép (tính bằng giây) của quảng cáo mà bạn nên trả về. Khi bạn không đặt chính sách này, sẽ không có khoảng thời gian tối đa. Thời gian BidRequest.imp.video.skip mới là true, nội dung này có thể sẽ hành động theo cách khác. Xem Thời lượng video có thể bỏ qua tối đa để biết thêm chi tiết.

BidRequest.imp.video.maxseq

Số lượng quảng cáo tối đa trong nhóm video. Nếu không được đặt, vùng quảng cáo sẽ không của một nhóm video.

Số lượng quảng cáo dạng video hiển thị thực tế có thể nhỏ hơn hoặc bằng giá trị này nhưng không được vượt quá giá trị này.

BidRequest.imp.video.minduration
Thời lượng tối thiểu (tính bằng giây) của quảng cáo mà bạn nên trả về. Thời gian chưa đặt, sẽ không có khoảng thời gian tối thiểu.
BidRequest.imp.video.plcmt
Mô tả vị trí video sẽ phát.
PLCMT_UNKNOWN Vị trí không xác định hoặc không xác định được.
PLCMT_INSTREAM Quảng cáo trước video, trong video và sau video được phát trước, trong hoặc sau nội dung video phát trực tuyến mà người tiêu dùng yêu cầu. Video trong luồng phát phải được đặt thành "sound on" (Bật âm thanh) theo mặc định tại trình phát khởi động hoặc có ý định rõ ràng của người dùng là xem nội dung video. Mặc dù có thể còn những nội dung khác xung quanh trình phát thì nội dung video phải là trọng tâm truy cập của người dùng. Video này phải vẫn là nội dung chính trên trang và là trình phát video duy nhất trong khung hiển thị có thể phát âm thanh khi phát. Nếu trình phát chuyển đổi sang nổi/bám, thì các lệnh gọi quảng cáo tiếp theo phải truyền tải chính xác kích thước trình phát đã cập nhật.
PLCMT_ACCOMPANYING_CONTENT Quảng cáo trước video, giữa video và sau video được phát trước, trong hoặc sau khi phát trực tuyến nội dung video. Trình phát video tải và phát trước, giữa hoặc sau các đoạn văn bản hoặc hình ảnh nội dung và chỉ bắt đầu phát khi nội dung đó xuất hiện trong khung nhìn. Nội dung đi kèm chỉ nên bắt đầu phát khi người dùng truy cập vào khung nhìn. Trình phát này có thể chuyển đổi thành trình phát nổi/cố định khi cuộn ra khỏi trang.
PLCMT_INTERSTITIAL Quảng cáo dạng video được phát mà không có nội dung video. Trong khi phát, nội dung đó phải là trọng tâm chính của trang và chiếm phần lớn của khung nhìn và không thể cuộn ra khỏi chế độ xem. Thông tin này có thể nằm trong như video trong ứng dụng hoặc bản trình chiếu.
PLCMT_NO_CONTENT_STANDALONE Quảng cáo dạng video được phát mà không phát trực tuyến nội dung video. Quảng cáo này có thể xuất hiện ở các vị trí như trình chiếu, nguồn cấp dữ liệu gốc, trong nội dung hoặc quảng cáo cố định/nổi.
BidRequest.imp.video.playbackmethod
Mô tả cách phát quảng cáo dạng video. Phương thức phát được xác định là tự động phát hoặc nhấp để phát dựa trên phương pháp đo lường tốt nhất hiện có.
AUTO_PLAY_SOUND_ON Bắt đầu khi tải trang với âm thanh bật.
AUTO_PLAY_SOUND_OFF Bắt đầu khi tải trang khi tắt âm thanh.
CLICK_TO_PLAY Bắt đầu khi nhấp vào khi âm thanh đang bật.
MOUSE_OVER Bắt đầu khi di chuột qua có âm thanh bật.
ENTER_SOUND_ON Bắt đầu khi người dùng truy cập vào khung nhìn có bật âm thanh.
ENTER_SOUND_OFF Theo mặc định, hệ thống sẽ bắt đầu khi bạn vào khung nhìn và tắt âm thanh.
BidRequest.imp.video.skip
Nếu là true, thì điều này cho biết trình phát sẽ cho phép video bị bỏ qua hoặc quảng cáo có thể bỏ qua được phép. Nếu không, cột đó cho biết quảng cáo có thể bỏ qua là không được phép.
BidRequest.imp.video.startdelay

Giá trị 0 có nghĩa là quảng cáo trước video, -1 có nghĩa là quảng cáo trong video và -2 có nghĩa là quảng cáo sau video.

Mọi giá trị dương khác là thời gian tính bằng giây kể từ thời điểm bắt đầu video cho đến thời điểm quảng cáo hiển thị.

Những tín hiệu này không phải là duy nhất của mẫu quảng cáo dạng video, nhưng đặc biệt có giá trị cho các bên đặt giá thầu khi đọc:

BidRequest.device.ifa
Trường này là một mã nhận dạng duy nhất (UUID) gồm 36 ký tự, chỉ được đặt khi sử dụng SSL và chưa được băm. Đây là phiên bản chưa mã hoá của BidRequest.device.dpidm5. Đối với thiết bị iOS, tệp này chứa Mã nhận dạng cho nhà quảng cáo (IDFA) bằng tất cả các ký tự viết hoa. Đối với Android thiết bị, thì tệp này chứa giá trị nhận dạng Android (ADID) bằng tất cả chữ thường ký tự. Đối với các thiết bị TV có thể nối mạng, thiết bị này chứa giá trị nhận dạng duy nhất của thiết bị. (ví dụ: RIDA của Roku).
BidRequest.device.devicetype
Chỉ định loại thiết bị.
MOBILE Bí danh đã lỗi thời cho HIGHEND_PHONE hoặc TABLET.
PERSONAL_COMPUTER Bao gồm cả thiết bị máy tính để bàn và máy tính xách tay.
CONNECTED_TV bao gồm cả TV có thể nối mạng (tức là TV thông minh) và thiết bị có thể nối mạng (chẳng hạn như Roku, Apple TV, v.v.).
HIGHEND_PHONE Bao gồm cả các thiết bị điện thoại cao cấp.
TABLET Bao gồm cả thiết bị máy tính bảng.
CONNECTED_DEVICE Bao gồm cả thiết bị chơi trò chơi chuyên dụng.
SET_TOP_BOX Bao gồm cả các thiết bị hộp giải mã tín hiệu số.
OOH_DEVICE Bao gồm các thiết bị quảng cáo ngoài trời; ví dụ: kỹ thuật số biển quảng cáo.
BidRequest.device.make
Chỉ định thương hiệu (chẳng hạn như Nokia hoặc Samsung) của thiết bị.
BidRequest.device.model
Chỉ định chính xác mẫu thiết bị (chẳng hạn như N70 hoặc Galaxy) nếu có, nếu không thì chứa một mẫu chung chung như "iphone" hoặc "ipad".
BidRequest.imp.metric
Khi Metric.type được đặt thành completion_rate, Metric.value sẽ là một phân số trong phạm vi [0,0, 1,0] thể hiện tỷ lệ hoàn thành trước đây của quảng cáo dạng video được phân phát trong vùng quảng cáo. Giá trị mặc định là -1.0 cho biết không có dữ liệu về tỷ lệ hoàn thành trong quá khứ.
BidRequest.imp.video.poddur
Thời lượng tính bằng giây của toàn bộ khoảng chèn quảng cáo, bao gồm cả tất cả các vị trí mà nhóm quảng cáo bao gồm. Giá trị này được đặt thành giá trị được chỉ định trong siêu dữ liệu video do nhà xuất bản video cung cấp.

Yêu cầu giá thầu cho video cũng chứa thông tin về khoảng không quảng cáo, chẳng hạn như ngành dọc, nhà cung cấp được phép và thông tin về kênh. Tất cả các trường hiện có khác trong yêu cầu giá thầu cũng áp dụng cho video.

Trường chiều rộng và chiều cao trong thông báo Vùng quảng cáo của yêu cầu video tương ứng với kích thước của trình phát quảng cáo video.

BidRequest.imp.ext.allowed_vendor_type
Các nhà cung cấp được phép. Xem vendors.txt trong tài liệu kỹ thuật để biết danh sách mã nhận dạng. Ví dụ: 309 = Đơn vị video DFA.
BidRequest.imp.video.mimes
Danh sách cho phép mô tả các loại MIME nội dung được hỗ trợ cho quảng cáo được phân phát để phản hồi yêu cầu giá thầu; ví dụ: "video/mp4". Phản hồi giá thầu phải cho biết khả năng hỗ trợ ít nhất một trong số các tính năng đó.
BidRequest.imp.video.protocols
Mô tả các phiên bản VAST được hỗ trợ của nhà xuất bản cho yêu cầu quảng cáo dạng video. Chứa một mảng các giá trị enum Protocol, bao gồm: VAST_2_0, VAST_3_0, VAST_2_0_WRAPPER, VAST_3_0_WRAPPER, VAST_4_0, VAST_4_0_WRAPPER, v.v.
BidRequest.imp.video.companionad
Trường này bao gồm một mảng các đối tượng Banner đại diện cho quảng cáo đồng hành (nếu có).
BidRequest.site.page

URL của trang xem video hoặc URL của trang đó mà video được nhúng vào. Ví dụ:

http://www.publisher.com/watchpagelink

Khi phản hồi yêu cầu video, bên đặt giá thầu phải trả về lệnh chuyển hướng VAST URL hoặc VAST XML trong trường BidResponse.seatbid.bid.adm. Phản hồi giá thầu cũng phải chứa nội dung khai báo thích hợp cho quảng cáo dạng video. Chiến lược phát hành đĩa đơn sau đây là phần trích dẫn phản hồi giá thầu video thích hợp:

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Sau đây là các trường quan trọng trong giá thầu phản hồi giá thầu video:

BidResponse.seatbid.bid.ext.attribute
Thuộc tính cho các quảng cáo có thể hiển thị từ đoạn mã này. Xem buyer-declarable-creative-attributes.txt cho danh sách mã nhận dạng. Chúng tôi kiểm tra để đảm bảo rằng không có thuộc tính nào trong số này khớp với những từ khóa mà nhà xuất bản không cho phép trong yêu cầu giá thầu. Ví dụ: cài đặt nếu một trong hai trường bao gồm 30, điều đó sẽ cho biết quảng cáo yêu cầu hỗ trợ VPAID để hiển thị.
BidResponse.seatbid.bid.adm

Đối với quảng cáo dạng video, đây là URL chuyển hướng VAST của quảng cáo dạng video. Ví dụ:

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

Ngoài ra, đây có thể là XML VAST thô.

Ví dụ về yêu cầu giá thầu và phản hồi

Định dạng Video

Cách người mua có thể thêm video

Các bảng sau đây minh hoạ cách người mua có thể đưa video vào mẫu quảng cáo và vị trí mà họ có thể phân phát cho web và ứng dụng di động tương ứng.

Web

Tệp sáng tạo dạng video Trong luồng (tất cả) Trong nguồn cấp dữ liệu/bài viết Quảng cáo gốc trong nguồn cấp dữ liệu/bài viết Quảng cáo xen kẽ Trong biểu ngữ

VPAID + VAST

 

VAST

 

MRAID và JS

 

 

 

 

 

JS tuỳ chỉnh

 

Quảng cáo gốc + VAST

 

Ứng dụng dành cho thiết bị di động

Tệp sáng tạo dạng video Trong luồng (tất cả) Trong nguồn cấp dữ liệu/bài viết Quảng cáo gốc trong nguồn cấp dữ liệu/bài viết Quảng cáo xen kẽ Trong biểu ngữ

VPAID + VAST

 

 

 

 

 

VAST

MRAID và JS

JS tuỳ chỉnh

Quảng cáo gốc + VAST

Khoá: Định dạng/công nghệ không có sẵn

Tệp sáng tạo dạng video được chấp nhận ở vị trí này, tuân theo các lệnh chặn của nhà xuất bản

Mẫu quảng cáo dạng video không có sẵn ở vị trí này

Tín hiệu được đề xuất trong OpenRTB

Các bảng sau đây minh hoạ các tín hiệu được đề xuất của OpenRTB cho tất cả định dạng video trên web dành cho máy tính và thiết bị di động cũng như ứng dụng di động.

Web trên máy tính để bàn và thiết bị di động

Định dạng video Tín hiệu được đề xuất (chỉ tín hiệu liên quan đến video) Tín hiệu có liên quan (chỉ áp dụng cho các tín hiệu có liên quan đến video)

Trong luồng (VPAID)

Có đối tượng VIDEO   &
video.placement = INSTREAM   &


Trong luồng (không có VPAID)

Có đối tượng VIDEO   &
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0


Ngoài luồng phát

Đối tượng VIDEO hiện diện


video.linearity: linear vị trí phụ thuộc vào
thực tế vị trí, các giá trị như sau
Video.startdelay = 0


Trong nguồn cấp dữ liệu

Có đối tượng VIDEO   &
video.placement = IN-FEED


Trong bài viết

Đối tượng VIDEO hiện diện   &
video.placement = IN-ARTICLE


Mã gốc

Đối tượng NATIVE hiện diện và


Trong biểu ngữ

Đối tượng video không xuất hiện &
banner.battr ≠ 6 video trong biểu ngữ (Tự động phát) và
banner.battr ≠ 7 Video trong biểu ngữ (Người dùng bắt đầu)


Ứng dụng dành cho thiết bị di động

Định dạng video Thông tin chi tiết về yêu cầu giá thầu (chỉ những thông tin liên quan đến video)

Quảng cáo trong luồng

Đối tượng VIDEO hiện diện   &
video.placement = INSTREAM    &

video.api = 1 VPAID 1.0 hoặc 2: VPAID 2.0

Ngoài luồng phát

Đối tượng VIDEO hiện diện


video.linearity: linear vị trí phụ thuộc vào
thực tế vị trí, các giá trị như sau
Video.startdelay = 0


Trong nguồn cấp dữ liệu

Có đối tượng VIDEO   &
video.placement = IN-FEED


Trong bài viết

Đối tượng VIDEO hiện diện   &
video.placement = IN-ARTICLE


Mã gốc

Có đối tượng NATIVE &


Quảng cáo xen kẽ (VAST)

Có đối tượng VIDEO   &
video.placement = INTERSTITIAL


Quảng cáo xen kẽ (không có VAST)

Có đối tượng VIDEO   &
video.placement = INTERSTITIAL

Đã lọc

Trong biểu ngữ (MRAID)

Đối tượng video không xuất hiện &
banner.battr ≠ 6 video trong biểu ngữ (Tự động phát) và
banner.battr ≠ 7 Video trong biểu ngữ (Do người dùng bắt đầu)


Trong biểu ngữ

(không có MRAID)

Đối tượng video không xuất hiện &
banner.battr ≠ 6 video trong biểu ngữ (Tự động phát) và
banner.battr ≠ 7 Video trong biểu ngữ (Do người dùng bắt đầu)


Cách nhà xuất bản có thể cho phép/không cho phép video

Bảng sau đây minh hoạ các cách mà nhà xuất bản có thể cho phép/không cho phép video trên vị trí đặt quảng cáo.

Tuỳ chọn Pub Định dạng có thể áp dụng Được mô tả trong yêu cầu giá thầu là

Chỉ định đơn vị Video trong luồng

Trong luồng (tất cả)

Đối tượng video hiện diện &
video.placement = INSTREAM

Chọn sử dụng VPAID

Web trong luồng

Đối tượng video hiện diện &
video.api = 1 (VPAID 1.0) hoặc 2 (VPAID 2.0)

Chọn tham gia IBV

Trong biểu ngữ

Quảng cáo xen kẽ

banner.battr ≠ 6 Video trong biểu ngữ (Tự động phát) &/hoặc 7 Video trong biểu ngữ (Do người dùng khởi tạo)

Chọn nhận (hướng dẫn)

Trong nguồn cấp dữ liệu

Trong bài viết

Có đối tượng video &
video.placement = IN-FEED hoặc IN-ARTICLE

Chọn sử dụng định dạng ngoài luồng phát (hướng dẫn)

Mã gốc

Có đối tượng gốc

Chặn quảng cáo xen kẽ video

Quảng cáo xen kẽ trong ứng dụng

Không có đối tượng VIDEO

Vỏ máy cạnh

# Mô tả trường hợp Bình luận Yêu cầu giá thầu

1

Chậm đóng tuỳ chỉnh bằng MRAID

Đối với quảng cáo xen kẽ, việc đóng quảng cáo có thể gửi thông báo cho Người mua bằng MRAID, ngay cả khi họ không sử dụng tính năng đóng tuỳ chỉnh.


X được áp dụng trong Authorized Buyers sẽ luôn xuất hiện ở đầu mọi nút đóng tuỳ chỉnh, ngay cả khi nút đóng tuỳ chỉnh xuất hiện bên dưới sau 5 giây


Bảng thuật ngữ

Xem Bảng thuật ngữ về video trên Authorized Buyers.

Các trường có liên quan cho định dạng Trong luồng và Ngoài luồng phát

Xem OpenRTB 2.5 (bắt đầu từ trang 47)

BidRequest.Video.
Placement
Quảng cáo trong luồng mWeb

1: Trong luồng phát
2: Trong biểu ngữ

mApp

1: Trong luồng phát
2: Trong biểu ngữ

Ngoài luồng phát mApp Interstitial

5: Quảng cáo xen kẽ

Native

3: Trong bài viết
4: Trong nguồn cấp dữ liệu

Rewarded

is_rewarded_inventory: Loại bool của tiện ích OpenRTB

linearity

Cho biết liệu lượt hiển thị phải là tuyến tính, phi tuyến tính, v.v. Nếu bạn không chỉ định giá trị nào, hãy giả định rằng tất cả đều được phép.

Quảng cáo trong luồng mWeb

1: LINEAR (Trong luồng phát)

mApp

1: LINEAR (Trong luồng phát)

Ngoài luồng phát mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE

videoad_start_delay
Quảng cáo trong luồng mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Ngoài luồng phát Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Nguồn giá trị yêu cầu giá thầu

OpenRTB
Đối tượng
Trường Authorized Buyers
/Exchange
Đặt giá thầu
Không phải trong luồng
Giá trị mẫu Ai xác định điều đó?
/Giá trị này bắt nguồn từ
ở đâu?
Đối tượng
Video kịch câm ["application/javascript",
"video/mp4"]",
Google
thời lượng tối thiểu không Nhà xuất bản đã được định cấu hình
thời lượng tối đa Do nhà xuất bản định cấu hình
playbackmet
hod
[6] Thường là Nhà xuất bản
Đã định cấu hình
api (MRAID) [1;2] Google
giao thức [2,3,5,6,7,8] Google
độ tuyến tính [1] Google
vị trí [1] Google
chiều rộng của trình phát 400.400.300 Google
chiều cao của người chơi 225.300.153 Google
độ trễ bắt đầu 0 Google, mặc định là 5 giây
bỏ qua 1 Nhà xuất bản/Google
- đối với Quảng cáo xen kẽ =>
của Google - cho Instream => Nhà xuất bản
quyết định có cho phép
không có thể bỏ qua, không thể bỏ qua hay cả hai.
Quảng cáo có tặng thưởng, luôn không bỏ qua;
tốc độ bit tối thiểu Không Google
tốc độ bit tối đa không Google
pos 1 Google
Thiết bị
Tỷ lệ Px 1 Google
lượt hiển thị
Bảo mật 1
của Google mặc định là true
vì thẻ quảng cáo luôn là
bảo mật