Trang này được dịch bởi Cloud Translation API.

Quy cách OpenRTB của DV360

Hãy tham khảo Quy cách OpenRTB 2.6 khi xem trang này.

Display & Video 360 không hỗ trợ mọi trường trong quy cách OpenRTB và có thể áp dụng các sắc thái. Các phần trong tài liệu này chứa thông tin và đề xuất dành riêng cho việc triển khai Display & Video 360. Bạn cũng nên tuân theo các nguyên tắc được trình bày trong quy cách OpenRTB, trừ phi có hướng dẫn khác.

Một số trường không được hỗ trợ nhưng vẫn được phân tích cú pháp. Bạn phải định dạng chính xác các trường này nhưng chúng sẽ không ảnh hưởng đến kết quả đặt giá thầu.

Quy cách yêu cầu giá thầu

Yêu cầu giá thầu là một yêu cầu HTTP Post có nội dung là một đối tượng yêu cầu giá thầu. Định dạng của phần nội dung được xác định trong tiêu đề Content-Type.

Phản hồi tương ứng là HTTP 204 không có nội dung cho yêu cầu không có giá thầu hoặc HTTP 200 có nội dung là một phản hồi giá thầu.

Nếu yêu cầu giá thầu không đúng định dạng, thì một HTTP 200 có nội dung là một phản hồi giá thầu có trường nbr được điền sẵn có thể được trả về.

Định dạng phản hồi được kiểm soát bằng tiêu đề Accept.

Định dạng JSON

Định dạng mặc định được dùng khi bạn không cung cấp loại MIME được chấp nhận.

Các yêu cầu và phản hồi JSON tuân theo Quy cách OpenRTB 2.6 của IAB. Tài liệu sau đây mô tả các tiện ích và khả năng hỗ trợ trường.

Tiêu đề Content-Type: application/json cho biết yêu cầu đặt giá thầu JSON, Accept: application/json cho biết các phản hồi đặt giá thầu phải ở định dạng JSON.

Định dạng Protobuf

LƯU Ý: Tính năng hỗ trợ Protobuf đang ở giai đoạn thử nghiệm beta, vui lòng liên hệ với DV360 nếu bạn quan tâm.

Các yêu cầu và phản hồi JSON tuân theo Quy cách Protobuf OpenRTB 2.6 của IAB.

Các tiện ích được hỗ trợ có giới hạn, hãy liên hệ với DV360 nếu bạn quan tâm.

Gửi tiêu đề Content-Type: application/x-protobuf để cho biết yêu cầu giá thầu Protobuf và đặt Accept: application/x-protobuf để nhận phản hồi giá thầu Protobuf.

Đối tượng yêu cầu giá thầu

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Bắt buộc. Mã nhận dạng duy nhất của yêu cầu đặt giá thầu. Bạn có thể dùng thông tin này để xác định từng yêu cầu riêng lẻ trong một khoảng thời gian rất ngắn sau khi các yêu cầu đó được phân phát.
`imp`	Mảng Imp	Bạn phải có ít nhất 1 đối tượng `imp`. Đối với các nhóm âm thanh, hệ thống hỗ trợ nhiều đối tượng `imp`. Đối với các trường hợp sử dụng khác (ví dụ: nhiều vùng quảng cáo độc lập trên trang), hệ thống sẽ dùng đối tượng `imp` đầu tiên và loại bỏ các đối tượng còn lại.
`site`	Trang web	Bắt buộc đối với các yêu cầu về trang web. `site` và `app` loại trừ lẫn nhau.
`app`	Ứng dụng	Bắt buộc đối với các yêu cầu về ứng dụng. `app` và `site` loại trừ lẫn nhau.
`device`	Thiết bị	Bắt buộc.
`user`	Người dùng	Bắt buộc.
`test`	Số nguyên	Không được hỗ trợ.
`at`	Số nguyên	`1`: Phiên đấu giá theo giá đầu tiên, trong đó nhà quảng cáo bị tính phí theo số tiền giá thầu của họ. `2` (mặc định): Phiên đấu giá theo giá thứ hai, trong đó nhà quảng cáo chỉ phải trả phí cao hơn một chút so với người đặt giá thầu cao thứ hai. `3`: Giá sàn nằm trong yêu cầu và không liên quan gì đến giá thầu cạnh tranh.
`tmax`	Số nguyên	Không bắt buộc, mặc định là tuỳ chỉnh theo từng chế độ tích hợp.
`wseat`	Mảng chuỗi	Danh sách các vị trí được phép của người mua. Được đề xuất, trừ phi tất cả nhà quảng cáo đều được phép đặt giá thầu. Nếu bạn không đặt, tức là không có quy tắc hạn chế nào.
`bseat`	Mảng chuỗi	Danh sách các vị trí của người mua mà giá thầu cần bị chặn. Người mua trong danh sách sẽ bị chặn đặt giá thầu cho các giao dịch và phiên đấu giá mở.
`allimps`	Số nguyên	Không được hỗ trợ.
`cur`	Mảng chuỗi	Không bắt buộc nhưng bạn nên thực hiện. Mặc định là theo từng chế độ tích hợp. Đơn vị tiền tệ trong yêu cầu giá thầu phải khớp với một trong các đơn vị tiền tệ đã đăng ký trong quá trình tích hợp. Bạn nên hỗ trợ một đơn vị tiền tệ cho mỗi sàn giao dịch.
`wlang`	Mảng chuỗi	Không được hỗ trợ.
`bcat`	Mảng chuỗi	Các danh mục nhà quảng cáo bị chặn bằng danh mục nội dung của IAB. Chưa đặt là không có danh mục bị chặn.
`badv`	Mảng chuỗi	Chỉ định nhà quảng cáo bị chặn dựa trên miền do nhà quảng cáo cung cấp. Chưa đặt nghĩa là không có nhà quảng cáo bị chặn.
`bapp`	Mảng chuỗi	Không được hỗ trợ.
`source`	Nguồn	Bán bắt buộc đối với `schain`.
`regs`	Regs	Không bắt buộc.
`ext`	Tiện ích yêu cầu giá thầu	Không bắt buộc.

Đối tượng tiện ích yêu cầu giá thầu

Trường	Loại	Thông tin chi tiết
`schain`	Chuỗi cung ứng	các chế độ tích hợp mới nên sử dụng trường `BidRequest.source.schain` trong Nguồn.
`purch`	Số nguyên	Thông số Lưu lượng truy cập đã mua là lưu lượng truy cập được chuyển hướng từ các tài sản không thuộc sở hữu, không có được hoặc không được khuyến khích theo cách khác. Đây là theo Quy cách mới về IVT 2.0 của MRC. Thông tin này sẽ được gọi là Nguồn lưu lượng truy cập của nhà xuất bản trong báo cáo dành cho người mua và sẽ có một trong các giá trị sau : `0` (mặc định): Không xác định – Giá trị không được gửi trong yêu cầu giá thầu. Không thể ghi nhận giá trị; `1`: Đã mua – Lưu lượng truy cập được chuyển hướng từ các tài sản không thuộc sở hữu (hoạt động có được hoặc được khuyến khích khác). `2`: Tự nhiên – Lượt nhập URL trực tiếp, lượt tìm kiếm trang web hoặc lượt tải ứng dụng xuống.
`gdemsignals`	Chuỗi	Một blob tín hiệu SCAR API từ GMA SDK. Nên dùng nếu lưu lượng truy cập GMA SDK, nếu không thì không được phép.
`disable_gma_format`	int	Không bắt buộc nếu bạn cung cấp `gdemsignals`, nếu không thì bạn không được phép cung cấp. `0` (mặc định): Khi `gdemsignals` được điền sẵn, adm phản hồi giá thầu là một blob json. `1`: Một thẻ quảng cáo cũng sẽ được cung cấp thay vì blob json.

Đối tượng nguồn

Trường	Loại	Thông tin chi tiết
`fd`	Số nguyên	Đơn vị chịu trách nhiệm về quyết định cuối cùng đối với việc bán lượt hiển thị `0` (Mặc định): Sàn giao dịch quyết định. `1`: Nguồn ở thượng nguồn quyết định.
`tid`	Chuỗi	Không được hỗ trợ.
`pchain`	Chuỗi	Không được hỗ trợ.
`schain`	Chuỗi cung ứng	Bắt buộc trong hầu hết các trường hợp. Bạn nên cung cấp trường này thay vì `schain` thông qua Tiện ích yêu cầu giá thầu hoặc Tiện ích nguồn.
`ext`	Phần mở rộng về nguồn	Không bắt buộc.

Đối tượng nguồn của tiện ích

Bạn nên sử dụng tiện ích này vì nó ảnh hưởng đến cách báo cáo các chỉ số về khả năng xem cho khách hàng trong DV3. Nếu tên đối tác OMID KHÔNG có trong danh sách chứng nhận của IAB, thì MRC yêu cầu chúng tôi báo cáo các chỉ số về khả năng xem riêng biệt với các chỉ số được MRC chứng nhận. Tìm hiểu thêm.

