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

Quảng cáo gốc

Quảng cáo gốc là quảng cáo được định dạng để phù hợp với nội dung và thiết kế trực quan xung quanh, làm tăng khả năng người dùng xem và nhấp vào quảng cáo hơn. Khoảng không quảng cáo gốc có trên ứng dụng di động cũng như trang web dành cho máy tính và thiết bị di động. Để biết thêm thông tin về quảng cáo gốc, hãy xem bài viết Tổng quan về quảng cáo gốc.

Quảng cáo gốc được hỗ trợ cho cả Authorized Buyers và tính năng Đặt giá thầu mở.

Dưới đây là quy trình làm việc cho quảng cáo gốc:

Google sẽ nhận được một lệnh gọi quảng cáo gốc. Lệnh gọi này chỉ định một hoặc cả hai mẫu quảng cáo gốc sau đây, mỗi mẫu chỉ định các trường gốc ưu tiên.
Google gửi cho người mua một yêu cầu giá thầu RTB chứa danh sách các trường đang được yêu cầu.
Những người mua quan tâm sẽ trả lời bằng các trường được yêu cầu.
Google chạy một phiên đấu giá để chọn giá thầu chiến thắng và gửi các thành phần mẫu quảng cáo do người mua cung cấp cho nhà xuất bản.
Nhà xuất bản tập hợp các thành phần này thành một quảng cáo gốc và tạo kiểu cho các thành phần đó sao cho phù hợp với thiết kế của trang web.

Định dạng thư

Google hỗ trợ quy cách OpenRTB ở cả JSON và Protobuf.

Đối với quảng cáo gốc OpenRTB Protobuf, các trường sau đây khác với quy cách:

JSON	Loại JSON	Protobuf	Loại Protobuf
`BidRequest.imp[].native.request`	`string`	`BidRequest.imp[].native.request_native`	`NativeRequest`
`BidResponse.seatbid[].bid[].adm`	`string`	`BidResponse.seatbid[].bid[].adm_native`	`NativeResponse`

Các trường OpenRTB Protobuf là thông điệp Protobuf thay vì chuỗi.

Nếu bạn sử dụng phương thức triển khai OpenRTB Protobuf, thì điểm cuối của bạn sẽ nhận được các yêu cầu giá thầu chứa BidRequest.imp.native.request_native thay vì BidRequest.imp.native.request. Ngoài ra, điểm cuối của bạn phải trả về các phản hồi giá thầu điền sẵn BidResponse.seatbid.bid.adm_native thay vì BidResponse.seatbid.bid.adm, nếu không, điểm cuối đó sẽ bị lọc ra khỏi phiên đấu giá.

Nếu sử dụng SDK của bên mua để hiển thị quảng cáo gốc, bạn phải thêm hình ảnh type vào declared_ad khi gửi mẫu quảng cáo để xem xét.

Mẫu quảng cáo gốc

Mẫu quảng cáo gốc mô tả các thành phần của quảng cáo gốc và xác định nội dung cũng như cấu trúc của NativeRequest của OpenRTB hoặc NativeAdTemplate của giao thức Google RTB không còn được dùng nữa trong yêu cầu giá thầu. Google hỗ trợ hai mẫu quảng cáo gốc phổ biến nhất cho quảng cáo gốc không phải dạng video và quảng cáo gốc dạng video:

Mẫu quảng cáo cài đặt ứng dụng – Quảng bá và thúc đẩy lượt cài đặt ứng dụng di động.
Mẫu quảng cáo nội dung – Kết hợp văn bản và hình ảnh chung hơn cho quảng cáo thương hiệu hoặc quảng cáo trên web.
Mẫu quảng cáo cài đặt ứng dụng dạng video
Mẫu quảng cáo nội dung video

Có các mẫu khác và có thể có một bộ yêu cầu khác đối với các trường, phương diện và kích thước.

Mẫu quảng cáo cài đặt ứng dụng

Các trường bắt buộc và nên dùng

Các bảng sau đây cho thấy các trường được gắn nhãn Bắt buộc hoặc Nên dùng. Các quy tắc sau được áp dụng:

