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 dạng video trong giao thức RTB của Google, hãy xem Hướng dẫn về quảng cáo dạng video trong giao thức RTB của Google.
Google hỗ trợ quảng cáo dạng video trong luồng phát, quảng cáo gốc và quảng cáo xen kẽ. Hãy xem hướng dẫn về định dạng quảng cáo Gốc và Xen 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 này và định dạng JSON, trừ phi có quy định khác.
Bạn có thể tìm thấy proto OpenRTB và các tiện ích OpenRTB dành riêng cho Google trong trang Proto và dữ liệu tham chiếu. Để biết thêm thông tin về cách phát triển bên đặt giá thầu, hãy xem phần Xử lý yêu cầu và Tạ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 mẫu quảng cáo của API Đặt giá thầu theo thời gian thực để 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 dạng 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 khoảng không quảng cáo dạng video.
Macro
Bạn có thể chỉ định macro trong đường liên kết URL video hoặc XML VAST được chỉ định trong BidResponse.seatbid.bid.adm
. Ngoài ra, nếu chỉ định một URL video, bạn cũng có thể đặt macro trong tài liệu XML VAST đượ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 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ự dành riêng cho 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 được đặt thành
true
, quảng cáo đồng hành có thể được chọn để hiển thị dưới dạng phần kết thúc (thẻ thông tin) trong khung video sau khi quảng cáo dạng video phát xong. 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. Phần thưởng thông thường có thể là đọc thêm một bài báo miễn phí, nhận thêm một mạng sống trong trò chơi hoặc nhận một phiên nghe nhạc không có quảng cáo được tài trợ. 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ề. Nếu bạn không đặt giá trị này, thì sẽ không có thời lượng tối đa. Khi
BidRequest.imp.video.skip
làtrue
, điều này có thể hoạt động theo cách khác. Hãy xem phần Thời lượng tối đa của video có thể bỏ qua để biết thêm thông tin chi tiết. BidRequest.imp.video.maxseq
-
Số lượng quảng cáo tối đa trong nhóm quảng cáo dạng video. Nếu bạn không đặt giá trị, thì vị trí quảng cáo sẽ không thuộc 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ề. Khi bạn không đặt giá trị, sẽ không có thời lượng tối thiểu.
BidRequest.imp.video.plcmt
-
Mô tả vị trí phát video.
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. Theo mặc định, video trong luồng phát phải được đặt thành "bật âm thanh" khi trình phát bắt đầu hoặc phải có ý định rõ ràng của người dùng về việc xem nội dung video. Mặc dù có thể có nội dung khác xung quanh trình phát, nhưng nội dung video phải là trọng tâm của lượt 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 nội dung đồ hoạ, đồng thời chỉ bắt đầu phát khi video đó vào 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/dán 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, video phải là tiêu điểm chính của trang và chiếm phần lớn khung nhìn, đồng thời không được cuộn ra khỏi khung nhìn. Quảng cáo này có thể xuất hiện ở các vị trí như video trong ứng dụng hoặc trình chiếu. PLCMT_NO_CONTENT_STANDALONE
Quảng cáo dạng video được phát mà không có nội dung video phát trực tuyến. 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 ở chế độ tắt tiếng. 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 với â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
Bắt đầu khi vào khung nhìn với âm thanh tắt theo mặc định. BidRequest.imp.video.skip
- Nếu là
true
, thì điều này cho biết trình phát sẽ cho phép người dùng bỏ qua video hoặc cho phép quảng cáo có thể bỏ qua. Nếu không, giá trị này cho biết rằng bạn không được phép sử dụng quảng cáo có thể bỏ qua. 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 từ đầu video đến thời điểm quảng cáo hiển thị.
Những tín hiệu này không chỉ dành riêng cho mẫu quảng cáo dạng video, mà còn đặc biệt có giá trị đối với bên đặt giá thầu:
BidRequest.device.ifa
- Trường này là một UUID gồm 36 ký tự, chỉ được đặt khi sử dụng SSL và không đượ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, giá trị này chứa Giá trị nhận dạng cho nhà quảng cáo (IDFA) bằng tất cả ký tự viết hoa. Đối với thiết bị Android, mã này chứa mã nhận dạng Android (ADID) bằng tất cả các ký tự viết thường. Đối với thiết bị TV có thể nối mạng, mã 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 không dùng nữa cho HIGHEND_PHONE hoặc TABLET. PERSONAL_COMPUTER
Bao gồm cả 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ụ: biển quảng cáo kỹ thuật số. 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ànhcompletion_rate
,Metric.value
sẽ là một phân số trong khoảng [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.
Các trường chiều rộng và chiều cao trong thông báo AdSlot 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 dạng video.
BidRequest.imp.ext.allowed_vendor_type
- Các nhà cung cấp được phép. Xem tệp 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ề một URL chuyển hướng VAST 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. Dưới đây là nội dung trích dẫn của một phản hồi giá thầu thích hợp cho quảng cáo dạng video:
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 phản hồi giá thầu cho video:
BidResponse.seatbid.bid.ext.attribute
-
Các thuộc tính cho những quảng cáo có thể hiển thị từ đoạn mã này. Hãy xem tệp buyer-declarable-creative-attributes.txt để biết 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 các thuộc tính mà nhà xuất bản không cho phép trong yêu cầu giá thầu.
Ví dụ: việc thiết lập xem có trường nào chứa
30
hay không sẽ cho biết quảng cáo cần có VPAID hỗ trợ để 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 và phản hồi giá thầu
Định dạng Video
- Cách người mua có thể thêm video
- Các tín hiệu được đề xuất của OpenRTB cho tất cả định dạng video
- Các tín hiệu đề xuất trong nguyên mẫu Authorized Buyers cho tất cả định dạng video
- Cách nhà xuất bản có thể cho phép/không cho phép video
- Trường hợp hiếm gặp
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 + JS |
|
|
|
|
|
JS tuỳ chỉnh |
|
||||
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 + JS |
|||||
JS tuỳ chỉnh |
|||||
Gốc + VAST |
Khoá: | Không có định dạng/công nghệ | 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 |
Không dùng được mẫu quảng cáo dạng video cho 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ỉ áp dụng cho các 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 phát (VPAID) |
Đối tượng VIDEO hiện diện & |
|
Trong luồng phát (không có VPAID) |
Đối tượng VIDEO hiện diện & |
|
Ngoài luồng phát |
Đối tượng VIDEO hiện diện vị trí |
|
Trong nguồn cấp dữ liệu |
Đối tượng VIDEO hiện diện & |
|
Trong bài viết |
Đối tượng VIDEO hiện diện & |
|
Mã gốc |
Đối tượng NATIVE hiện diện và |
|
Trong biểu ngữ |
Không có đối tượng video & |
Ứ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 & |
|
Ngoài luồng phát |
Đối tượng VIDEO hiện diện vị trí |
|
Trong nguồn cấp dữ liệu |
Đối tượng VIDEO hiện diện & |
|
Trong bài viết |
Đối tượng VIDEO hiện diện & |
|
Mã gốc |
Đối tượng NATIVE hiện diện và |
|
Quảng cáo xen kẽ (VAST) |
Đối tượng VIDEO hiện diện & |
|
Quảng cáo xen kẽ (không có VAST) |
Đối tượng VIDEO hiện diện & |
Đã lọc |
Trong biểu ngữ (MRAID) |
Không có đối tượng video & |
|
Trong biểu ngữ (không có MRAID) |
Không có đối tượng video & |
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 nhà xuất bản có thể cho phép/không cho phép quảng cáo dạng video trong vị trí của họ.
Tuỳ chọn Pub | Định dạng á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 & |
Chọn sử dụng VPAID |
Trong luồng phát trên web |
Đối tượng video hiện diện & |
Chọn sử dụng IBV |
Trong biểu ngữ Quảng cáo xen kẽ |
|
Chọn sử dụng (hướng dẫn) |
Trong nguồn cấp dữ liệu Trong bài viết |
Đối tượng video hiện diện & |
Chọn sử dụng quảng cáo không trong luồng (hướng dẫn) |
Mã gốc |
Đối tượng gốc hiện diện |
Chặn quảng cáo xen kẽ dạng video |
Quảng cáo xen kẽ trong ứng dụng |
Không có đối tượng VIDEO |
Trường hợp đặc biệt
# | Nội dung mô tả trường hợp | Bình luận | Yêu cầu giá thầu |
---|---|---|---|
1 |
Trì hoãn thao tác đó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 liên quan cho định dạng Trong luồng và Ngoài luồng
Xem OpenRTB 2.5 (bắt đầu từ trang 47)
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
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.
|
||||
videoad_start_delay
|
|
Nguồn giá trị yêu cầu giá thầu
Đối tượng OpenRTB |
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 | điệu bộ | có | ["application/javascript", "video/mp4"]", |
|
thời lượng tối thiểu | không | Nhà xuất bản đã định cấu hình | ||
maxduration | có | Nhà xuất bản đã định cấu hình | ||
playbackmet hod |
có | [6] | Thường là Nhà xuất bản đã được định cấu hình |
|
api (MRAID) | có | [1,2] | ||
giao thức | có | [2,3,5,6,7,8] | ||
tính tuyến tính | có | [1] | ||
vị trí | có | [1] | ||
chiều rộng trình phát | có | 400.400.300 | ||
chiều cao của người chơi | có | 225.300.153 | ||
độ trễ bắt đầu | có | 0 | Google, mặc định là 5 giây | |
bỏ qua | có | 1 | Nhà xuất bản/Google – đối với quảng cáo xen kẽ => Google – đối với quảng cáo trong luồng => Nhà xuất bản quyết định cho phép có thể bỏ qua, không thể bỏ qua hoặc cả hai. Quảng cáo có tặng thưởng, luôn không thể bỏ qua; |
|
tốc độ bit tối thiểu | Không | |||
tốc độ bit tối đa | không | |||
pos | có | 1 | ||
Thiết bị | ||||
Tỷ lệ px | có | 1 | ||
lượt hiển thị | ||||
Bảo mật | có | 1 | Google mặc định là true vì thẻ quảng cáo luôn an toàn |