Trường	Loại	Thông tin chi tiết
`omidpn`	Chuỗi	Giá trị nhận dạng của việc tích hợp SDK OM. Tham số này giống với tham số "name" của đối tượng Đối tác OMID.
`omidpv`	Chuỗi	Phiên bản tích hợp OM SDK. Tham số này giống với tham số "versionString" của đối tượng Đối tác OMID.
`schain`	Chuỗi cung ứng	các chế độ tích hợp mới nên sử dụng trường `schain` trong Nguồn.

Đối tượng Regs

Trường	Loại	Thông tin chi tiết
`coppa`	Số nguyên	`0` (mặc định): COPPA không áp dụng cho yêu cầu này. `1`: Yêu cầu này áp dụng COPPA.
`ext`	Tiện ích về quy định	Không bắt buộc.

Đối tượng tiện ích Regs

Trường	Loại	Thông tin chi tiết
`gdpr`	Số nguyên	Cho biết yêu cầu giá thầu có đến từ khu vực EEA hay không. `0` (mặc định): Khu vực không thuộc Khu vực kinh tế Châu Âu (EEA). `1`: Khu vực EEA, Xem Giải pháp về nhà cung cấp đã đồng ý theo GDPR để biết thêm thông tin chi tiết.
`us_privacy`	Chuỗi	Vui lòng tuân thủ quy cách kỹ thuật do IAB Tech Lab cung cấp để triển khai chuỗi `us_privacy`. Khi chúng tôi nhận được chuỗi `us_privacy` trong yêu cầu giá thầu và Khi chuỗi quyền riêng tư của IAB cho biết người dùng chưa chọn không nhận, Display & Video 360 sẽ đặt giá thầu cho những yêu cầu đó. Chúng tôi sẽ không truyền tín hiệu của IAB cho các nhà cung cấp khác. Khi chuỗi IAB cho biết người dùng đã chọn không đồng ý, Google sẽ không đặt giá thầu cho những yêu cầu đó.

Đối tượng imp

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Giá trị nhận dạng duy nhất cho lượt hiển thị này trong bối cảnh của yêu cầu giá thầu (thường thì giá trị bắt đầu bằng 1 và tăng lên đến n cho n lượt hiển thị).
`metric`	Đối tượng	Không được hỗ trợ.
`banner`	Quảng cáo biểu ngữ	Bắt buộc đối với các cơ hội quảng cáo biểu ngữ.
`video`	Video	Bắt buộc đối với các cơ hội quảng cáo dạng video.
`audio`	Âm thanh	Bắt buộc đối với các cơ hội quảng cáo dạng âm thanh.
`native`	Gốc	Bắt buộc đối với các cơ hội quảng cáo gốc.
`pmp`	Pmp	Thoả thuận trong trang web thương mại riêng tư có hiệu lực cho lượt hiển thị này.
`displaymanager`	Chuỗi	Tên của đối tác dàn xếp quảng cáo, công nghệ SDK hoặc trình phát chịu trách nhiệm hiển thị quảng cáo (thường là video hoặc thiết bị di động). Được một số máy chủ quảng cáo sử dụng để tuỳ chỉnh mã quảng cáo theo đối tác. Nên dùng cho video và/hoặc ứng dụng.
`displaymanagerver`	Chuỗi	Phiên bản của đối tác dàn xếp quảng cáo, công nghệ SDK hoặc trình phát chịu trách nhiệm hiển thị quảng cáo (thường là video hoặc thiết bị di động). Được một số máy chủ quảng cáo sử dụng để tuỳ chỉnh mã quảng cáo theo đối tác. Nên dùng cho video và/hoặc ứng dụng.
`instl`	Số nguyên	`0` (mặc định): không phải quảng cáo xen kẽ. `1`: quảng cáo là quảng cáo xen kẽ hoặc quảng cáo toàn màn hình.
`tagid`	Chuỗi	Giá trị nhận dạng cho vị trí đặt quảng cáo hoặc thẻ quảng cáo cụ thể được dùng để bắt đầu phiên đấu giá. Điều này có thể hữu ích cho việc gỡ lỗi mọi vấn đề hoặc để người mua tối ưu hoá.
`bidfloor`	Số thực dấu phẩy động	Giá thầu tối thiểu cho lượt hiển thị này, được biểu thị bằng CPM.
`bidfloorcur`	Chuỗi	Đơn vị tiền tệ được chỉ định bằng mã chữ cái ISO-4217.
`clickbrowser`	Số nguyên	Cho biết loại trình duyệt được mở khi nhấp vào mẫu quảng cáo trong một ứng dụng. `0` (mặc định): được nhúng `1`: gốc Xin lưu ý rằng Safari View Controller trong các thiết bị iOS 9.x được coi là một trình duyệt gốc cho mục đích của trường này.
`secure`	Số nguyên	Nếu lượt hiển thị này yêu cầu một URL HTTPS bảo mật hoặc một URL HTTP không bảo mật. `0` (mặc định):không an toàn `1`: an toàn
`iframebuster`	Mảng chuỗi
`exp`	Số nguyên	DV360 đặt thời gian hết hạn của giá thầu mà không cần quan tâm đến giá trị do đối tác gửi trong trường này. Những sự kiện hiển thị nhận được sau khoảng thời gian hết hạn của lượt hiển thị (thường là 1 giờ) sẽ bị loại bỏ vì đã hết hạn và DV360 sẽ không coi đó là sự kiện có tính phí.
`rwdd`	Số nguyên	Cho biết liệu người dùng có nhận được phần thưởng khi xem quảng cáo hay không. `0` (mặc định): Không được tặng thưởng `1`: Được tặng thưởng Thông thường, việc triển khai quảng cáo dạng video cho phép người dùng đọc miễn phí một bài viết tin tức bổ sung, nhận thêm một mạng trong trò chơi hoặc có một phiên nghe nhạc không có quảng cáo được tài trợ. Phần thưởng thường được phân phát sau khi quảng cáo dạng video phát xong.

Đối tượng tiện ích Imp

Trường	Loại	Thông tin chi tiết
`bcrid`	Chuỗi	Danh sách mã nhận dạng mẫu quảng cáo cần bị chặn.

Trường	Loại	Thông tin chi tiết
`format`	Mảng định dạng	Danh sách các định dạng được hỗ trợ.
`w`	Số nguyên	`h` và `w` được hợp nhất vào trường `format`. Bạn nên dùng `format`.
`h`	Số nguyên	`h` và `w` được hợp nhất vào trường `format`. Bạn nên dùng `format`.
`wmax`	Số nguyên	Không được hỗ trợ.
`hmax`	Số nguyên	Không được hỗ trợ.
`wmin`	Số nguyên	Không được hỗ trợ.
`hmin`	Số nguyên	Không được hỗ trợ.
`btype`	Mảng số nguyên	Danh sách các loại quảng cáo biểu ngữ bị chặn: `1`: Quảng cáo dạng văn bản HTML `2`: Quảng cáo biểu ngữ HTML `3`: Quảng cáo JavaScript `4`: Quảng cáo IFrame
`battr`	Mảng số nguyên	Hỗ trợ các giá trị sau: `1`: Tự động phát âm thanh `2`: Người dùng bắt đầu phát âm thanh `3`: Tự động mở rộng `4`: Mở rộng khi nhấp `5`: Mở rộng khi di chuột `6`: Tự động phát video trong biểu ngữ `7`: Người dùng bắt đầu phát video trong biểu ngữ `8`: Cửa sổ bật lên(trên/dưới/khi thoát) `9`: Khiêu khích hoặc gợi cảm `10`: "Gây phiền toái", ví dụ: Rung lắc, nhấp nháy, chớp sáng, hoạt ảnh quá mức, biểu tượng mặt cười `11`: Khảo sát `12`: Chỉ có văn bản `13`: Tương tác với người dùng (trò chơi) `14`: Kiểu hộp thoại hoặc cảnh báo của Windows `15`: Có nút bật/tắt âm thanh `16`: Có thể bỏ qua quảng cáo `17`: Flash
`pos`	Số nguyên	Vị trí của quảng cáo: `0` (mặc định): Không xác định `1`: Phía trên dòng gấp `2`: Không được hỗ trợ: Có thể ở phía dưới dòng gấp `3`: Phía dưới dòng gấp `4`: Tiêu đề `5`: Chân trang `6`: Thanh bên `7`: Toàn màn hình
`mimes`	Mảng chuỗi	Không được hỗ trợ. DV360 sẽ sử dụng text/html cho tất cả mẫu quảng cáo dạng biểu ngữ.
`topframe`	Số nguyên	`0` (mặc định): Biểu ngữ được phân phối trong một iframe. `1`: Không được hỗ trợ: Biểu ngữ được phân phối trong khung trên cùng.
`expdir`	Mảng số nguyên	`1`: Trái `2`: Phải `3`: Lên `4`: Xuống `5`: Toàn màn hình có thể mở rộng
`api`	Mảng số nguyên	Các khung API được hỗ trợ `1`: Trái `2`: Phải `3`: Lên `4`: Xuống `5`: Toàn màn hình có thể mở rộng
`id`	Chuỗi	Giá trị nhận dạng của đối tượng biểu ngữ và phải là giá trị nhận dạng riêng biệt trong lượt hiển thị. Nên dùng khi các đối tượng `banner` được dùng với một đối tượng video.
`vcm`	Số nguyên	Chỉ liên quan đến `banner` được dùng với đối tượng video. `0`: Biểu ngữ xuất hiện đồng thời với mẫu quảng cáo dạng video. `1`: Biểu ngữ là thẻ kết thúc sau video.