Bên đặt giá thầu phải điền vào các trường được đánh dấu là Bắt buộc.
Bên đặt giá thầu không bắt buộc phải cung cấp các trường được đánh dấu là Được đề xuất và nhà xuất bản có thể hiển thị hoặc không hiển thị các trường này nếu được cung cấp (ví dụ: điểm xếp hạng dạng ngôi sao).
Lời kêu gọi hành động (CTA) luôn được đánh dấu là Nên dùng vì hệ thống sẽ chỉ định một lời kêu gọi hành động mặc định nếu bên đặt giá thầu không gửi lời kêu gọi hành động. Tuy nhiên, lời kêu gọi hành động sẽ luôn hiển thị nếu được gửi.

Bảng sau đây liệt kê các trường của mẫu quảng cáo cài đặt ứng dụng. Ứng dụng di động sử dụng các trường này để tạo quảng cáo cài đặt ứng dụng gốc.

Trường	Mô tả	Bắt buộc hay Nên dùng?	Luôn hiển thị?	Kích thước hình ảnh đề xuất/số ký tự tối đa	Ví dụ:
Dòng tiêu đề	Tên ứng dụng	Bắt buộc	Có	25 ký tự	Flood-It!
Hình ảnh	Ảnh chụp màn hình ứng dụng hoặc một hình ảnh có liên quan khác	Bắt buộc	Không	1.200px x 627px hoặc 600px x 600px tuỳ thuộc vào tỷ lệ khung hình mà nhà xuất bản yêu cầu.	<Ảnh chụp màn hình trò chơi Flood-It!>
Nội dung	Văn bản chính của ứng dụng	Bắt buộc	Không	90 ký tự	Đơn giản đến mức đánh lừa + thử thách đến mức hấp dẫn = một trò chơi gây nghiện một cách thú vị!
Biểu tượng ứng dụng	Biểu tượng ứng dụng	Bắt buộc	Không	128 x 128 px	<Biểu tượng ứng dụng Flood-it!>
Lời kêu gọi hành động	Hành động ưu tiên của người dùng	Đề xuất	Có	15 ký tự	Cài đặt
Điểm xếp hạng theo sao	Số lượng sao (0 – 5) thể hiện điểm xếp hạng của ứng dụng trong cửa hàng ứng dụng	Đề xuất	Không	0 – 5	4,5
Giá	Chi phí của ứng dụng	Đề xuất	Không	15 ký tự	Miễn phí

Lưu ý về độ dài văn bản

Nếu người mua gửi một thành phần văn bản (ví dụ: văn bản nội dung) dài hơn số ký tự tối đa được đề xuất, thì Google hoặc nhà xuất bản có thể cắt bớt và đánh dấu văn bản đó. Xin lưu ý rằng giới hạn cắt ngắn là một nửa kích thước đối với tiếng Trung, tiếng Nhật và tiếng Hàn. Ví dụ: giới hạn tiêu đề là 90 cho tiếng Anh và 45 cho tiếng Trung Quốc.

Lưu ý về kích thước hình ảnh

Nhà xuất bản được phép:

Cắt hình ảnh chính theo chiều đối xứng đến tối đa 20% theo một chiều (chiều cao hoặc chiều rộng).
Điều chỉnh tỷ lệ hình ảnh mà không thay đổi tỷ lệ khung hình.
Các hình ảnh có tỷ lệ khung hình khác biệt đáng kể so với tỷ lệ khung hình ngụ ý qua chiều cao và chiều rộng có thể bị lọc.

Mẫu quảng cáo nội dung

Bảng sau đây liệt kê các trường của mẫu quảng cáo nội dung. Nhà xuất bản sử dụng các trường này để tạo quảng cáo nội dung gốc.

Trường	Mô tả	Bắt buộc hay Nên dùng?	Luôn hiển thị?	Kích thước hình ảnh đề xuất/số ký tự tối đa *	Ví dụ:
Dòng tiêu đề	Tiêu đề quảng cáo	Bắt buộc	Có	25 ký tự	Lãi suất thế chấp thấp nhất
Hình ảnh	Hình ảnh chính của quảng cáo	Bắt buộc	Không	1.200px x 627px hoặc 600px x 600px tuỳ thuộc vào tỷ lệ khung hình mà nhà xuất bản yêu cầu.	<Hình ảnh chính của quảng cáo>
Nội dung	Nội dung quảng cáo	Bắt buộc	Không	90 ký tự	Nhà của bạn ở Brooklyn – rẻ hơn và nhanh hơn bạn nghĩ!
Biểu trưng	Biểu trưng của nhà quảng cáo hoặc một hình ảnh nhỏ khác có liên quan	Đề xuất	Không	128 x 128 px	<Biểu trưng của NY Mortgage Inc.>
Lời kêu gọi hành động	Hành động ưu tiên của người dùng	Đề xuất	Không	15 ký tự	Nhận bản báo giá
Nhà quảng cáo	Văn bản xác định nhà quảng cáo hoặc thương hiệu	Bắt buộc	Không	25 ký tự	NY Mortgage Inc.

