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ố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 đó 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ầ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 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ànhcompletion_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 tín hiệu đề 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 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 & |
|
Trong luồng (không có VPAID) |
Có đối tượng VIDEO & |
|
Ngoài luồng phát |
Đối tượng VIDEO hiện diện
|
|
Trong nguồn cấp dữ liệu |
Có đối tượng VIDEO & |
|
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ữ |
Đối tượng video không xuất hiện & |
Ứ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
|
|
Trong nguồn cấp dữ liệu |
Có đối tượng VIDEO & |
|
Trong bài viết |
Đối tượng VIDEO hiện diện & |
|
Mã gốc |
Có đối tượng NATIVE & |
|
Quảng cáo xen kẽ (VAST) |
Có đối tượng VIDEO & |
|
Quảng cáo xen kẽ (không có VAST) |
Có đối tượng VIDEO & |
Đã lọc |
Trong biểu ngữ (MRAID) |
Đối tượng video không xuất hiện & |
|
Trong biểu ngữ (không có MRAID) |
Đối tượng video không xuất hiện & |
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 & |
Chọn sử dụng VPAID |
Web trong luồng |
Đối tượng video hiện diện & |
Chọn tham gia IBV |
Trong biểu ngữ Quảng cáo xen kẽ |
|
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 & |
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
|
|
||||
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
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 | có | ["application/javascript", "video/mp4"]", |
|
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 | có | Do nhà xuất bản định cấu hình | ||
playbackmet hod |
có | [6] | Thường là Nhà xuất bản Đã định cấu hình |
|
api (MRAID) | có | [1;2] | ||
giao thức | có | [2,3,5,6,7,8] | ||
độ tuyến tính | có | [1] | ||
vị trí | có | [1] | ||
chiều rộng của 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ẽ => 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 | |||
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 | của Google mặc định là true vì thẻ quảng cáo luôn là bảo mật |