Định dạng đối tượng

Trường	Loại	Thông tin chi tiết
`w`	Số nguyên	Chiều rộng tính bằng pixel không phụ thuộc vào thiết bị (DIP).
`h`	Số nguyên	Chiều cao tính bằng số pixel không phụ thuộc vào thiết bị (DIP).
`wratio`	Số nguyên	Không được hỗ trợ.
`hratio`	Số nguyên	Không được hỗ trợ.
`wmin`	Số nguyên	Không được hỗ trợ.

Đối tượng video

Bạn nên chỉ định vị trí đặt video trong yêu cầu giá thầu. Trường vị trí bị thiếu được phân loại là vị trí không xác định. Hãy xem bài viết về tiêu chí nhắm mục tiêu theo vị trí để biết thêm thông tin chi tiết.

Trường	Loại	Thông tin chi tiết
`mimes`	Mảng chuỗi	Bạn phải chọn ít nhất một loại mime. `video/flv` hoặc `video/x-f4v` `video/mp4`, `video/x-mp4` hoặc `application/mp4` `video/webm` hoặc `video/x-webm` `video/x-ms-wmv` `video/3gpp` `video/ogg` hoặc `application/ogg` `application/javascript` hoặc `application/x-javascript`
`minduration`	Số nguyên	Thời lượng tối thiểu của video tính bằng giây, mặc định là không có thời lượng tối thiểu.
`maxduration`	Số nguyên	Thời lượng tối đa của video (tính bằng giây), mặc định là không có thời lượng tối đa.
`protocols`	Mảng số nguyên	Bạn phải có ít nhất một giao thức được hỗ trợ. `1`: VAST 1.0 `2`: VAST 2.0 `3`: VAST 3.0 `4`: Vỏ VAST 1.0 `5`: Vỏ VAST 2.0 `6`: Vỏ VAST 3.0 `7`: VAST 4.0 `8`: Vỏ VAST 4.0 `9`: DAAST 1.0 `10`: Vỏ DAAST 1.0
`w`	Số nguyên	Chiều rộng của trình phát video tính bằng pixel độc lập với thiết bị (DIP).
`h`	Số nguyên	Chiều cao của trình phát video tính bằng pixel độc lập với thiết bị (DIP).
`startdelay`	Số nguyên	Độ trễ bắt đầu tính bằng giây cho các vị trí quảng cáo trước video, trong video hoặc sau video.
`placement`	Số nguyên	Bạn nên chỉ định plcmt (và/hoặc) vị trí đặt video trong yêu cầu giá thầu. Nếu thiếu cả hai trường, vị trí sẽ được phân loại là vị trí không xác định. `0` (mặc định): Không xác định `1`: Trong luồng phát `2`: Trong biểu ngữ `3`: Trong bài viết `4`: Trong nguồn cấp dữ liệu `5`: Nổi Lưu ý: Để được coi là Trong luồng phát (Vị trí hoặc Loại vị trí 1), vị trí/lượt hiển thị video phải được đặt thành "bật âm thanh" và được báo hiệu chính xác trong Phương thức phát (Tất cả các giá trị 1, 3, 4 và 5 đều đủ điều kiện).
`plcmt`	Số nguyên	Bạn nên chỉ định plcmt (và/hoặc) vị trí đặt video trong yêu cầu giá thầu. Nếu thiếu cả hai trường, vị trí sẽ được phân loại là vị trí không xác định. `0` (mặc định): Không xác định `1`: Trong luồng phát `2`: Nội dung đi kèm `3`: Xen kẽ `4`: Không có nội dung/Độc lập Lưu ý: Để được coi là Trong luồng phát (Vị trí hoặc Loại vị trí 1), vị trí/lượt hiển thị video phải được đặt thành "bật âm thanh" và được báo hiệu chính xác trong Phương thức phát (Tất cả các giá trị 1, 3, 4 và 5 đều đủ điều kiện). Lưu ý: Nếu bạn cung cấp cả `plcmt` và `placement`, thì `plcmt` sẽ được ưu tiên. Hãy xem Hướng dẫn về IAB để biết cách di chuyển sang plcmt. Lưu ý: `plcmt: Accompanying Content (2)` được coi là `placement: In Article (3)` `plcmt: No Content/Standalone (4)` được coi là `placement: In feed (4)` `placement: In Banner` không có mối liên kết trong `plcmt`
`linearity`	Số nguyên	Không được hỗ trợ.
`skip`	Số nguyên	Liệu trình phát video có cho phép bỏ qua quảng cáo hay không. `0` (mặc định): Không thể bỏ qua `1`: Có thể bỏ qua
`skipmin`	Số nguyên	Không được hỗ trợ.
`skipafter`	Số nguyên	Không được hỗ trợ.
`sequence`	Số nguyên	Nếu nhiều lượt hiển thị quảng cáo được cung cấp trong cùng một yêu cầu giá thầu, số thứ tự sẽ cho phép phân phối phối hợp nhiều mẫu quảng cáo.
`battr`	Mảng số nguyên	Thuộc tính mẫu quảng cáo bị chặn.
`maxextended`	Số nguyên	Thời lượng tối đa của quảng cáo dạng video mở rộng (nếu được phép mở rộng). `0` (mặc định): Không cho phép gia hạn `-1`: cho phép gia hạn và không có giới hạn thời gian `>0`: số giây được hỗ trợ để phát mở rộng ngoài giá trị maxduration.
`minbitrate`	Số nguyên	Tốc độ bit tối thiểu tính bằng Kb/giây.
`maxbitrate`	Số nguyên	Tốc độ bit tối đa tính bằng Kb/giây.
`boxingallowed`	Số nguyên	Cho biết liệu có được phép tạo hiệu ứng hòm thư cho nội dung 4:3 trong cửa sổ 16:9 hay không `0`: không được phép `1` (mặc định): Được phép
`playbackmethod`	Mảng số nguyên	Các phương thức phát có thể đang được sử dụng. Nếu bạn không chỉ định, thì có thể sử dụng mọi phương thức. `0` (mặc định): Không xác định `1`: Tự động phát, bật âm thanh `2`: Tự động phát, tắt âm thanh `3`: Nhấp để phát `4`: Di chuột `5`: Bắt đầu khi vào khung hiển thị, bật âm thanh `6`: Bắt đầu khi vào khung hiển thị, tắt âm thanh Lưu ý: Tất cả lượt hiển thị có Chế độ âm thanh mặc định là Tắt (Phương thức phát là 2, 6 hoặc 0) đều phải báo hiệu Vị trí ngoài luồng phát thuộc loại 2, 3, 4 hoặc 5 (oRTB 2.5) hoặc Loại vị trí phụ là 2, 3 hoặc 4.
`playbackend`	Số nguyên	Sự kiện khiến quá trình phát kết thúc. `1`: Video hoàn tất hoặc người dùng kết thúc `2`: Rời khỏi khung hiển thị hoặc người dùng kết thúc `3`: Khi rời khỏi khung hiển thị, video tiếp tục phát dưới dạng cửa sổ nổi cho đến khi hoàn tất hoặc người dùng kết thúc
`delivery`	Mảng số nguyên	Các phương thức phân phối được hỗ trợ. Nếu bạn không chỉ định, hãy giả định rằng tất cả đều được hỗ trợ. `1`: Phát trực tuyến `2`: Lũy tiến
`pos`	Số nguyên	Vị trí quảng cáo trên màn hình. `0` (mặc định): Không xác định `1`: Phía trên dòng gấp `2`: Không được hỗ trợ: Có thể ở phía dưới dòng gấp `3`: Phía dưới dòng gấp `4`: Tiêu đề `5`: Chân trang `6`: Thanh bên `7`: Toàn màn hình
`companionad`	Mảng biểu ngữ	Quảng cáo đồng hành (nếu có).
`api`	Mảng số nguyên	`0` (mặc định): Không xác định `1`: VPAID 1 `2`: VPAID 2 `3`: MRAID 1 `4`: ORMMA `5`: MRAID 2 `6`: MRAID 3 `7`: OMID 1 – bắt buộc phải bật tính năng đo lường bằng OMID cho Active View. `8`: SIMID 1
`companiontype`	Mảng số nguyên	Không được hỗ trợ.
`maxseq`	Số nguyên	Số lượng quảng cáo tối đa được trả về trong một nhóm quảng cáo dạng video động.
`poddur`	Mảng số nguyên	Thời lượng tối đa của một nhóm video động (tính bằng giây).