Mẫu quảng cáo cài đặt ứng dụng dạng video

Trường	Mô tả	Bắt buộc hay Nên dùng?	Luôn hiển thị?	Kích thước hình ảnh đề xuất/số ký tự tối đa *	Ví dụ:
Video	Phản hồi VAST video chứa tất cả các thành phần cần thiết để phát lại quảng cáo dạng video.	Bắt buộc	Không	-	URL đến tệp XML VAST chứa Flood-It! Quảng cáo dạng video
Dòng tiêu đề	Tên ứng dụng	Bắt buộc	Có	25 ký tự	Flood-It!
Hình ảnh	Hình ảnh (hình thu nhỏ) hiển thị trong trình phát trước khi quảng cáo dạng video được nhấp vào hoặc trong khi quảng cáo đó đang tải.	Bắt buộc	Không	Phải khớp với tỷ lệ khung hình của video (ví dụ: 1280x720 cho video 16x9, 4x3 cho video 640x480).	Ảnh chụp màn hình trò chơi Flood-It! Hoặc trong video
Nội dung	Văn bản chính của ứng dụng	Bắt buộc	Không	90 ký tự	Đơn giản đến mức đánh lừa + thử thách đến mức hấp dẫn = một trò chơi gây nghiện một cách thú vị!
Biểu tượng ứng dụng	Biểu tượng ứng dụng	Bắt buộc	Không	128 x 128 px	Biểu tượng ứng dụng Flood-it!
Lời kêu gọi hành động	Hành động ưu tiên của người dùng	Bắt buộc	Có	15 ký tự	Cài đặt
Điểm xếp hạng theo sao	Số lượng sao (0 – 5) thể hiện điểm xếp hạng của ứng dụng trong cửa hàng ứng dụng	Đề xuất	Không	0 – 5	4,5
Giá	Chi phí của ứng dụng	Đề xuất	Không	15 ký tự	Miễn phí

Quy định hạn chế

Video: Tất cả video phải ở dạng URL VAST hoặc Thẻ VAST. Bạn không thể chỉ định tệp video thô như WebM, MP4, v.v.
Độ dài văn bản: Nếu người mua chỉ định một thành phần văn bản như body trong phản hồi, thì thành phần đó có thể bị Google hoặc nhà xuất bản cắt bớt và đánh dấu bằng dấu ba chấm. Xin lưu ý rằng giới hạn cắt ngắn là một nửa kích thước trong tiếng Trung, tiếng Nhật và tiếng Hàn. Ví dụ: giới hạn tiêu đề là 90 ký tự đối với tiếng Anh và 45 ký tự đối với tiếng Trung Quốc.
Kích thước hình ảnh: Nhà xuất bản được phép:
- Cắt hình ảnh chính theo chiều đối xứng đến tối đa 20% theo một chiều (chiều cao hoặc chiều rộng).
- Điều chỉnh tỷ lệ hình ảnh mà không thay đổi tỷ lệ khung hình.

Ví dụ về quảng cáo cài đặt ứng dụng

Mẫu quảng cáo nội dung video