Phần mở rộng được hỗ trợ cho đối tượng video

Trường	Loại	Thông tin chi tiết
`rewarded`	Số nguyên	Trường này dùng để báo hiệu xem các yêu cầu có được thưởng hay không. Bạn nên gửi giá trị này dưới dạng số nguyên. `0` (mặc định): không được tặng thưởng `1`: được tặng thưởng

Đối tượng âm thanh

Trường	Loại	Thông tin chi tiết
`mimes`	Mảng chuỗi	Bạn phải chọn ít nhất một loại mime. `audio/m4a`, `audio/mp4` hoặc `audio/x-m4a` `audio/mpeg` hoặc `audio/mp3` `audio/ogg` hoặc `audio/x-ogg`
`minduration`	Số nguyên	Thời lượng tối thiểu của quảng cáo tính bằng giây.
`maxduration`	Số nguyên	Thời lượng quảng cáo tối đa tính bằng giây.
`protocols`	Mảng số nguyên	`3`: VAST 3.0 `6`: VAST 3.0 Wrapper `7`: VAST 4.0 `8`: VAST 4.0 Wrapper
`startdelay`	Số nguyên	Độ trễ bắt đầu tính bằng giây cho vị trí đặt quảng cáo trước video, trong video hoặc sau video. `-2`: Sau video `-1`: Trong video `0`: Trước video `>0`: Trong video
`sequence`	Số nguyên	Không được hỗ trợ.
`battr`	Mảng số nguyên	Không được hỗ trợ.
`maxextended`	Số nguyên	Không được hỗ trợ.
`minbitrate`	Số nguyên	Tốc độ bit tối thiểu tính bằng Kb/giây.
`maxbitrate`	Số nguyên	Tốc độ bit tối đa tính bằng Kb/giây.
`delivery`	Mảng số nguyên	Không được hỗ trợ.
`companionad`	Mảng đối tượng biểu ngữ	Mọi vị trí mẫu quảng cáo đồng hành dạng biểu ngữ.
`api`	Mảng số nguyên	Danh sách các khung API được hỗ trợ cho lượt hiển thị này. `7`: Omid V1
`companiontype`	Mảng số nguyên	Không được hỗ trợ.
`maxseq`	Mảng số nguyên	Không được hỗ trợ.
`feed`	Số nguyên	Loại nguồn cấp dữ liệu âm thanh. `1`: Dịch vụ âm nhạc `2`: Chương trình phát sóng `3`: Podcast
`stitched`	Số nguyên	Không được hỗ trợ.
`nvol`	Số nguyên	Không được hỗ trợ.

Đối tượng gốc

Hãy xem quy cách quảng cáo gốc trên DV360 để biết thêm thông tin chi tiết.

Trường	Loại	Thông tin chi tiết
`request`	Chuỗi	Chuỗi mã hoá đối tượng json gốc.
`ver`	Chuỗi	`1.0`: Không được hỗ trợ `1.1`: Không được hỗ trợ `1.2`
`api`	Mảng số nguyên	Danh sách các khung API được hỗ trợ cho lượt hiển thị này. `7`: Omid V1
`battr`	Mảng số nguyên	Không được hỗ trợ.

Đối tượng PMP

Trường	Loại	Thông tin chi tiết
`private_auction`	Số nguyên	`0` (Mặc định): Cho phép tất cả giá thầu `1`: Chỉ có giao dịch
`deals`	Mảng đối tượng Deal	Các ưu đãi cần đưa vào.

Đối tượng thoả thuận

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Đối tượng PMP không thể chứa nhiều đối tượng giao dịch cho mỗi mã nhận dạng.
`bidfloor`	Đôi	Giá thầu tối thiểu cho lượt hiển thị này theo CPM. Bắt buộc nếu có `at=3`.
`bidfloorcur`	Chuỗi	Đơn vị tiền tệ được chỉ định bằng mã chữ cái ISO-4217. Mặc định là đơn vị tiền tệ của yêu cầu đặt giá thầu nếu bạn không chỉ định.
`at`	Số nguyên	Giá trị mặc định là `bid_request.at` nếu bạn không chỉ định. `1`: Giá đầu tiên `2`: Giá thứ hai `3`: Giá cố định
`wseat`	Mảng chuỗi	Mã đối tác của những đối tác đủ điều kiện tham gia giao dịch. Không có ghế tức là không có hạn chế về ghế.
`wadomain`	Mảng chuỗi	Miền của nhà quảng cáo được phép đặt giá thầu cho giao dịch này. Không có chỗ ngồi tức là không có hạn chế về miền.
`guar`	Số nguyên	Trường này dùng để báo hiệu xem giao dịch có phải là giao dịch đảm bảo hay không. Bạn nên gửi giá trị này dưới dạng số nguyên. Sàn giao dịch phải có trong danh sách cho phép để DV360 chấp nhận giao dịch đảm bảo; hãy liên hệ để yêu cầu việc này. Nếu sàn giao dịch của bạn hiện đang sử dụng một cơ chế khác để báo hiệu các giao dịch đảm bảo với DV360, hãy liên hệ để thảo luận về việc chuyển sang tiện ích ưu tiên này. `0` (mặc định): Không đảm bảo `1`: Đảm bảo
`ext`	Phần mở rộng về ưu đãi	Không bắt buộc.

Phần mở rộng được hỗ trợ cho đối tượng ưu đãi

Trường Loại Thông tin chi tiết

Trường	Loại	Thông tin chi tiết
`guaranteed`	Số nguyên	Trường này dùng để báo hiệu xem giao dịch có phải là giao dịch đảm bảo hay không. Bạn nên gửi giá trị này dưới dạng số nguyên. Sàn giao dịch phải có trong danh sách cho phép để DV360 chấp nhận giao dịch đảm bảo; hãy liên hệ để yêu cầu việc này. Nếu sàn giao dịch của bạn hiện đang sử dụng một cơ chế khác để báo hiệu các giao dịch đảm bảo với DV360, hãy liên hệ để thảo luận về việc chuyển sang tiện ích ưu tiên này. `0` (mặc định): Không đảm bảo `1`: Đảm bảo Bạn nên dùng `deal.guar` thay cho trường này.

guaranteed

Số nguyên

Trường này dùng để báo hiệu xem giao dịch có phải là giao dịch đảm bảo hay không. Bạn nên gửi giá trị này dưới dạng số nguyên.

Sàn giao dịch phải có trong danh sách cho phép để DV360 chấp nhận giao dịch đảm bảo; hãy liên hệ để yêu cầu việc này.

Nếu sàn giao dịch của bạn hiện đang sử dụng một cơ chế khác để báo hiệu các giao dịch đảm bảo với DV360, hãy liên hệ để thảo luận về việc chuyển sang tiện ích ưu tiên này.

0 (mặc định): Không đảm bảo
1: Đảm bảo

Bạn nên dùng deal.guar thay cho trường này.

Đối tượng trang web

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Mã nhận dạng của trang web trên sàn giao dịch.
`name`	Chuỗi	Không được hỗ trợ.
`domain`	Chuỗi	Miền của trang web. Bạn nên gửi một URL đầy đủ trong site.page thay vì chỉ điền site.domain.
`cat`	Mảng chuỗi	Không được hỗ trợ.
`sectioncat`	Mảng chuỗi	Không được hỗ trợ.
`pagecat`	Mảng chuỗi	Không được hỗ trợ.
`page`	Chuỗi	URL đầy đủ nơi lượt hiển thị sẽ xuất hiện. Bạn nên gửi URL đầy đủ cho mục đích nhắm mục tiêu.
`ref`	Chuỗi	URL của trang giới thiệu đã khiến người dùng chuyển đến trang hiện tại.
`search`	Chuỗi	Không được hỗ trợ.
`mobile`	Số nguyên	Không được hỗ trợ.
`privacypolicy`	Số nguyên	Không được hỗ trợ.
`publisher`	Đối tượng Publisher	Thông tin chi tiết về nhà xuất bản của trang web.
`content`	Đối tượng nội dung	Thông tin chi tiết về nội dung trong một trang web.
`keywords`	Chuỗi (định dạng CSV)	Không được hỗ trợ.
`ext`	Phần mở rộng về trang web	Các tiện ích cho đối tượng trang web.

Đối tượng tiện ích trang web

Trường	Loại	Thông tin chi tiết
`inventorypartnerdomain`	Chuỗi	Được dùng để chia sẻ khoảng không quảng cáo trên CTV, hãy xem Phần giải thích về việc thêm ứng dụng CTV của IAB.