Trường	Mô tả	Bắt buộc hay Nên dùng?	Luôn hiển thị?	Kích thước hình ảnh đề xuất/số ký tự tối đa *	Ví dụ:
Video	Phản hồi VAST video chứa tất cả các thành phần cần thiết để phát lại quảng cáo dạng video.	Bắt buộc	Có	-	URL đến tệp XML VAST chứa Flood-It! Quảng cáo dạng video
Dòng tiêu đề	Tiêu đề quảng cáo	Bắt buộc	Có	25 ký tự	Lãi suất thế chấp thấp nhất
Hình ảnh	Hình ảnh (hình thu nhỏ) hiển thị trong trình phát trước khi quảng cáo dạng video được nhấp vào hoặc trong khi quảng cáo đó đang tải.	Bắt buộc	Không	Phải khớp với tỷ lệ khung hình của video (ví dụ: 1280x720 cho video 16x9, 4x3 cho video 640x480).	Ảnh chụp màn hình video
Nội dung	Nội dung quảng cáo	Bắt buộc	Không	90 ký tự	Nhà của bạn ở Brooklyn – rẻ hơn và nhanh hơn bạn nghĩ!
Biểu trưng	Biểu trưng của nhà quảng cáo hoặc một hình ảnh nhỏ khác có liên quan	Đề xuất	Không	128 x 128 px	Biểu trưng của NY Mortgage Inc.
Lời kêu gọi hành động	Hành động ưu tiên của người dùng	Bắt buộc	Không	15 ký tự	Nhận bản báo giá
Nhà quảng cáo	Văn bản xác định nhà quảng cáo hoặc thương hiệu	Bắt buộc	Không	25 ký tự	NY Mortgage Inc.

Trường meta

Tất cả mẫu quảng cáo được hỗ trợ đều dùng chung các trường meta sau:

Giao thức RTB của Google	Tương đương OpenRTB	Mô tả
`NativeAd.click_link_url`	`Link.url`	URL mà trình duyệt sẽ gọi khi người dùng nhấp vào quảng cáo. Có thể là bước đầu tiên của một chuỗi chuyển hướng cuối cùng sẽ dẫn đến trang đích. Đối với quảng cáo gốc, bạn nên sử dụng `click_link_url` làm trường để đặt đích đến mà người dùng sẽ truy cập cuối cùng. Bạn bắt buộc phải sử dụng trường này trong trường hợp trang đích động.
`Ad.click_through_url`	`Bid.adomain`	Phải được đặt nếu bên đặt giá thầu có ý định đặt giá thầu. Đây là tập hợp các URL đích cho đoạn mã, bao gồm cả URL mà người dùng sẽ truy cập nếu họ nhấp vào quảng cáo hiển thị và mọi URL hiển thị trong quảng cáo đã hiển thị. Đừng đưa các lệnh gọi trung gian đến máy chủ quảng cáo không liên quan đến trang đích cuối cùng. BidResponse trả về một đoạn mã hoặc quảng cáo dạng video nhưng khai báo không có `click_through_url` sẽ bị loại bỏ. Chỉ đặt trường này nếu bạn đặt `html_snippet`, `video_url` hoặc `native_ad`. Dữ liệu này được dùng làm nội dung khai báo URL đích, ví dụ: để lọc sau các URL bị nhà xuất bản chặn hoặc phân loại quảng cáo. Tham khảo `NativeAd.click_link_url` khi sử dụng quảng cáo gốc. Đối với quảng cáo không phải quảng cáo gốc, URL này không được dùng để theo dõi lượt nhấp hoặc bất kỳ chức năng quảng cáo nào khác; URL này chỉ được dùng để khai báo URL đích. Đối với quảng cáo gốc, nếu bạn không đặt `NativeAd.click_link_url`, thì giá trị đầu tiên của `click_through_url` sẽ được dùng để chuyển hướng người dùng đến trang đích. Ngoài ra, tất cả giá trị đều được dùng làm nội dung khai báo URL đích (tương tự như trường hợp không phải mã gốc).
`NativeAd.click_tracking_urls`	`Link.clicktrackers`	Không bắt buộc. URL bổ sung cho phép nhà quảng cáo theo dõi số lượt nhấp của người dùng vào quảng cáo.
`Ad.ad_choices_destination_url`	`BidExt.ad_choices_destination_url`	Liên kết đến trang lựa chọn ưu tiên về quảng cáo hoặc trang chọn không nhận quảng cáo. Nếu có, biểu tượng AdChoices tiêu chuẩn sẽ được thêm vào mẫu quảng cáo gốc và liên kết với URL này. Tính năng này được hỗ trợ cho quảng cáo gốc nhưng không phải là một phần của thông báo gốc trong phản hồi giá thầu.
`Ad.impression_tracking_url`	`NativeResponse.imptrackers`	Bạn nên theo dõi lượt hiển thị gốc bằng `impression_tracking_url` trong giao thức đặt giá thầu theo thời gian thực của Authorized Buyers hoặc trình theo dõi lượt hiển thị gốc trong OpenRTB.