Đối tượng ứng dụng

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Mã ứng dụng trên sàn giao dịch.
`name`	Chuỗi	Tên ứng dụng, có thể được đặt biệt hiệu theo yêu cầu của nhà xuất bản. Nhà xuất bản có thể cung cấp trực tiếp tên ứng dụng cho các yêu cầu không có SDK (chủ yếu là TV có kết nối) trong yêu cầu.
`bundle`	Chuỗi	Bắt buộc. Đối với iOS, bạn phải nhập mã nhận dạng cửa hàng ứng dụng bằng số. Chúng tôi không chấp nhận mã nhận dạng gói theo kiểu DNS nghịch. Đối với ứng dụng CTV, bạn nên truyền giá trị nhận dạng ứng dụng do cửa hàng xác định. Vui lòng tuân thủ hướng dẫn về mã nhận dạng do cửa hàng OTT/CTV của IAB chỉ định mới được xuất bản.
`domain`	Chuỗi	Miền, ví dụ: `mygame.foo.com`
`storeurl`	Chuỗi	Bắt buộc để xác minh tệp app-ads.txt và xác thực cửa hàng ứng dụng trên TV kết nối Internet.
`cat`	Mảng chuỗi	Không được hỗ trợ.
`sectioncat`	Mảng chuỗi	Không được hỗ trợ.
`pagecat`	Mảng chuỗi	Không được hỗ trợ.
`ver`	Chuỗi	Không được hỗ trợ.
`privacypolicy`	Số nguyên	Không được hỗ trợ.
`paid`	Số nguyên	Không được hỗ trợ.
`publisher`	Đối tượng Publisher	Thông tin về nhà xuất bản ứng dụng.
`content`	Đối tượng nội dung	Thông tin về nội dung ứng dụng.
`keywords`	Chuỗi (định dạng CSV)	Không được hỗ trợ.
`ext`	Phần mở rộng về ứng dụng	Các tiện ích cho đối tượng ứng dụng.

Đối tượng phần mở rộng về ứng dụng

Trường	Loại	Thông tin chi tiết
`inventorypartnerdomain`	Chuỗi	Được dùng để chia sẻ khoảng không quảng cáo trên CTV, hãy xem Phần giải thích về việc thêm ứng dụng CTV của IAB.

Đối tượng nội dung

Bạn nên truyền các thuộc tính này nếu có.

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Mã nhận dạng riêng biệt của nội dung.
`episode`	Số nguyên	Số tập nội dung (thường là cho nội dung video).
`title`	Chuỗi	Nên dùng cho các yêu cầu về CTV, video và âm thanh.
`series`	Chuỗi	Nên dùng cho các yêu cầu về CTV, video và âm thanh.
`season`	Chuỗi	Nhãn cho phần nội dung.
`artist`	Chuỗi	Nghệ sĩ được ghi công trong nội dung.
`genre`	Chuỗi	Thể loại mô tả đúng nhất nội dung. DV360 đề xuất cung cấp tín hiệu này cho các yêu cầu về CTV, video và âm thanh. DV360 hỗ trợ một số phân loại giá trị thể loại video cho trường này: Danh sách thể loại của Google (Tải xuống) Danh mục IAB về truyền hình/phim ảnh/thể thao (Tải xuống) Phân loại thể loại video của Gracenote theo Nielsen
`album`	Chuỗi	Đĩa nhạc chứa nội dung, thường là nội dung âm thanh.
`isrc`	Chuỗi	Mã ghi âm chuẩn quốc tế tuân thủ tiêu chuẩn ISO-3901.
`producer`	Đối tượng Producer	Thông tin chi tiết về nhà sản xuất nội dung.
`url`	Chuỗi	URL của nội dung.
`cat`	Mảng chuỗi	Danh mục nội dung theo IAB mô tả nội dung.
`prodq`	Số nguyên	Chất lượng sản xuất: `0` (Mặc định): Không xác định `1`: Chuyên nghiệp `2`: Bán chuyên `3`: Do người dùng tạo
`videoquality`	Số nguyên	Không được hỗ trợ.
`context`	Số nguyên	Loại nội dung: `1`: Video `2`: Trò chơi `3`: Nhạc `4`: Ứng dụng `5`: Văn bản `6`: Khác `7`: Không xác định
`contentrating`	Chuỗi	Nên dùng cho Âm thanh và Video/CTV, vì chúng tôi sẽ bắt đầu đưa ra quyết định về thuộc tính này.
`userrating`	Chuỗi	Số sao, số lượt thích, v.v.
`qagmediarating`	Số nguyên	Mức phân loại nội dung nghe nhìn theo [nguyên tắc của Nhóm đảm bảo chất lượng](http://www.iab.net/ne_guidelines). `1`: Tất cả đối tượng `2`: Từ 12 tuổi trở lên `3`: Người trưởng thành
`keywords`	Chuỗi (định dạng CSV)	Không được hỗ trợ.
`livestream`	Số nguyên	Nếu nội dung đó là nội dung phát trực tiếp. `0`: Không phát trực tiếp `1`: Nội dung đang phát trực tiếp
`sourcerelationship`	Số nguyên	`0`: Gián tiếp `1`: Trực tiếp
`len`	Số nguyên	Thời lượng nội dung tính bằng giây. Nên dùng cho các yêu cầu về CTV/video và âm thanh.
`language`	Chuỗi (ISO-639-1-alpha-2)	Ngôn ngữ của nội dung.
`embeddable`	Số nguyên	Chỉ báo cho biết nội dung có thể nhúng hay không (ví dụ: trình phát video có thể nhúng) `0`: Không thể nhúng `1`: Có thể nhúng
`data`	Mảng Đối tượng dữ liệu	Dữ liệu bổ sung.

Đối tượng Producer

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Không được hỗ trợ.
`name`	Chuỗi	Không được hỗ trợ.
`cat`	Mảng chuỗi	Không được hỗ trợ.
`domain`	Chuỗi	Miền cấp cao nhất của nhà sản xuất.

Đối tượng dữ liệu

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Mã nhận dạng của nhà cung cấp dữ liệu.
`name`	Chuỗi	Tên sàn giao dịch của nhà cung cấp dữ liệu.
`segment`	Mảng gồm các đối tượng Phân đoạn	Giá trị dữ liệu thực tế.
`ext`	Tiện ích dữ liệu	Các tiện ích cho đối tượng Dữ liệu.

Các tiện ích được hỗ trợ cho đối tượng dữ liệu

Trường	Loại	Thông tin chi tiết
`segtax`	Số nguyên	Mã phân loại, hãy xem Phân loại phân khúc để biết thêm thông tin chi tiết.
`segclass`	Chuỗi	Phiên bản của thuật toán phân loại đã tạo ra mã phân đoạn trong hệ thống phân loại.

Đối tượng phân đoạn

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Mã nhận dạng của phân khúc dữ liệu dành riêng cho nhà cung cấp dữ liệu.
`name`	Chuỗi	Tên của phân khúc dữ liệu.
`value`	Chuỗi	Giá trị của phân khúc dữ liệu.

Đối tượng nhà xuất bản

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Bắt buộc.
`name`	Chuỗi	Không được hỗ trợ.
`cat`	Mảng chuỗi	Không được hỗ trợ.
`domain`	Chuỗi	Không được hỗ trợ.

Đối tượng thiết bị

Trường	Loại	Thông tin chi tiết
`ua`	Chuỗi	Bắt buộc.
`sua`	Đối tượng UserAgent	Thông tin có cấu trúc về tác nhân người dùng.
`geo`	Đối tượng địa lý	Vị trí của thiết bị.
`dnt`	Số nguyên	Cờ Không theo dõi được đặt trong tiêu đề của trình duyệt. `0`: Không hạn chế việc theo dõi `1`: Không theo dõi
`lmt`	Số nguyên	Tín hiệu Giới hạn việc theo dõi quảng cáo được xác nhận về mặt thương mại. `0`: Hoạt động theo dõi không bị hạn chế `1`: Hoạt động theo dõi phải bị hạn chế theo nguyên tắc thương mại
`ip`	Chuỗi	Bắt buộc nếu là IPv4. Nếu địa chỉ IP bị cắt bớt, bạn phải khai báo trong `device.ext.truncated_ip`.
`ipv6`	Chuỗi	Bắt buộc nếu là IPv6. Nếu địa chỉ IP bị cắt bớt, bạn phải khai báo trong `device.ext.truncated_ip`.
`devicetype`	Số nguyên	Bạn nên dùng cho tất cả các loại khoảng không quảng cáo. Được dùng để tăng cường khả năng nhận dạng loại thiết bị.
`make`	Chuỗi
`model`	Chuỗi
`os`	Chuỗi	Hệ điều hành của thiết bị. `ios`: Trong yêu cầu Ứng dụng, thông số này xác định lưu lượng truy cập iOS. `android`: Xác định một thiết bị Android nếu `ua` hoặc `sua` không xác định được thiết bị. `[anything else]`: Được dùng trong mục chẩn đoán để cô lập các vấn đề. Trường này không phân biệt chữ hoa chữ thường.
`osv`	Chuỗi	Không được hỗ trợ.
`hwv`	Chuỗi	Phiên bản phần cứng của thiết bị.
`h`	Số nguyên	Chiều cao thực của màn hình, tính bằng pixel.
`w`	Số nguyên	Chiều rộng thực của màn hình, tính bằng pixel.
`ppi`	Số nguyên	Không được hỗ trợ.
`pxratio`	Đôi	Tỷ lệ giữa pixel vật lý và pixel độc lập với thiết bị.
`js`	Số nguyên	Không được hỗ trợ.
`geofetch`	Số nguyên	Không được hỗ trợ.
`flashver`	Chuỗi	Không được hỗ trợ.
`language`	Chuỗi (ISO-639-1-alpha-2)	Ngôn ngữ của thiết bị.
`carrier`	Chuỗi	Không được hỗ trợ.
`mccmnc`	Chuỗi	Không được hỗ trợ.
`connectiontype`	Số nguyên	Loại kết nối mạng
`ifa`	Chuỗi	Mã nhận dạng được phê duyệt để nhà quảng cáo sử dụng công khai.
`didsha1`	Chuỗi	Không được hỗ trợ.
`didmd5`	Chuỗi	Không được hỗ trợ.
`dpidsha1`	Chuỗi	Không được hỗ trợ.
`dpidmd5`	Chuỗi	Không được hỗ trợ.
`macsha1`	Chuỗi	Không được hỗ trợ.
`macmd5`	Chuỗi	Không được hỗ trợ.
`ext`	Tiện ích trên thiết bị	Tiện ích cho đối tượng thiết bị.

Phần mở rộng được hỗ trợ cho đối tượng thiết bị

Nếu ip bị thay đổi hoặc cắt bớt, bạn nên gửi các tiện ích sau để ngăn lưu lượng truy cập bị coi là lưu lượng truy cập không hợp lệ.

Trường	Loại	Thông tin chi tiết
`truncated_ip`	Số nguyên	Cho biết địa chỉ IP trong trường `device.ip` của yêu cầu giá thầu có bị cắt bớt hay không. `0`: Không bị cắt bớt `1`: Bị cắt bớt Giá trị mặc định là không bị cắt bớt và bắt buộc nếu địa chỉ IP bị cắt bớt. Nếu không được khai báo, yêu cầu giá thầu có thể bị phân loại là lưu lượng truy cập không hợp lệ.
`ifa_type`	Chuỗi	Cho biết nguồn gốc của trường device.ifa, cho dù trường này được cung cấp từ chính thiết bị hay do nhà xuất bản hoặc SSP tạo trong chuỗi cung ứng. `aaid`: Android TV `rida`: Roku `afai`: Amazon Fire `idfa`: Apple tvOS `msai`: Xbox/Microsoft `dpid`: Mã nhận dạng nền tảng thiết bị chung `ppid`: Mã nhận dạng do nhà xuất bản cung cấp `sspid`: Mã nhận dạng do SSP cung cấp `sessionid`: Mã nhận dạng phiên ngắn hạn (chỉ fcapping)
`attestation_token`	Chuỗi (mã hoá base64)	Mã thông báo chứng thực dựa trên thiết bị cho những hoạt động trao đổi hỗ trợ cấp độ xác thực thiết bị đó.
`atts`	Số nguyên	(Chỉ dành cho iOS) Một số nguyên được truyền để biểu thị trạng thái uỷ quyền theo dõi ứng dụng của ứng dụng. `0`: Chưa xác định `1`: Bị hạn chế `2`: Bị từ chối `3`: Được phép
`cdep`	Chuỗi	Nhãn ngừng sử dụng cookie của bên thứ ba trên Chrome. Xem phần Kiểm thử với sự hỗ trợ trên Chrome và Quy cách cộng đồng của Cục Quảng cáo tương tác (IAB)

Đối tượng UserAgent

Trường	Loại	Thông tin chi tiết
`browsers`	Mảng gồm các đối tượng BrandVersion	Mỗi đối tượng BrandVersion xác định một trình duyệt hoặc thành phần phần mềm tương tự.
`platform`	Đối tượng BrandVersion	Xác định nền tảng.
`mobile`	Số nguyên	`0` (mặc định): Tác nhân ưu tiên nội dung "máy tính" hoặc "đầy đủ". `1`: Nhân viên hỗ trợ ưu tiên nội dung "di động".
`architecture`	Chuỗi	Cấu trúc thiết bị, ví dụ: "x86" hoặc "arm".
`bitness`	Chuỗi	Độ bit của thiết bị, ví dụ: "64" cho kiến trúc 64 bit.
`model`	Chuỗi	Mẫu thiết bị.
`source`	Số nguyên	Nguồn dữ liệu được dùng để tạo đối tượng này, hãy xem Danh sách: Nguồn User-Agent. Nên dùng khi truyền đối tượng UserAgent.

Đối tượng BrandVersion

Trường	Loại	Thông tin chi tiết
`brand`	Chuỗi	Giá trị nhận dạng thương hiệu, ví dụ: "Chrome" hoặc "Windows". Bắt buộc.
`version`	Mảng chuỗi	Một chuỗi các thành phần phiên bản, theo thứ tự phân cấp giảm dần (chính, phụ, vi mô, v.v.).

Đối tượng địa lý

Trường	Loại	Thông tin chi tiết
`lat`	Đôi	Không được hỗ trợ.
`lon`	Đôi	Không được hỗ trợ.
`type`	Số nguyên	Không được hỗ trợ.
`accuracy`	Số nguyên	Không được hỗ trợ.
`lastfix`	Số nguyên	Không được hỗ trợ.
`ipservice`	Số nguyên	Không được hỗ trợ.
`country`	Chuỗi	Không được hỗ trợ.
`region`	Chuỗi	Không được hỗ trợ.
`regionfips104`	Chuỗi	Không được hỗ trợ.
`metro`	Chuỗi	Không được hỗ trợ.
`city`	Chuỗi	Không được hỗ trợ.
`zip`	Chuỗi	Không được hỗ trợ.
`utcoffset`	Số nguyên	Không được hỗ trợ.

Đối tượng người dùng

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Được hỗ trợ nếu Google lưu trữ bảng so khớp mã nhận dạng.
`buyeruid`	Chuỗi	Được hỗ trợ nếu SSP lưu trữ bảng so khớp mã nhận dạng.
`yob`	Số nguyên	Được đề xuất để nhắm mục tiêu theo nhân khẩu học.
`gender`	Chuỗi	Được đề xuất để nhắm mục tiêu theo nhân khẩu học.
`keywords`	Chuỗi (CSV)	Không được hỗ trợ.
`customdata`	Chuỗi	Không được hỗ trợ.
`geo`	Đối tượng địa lý	Không được hỗ trợ.
`data`	Mảng Đối tượng dữ liệu	Dữ liệu bổ sung.
`eids`	Mảng gồm các đối tượng Mã nhận dạng mở rộng	Các phiên bản mã nhận dạng mở rộng do sàn giao dịch cung cấp.
`ext`	Tiện ích người dùng	Tiện ích cho đối tượng người dùng.

Các tiện ích được hỗ trợ cho đối tượng người dùng

Trường	Loại	Thông tin chi tiết
`consent`	Chuỗi (base64 an toàn cho web)	Chuỗi về sự đồng ý của IAB. Chứa siêu dữ liệu về thông tin mà người dùng đã đồng ý cho phép thu thập và những nhà cung cấp được phép sử dụng thông tin đó. Giá trị này là một chuỗi nhị phân được mã hoá base64 an toàn cho web bằng cách sử dụng định dạng nhị phân tuỳ chỉnh.
`us_privacy`	Chuỗi	Nếu người dùng đã thấy thông tin tuân thủ CCPA hoặc các luật tương tự.
`consented_providers_settings`.`consented_providers`	Đối tượng bên ngoài (consented_providers_settings) bao bọc một mảng số nguyên bên trong (consented_providers).	Khi sự đồng ý theo GDPR được thu thập thông qua TCF, trường này sẽ liệt kê những nhà cung cấp công nghệ quảng cáo mà người dùng đã đồng ý và không tham gia TCF. Xem "Quy cách kỹ thuật về Sự đồng ý bổ sung của Google".
`eids`	Mảng gồm các đối tượng Mã nhận dạng mở rộng	Các phiên bản mã nhận dạng mở rộng do sàn giao dịch cung cấp.

Đối tượng mã nhận dạng mở rộng

Trường	Loại	Thông tin chi tiết
`source`	Chuỗi	Nhà cung cấp giá trị nhận dạng
`uids`	Mảng gồm các đối tượng UID của mã nhận dạng mở rộng	Giá trị nhận dạng thực tế

Đối tượng UID mã nhận dạng mở rộng

Trường	Loại	Thông tin chi tiết
`id`	Chuỗi	Chính giá trị nhận dạng đó.
`atype`	Số nguyên	Loại tác nhân người dùng được liên kết với mã nhận dạng này.

Đối tượng trong chuỗi cung ứng

Trường Loại Thông tin chi tiết

complete Số nguyên 0 (mặc định): Chuỗi cung ứng chưa hoàn chỉnh.
1: Chuỗi cung ứng hoàn chỉnh cho nhà xuất bản.

ver Chuỗi Bắt buộc.
Giá trị được định dạng là "major.minor", ví dụ: phiên bản 1.0 là chuỗi "1.0".

Trường	Loại	Thông tin chi tiết
`complete`	Số nguyên	`0` (mặc định): Chuỗi cung ứng chưa hoàn chỉnh. `1`: Chuỗi cung ứng hoàn chỉnh cho nhà xuất bản.
`ver`	Chuỗi	Bắt buộc. Giá trị được định dạng là "major.minor", ví dụ: phiên bản 1.0 là chuỗi "1.0".
`nodes`	Mảng nút chuỗi cung ứng	Bắt buộc. Trong một chuỗi cung ứng hoàn chỉnh, nút đầu tiên đại diện cho hệ thống quảng cáo ban đầu và mã nhận dạng người bán liên quan đến giao dịch, tức là chủ sở hữu của trang web, ứng dụng hoặc phương tiện khác. Trong một chuỗi cung ứng chưa hoàn chỉnh, đây là nút đầu tiên được biết. Nút cuối cùng đại diện cho thực thể gửi yêu cầu giá thầu này.

nodes

Mảng nút chuỗi cung ứng

Bắt buộc.

Trong một chuỗi cung ứng hoàn chỉnh, nút đầu tiên đại diện cho hệ thống quảng cáo ban đầu và mã nhận dạng người bán liên quan đến giao dịch, tức là chủ sở hữu của trang web, ứng dụng hoặc phương tiện khác.

Trong một chuỗi cung ứng chưa hoàn chỉnh, đây là nút đầu tiên được biết. Nút cuối cùng đại diện cho thực thể gửi yêu cầu giá thầu này.

Đối tượng nút trong chuỗi cung ứng

Trường	Loại	Thông tin chi tiết
`asi`	Chuỗi	Tên miền chuẩn hoá của hệ thống SSP, Exchange, Header Wrapper, v.v. mà các bên đặt giá thầu kết nối. Đây có thể là miền hoạt động của hệ thống (nếu khác với miền của công ty mẹ) để tạo điều kiện cho WHOIS và việc tra cứu IP ngược nhằm thiết lập quyền sở hữu rõ ràng đối với hệ thống được uỷ quyền. Đây phải là giá trị giống như giá trị dùng để xác định người bán trong tệp ads.txt (nếu có).
`sid`	Chuỗi	Giá trị nhận dạng được liên kết với tài khoản người bán hoặc người bán lại trong hệ thống quảng cáo. Giá trị này phải giống với giá trị được dùng trong các giao dịch (tức là yêu cầu giá thầu OpenRTB) trong trường do SSP/sàn giao dịch chỉ định. Thông thường, trong OpenRTB, đây là publisher.id. Đối với OpenDirect, giá trị này thường là mã tổ chức của nhà xuất bản. Chỉ được dài tối đa 64 ký tự.
`rid`	Chuỗi	RequestId OpenRTB của yêu cầu do người bán này phát hành.
`name`	Chuỗi	Tên của công ty (pháp nhân) được thanh toán cho khoảng không quảng cáo được giao dịch theo seller_id đã cho. Giá trị này là không bắt buộc và KHÔNG nên được đưa vào nếu có trong tệp sellers.json của hệ thống quảng cáo.
`domain`	Chuỗi	Tên miền doanh nghiệp của thực thể do nút này đại diện. Giá trị này là không bắt buộc và KHÔNG nên được đưa vào nếu có trong tệp sellers.json của hệ thống quảng cáo.
`hp`	Số nguyên	Cho biết liệu nút này có tham gia vào quy trình thanh toán cho khoảng không quảng cáo hay không. `1`: Hệ thống quảng cáo trong trường asi thanh toán cho người bán trong trường sid, người chịu trách nhiệm thanh toán cho nút trước đó trong chuỗi. `0`: Nút này không tham gia vào quy trình thanh toán cho khoảng không quảng cáo. Đối với phiên bản 1.0 của SupplyChain, thuộc tính này phải luôn là 1. Bạn phải đưa thông tin này vào một cách rõ ràng vì dự kiến các phiên bản trong tương lai của quy cách này sẽ giới thiệu các nút xử lý không thanh toán. Bên triển khai phải đảm bảo rằng họ hỗ trợ trường này và truyền trường này đi khi tạo các đối tượng SupplyChain trong yêu cầu giá thầu được gửi đến một hệ thống quảng cáo hạ nguồn.

Quy cách phản hồi giá thầu

Đối tượng BidResponse

Thuộc tính	Thông tin chi tiết về việc triển khai	Luôn vượt qua
id	Nếu xảy ra lỗi phân tích cú pháp, giá trị này có thể là "0" thay vì mã nhận dạng yêu cầu giá thầu.	Có
seatbid
bidid
cur	Nếu xảy ra lỗi phân tích cú pháp, thì lỗi này sẽ không được truyền. Đối với lưu lượng truy cập yêu cầu giá thầu hợp lệ, cur luôn được cung cấp.	Có
customdata
nbr	Thông tin này chỉ được đưa vào nếu có vấn đề với yêu cầu đặt giá thầu. Các giá trị có thể có bao gồm: `2`: Yêu cầu không hợp lệ `12`: Vi phạm uỷ quyền ads.txt `16`: SupplyChain không đầy đủ `17`: Nút SupplyChain bị chặn Lưu ý: Khi phát hiện một lỗi vi phạm cụ thể về (app-)ads.txt hoặc SupplyChain, một trong các mã 12, 16 hoặc 17 sẽ được điền vào một phần (1%) của các phản hồi. Mã 2 sẽ được điền cho tất cả các yêu cầu không hợp lệ khác. Những yêu cầu có NBR sẽ có dạng như sau: { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } }
ext	Nếu có vấn đề với yêu cầu đặt giá thầu, ext có thể chứa thông tin giúp chẩn đoán lỗi (nếu được hỗ trợ).