Các trường bắt buộc và nên dùng trong giao thức RTB của Google

required_fields và recommended_fields do nhà xuất bản chỉ định. Chúng tôi sẽ hướng dẫn cách dịch các trường bit này để xác định xem một trường là bắt buộc hay đề xuất.

Trường bit sử dụng từng bit của một giá trị nhị phân để lưu trữ câu lệnh đúng hoặc sai, tương đương với việc gửi nhiều tín hiệu boolean như is_logo_required hoặc is_header_required, nhưng tất cả đều được đóng gói với nhau.

Lưu ý: Trong OpenRTB, trường BidRequest.imp.native.request_native.assets.required xác định liệu một trường nhất định là bắt buộc hay được đề xuất.

Ví dụ:

Trong ví dụ này, chúng ta sẽ sử dụng giá trị required_fields là 1085.

Trước tiên, hãy tìm giá trị nhị phân tương đương: 10000111101

Sau khi có giá trị nhị phân, bạn có thể kiểm tra các bit để xem một trường có bắt buộc (1) hay không bắt buộc (0).

Bảng sau đây liên kết các trường với vị trí của các trường đó trong giá trị nhị phân. Đọc tệp nhị phân từ phải sang trái, trong đó 1 bit tương ứng với vị trí ngoài cùng bên phải trong giá trị nhị phân.

Trường	Vị trí giá trị nhị phân (từ phải sang trái)
`HEADLINE`	`1`
`BODY`	`2`
`CALL_TO_ACTION`	`4`
`ADVERTISER`	`8`
`IMAGE`	`16`
`LOGO`	`32`
`APP_ICON`	`64`
`STAR_RATING`	`128`
`PRICE`	`256`
`STORE`	`512`
`VIDEO`	`1024`

Xem xét giá trị nhị phân mẫu 10000111101, 1 bit (bên phải cùng) là 1, biểu thị một giá trị bắt buộc. Theo bảng, 1 bit tương ứng với HEADLINE.

2 bit (giá trị thứ hai từ bên phải) là 0, cho biết không bắt buộc. 2 bit tương ứng với BODY.

Dưới đây là tất cả các trường bắt buộc được diễn giải trong ví dụ của chúng tôi:

Giá trị	Mô tả	Bắt buộc?
`1`	`VIDEO`	Có
`0`	`STORE`	Không
`0`	`PRICE`	Không
`0`	`STAR_RATING`	Không
`0`	`APP_ICON`	Không
`1`	`LOGO`	Có
`1`	`IMAGE`	Có
`1`	`ADVERTISER`	Có
`1`	`CALL_TO_ACTION`	Có
`0`	`BODY`	Không
`1`	`HEADLINE`	Có

Nội dung thể hiện mẫu quảng cáo gốc trong yêu cầu giá thầu

Khi nhận được yêu cầu giá thầu chứa khoảng không quảng cáo gốc, yêu cầu đó sẽ chứa mẫu quảng cáo gốc ở nhiều dạng tuỳ thuộc vào giao thức được sử dụng. Bạn nên sử dụng OpenRTB vì giao thức Google không còn được dùng nữa.

Trong OpenRTB, mẫu quảng cáo gốc được mô tả bằng thông báo NativeRequest. Trong giao thức Google RTB, mẫu này được mô tả bằng NativeAdTemplate. Những thông báo này cung cấp các thông tin chi tiết sau đây về khoảng không quảng cáo gốc:

Các trường bắt buộc hoặc nên dùng.
Kích thước cho hình ảnh, biểu trưng và biểu tượng ứng dụng.
Thông số kỹ thuật cho kiểu hiển thị quảng cáo.

Lưu ý: Đối với trường style_layout_type, PIXEL cho biết đơn vị gốc có kích thước cố định, còn FLUID có nghĩa là đơn vị này sẽ điều chỉnh theo tỷ lệ để lấp đầy chiều rộng của cột bao bọc và điều chỉnh chiều cao để giữ nguyên tỷ lệ khung hình. Khi bạn chỉ định FLUID, chiều cao và chiều rộng có thể là 1x1.

Mã thành phần OpenRTB

OpenRTB truyền một mảng thành phần trong yêu cầu giá thầu mô tả cấu trúc của quảng cáo gốc mà bạn nên trả về trong phản hồi. Mỗi thành phần trong yêu cầu sẽ có một mã nhận dạng phải được chỉ định cho thành phần tương ứng trong phản hồi. Để biết ví dụ về cách các mã nhận dạng này tương ứng giữa yêu cầu và phản hồi, hãy xem mẫu yêu cầu giá thầu gốc và mẫu phản hồi giá thầu gốc.

Nội dung thể hiện quảng cáo gốc trong phản hồi giá thầu

Khi đặt giá thầu trên khoảng không quảng cáo gốc, người mua phải điền vào các trường bắt buộc được xác định trong yêu cầu giá thầu. Trong OpenRTB, bạn có thể thực hiện việc này bằng BidResponse.seatbid.bid.adm_native khi sử dụng Protobuf hoặc BidResponse.seatbid.bid.adm cho JSON. Đối với giao thức Google không dùng nữa, bạn có thể thực hiện việc này bằng trường BidResponse.ad.native_ad.

Ví dụ về yêu cầu giá thầu

Lưu ý: Để hiểu những thông tin bắt buộc hoặc không bắt buộc trong phản hồi, hãy xem mẫu quảng cáo gốc trong yêu cầu giá thầu. Đối với OpenRTB, bạn có thể tìm thấy thông tin này trong BidRequest.imp.native. Đối với giao thức Google không dùng nữa, bạn có thể tìm thấy giao thức này trong BidRequest.adslot.native_ad_template.

Yêu cầu giá thầu không phải video

OpenRTB ProtobufJSON OpenRTBGoogle

Ví dụ minh họa

Yêu cầu tuần tự

id: "l6210s8bS8Uc726V81B821"
imp {
  id: "1"
  tagid: "3019814809"
  bidfloor: 0.06
  bidfloorcur: "USD"
  secure: true
  native {
    ver: "1.2"
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 25
        }
      }
      assets {
        id: 2
        required: true
        data {
          type: DESC
          len: 90
        }
      }
      assets {
        id: 3
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 4
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      assets {
        id: 5
        img {
          type: LOGO
          wmin: 100
          hmin: 100
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        style_id: 497439
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0006697923527099192
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.05
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 50577321529
    dfp_ad_unit_code: "/3711494/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    open_bidding {
      is_open_bidding: true
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "FR"
    }
  }
  content {
    livestream: false
    language: "fr"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: ""
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "FRA"
    region: "FR-C"
    zip: "63120"
    type: IP
    utcoffset: 120
    accuracy: 6948
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9112278
    }
  }
  ipv6: "2a01:cb14:8183::"
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    browsers {
      brand: "Chromium"
      version: "130"
      version: "0"
    }
    browsers {
      brand: "Microsoft Edge"
      version: "130"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "15"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1712
      consented_providers: 2316
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 350
cur: "USD"
regs {
  gpp: "OMITTED"
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
}

Ví dụ minh họa

{
  "id": "l6210s8bS8Uc726V81B821",
  "imp": [
    {
      "id": "1",
      "tagid": "3019814809",
      "bidfloor": 0.06,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0006697923527099192,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.05,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "50577321529"
        ],
        "dfp_ad_unit_code": "/3711494/google/test",
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test Data"
          }
        ],
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "open_bidding": {
          "is_open_bidding": 1
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 2
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "FR"
      }
    },
    "content": {
      "livestream": 0,
      "language": "fr"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED",
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "FRA",
      "region": "FR-C",
      "zip": "63120",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 6948,
      "ext": {
        "geo_criteria_id": 9112278
      }
    },
    "ipv6": "2a01:cb14:8183::",
    "os": "Windows",
    "devicetype": 2,
    "lmt": 0,
    "pxratio": 1.0,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "130",
            "0"
          ]
        },
        {
          "brand": "Microsoft Edge",
          "version": [
            "130",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Windows",
        "version": [
          "15",
          "0"
        ]
      },
      "mobile": 0,
      "architecture": "x86",
      "bitness": "64",
      "source": 2
    }
  },
  "user": {
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1712",
          "2316"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "eids": [
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "USD"
  ],
  "regs": {
    "gpp": "OMITTED",
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v",
    "fcap_scope": 1
  }
}