Các tiện ích được hỗ trợ cho đối tượng BidResponse

Thuộc tính	Thông tin chi tiết về việc triển khai
err	Nội dung mô tả dễ đọc về lỗi trong yêu cầu giá thầu. Các trường hợp phản hồi bao gồm: Nội dung yêu cầu giá thầu bị trống. Yêu cầu giá thầu không sử dụng đơn vị tiền tệ nằm trong danh sách cho phép của một sàn giao dịch cụ thể. Yêu cầu giá thầu không chứa loại mime được chấp nhận.
errHelp	Đường liên kết đến trang này.

Thuộc tính

Thông tin chi tiết về việc triển khai

err

Nội dung mô tả dễ đọc về lỗi trong yêu cầu giá thầu. Các trường hợp phản hồi bao gồm:

Nội dung yêu cầu giá thầu bị trống.
Yêu cầu giá thầu không sử dụng đơn vị tiền tệ nằm trong danh sách cho phép của một sàn giao dịch cụ thể.
Yêu cầu giá thầu không chứa loại mime được chấp nhận.

errHelp

Đường liên kết đến trang này.

Đối tượng Seatbid

Thuộc tính	Có thể làm	Thông tin chi tiết về việc triển khai	Luôn vượt qua
giá thầu			có
ghế			có
nhóm

Đối tượng giá thầu

Thuộc tính	Có thể làm	Thông tin chi tiết về việc triển khai	Luôn vượt qua
id			có
impid			có
price			có
nurl
burl
lurl
adm
adid
adomain
gói
iurl
cid			có
crid			có
chiến thuật
mèo
attr
api
giao thức
qagmediarating
language
mã thoả thuận
tuần
giờ
wratio
hratio
exp

Các phần mở rộng được hỗ trợ cho đối tượng giá thầu

Thuộc tính	Thông tin chi tiết về việc triển khai
`apis`	DV360 sẽ gửi `seatbid.bid.apis` nếu cả OMID và MRAID đều được hỗ trợ. DV360 sẽ đặt cả OMID_1 và MRAID làm một mảng số nguyên.

Các lựa chọn phân phát quảng cáo

Trong phần 4.3 của quy cách OpenRTB, có 2 lựa chọn phân phát:

Phần đánh dấu được phân phát trên thông báo chiến thắng
Mức chiết khấu được cung cấp trong giá thầu

DV360 hỗ trợ cả hai lựa chọn.

Đối với quảng cáo biểu ngữ, DV360 luôn trả về mã đánh dấu trong trường adm. Bạn không bắt buộc phải sử dụng mã đánh dấu được phân phát trên thông báo giành chiến thắng.
Đối với quảng cáo dạng video/âm thanh sử dụng giao thức VAST, DV360 hỗ trợ việc trả về VAST XML trong trường adm hoặc trong phản hồi của thông báo trúng thầu dựa trên các yêu cầu của đối tác trao đổi.

Hãy tham khảo quy cách OpenRTB để biết ưu và nhược điểm của hai lựa chọn này.

Các phương pháp hay nhất