Ví dụ minh họa

Yêu cầu tuần tự

id: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "it"
adslot {
  id: 1
  excluded_attribute: 14
  excluded_attribute: 32
  allowed_vendor_type: 42
  allowed_vendor_type: 144
  excluded_sensitive_category: 36
  excluded_sensitive_category: 19
  matching_ad_data {
    billing_id: 74792558829
    billing_id: 11204117851
    minimum_cpm_micros: 390000
  }
  matching_ad_data {
    billing_id: 44428418146
    billing_id: 91112044263
    minimum_cpm_micros: 110000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 10366
  excluded_product_category: 11504
  ad_block_key: 8767661977
  publisher_settings_list_id: 7807286827624818876
  publisher_settings_list_id: 8186380472781289268
  allowed_restricted_category: 32
  allowed_restricted_category: 33
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 6
  allowed_restricted_category_for_deals: 32
  allowed_restricted_category_for_deals: 33
  click_through_rate: 0.0010397299
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  secure_signals {
    data: "Test Data: bw44G12BFZ"
    source: "OMITTED"
  }
  consented_providers_settings {
    tcf_consent_string: "OMITTED"
    additional_consent_string: "OMITTED"
  }
  regs_gdpr: true
  native_ad_template {
    required_fields: 17
    recommended_fields: 0
    headline_max_safe_length: 90
    body_max_safe_length: 90
    call_to_action_max_safe_length: 15
    advertiser_max_safe_length: 25
    image_width: 1200
    image_height: 627
    style_id: 749853
    style_layout_type: FLUID
    style_height: 1
    style_width: 1
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  supported_auction_environment: SERVER_SIDE_AUCTION
}
is_test: false
timezone_offset: 120
geo_criteria_id: 1008463
bid_response_feedback {
  request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301"
  creative_status_code: 1
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 220000
  feedback_type: BID_FEEDBACK
}
bid_response_feedback {
  request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G"
  creative_status_code: 80
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 3450000
  feedback_type: BID_FEEDBACK
}
publisher_type: PUBLISHER_OWNED_AND_OPERATED
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  screen_pixel_ratio_millis: 1000
  limit_ad_tracking: false
}
publisher_country: "IT"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 350
google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "ITA"
  region: "IT-MI"
  city: "Milan"
  utcoffset: 120
  accuracy: 6821
}
user_agent_data {
  platform {
    brand: "Windows"
    version: "10"
    version: "0"
  }
  mobile: false
  architecture: "x86"
  browsers {
    brand: "Chromium"
    version: "128"
    version: "0"
  }
  browsers {
    brand: "Not;A=Brand"
    version: "24"
    version: "0"
  }
  bitness: "64"
  source: CLIENT_HINTS_HIGH_ENTROPY
}
page_visibility: VISIBILITY_STATE_VISIBLE
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "testdomain.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

Yêu cầu giá thầu cho video