Bạn nên sử dụng Mã đối tác của Display & Video 360 làm mã nhận dạng chỗ đặt quảng cáo. Bạn không nên sử dụng mã nhận dạng chỗ ngồi dành riêng cho sàn giao dịch.

Đảm bảo nhà xuất bản của bạn có tệp ads.txt hoặc các ứng dụng có tệp app-ads.txt được liên kết và họ liệt kê bạn trong tệp đó với tư cách là người bán hoặc người bán lại được uỷ quyền. Tìm hiểu thêm.

Ngoài ra, hãy đảm bảo thông tin nhất quán được truyền trong các yêu cầu giá thầu. Ví dụ: app.bundle phải nhất quán với thông tin thiết bị di động và app.storeurl.

TV kết nối Internet

Tuân thủ nguyên tắc về IFA OTT của IAB khi truyền device.ifa và device.lmt. Bạn cũng nên triển khai device.ext.ifa_type để tuân thủ các nguyên tắc. Tất cả các tính năng giới hạn tần suất và nhắm đến đối tượng mục tiêu trên CTV đều yêu cầu phải có một IFA.

Ngoài ra, hãy tuân thủ các nguyên tắc về mã nhận dạng do cửa hàng OTT/CTV của IAB chỉ định mới được xuất bản. Nguyên tắc này xác định cách truyền app.bundle cho các ứng dụng CTV, chủ yếu là sử dụng mã nhận dạng do cửa hàng ứng dụng xác định.

Đo lường bằng Active View

Active View là một công nghệ của Google dùng để đo lường xem một lượt hiển thị có thể xem được hay không và xem được trong bao lâu. Active View sử dụng OMID cho cả quảng cáo hiển thị và quảng cáo dạng video. Để bật tính năng đo lường bằng OMID, các nền tảng trao đổi phải thêm các trường sau vào yêu cầu OpenRTB để DV360 biết được khả năng hỗ trợ OMID của khách hàng.

Bắt buộc: Thêm Khung API (Video.api=7 cho OMSDK) vào các yêu cầu đặt giá thầu. Đây là yêu cầu bắt buộc để Chế độ xem đang kích hoạt có thể đo lường bằng OMID.
Được đề xuất: Bạn nên thêm omidpn và omidpv vào Source.Ext vì điều này sẽ ảnh hưởng đến cách báo cáo các chỉ số về khả năng xem trong DV360 cho khách hàng. Nếu tên đối tác OMID không có trong danh sách chứng nhận của IAB, thì theo yêu cầu của MRC, chúng tôi phải báo cáo các chỉ số về khả năng xem riêng biệt với các chỉ số được MRC chứng nhận. Tìm hiểu thêm.

Câu hỏi thường gặp

DV360 có hỗ trợ tiện ích tuỳ chỉnh của nền tảng trao đổi quảng cáo không?

Có. Ngoài các tiện ích được liệt kê trong quy cách này, Display & Video 360 cũng có thể hỗ trợ các tiện ích tuỳ chỉnh theo từng trường hợp. Bạn nên chỉ định và kiểm thử tiện ích tuỳ chỉnh trong thời gian tích hợp.

DV360 có hỗ trợ video có tặng thưởng không?

Có, hãy gửi cho chúng tôi phần mở rộng video có tặng thưởng.

Nhiều khoảng không quảng cáo của tôi đang hiển thị là nhân khẩu học không xác định, làm cách nào để cải thiện phạm vi tiếp cận theo nhân khẩu học?

Điền user.yob và user.gender vào các yêu cầu giá thầu gửi đến DV360 để tăng mức độ phù hợp.

DV360 có điểm cuối cho từng khu vực không?

Không, chúng tôi sử dụng một điểm cuối duy nhất trên toàn cầu và tự động định tuyến các yêu cầu đến trung tâm dữ liệu gần nhất, vì vậy, chúng tôi không thể cung cấp điểm cuối theo khu vực cụ thể.

Yêu cầu đối với yêu cầu từ máy chủ đến máy chủ (s2s) là gì?

Liên hệ để yêu cầu thêm vào danh sách cho phép của chúng tôi. Bạn phải chuyển tiếp User Agent của ứng dụng khách và đảm bảo rằng cookie bị vô hiệu hoá/bỏ qua trong phản hồi cho một lệnh tìm nạp VAST s2s.

DV360 có hỗ trợ OMID không?

Chúng tôi có thể đo lường khả năng xem bằng OMID miễn là bạn khai báo OMID là đã bật tại thời điểm yêu cầu đặt giá thầu. Thông tin chi tiết về vấn đề này được tóm tắt trên các trang 24-25.

Bạn hỗ trợ phiên bản Native nào? Bạn có yêu cầu nào về quảng cáo gốc không?

Chúng tôi chỉ hỗ trợ Native Ver1.2. Quy cách gốc.

DV360 có hỗ trợ các yêu cầu giá thầu được gửi dưới dạng GZIP không?

DV360 có thể nhận được các yêu cầu đặt giá thầu được nén bằng gzip và sẽ phản hồi bằng các phản hồi được nén bằng gzip nếu tiêu đề Accept-Encoding cho biết yêu cầu đó được hỗ trợ.

DV360 có hỗ trợ DBURL không?

Hiện tại thì không.

DV360 có hỗ trợ thông báo thắng/thua không?

Hiện tại thì không. Nếu bạn cho rằng chúng tôi nên hỗ trợ tính năng này, vui lòng liên hệ với chúng tôi để cung cấp thêm thông tin chi tiết.

DV360 có yêu cầu App.name để nhắm mục tiêu không?

Không, DV360 sử dụng App.name để tham chiếu nhưng không bắt buộc phải nhắm mục tiêu,App.bundle được dùng để nhắm mục tiêu.

DV360 có thể hỗ trợ nhiều kích thước quảng cáo được gửi trong một yêu cầu giá thầu không?

Có, chúng tôi sẽ xem xét tất cả các kích thước mẫu quảng cáo đủ điều kiện trong banner.format.

DV360 có hỗ trợ nhiều định dạng trong cùng một yêu cầu giá thầu không?

Chúng tôi có hạn chế về việc hỗ trợ các yêu cầu đặt giá thầu có nhiều định dạng, nhưng đang nỗ lực cải thiện. Chúng tôi hỗ trợ các định dạng hiển thị và video cho quảng cáo xen kẽ, nhưng hiện không hỗ trợ định dạng hiển thị và quảng cáo gốc. Nếu bạn đang gửi yêu cầu giá thầu nhiều định dạng, vui lòng liên hệ để yêu cầu kiểm thử.

DV360 có hỗ trợ các loại lượt hiển thị hỗn hợp trong cùng một yêu cầu không?

Hiện tại, chúng tôi chỉ hỗ trợ quảng cáo xen kẽ dạng video/biểu ngữ. Chúng tôi đang triển khai quảng cáo gốc/biểu ngữ và quảng cáo dạng video/biểu ngữ. Nếu có các tổ hợp khác, vui lòng liên hệ với nhóm của chúng tôi.

Mỗi vị trí có thể gửi nhiều giá thầu cho một hoặc nhiều cơ hội hiển thị như vậy trong cùng một yêu cầu không?

Có.

DV360 có giải pháp hoặc nhu cầu cụ thể nào liên quan đến việc giới hạn hoặc hiển thị cùng một nhà quảng cáo cho nhiều cơ hội hiển thị như vậy trong cùng một yêu cầu không?

DV360 thực thi quy định rằng mỗi nhà quảng cáo chỉ có thể đặt giá thầu tối đa một cơ hội hiển thị cho mỗi yêu cầu. Chúng tôi mong rằng các SSP sẽ nhóm các đối tượng imp một cách có ý nghĩa; ví dụ: tất cả trên cùng một trang, tất cả trong cùng một ứng dụng, v.v.

DV360 có hỗ trợ nhiều lượt hiển thị trong cùng một yêu cầu giá thầu không?

DV360 hiện hỗ trợ nhiều đối tượng âm thanh hiển thị. Tuy nhiên, chúng tôi sẽ cần kiểm thử/bật từng sàn giao dịch muốn sử dụng tính năng này. Hãy xem quy cách yêu cầu đặt giá thầu để biết thêm thông tin. Chúng tôi đang nỗ lực mở rộng tính năng này cho các định dạng khác:

{
id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38",
seatbid {
bid {
  id: "0",
  impid: "234232",
  price: 41.373926619828261,
  adid: "123",
  adm: "...",
  adomain: "xxx.com",
  cid: "0",
  crid: "123",
  dealid: "sample-deal-id-1",
  language: "xx",
},
bid {
  id: "1",
  impid: "234255",
  price: 2.34192037470726,
  adid: "234",
  adm: "...",
  adomain: "xyz.com",
  cid: "0",
  crid: "234",
  dealid: "sample-deal-id-2",
  language: "xx",
},
seat: "123456"
},
cur: "EUR"
}

Liên hệ với chúng tôi

Nếu bạn có thắc mắc hoặc gặp vấn đề, hãy liên hệ với nhóm hỗ trợ sàn giao dịch của chúng tôi.