{
  id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123",
  ip: "\0338\355",
  google_user_id: "CAESEJ1ur2l94_8ruuu",
  cookie_version: 1,
  cookie_age_seconds: 5184000,
  hosted_match_data: "W9ABDAAAAGR67nl0",
  user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36",
  publisher_country: "IN",
  geo_criteria_id: 1007796,
  timezone_offset: 330,
  publisher_id: "pub-2230723027927371",
  seller_network_id: 989,
  url: "https://m.example.com",
  detected_language: [en],
  google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q",
  auction_type: "SECOND_PRICE",
  device: {
    device_type: "HIGHEND_PHONE",
    platform: "android",
    brand: "coolpad",
    model: "cp8298_i00",
    os_version: {
      major: 5,
      minor: 1
    },
    carrier_id: 70210,
    screen_width: 360,
    screen_height: 640,
    screen_pixel_ratio_millis: 2000
  },
  mobile: {
    is_app: false,
    is_mobile_web_optimized: true,
    DEPRECATED_platform: "android",
    DEPRECATED_mobile_device_type: "HIGHEND_PHONE",
    DEPRECATED_brand: "coolpad",
    DEPRECATED_model: "cp8298_i00",
    DEPRECATED_os_version: {
      os_version_major: 5,
      os_version_minor: 1
    },
    DEPRECATED_screen_width: 360,
    DEPRECATED_screen_height: 640,
    DEPRECATED_carrier_id: 70210,
    DEPRECATED_device_pixel_ratio_millis: 2000
  },
  publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED",
  adslot: [{
    id: 1,
    ad_block_key: 2882274820,
    width:   [300,250],
    height:   [250,250],
    excluded_attribute:   [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22],
    allowed_vendor_type:   [42,144,575,698,704,743,776,785,793,797,808,828,832,885],
    excluded_sensitive_category:   [36,27,19,4,23,30,10,3,31,5,8,37,18],
    excluded_product_category:   [10031,11669,13423,13525,13566,13589,13612,13740],
    excluded_creatives:   [{
      buyer_creative_id: "1234567.1234567890-ssl"
    }],
    matching_ad_data:   [{
      billing_id:     [6629616415,51386650457],
      minimum_cpm_micros: 1380000,
      direct_deal:     [{
        direct_deal_id: 410401,
        fixed_cpm_micros: 1360000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      },{
        direct_deal_id: 240644,
        fixed_cpm_micros: 1500000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      }]
    },{
      billing_id:     [1234567890],
      minimum_cpm_micros: 1380000
    }],
    publisher_settings_list_id:   [12109930661871909476,11138951146123409010],
    slot_visibility: "BELOW_THE_FOLD",
    viewability: 30,
    click_through_rate: 0.0010072842,
    iframing_state: "UNKNOWN_IFRAME_STATE",
    native_ad_template:   [{
      required_fields: 1065,
      recommended_fields: 4,
      headline_max_safe_length: 25,
      body_max_safe_length: 90,
      call_to_action_max_safe_length: 15,
      advertiser_max_safe_length: 25,
      logo_width: 100,
      logo_height: 100,
      style_id: 199892,
      style_height: 250,
      style_width: 300
    }],
    sticky_settings: {

    },
    renderer: "GOOGLE",
    is_amp_page: "DIALECT_HTML",
    amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED",
    allowed_ad_types:   [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE],
    session_depth: 1,
    internal_data: {

    }
  }],
  response_deadline_ms: 122,
  is_test: false
}

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

Phản hồi giá thầu không phải video

OpenRTB ProtobufJSON OpenRTBGoogle

Ví dụ minh họa

Phản hồi tuần tự

id: "22i22S9494PQl819H7Ld5K"
seatbid {
  bid {
    id: "2GTnPXOn76gg1C6574T"
    impid: "1"
    price: 0.24
    adid: "test_creative_id_713312"
    adomain: "google.com"
    crid: "test_creative_id_713312"
    exp: 300
    language: "xx"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 1200
          h: 1200
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 50577321529
      third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
    }
  }
  seat: "5249:9218:332606"
}
cur: "USD"

Ví dụ minh họa

{
  "id": "22i22S9494PQl819H7Ld5K",
  "seatbid": [
    {
      "bid": [
        {
          "id": "2GTnPXOn76gg1C6574T",
          "impid": "1",
          "price": 0.24,
          "adid": "test_creative_id_713312",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_713312",
          "exp": 300,
          "language": "xx",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "50577321529",
            "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"
        }
      ],
      "seat": "5249:9218:332606"
    }
  ],
  "cur": "USD"
}

Ví dụ minh họa

Phản hồi tuần tự

ad {
  adslot {
    id: 1
    max_cpm_micros: 110734
    min_cpm_micros: 0
    billing_id: 74792558829
    deal_id: 0
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_907643"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254 225"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
  dsa_transparency {
    buyer_render: true
  }
}
processing_time_ms: 27

Phản hồi giá thầu bằng video

bid_response {
  ad {
    ...
    click_through_url: "https://www.exampleDomain.com"
    impression_tracking_url: "https://my_impression_tracking_url.com/"
    ad_choices_destination_url: "https://my_ad_choices_destination_url.com/"
    ...
    native_ad {
      headline: "Lowest mortgage rates"
      video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast"
      call_to_action: "Get a quote"
      advertiser: "NY Mortgage Inc."
      image {
        url: "https://www.example.net/mypromoimage.png"
        width: 1200
        height: 700
      }
      logo {
        url: "https://www.example.net/mylogo.png"
        width: 200
        height: 200
      }
      click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1"
      click_tracking_urls: "https://my_click_tracking_url.com/"
    }
  }
}