Quá trình tương tác đặt giá thầu theo thời gian thực bắt đầu khi Google gửi yêu cầu giá thầu đến ứng dụng của bạn. Hướng dẫn này giải thích cách lập trình ứng dụng để xử lý yêu cầu giá thầu.
Thận trọng: Giao thức RTB của Google không còn được dùng nữa. Các ví dụ trong hướng dẫn này sẽ sử dụng cách triển khai OpenRTB Protobuf của Google, trừ phi có quy định khác.
Phân tích cú pháp yêu cầu Protobuf
Google gửi yêu cầu giá thầu dưới dạng vùng đệm giao thức được chuyển đổi tuần tự đính kèm dưới dạng tải trọng tệp nhị phân của yêu cầu POST HTTP. Content-Type được đặt thành application/octet-stream. Hãy xem Ví dụ về yêu cầu giá thầu để biết ví dụ.
Bạn phải phân tích cú pháp yêu cầu này thành một thực thể của thông báo BidRequest. Tuỳ thuộc vào giao thức bạn chọn, BidRequest được xác định trong openrtb.proto hoặc realtime-bidding.proto không dùng nữa. Bạn có thể lấy dữ liệu này từ trang dữ liệu tham chiếu . Bạn có thể phân tích cú pháp thông báo bằng cách sử dụng phương thức ParseFromString() trong lớp được tạo cho BidRequest. Ví dụ: mã C++ sau đây phân tích cú pháp một yêu cầu được cung cấp tải trọng POST trong một chuỗi:
string post_payload = /* the payload from the POST request */ ;
BidRequest bid_request ;
if ( bid_request . ParseFromString ( post_payload )) {
// Process the request .
} Sau khi có BidRequest, bạn có thể xử lý tệp này dưới dạng một đối tượng, trích xuất và diễn giải các trường mà bạn cần. Ví dụ: trong C++, việc lặp lại các giao dịch trong "BidRequest" OpenRTB có thể có dạng như sau:
for ( const BidRequest :: Imp :: Pmp :: Deal & deal : pmp . deals ()) {
DoSomething ( deal . id (), deal . wseat ());
} Mã thanh toán
Bạn sẽ nhận được yêu cầu giá thầu khi khoảng không quảng cáo của nhà xuất bản được nhắm mục tiêu bằng một hoặc nhiều
cấu hình nhắm mục tiêu trước . BidRequest.imp.ext.billing_id sẽ được điền sẵn mã thanh toán của mọi người mua đủ điều kiện và các cấu hình nhắm mục tiêu trước có liên quan. Ngoài ra, đối với khoảng không quảng cáo của giao dịch , bạn có thể tìm thấy mã nhận dạng thanh toán được liên kết với người mua có liên quan bằng cách sử dụng BidRequest.imp.pmp.deal.ext.billing_id. Bạn chỉ có thể chỉ định mã thanh toán của người mua có trong yêu cầu giá thầu khi đặt giá thầu.
Nếu yêu cầu giá thầu có nhiều mã thanh toán, bạn phải chỉ định mã thanh toán của người mua mà bạn dự định phân bổ giá thầu bằng trường BidResponse.seatbid.bid.ext.billing_id.
Tệp từ điển
Yêu cầu giá thầu sử dụng giá trị nhận dạng được xác định trong các tệp từ điển có sẵn trên trang dữ liệu tham chiếu .
Macro URL giá thầu theo giao thức RTB của Google
Bạn có thể chèn một số trường của BidRequest vào
URL dùng trong yêu cầu POST HTTP (không bắt buộc). Điều này rất hữu ích, ví dụ: nếu bạn sử dụng một giao diện người dùng nhẹ giúp cân bằng tải trên nhiều phần phụ trợ bằng cách sử dụng một giá trị từ yêu cầu. Hãy liên hệ với người quản lý tài khoản kỹ thuật để yêu cầu hỗ trợ về các macro mới.
Macro Mô tả %%GOOGLE_USER_ID%%Thay thế bằng google_user_id từ BidRequest. Ví dụ: URL của bên đặt giá thầu
http://google.bidder.com/path?gid=%%GOOGLE_USER_ID%%
http://google.bidder.com/path?gid=dGhpyBhbiBleGFtGxl
Nếu không xác định được Mã nhận dạng người dùng của Google, thì chuỗi trống sẽ được thay thế, với kết quả tương tự như
http://google.bidder.com/path?gid= %%HAS_MOBILE%%Được thay thế bằng 1 hoặc 0 khi gọi has_mobile() của BidRequest.
%%HAS_VIDEO%%Được thay thế bằng 1 (đúng) hoặc 0 (sai) khi gọi has_video() của BidRequest.
%%HOSTED_MATCH_DATA%%Được thay thế bằng giá trị của trường hosted_match_data từ BidRequest.
%%MOBILE_IS_APP%%Được thay thế bằng 1 (đúng) hoặc 0 (sai) từ trường mobile.is_app của BidRequest.
Tìm mã ứng dụng di động từ URL giao dịch
Các giao dịch ứng dụng di động sẽ báo cáo các URL có dạng như sau:
mbappgewtimrzgyytanjyg4888888 .com Sử dụng bộ giải mã cơ số 32 để giải mã phần chuỗi in đậm (gewtimrzgyytanjyg4888888
Bạn có thể sử dụng trình giải mã trực tuyến , nhưng bạn sẽ phải viết hoa các chữ cái và thay thế 8 ở cuối bằng các giá trị =.
Vì vậy, hãy giải mã giá trị này:
GEWTIMRZGYYTANJYG4====== sẽ dẫn đến:
1 - 429610587
Chuỗi
429610587 là mã ứng dụng cho ứng dụng iOS
iFunny .
Sau đây là một ví dụ khác. URL được báo cáo là:
mbappgewtgmjug4ytmmrtgm888888 .com
Giải mã giá trị này:
GEWTGMJUG4YTMMRTGM====== sẽ dẫn đến:
1 - 314716233
Kết quả
314716233 là mã ứng dụng cho ứng dụng iOS
TextNow .
Tìm tên ứng dụng di động qua URL giao dịch
Dưới đây là ví dụ về cách lấy tên ứng dụng. URL được báo cáo như sau:
mbappMFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q888 .com
Giải mã giá trị này:
MFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q=== sẽ dẫn đến:
air.com.hypah.io.slither
Kết quả tương đương với ứng dụng Android
slither.io .
Các trường Đặt giá thầu mở
Yêu cầu giá thầu được gửi đến bên đặt giá thầu trên mạng và sàn giao dịch tham gia tính năng Đặt giá thầu mở tương tự như yêu cầu của Authorized Buyers tham gia tính năng đặt giá thầu theo thời gian thực tiêu chuẩn. Khách hàng sử dụng tính năng Đặt giá thầu mở sẽ nhận được một số trường bổ sung và một vài trường hiện có có thể có cách sử dụng thay thế. Các tính năng này bao gồm:
OpenRTB
Authorized Buyers
Thông tin chi tiết
BidRequest.imp[].ext.dfp_ad_unit_codeBidRequest.adslot[].dfp_ad_unit_codeChứa mã mạng Ad Manager của nhà xuất bản, theo sau là hệ thống phân cấp đơn vị quảng cáo, được phân tách bằng dấu gạch chéo lên.
Ví dụ: nội dung này sẽ xuất hiện với định dạng tương tự như:
/1234/cruises/mars.
BidRequest.user.data[].segment[]BidRequest.adslot[].exchange_bidding.key_value[]Các cặp khoá-giá trị lặp lại được gửi từ nhà xuất bản đến bên đặt giá thầu trao đổi.
Bạn có thể xác định rằng các giá trị này là cặp khoá-giá trị do nhà xuất bản gửi khi BidRequest.user.data[].name được đặt thành “Publisher Passed”.
Lưu ý: Trường này hiện chỉ được gửi đến những người tham gia chương trình thử nghiệm beta khép kín.
Khai báo nhà cung cấp được phép
Các nhà cung cấp công nghệ cung cấp các dịch vụ như nghiên cứu, tái tiếp thị và phân phát quảng cáo có thể đóng vai trò trong hoạt động tương tác giữa người mua và người bán. Chỉ những nhà cung cấp mà Google đã kiểm tra để tham gia các hoạt động tương tác với Authorized Buyers mới được phép.
Để hiểu BidRequest và tạo BidResponse, bạn cần biết hai cách khai báo nhà cung cấp công nghệ:
Bạn không cần khai báo một số nhà cung cấp; những nhà cung cấp này được liệt kê trong phần Nhà cung cấp bên ngoài được chứng nhận của Ad Manager .
Các nhà cung cấp khác chỉ có thể tham gia nếu được khai báo trong BidRequest:
Trong BidRequest, trường BidRequest.imp.ext.allowed_vendor_type chỉ định những nhà cung cấp mà người bán cho phép. Các nhà cung cấp sẽ được gửi trong allowed_vendor_type được liệt kê trong tệp từ điển vendors.txt
Ví dụ về yêu cầu giá thầu
Các ví dụ sau đây thể hiện các mẫu yêu cầu Protobuf và JSON mà con người có thể đọc được.
OpenRTB Protobuf
Ví dụ minh họa
Yêu cầu tuần tự
id : "G44mF74ywRs183dKa9565D"
imp {
id : "1"
banner {
w : 320
h : 50
pos : BELOW_THE_FOLD
expdir : LEFT
expdir : RIGHT
expdir : UP
expdir : DOWN
wmax : 320
hmax : 50
wmin : 214
hmin : 33
format {
w : 320
h : 50
}
format {
w : 300
h : 50
}
[ com . google . doubleclick . banner_ext ] {
flexslot {
wmin : 214
wmax : 320
hmin : 33
hmax : 50
}
}
}
tagid : "3724651684"
bidfloor : 0.01
bidfloorcur : "USD"
secure : true
exp : 3600
metric {
type : "click_through_rate"
value : 2.80155200016452 e - 05
vendor : "EXCHANGE"
}
metric {
type : "viewability"
value : 0.14
vendor : "EXCHANGE"
}
[ com . google . doubleclick . imp ] {
billing_id : 61560909063
dfp_ad_unit_code : "/2149822/google/test"
ampad : AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
buyer_generated_request_data {
data : "Test Data"
}
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 : "US"
}
}
content {
livestream : false
language : "es"
}
mobile : true
[ com . google . doubleclick . site ] {
amp : DIALECT_HTML
page_visibility : VISIBILITY_STATE_HIDDEN
inventorypartnerdomain : "OMITTED"
uact {
wasact : true
isact : true
}
ntype : NAVIGATION_TYPE_NAVIGATE
}
}
device {
ua : "OMITTED"
ip : "192.168.1.0"
geo {
lat : 0.0
lon : 0.0
country : "MEX"
region : "MX-NLE"
zip : "67050"
type : IP
utcoffset : - 360
accuracy : 3447
[ com . google . doubleclick . geo ] {
geo_criteria_id : 9143049
}
}
make : "Motorola"
model : "razr 2024"
os : "android"
osv : "14"
devicetype : HIGHEND_PHONE
lmt : false
w : 320
h : 783
pxratio : 3.375
sua {
browsers {
brand : "Chromium"
version : "130"
version : "0"
}
browsers {
brand : "Android WebView"
version : "130"
version : "0"
}
platform {
brand : "Android"
version : "14"
version : "0"
}
mobile : true
model : "motorola razr 2024"
source : CLIENT_HINTS_HIGH_ENTROPY
}
}
user {
id : "7pWq9gH2c44W14G0diM896340U7"
buyeruid : "ob9RP0311MR4X7c983o221v0B890U239"
customdata : "77o24I2Ie6j9g1Svm1J60Nnn8zB185Bk1yBhM6i28cWp9wjb"
[ com . google . doubleclick . user ] {
eids {
source : "OMITTED"
uids {
id : "12JD92JD8078S8J29SDOAKC0EF230337"
}
}
eids {
source : "OMITTED"
uids {
id : "12JD92JD8078S8J29SDOAKC0EF230337"
}
}
idage : 1296000
}
}
at : FIRST_PRICE
tmax : 350
cur : "USD"
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-zph5Vk-45u86x7963d1Se8v5W33W604M5WCTYJ4eH7jzh9702Y7A818s510l2vhC7tK4"
fcap_scope : FREQUENCY_CAPPING_SCOPE_NONE
}
JSON OpenRTB
Ví dụ minh họa
{
"id" : "G44mF74ywRs183dKa9565D" ,
"imp" : [
{
"id" : "1" ,
"banner" : {
"w" : 320 ,
"h" : 50 ,
"pos" : 3 ,
"expdir" : [
1 ,
2 ,
3 ,
4
],
"wmax" : 320 ,
"hmax" : 50 ,
"wmin" : 214 ,
"hmin" : 33 ,
"format" : [
{
"w" : 320 ,
"h" : 50
},
{
"w" : 300 ,
"h" : 50
}
],
"ext" : {
"flexslot" : {
"wmin" : 214 ,
"wmax" : 320 ,
"hmin" : 33 ,
"hmax" : 50
}
}
},
"tagid" : "3724651684" ,
"bidfloor" : 0.01 ,
"bidfloorcur" : "USD" ,
"secure" : 1 ,
"exp" : 3600 ,
"metric" : [
{
"type" : "click_through_rate" ,
"value" : 2.80155200016452 e - 05 ,
"vendor" : "EXCHANGE"
},
{
"type" : "viewability" ,
"value" : 0.14 ,
"vendor" : "EXCHANGE"
}
],
"ext" : {
"billing_id" : [
"61560909063"
],
"dfp_ad_unit_code" : "/2149822/google/test" ,
"ampad" : 3 ,
"buyer_generated_request_data" : [
{
"data" : "Test 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" : "US"
}
},
"content" : {
"livestream" : 0 ,
"language" : "es"
},
"mobile" : 1 ,
"ext" : {
"amp" : 0 ,
"page_visibility" : 2 ,
"inventorypartnerdomain" : "OMITTED" ,
"uact" : {
"wasact" : 1 ,
"isact" : 1
},
"ntype" : 1
}
},
"device" : {
"ua" : "OMITTED" ,
"ip" : "192.168.1.0" ,
"geo" : {
"lat" : 0.0 ,
"lon" : 0.0 ,
"country" : "MEX" ,
"region" : "MX-NLE" ,
"zip" : "67050" ,
"type" : 2 ,
"utcoffset" : - 360 ,
"accuracy" : 3447 ,
"ext" : {
"geo_criteria_id" : 9143049
}
},
"make" : "Motorola" ,
"model" : "razr 2024" ,
"os" : "android" ,
"osv" : "14" ,
"devicetype" : 4 ,
"lmt" : 0 ,
"w" : 320 ,
"h" : 783 ,
"pxratio" : 3.375 ,
"sua" : {
"browsers" : [
{
"brand" : "Chromium" ,
"version" : [
"130" ,
"0"
]
},
{
"brand" : "Android WebView" ,
"version" : [
"130" ,
"0"
]
}
],
"platform" : {
"brand" : "Android" ,
"version" : [
"14" ,
"0"
]
},
"mobile" : 1 ,
"model" : "motorola razr 2024" ,
"source" : 2
}
},
"user" : {
"id" : "7pWq9gH2c44W14G0diM896340U7" ,
"buyeruid" : "ob9RP0311MR4X7c983o221v0B890U239" ,
"customdata" : "77o24I2Ie6j9g1Svm1J60Nnn8zB185Bk1yBhM6i28cWp9wjb" ,
"ext" : {
"eids" : [
{
"source" : "OMITTED" ,
"uids" : [
{
"id" : "12JD92JD8078S8J29SDOAKC0EF230337"
}
]
},
{
"source" : "OMITTED" ,
"uids" : [
{
"id" : "12JD92JD8078S8J29SDOAKC0EF230337"
}
]
}
],
"idage" : 1296000
}
},
"at" : 1 ,
"tmax" : 350 ,
"cur" : [
"USD"
],
"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-zph5Vk-45u86x7963d1Se8v5W33W604M5WCTYJ4eH7jzh9702Y7A818s510l2vhC7tK4" ,
"fcap_scope" : 1
}
}
Google (Không dùng nữa)
Ví dụ minh họa
Yêu cầu tuần tự
id : "To1)\351\216ec%\362\220w\235\300\010\255G\020^\257\'[}"
ip : "\300\250"
user_agent : "OMITTED"
url : "https://www.google.com"
detected_language : "it"
adslot {
id : 1
width : 336
width : 300
height : 280
height : 250
excluded_attribute : 70
excluded_attribute : 16
allowed_vendor_type : 445
allowed_vendor_type : 704
excluded_sensitive_category : 31
excluded_sensitive_category : 24
matching_ad_data {
billing_id : 78614473201
minimum_cpm_micros : 10000
}
slot_visibility : BELOW_THE_FOLD
excluded_product_category : 10003
excluded_product_category : 10017
ad_block_key : 5501504864
publisher_settings_list_id : 3066683014322168515
iframing_state : UNKNOWN_IFRAME_STATE
viewability : 80
click_through_rate : 0.001814635
renderer : GOOGLE
allowed_ad_types : ALLOWED_AD_TYPE_BANNER
is_amp_page : DIALECT_HTML
amp_ad_requirement_type : AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
consented_providers_settings {
consented_providers : 1227
consented_providers : 2140
tcf_consent_string : "OMITTED"
additional_consent_string : "OMITTED"
}
regs_gdpr : true
flexible_adslot_settings {
max_width : 412
max_height : 361
min_width : 206
min_height : 46
}
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_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
cookie_version : 1
google_user_id : "Fl9o7N66Yl32fK90ZvfV50238gt"
timezone_offset : 120
mobile {
app_id : "com.google.testapp"
is_app : false
is_mobile_web_optimized : true
app_name : "Test App"
app_rating : 3.9867892
}
cookie_age_seconds : 10368000
geo_criteria_id : 1008141
publisher_settings_list_id : 7538157606866003226
publisher_type : PUBLISHER_OWNED_AND_OPERATED
partner_id : 7568211982740612868
device {
device_type : HIGHEND_PHONE
platform : "android"
brand : "Samsung"
model : "sm-a750fn"
os_version {
major : 10
}
carrier_id : 70150
screen_width : 412
screen_height : 846
screen_pixel_ratio_millis : 2625
screen_orientation : PORTRAIT
limit_ad_tracking : false
}
publisher_country : "IT"
publisher_id : "pub-1111111111111111"
response_deadline_ms : 350
google_query_id : "ANy-zM40L2-685i3i9Pb9aV5D0nlcJ6vR1yvq0Xev4635927DQi781B2X403h2GoyQQdMl26"
auction_type : FIRST_PRICE
geo {
lat : 0.0
lon : 0.0
country : "ITA"
region : "IT-BO"
city : "Bologna"
utcoffset : 120
accuracy : 5230
}
user_agent_data {
platform {
brand : "Android"
version : "10"
version : "0"
}
mobile : true
model : "SM-A750FN"
browsers {
brand : "Android WebView"
version : "129"
version : "0"
}
browsers {
brand : "Not=A?Brand"
version : "8"
version : "0"
}
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_BROWSER
privacy_treatments {
allow_user_data_collection : true
}
inventory_partner_domain : "OMITTED"
Để chuyển đổi yêu cầu giá thầu thành một dạng tệp nhị phân, như bạn sẽ nhận được từ tải trọng POST trong một yêu cầu thực, bạn có thể làm như sau (trong C++). Tuy nhiên, xin lưu ý rằng phương thức này không áp dụng cho JSON OpenRTB.
string text_format_example = /* example from above */ ;
BidRequest bid_request ;
if ( TextFormat :: ParseFromString ( text_format_example , &bid_request )) {
string post_payload ;
if ( bid_request . SerializeToString ( &post_payload )) {
// post_payload is a binary serialization of the protocol buffer
}
} Phản hồi theo thời gian thực
Authorized Buyers cũng như các sàn giao dịch và mạng sử dụng tính năng Đặt giá thầu mở có thể xem ý kiến phản hồi theo thời gian thực.
Phản hồi về giá thầu phản hồi được hỗ trợ trên yêu cầu giá thầu tiếp theo cho cả giao thức OpenRTB và giao thức Google RTB không còn được dùng nữa. Đối với OpenRTB, thông tin này được gửi trong BidRequest.ext.bid_feedback.
Ngoài các trường mặc định được gửi trong Ý kiến phản hồi về phản hồi giá thầu, bạn cũng có thể gửi dữ liệu tuỳ chỉnh trong phản hồi giá thầu bằng cách sử dụng trường BidResponse.seatbid.bid.ext.event_notification_token. event_notification_token là dữ liệu tuỳ ý mà chỉ bên đặt giá thầu mới biết và có thể giúp gỡ lỗi, ví dụ: mã nhắm mục tiêu mới hoặc mã đặt giá thầu đại diện cho một chiến thuật mới hoặc siêu dữ liệu liên kết với mẫu quảng cáo mà chỉ bên đặt giá thầu mới biết. Để biết thông tin chi tiết, hãy xem Vùng đệm giao thức của tiện ích OpenRTB dành cho OpenRTB hoặc giao thức RTB của Google không còn được dùng nữa.
Cảnh báo: Nếu bạn đã định cấu hình điểm cuối đặt giá thầu để sử dụng OpenRTB và
Google RTB, thì một vấn đề đã biết là event_notification_token
được đặt trong phản hồi giá thầu cho một giao thức có thể xuất hiện trong phản hồi giá thầu
trong giao thức còn lại. Bạn phải đặt event_notification_token trong phản hồi giá thầu thành một chuỗi UTF-8 trong cả hai giao thức, nếu không, các yêu cầu giá thầu bao gồm mã thông báo có thể không chuyển đổi tuần tự và không đến được điểm cuối.
Khi Authorized Buyers gửi yêu cầu giá thầu đến một bên đặt giá thầu, bên đặt giá thầu sẽ phản hồi bằng BidResponse. Nếu bên đặt giá thầu đã bật tính năng phản hồi theo thời gian thực, thì trong một yêu cầu giá thầu tiếp theo, Authorized Buyers sẽ gửi phản hồi về phản hồi trong một thông báo BidFeedback:
message BidFeedback {
// The unique id from BidRequest . id .
optional string request_id = 1 ;
// The status code for the ad . See creative - status - codes . txt in the
// technical documentation for a list of ids .
optional int32 creative_status_code = 2 ;
// Deprecated . This field is not populated and will be removed after March ,
// 2025. If the bid won the auction , this is the price paid in your account
// currency . If the bid participated in the auction but was out - bid , this
// is the CPM that should have been exceeded in order to win . This is not
// set if the bid was filtered prior to the auction , if the publisher or
// winning bidder has opted out of price feedback or if your account has
// opted out of sharing winning prices with other bidders . For first - price
// auctions , minimum_bid_to_win is populated instead of this field .
optional double price = 3 [ deprecated = true ];
// The minimum bid value necessary to have won the auction , in your account
// currency . If your bid won the auction , this is the second highest bid
// that was not filtered ( including the floor price ) . If your bid didn 't win
// the auction , this is the winning candidate 's bid. This field will only be
// populated if your bid participated in a first - price auction , and will not
// be populated if your bid was filtered prior to the auction .
optional double minimum_bid_to_win = 6 ;
// The minimum bid value necessary to have won the server - side component of
// the overall auction given that there was also an interest group bidding
// component to the overall auction which ran using the Protected Audience
// API . The value is expressed in CPM of the buyer account currency . The
// minimum bid to win for the overall auction , including bids from the
// server - side and the on - device interest group components , is populated in
// the minimum_bid_to_win field of the same BidFeedback object .
optional double sscminbidtowin = 14 ;
// Billable event rate multiplier that was applied to this bid during
// ranking . The adjustment reflects the likelihood that your bid would
// generate a billable event ( namely , the ad renders successfully ) if it won
// the auction , relative to the probability that other bids generate a
// billable event if they won the auction . This adjustment can be larger or
// smaller than 1. This affects the final ranking in the auction only ; in
// particular , this multiplier does not affect the payment or whether the
// bid clears any floor price .
optional float billable_event_rate_bid_adjustment = 13 [ default = 1 ];
// When a publisher uses an RTB auction and waterfall - based SDK mediation on
// the same query , the winner of the real - time auction must also compete in
// a mediation waterfall ( which is ordered by price ) to win the impression .
// If the bid participated in the auction and there was no waterfall , the
// value of this field is 0. If the bid participated in the auction and
// there was a waterfall , the value of this field is a price representing a
// sample bid from the eligible mediation networks that were higher than the
// auction winner , weighted by expected fill rate . This field can be used
// in conjunction with minimum_bid_to_win to train bidding models . The CPM
// is in your account currency .
optional double sampled_mediation_cpm_ahead_of_auction_winner = 8 ;
message EventNotificationToken {
// The contents of the token .
optional string payload = 1 ;
}
// The token included in the corresponding bid .
optional EventNotificationToken event_notification_token = 4 ;
// The creative ID included in the corresponding bid .
optional string buyer_creative_id = 5 ;
// Possible types of bid response feedback objects .
enum FeedbackType {
FEEDBACK_TYPE_UNSPECIFIED = 0 ;
// Feedback for a bid that was submitted on a bid response .
BID_FEEDBACK = 1 ;
// Feedback for an interest group buyer submitted on a bid response to
// particpate in an interest group bidding component of the auction run
// using the Protected Audience API .
INTEREST_GROUP_BUYER_FEEDBACK = 2 ;
}
// The type of the BidFeedback message . Google will send separate
// BidFeedback objects for :
// a ) Each bid submitted on a bid response
// b ) Each buyer submitted on a bid response to particpate in an interest
// group bidding component of the auction run using the Protected Audience
// API .
optional FeedbackType feedbacktype = 15 ;
// Origin of an interest group buyer that was included in the bid response .
// This field is populated only for feedback where a bidder opted in an
// interest group buyer to participate in the interest group bidding
// component of the overall auction run using the Protected Audience API .
// To learn more about origins , see https : // www . rfc - editor . org / rfc / rfc6454 .
// To learn more about interest group bidding and the Protected Audience
// API , see
// https : // developers . google . com / authorized - buyers / rtb / fledge - origin - trial .
optional string buyerorigin = 16 ;
// The status code for the submitted interest group buyer . This field is
// only populated in the feedback for an interest group buyer that a bidder
// requested to enter into the interest group auction through the bid
// response . Individual creative status codes of bids submitted by the buyer
// in the on - device interest group auction are not available . See
// https : // storage . googleapis . com / adx - rtb - dictionaries / interest - group - buyer - status - codes . txt
// for a list of interest group buyer status codes .
optional int32 igbuyerstatus = 17 ;
} Trong thông báo này, trường đầu tiên bạn nên kiểm tra là bid_feedback.creative_status_code; bạn có thể tìm thấy ý nghĩa của mã trong
creative-status-codes.txt . Xin lưu ý rằng nếu thắng giá thầu, bạn có thể chọn không tham gia tính năng ý kiến phản hồi về giá. Để biết thêm thông tin, hãy xem bài viết Cách chọn không tham gia .
Phản hồi theo thời gian thực bao gồm mã yêu cầu giá thầu và một trong những thông tin sau:
Kết quả đấu giá
Phản hồi theo thời gian thực
Người mua không gửi giá thầu.
Miễn phí.
Người mua đã gửi một giá thầu bị lọc ra trước khi tham gia phiên đấu giá.
Mã trạng thái mẫu quảng cáo (creative-status-codes.txt ).
Người mua đã gửi giá thầu nhưng thua phiên đấu giá.
Mã trạng thái mẫu quảng cáo 79 (bị trả giá cao hơn trong phiên đấu giá).
Người mua đã gửi một giá thầu thắng phiên đấu giá.
Giá thanh toán và mã trạng thái mẫu quảng cáo 1.
Đối với một lượt hiển thị ứng dụng và mã trạng thái mẫu quảng cáo là 83, nhà xuất bản ứng dụng có thể đang sử dụng quy trình dàn xếp dạng thác nước, do đó, giá thầu chiến thắng sẽ cạnh tranh với các nhu cầu khác trong chuỗi thác nước trả về của nhà xuất bản. Tìm hiểu cách sử dụng sampled_mediation_cpm_ahead_of_auction_winner khi đặt giá thầu .
Mẫu
Sau đây là mẫu phản hồi theo thời gian thực như trong các giao thức được hỗ trợ:
OpenRTB Protobuf
Ví dụ minh họa
Yêu cầu tuần tự
id : "01WjN3uc042XYP8Yw509Q7"
imp {
id : "1"
banner {
w : 344
h : 650
pos : AD_POSITION_FULLSCREEN
api : MRAID_1
api : MRAID_2
format {
w : 344
h : 650
}
format {
w : 300
h : 600
}
}
displaymanager : "GoogleMobileAds-Android"
displaymanagerver : "22.6.0"
instl : true
tagid : "7282514850"
bidfloor : 0.01
bidfloorcur : "USD"
secure : true
exp : 14400
clickbrowser : true
metric {
type : "viewability"
value : 0.77
vendor : "EXCHANGE"
}
[ com . google . doubleclick . imp ] {
billing_id : 75441834964
publisher_settings_list_id : 9268043626392948934
publisher_settings_list_id : 2867966915706729060
allowed_vendor_type : 113
allowed_vendor_type : 41423
ampad : AMP_AD_NOT_ALLOWED
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
allowed_restricted_category : 32
allowed_restricted_category : 33
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
is_app_open_ad : true
ae : SERVER_SIDE_AUCTION
}
}
app {
name : "Test App"
ver : "6.46.0"
bundle : "com.google.testapp"
publisher {
id : "pub-7120195540802809"
[ com . google . doubleclick . publisher ] {
country : "US"
}
}
content {
url : "https://www.google.com"
userrating : "4.6"
livestream : false
language : "en"
}
storeurl : "https://www.google.com"
[ com . google . doubleclick . app ] {
inventorypartnerdomain : "OMITTED"
}
}
device {
ua : "OMITTED"
ip : "192.168.1.0"
geo {
lat : 0.0
lon : 0.0
country : "GHA"
type : IP
utcoffset : 0
accuracy : 8865
[ com . google . doubleclick . geo ] {
geo_criteria_id : 9067654
}
}
make : "Itel"
model : "itel W6502"
os : "android"
osv : "10"
connectiontype : CELL_4G
devicetype : HIGHEND_PHONE
lmt : true
w : 360
h : 722
pxratio : 2.0
sua {
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "537"
version : "36"
}
platform {
brand : "Android"
version : "10"
}
mobile : true
model : "itel W6502"
source : USER_AGENT_STRING
}
}
user {
[ com . google . doubleclick . user ] {
session {
duration : 660
}
}
}
at : FIRST_PRICE
tmax : 300
cur : "USD"
bcat : "IAB19-22"
bcat : "IAB23-1"
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 ] {
bid_feedback {
request_id : "4004C52Z6Z7Fa39Lf6F2AQ"
creative_status_code : 79
buyer_creative_id : "test_creative_id_129669"
minimum_bid_to_win : 0.1
feedbacktype : BID_FEEDBACK
}
google_query_id : "ANy-zbp8Gw-Mv43u3ni49Ena0i57E0789881P6YVa8jXDHq36B3fNk8me8F20GS6114onx7A"
fcap_scope : FREQUENCY_CAPPING_SCOPE_APP
privacy_treatments {
allow_user_data_collection : true
}
}
JSON OpenRTB
Ví dụ minh họa
{
"id" : "01WjN3uc042XYP8Yw509Q7" ,
"imp" : [
{
"id" : "1" ,
"banner" : {
"w" : 344 ,
"h" : 650 ,
"pos" : 7 ,
"api" : [
3 ,
5
],
"format" : [
{
"w" : 344 ,
"h" : 650
},
{
"w" : 300 ,
"h" : 600
}
]
},
"displaymanager" : "GoogleMobileAds-Android" ,
"displaymanagerver" : "22.6.0" ,
"instl" : 1 ,
"tagid" : "7282514850" ,
"bidfloor" : 0.01 ,
"bidfloorcur" : "USD" ,
"secure" : 1 ,
"exp" : 14400 ,
"clickbrowser" : 1 ,
"metric" : [
{
"type" : "viewability" ,
"value" : 0.77 ,
"vendor" : "EXCHANGE"
}
],
"ext" : {
"billing_id" : [
"75441834964"
],
"publisher_settings_list_id" : [
"9268043626392948934" ,
"2867966915706729060"
],
"allowed_vendor_type" : [
113 ,
41423
],
"ampad" : 2 ,
"excluded_creatives" : [
{
"buyer_creative_id" : "EXCLUDED_BUYER_CREATIVE_ID"
},
{
"buyer_creative_id" : "EXCLUDED_BUYER_CREATIVE_ID"
}
],
"allowed_restricted_category" : [
32 ,
33
],
"creative_enforcement_settings" : {
"policy_enforcement" : 2 ,
"publisher_blocks_enforcement" : 1
},
"auction_environment" : 0 ,
"is_app_open_ad" : 1 ,
"ae" : 0
}
}
],
"app" : {
"name" : "Test App" ,
"ver" : "6.46.0" ,
"bundle" : "com.google.testapp" ,
"publisher" : {
"id" : "pub-7120195540802809" ,
"ext" : {
"country" : "US"
}
},
"content" : {
"url" : "https://www.google.com" ,
"userrating" : "4.6" ,
"livestream" : 0 ,
"language" : "en"
},
"storeurl" : "https://www.google.com" ,
"ext" : {
"inventorypartnerdomain" : "OMITTED"
}
},
"device" : {
"ua" : "OMITTED" ,
"ip" : "192.168.1.0" ,
"geo" : {
"lat" : 0.0 ,
"lon" : 0.0 ,
"country" : "GHA" ,
"type" : 2 ,
"utcoffset" : 0 ,
"accuracy" : 8865 ,
"ext" : {
"geo_criteria_id" : 9067654
}
},
"make" : "Itel" ,
"model" : "itel W6502" ,
"os" : "android" ,
"osv" : "10" ,
"connectiontype" : 6 ,
"devicetype" : 4 ,
"lmt" : 1 ,
"w" : 360 ,
"h" : 722 ,
"pxratio" : 2.0 ,
"sua" : {
"browsers" : [
{
"brand" : "Mozilla" ,
"version" : [
"5" ,
"0"
]
},
{
"brand" : "AppleWebKit" ,
"version" : [
"537" ,
"36"
]
}
],
"platform" : {
"brand" : "Android" ,
"version" : [
"10"
]
},
"mobile" : 1 ,
"model" : "itel W6502" ,
"source" : 3
}
},
"user" : {
"ext" : {
"session" : {
"duration" : 660
}
}
},
"at" : 1 ,
"tmax" : 300 ,
"cur" : [
"USD"
],
"bcat" : [
"IAB19-22" ,
"IAB23-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" : {
"bid_feedback" : [
{
"request_id" : "4004C52Z6Z7Fa39Lf6F2AQ" ,
"creative_status_code" : 79 ,
"buyer_creative_id" : "test_creative_id_129669" ,
"minimum_bid_to_win" : 0.1 ,
"feedbacktype" : 1
}
],
"google_query_id" : "ANy-zbp8Gw-Mv43u3ni49Ena0i57E0789881P6YVa8jXDHq36B3fNk8me8F20GS6114onx7A" ,
"fcap_scope" : 4 ,
"privacy_treatments" : {
"allow_user_data_collection" : 1
}
}
}
Google (Không dùng nữa)
Ví dụ minh họa
Yêu cầu tuần tự
id : "\334\225\241N\334P\373p\340\000\300C\327+\215\013\355Q\337\251Z\236g"
ip : "\300\250"
user_agent : "OMITTED"
url : "https://www.google.com"
detected_language : "es"
adslot {
id : 1
width : 320
height : 50
excluded_attribute : 19
excluded_attribute : 20
allowed_vendor_type : 42
allowed_vendor_type : 144
matching_ad_data {
billing_id : 58232806131
billing_id : 71082687953
minimum_cpm_micros : 1400000
}
matching_ad_data {
billing_id : 82776154517
billing_id : 59477532962
minimum_cpm_micros : 78750000
}
slot_visibility : ABOVE_THE_FOLD
ad_block_key : 7742701593
publisher_settings_list_id : 4723020262350940099
publisher_settings_list_id : 6354748437627634678
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
viewability : 99
allowed_ad_types : ALLOWED_AD_TYPE_BANNER
is_amp_page : DIALECT_HTML
amp_ad_requirement_type : AMP_AD_NOT_ALLOWED
session_depth : 300
api : OMID_1
api : MRAID_1
omidpn : "Google"
omidpv : "afma-sdk-i-v10.14.0"
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
impression_expiration_seconds : 3600
supported_auction_environment : SERVER_SIDE_AUCTION
display_manager : "GoogleMobileAds-iOS"
display_manager_version : "10.14.0"
}
is_test : false
timezone_offset : - 420
mobile {
app_id : "350328655"
is_app : true
is_mobile_web_optimized : true
encrypted_advertising_id : ",\271\302R\363\232\001NA\001\240D\"\032\001N\251+\271\000\3510\026)\356n\3733\214a\276\321P\202\205\033"
app_name : "Test App"
advertising_id : "^\274v\200\002\333u\227Y\304\343u\304\272\312\247"
skadn {
sourceapp : "350328655"
skadnetids : "6sZrk2l9"
skadnetids : "L60y296B"
versions : "2.0"
versions : "2.1"
supported_fidelity_types : STOREKIT_RENDERED_ADS
supported_fidelity_types : VIEW_THROUGH_ADS
}
}
postal_code : "10011"
geo_criteria_id : 9194140
bid_response_feedback {
request_id : "\177f\245p\252\347p\251\266\326S(\272\335\013\257"
creative_status_code : 80
event_notification_token : "token"
buyer_creative_id : "test_creative_id_923023"
minimum_bid_to_win : 3750000
feedback_type : BID_FEEDBACK
}
bid_response_feedback {
request_id : "6\374\201J\0355\275\014\335\270\202\307\261\253I\247"
creative_status_code : 80
event_notification_token : "token"
buyer_creative_id : "test_creative_id_923023"
minimum_bid_to_win : 570000
feedback_type : BID_FEEDBACK
}
publisher_type : PUBLISHER_OWNED_AND_OPERATED
device {
device_type : HIGHEND_PHONE
platform : "iphone"
brand : "Apple"
model : "iPhone14,5"
os_version {
major : 17
minor : 6
micro : 1
}
carrier_id : 0
screen_width : 390
screen_height : 844
screen_pixel_ratio_millis : 3000
screen_orientation : PORTRAIT
hardware_version : "iPhone14,5"
limit_ad_tracking : false
app_tracking_authorization_status : AUTHORIZED
connection_type : WIFI
}
publisher_country : "CA"
publisher_id : "pub-1111111111111111"
response_deadline_ms : 300
google_query_id : "ANy-z73p95-804i3oEddT04Y8kl9v8C0D3k33ZDTAuc547f0v52955w82z36pq70wV1j5xKW"
auction_type : FIRST_PRICE
geo {
lat : 0.0
lon : 0.0
country : "USA"
metro : "807"
city : "San Mateo"
zip : "94401"
utcoffset : - 420
accuracy : 997
}
user_agent_data {
platform {
brand : "iPhone"
version : "17"
version : "6"
}
mobile : true
model : "iPhone"
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "605"
version : "1"
}
bitness : "64"
source : USER_AGENT_STRING
}
supply_chain {
complete : true
nodes {
advertising_system_identifier : "testdomain.com"
seller_identifier : "pub-1111111111111111"
handles_payment : true
}
nodes {
advertising_system_identifier : "testdomain.com"
seller_identifier : "pub-1111111111111111"
handles_payment : true
}
version : "1.0"
}
frequency_capping_scope : FREQUENCY_CAPPING_SCOPE_DEVICE
privacy_treatments {
allow_user_data_collection : true
}
inventory_partner_domain : "OMITTED"
session_duration_seconds : 411
Xây dựng mô hình đặt giá thầu cho phiên đấu giá theo giá đầu tiên
Sau khi đặt giá thầu trong phiên đấu giá theo giá đầu tiên, bạn sẽ nhận được phản hồi theo thời gian thực, bao gồm cả các trường minimum_bid_to_win và sampled_mediation_cpm_ahead_of_auction_winner nếu giá thầu không bị lọc khỏi phiên đấu giá. Bạn có thể sử dụng các tín hiệu này để thông báo cho logic đặt giá thầu về mức giá thầu có thể cao hơn hoặc thấp hơn bao nhiêu để giành được lượt hiển thị.
minimum_bid_to_win: Giá thầu tối thiểu có thể được đặt để giành chiến thắng trong phiên đấu giá đặt giá thầu theo thời gian thực. Nếu bạn đã thắng phiên đấu giá, thì đây sẽ là giá thầu thấp nhất mà bạn có thể đặt mà vẫn thắng. Nếu bạn thua phiên đấu giá, đây sẽ là giá thầu thắng thầu.
sampled_mediation_cpm_ahead_of_auction_winner: Nếu có các mạng khác trong chuỗi dàn xếp , thì giá trị của trường này là giá thể hiện giá thầu mẫu từ một trong các mạng dàn xếp đủ điều kiện cao hơn giá thầu của người chiến thắng trong phiên đấu giá, được tính trọng số theo tỷ lệ đáp ứng dự kiến. Giá trị này sẽ được đặt thành 0 nếu không có mạng nào trong chuỗi dàn xếp dự kiến sẽ đáp ứng hoặc nếu nhà xuất bản không sử dụng tính năng dàn xếp SDK.
Cách hoạt động
Để mô tả các phép tính dùng để xác định các giá trị có thể có cho minimum_bid_to_win và sampled_mediation_cpm_ahead_of_auction_winner, trước tiên, chúng ta cần xác định những điều sau:
Dưới đây là CPM trong chuỗi dàn xếp theo thứ tự giảm dần:
\[C_1, C_2, …, C_n\]
Dưới đây là tỷ lệ đáp ứng tương ứng cho các CPM trong chuỗi dàn xếp:
\[f_1, f_2, …, f_n\]
Sau đây là hàm dùng để xác định CPM dự kiến và xác suất của CPM đó từ phần tử chuỗi dàn xếp \(i\), dựa trên tỷ lệ đáp ứng đã cho:
\(X_i = \{C_i\) với xác suất \(f_i\); \(0\) với xác suất \(1 - f_i\}\)
Chuỗi dàn xếp chiến thắng cuối cùng sẽ là:
\[\{C_1, C_2, …, C_K, W\}\]
trong đó \(W\) là giá thầu chiến thắng và \(C_K > W >= C_{K+1}\)
Giá đặt trước (hoặc giá sàn) được biểu thị là \(F\).
Giá thầu của người về nhì được biểu thị là \(R\).
Cách tính cho người chiến thắng trong phiên đấu giá
Trường
Cách tính
minimum_bid_to_win\(max\{F, R, X_{K+1}, …, X_n\}\)
sampled_mediation_cpm_ahead_\(\{C_i\) có xác suất \(\prod_{j=1}^{i-1}(1-f_j) \cdot f_i \div \prod_{j=1}^{K}(1-f_j)\}\)
Đối với \(1 <= i <= K\).
Cách tính cho phiên đấu giá thua
Trường
Cách tính
minimum_bid_to_win\(max\{F, W\}\)
sampled_mediation_cpm_ahead_\(max\{X_1, …, X_K\}\)
Giả sử một nhà xuất bản sử dụng cả tính năng đặt giá thầu theo thời gian thực và chuỗi dàn xếp SDK như sau:
Chuỗi dàn xếp SDK
CPM dự kiến
Tỷ lệ đáp ứng
Mạng 1
\(C_1 = $3.00\)
\(f_1 = 5\%\)
Mạng 2
\(C_2 = $2.00\)
\(f_2 = 45\%\)
Mạng 3
\(C_3 = $0.50\)
\(f_3 = 80\%\)
Network 4
\(C_4 = $0.10\)
\(f_4 = 85\%\)
Giả sử kết quả của phiên đấu giá RTB như sau:
Phiên đấu giá RTB
CPM
Người chiến thắng trong phiên đấu giá (W)
1 đô la
Á quân trong phiên đấu giá (R)
0,05 USD
Giá đặt trước / giá sàn (F)
$0
Giá thầu thắng phiên đấu giá
Sau đây là ví dụ về cách tính giá trị và xác suất cho minimum_bid_to_win và sampled_mediation_cpm_ahead_of_auction_winner cho một giá thầu đã thắng.
minimum_bid_to_winXác suất
\(max(F, R, C_3) = $0.50\)
\(f_3 = 80\%\)
\(max(F, R, C_4) = $0.10\)
\((1-f_3) \cdot f_4 = 17\%\)
\(max(F, R, 0) = $0.05\)
\((1-f_3) \cdot (1-f_4) = 3\%\)
sampled_mediation_cpm_Xác suất
\(C_1 = $3.00\)
\(f_1 \div (1-(1-f_1) \cdot (1-f_2)) =~ 10.5\%\)
\(C_2 = $2.00\)
\(((1-f_1) \cdot f_2) \div (1-(1-f_1) \cdot (1-f_2)) =~ 89.5\%\)
Lưu ý: Nếu bên thắng phiên đấu giá phân phát quảng cáo và nhận được thông báo thanh toán (ví dụ: thông qua một điểm cuối được chỉ định trong BidResponse.seatbid[].bid[].burl), thì bên thắng phiên đấu giá có thể suy luận rằng không có CPM dàn xếp nào được lấy mẫu đã lấp đầy và có thể đưa tần suất xảy ra điều này vào mô hình của họ.Giá thầu thua phiên đấu giá
Sau đây là ví dụ về cách tính giá trị và xác suất cho minimum_bid_to_win và sampled_mediation_cpm_ahead_of_auction_winner đối với một giá thầu thua cuộc.
minimum_bid_to_winXác suất
\(max(F, W) = $1.00\)
\(100\%\)
sampled_mediation_cpm_Xác suất
\(C_1 = $3.00\)
\(f_1 = 5\%\)
\(C_2 = $2.00\)
\((1-f_1) \cdot f_2 =~ 42.8\%\)
\(0\)
\((1-f_1) \cdot (1-f_2) =~ 52.2\%\)
Lưu ý: Giá trị sampled_mediation_cpm_ahead_of_auction_winner bằng 0 cho biết phiên đấu giá đặt giá thầu theo thời gian thực đã thắng. Trong ví dụ trên, người chiến thắng trong phiên đấu giá dự kiến sẽ không bị một mạng dàn xếp cạnh tranh đặt giá thầu cao hơn trong 52,2% thời gian.Phân tách giá thầu
Tính năng làm phẳng giá thầu mô tả quá trình xử lý một BidRequest phức tạp thành nhiều yêu cầu giá thầu được gửi đến ứng dụng của bạn. Khi một yêu cầu giá thầu được làm phẳng, bạn có thể biết yêu cầu giá thầu nào thuộc yêu cầu ban đầu vì các yêu cầu đó sẽ có giá trị giống hệt nhau trong trường BidRequest.ext.google_query_id.
Tính năng làm phẳng giá thầu được bật theo mặc định, nhưng bạn có thể liên hệ với người quản lý tài khoản nếu muốn tắt tính năng này.
Một số cơ hội quảng cáo có thể chấp nhận nhiều định dạng. Khi áp dụng tính năng làm phẳng giá thầu, mỗi định dạng sẽ được gửi trong một yêu cầu giá thầu riêng biệt, trong đó các thuộc tính như mã thanh toán đủ điều kiện có liên quan đến định dạng được chỉ định trong yêu cầu.
Các yêu cầu giá thầu chứa các định dạng sau sẽ được phân tách thành các yêu cầu giá thầu riêng biệt:
Biểu ngữ
Video
Âm thanh
Mã gốc
Dưới đây là ví dụ về một yêu cầu giá thầu JSON OpenRTB được đơn giản hoá mà không làm phẳng định dạng quảng cáo so với một nhóm yêu cầu tương đương đã được làm phẳng:
Làm phẳng trước
Ví dụ minh họa
{
"id": "V5ar1wXqKP58nbsyJ6549D",
"imp": [
{
"id": "1",
"video": {
"linearity": 1,
"w": 300,
"h": 250,
"pos": 1,
"skip": 1,
"playbackmethod": [
6
],
"placement": 3,
"mimes": [
"video/mp4"
],
"protocols": [
2,
3
]
},
"banner": {
"format": [
{
"w": 300,
"h": 250
}
],
"w": 300,
"h": 250,
"pos": 1
},
"ext": {
"billing_id": [
47039494050,
52030317241
]
}
}
],
"ext": {
"google_query_id": "ANy-zdp266-244itJsom3dmXb7SvW1IPg6478g639g0867v1126w630F3M7lAp640H666744"
}
}
Sau khi làm phẳng
Ví dụ minh họa
Yêu cầu 1
{
"id": "B3xr1yZqRL48nbsyJ6367N",
"imp": [
{
"id": "1",
"video": {
"linearity": 1,
"w": 300,
"h": 250,
"pos": 1,
"skip": 1,
"playbackmethod": [
6
],
"placement": 3,
"mimes": [
"video/mp4"
],
"protocols": [
2,
3
]
}
"ext": {
"billing_id": [
47039494050
]
}
],
"ext": {
"google_query_id": "ANy-zdp266-244itJsom3dmXb7SvW1IPg6478g639g0867v1126w630F3M7lAp640H666744"
}
} Yêu cầu 2
{
"id": "M1dY8qHyNK74bMsjF393Gf",
"imp": [
{
"id": "1",
"banner": {
"format": [
{
"w": 300,
"h": 250
}
],
"w": 300,
"h": 250,
"pos": 1
},
"ext": {
"billing_id": [
52030317241
]
}
}
],
"ext": {
"google_query_id": "ANy-zdp266-244itJsom3dmXb7SvW1IPg6478g639g0867v1126w630F3M7lAp640H666744"
}
}
Ưu đãi
Cơ hội quảng cáo cho một bên đặt giá thầu cụ thể có thể áp dụng cho nhiều loại giao dịch, ngoài phiên đấu giá mở. Khi làm phẳng giá thầu cho giao dịch, hệ thống sẽ gửi một yêu cầu giá thầu cho phiên đấu giá mở và một yêu cầu cho mỗi loại giao dịch giá cố định. Trong thực tế, các quy tắc ràng buộc về quảng cáo có thể khác nhau giữa các loại phiên đấu giá và giao dịch giá cố định. Ví dụ: đối với một cơ hội quảng cáo dạng video nhất định có sẵn cho cả phiên đấu giá công khai và giao dịch giá cố định, người đặt giá thầu sẽ nhận được các yêu cầu giá thầu riêng biệt cho từng loại, trong đó các quy tắc ràng buộc như thời lượng quảng cáo tối đa và liệu có cho phép quảng cáo có thể bỏ qua hay không có thể khác nhau. Do đó, việc làm phẳng áp dụng cho cơ hội quảng cáo giúp bạn dễ dàng phân biệt các quy tắc ràng buộc quảng cáo cho phiên đấu giá mở và giao dịch theo giá cố định.
Lưu ý: Phiên đấu giá kín và Gói đấu giá sẽ có các quy tắc ràng buộc giống hệt với phiên đấu giá mở và sẽ tiếp tục được đưa vào các yêu cầu giá thầu phiên đấu giá mở.Thời lượng tối đa của video có thể bỏ qua
Giao thức của Google và cách triển khai OpenRTB hỗ trợ các trường sau đây cho thời lượng video và khả năng bỏ qua:
Thời lượng
Thời lượng có thể bỏ qua
Khả năng bỏ qua
Giao thức Google
max_ad_durationskippable_max_ad_durationvideo_ad_skippable
OpenRTB
maxdurationkhông áp dụng
skip
Điều này có nghĩa là mặc dù giao thức của Google có thể có thời lượng chi tiết có thể bỏ qua và không thể bỏ qua, nhưng việc triển khai OpenRTB chỉ có một giá trị thời lượng tối đa.
Trước khi làm phẳng giá thầu, maxduration của OpenRTB sẽ được đặt thành giá trị thấp hơn trong các trường max_ad_duration và skippable_max_ad_duration của giao thức Google. Hành vi này hiện đã thay đổi thành việc gửi hai yêu cầu giá thầu riêng biệt khi các giá trị này khác nhau: một yêu cầu đại diện cho maxduration cho cơ hội có thể bỏ qua và yêu cầu còn lại cho cơ hội không thể bỏ qua.
Các ví dụ sau đây cho thấy cách một yêu cầu theo giao thức của Google được chuyển đổi sang OpenRTB trước và sau khi làm phẳng giá thầu. Yêu cầu tương đương về giao thức của Google có max_ad_duration là 15 và skippable_max_ad_duration là 60.
Ví dụ:
max_ad_durationskip (true HOẶC false)
Yêu cầu ban đầu không làm phẳng
15true
Yêu cầu được làm phẳng #1: Không thể bỏ qua
15false
Yêu cầu được làm phẳng #2: Có thể bỏ qua
60true
Việc phân tách yêu cầu giá thầu theo thời lượng video có thể bỏ qua sẽ chỉ diễn ra khi đáp ứng các điều kiện sau:
Yêu cầu này cho phép video.
Cả video có thể bỏ qua và không thể bỏ qua đều được cho phép, đồng thời hai thời lượng tối đa tương ứng sẽ khác nhau.
Yêu cầu này đủ điều kiện tham gia Phiên đấu giá kín hoặc Phiên đấu giá mở.
Tài khoản bên đặt giá thầu có các điểm cuối OpenRTB đang hoạt động.
Bạn có thể chọn không sử dụng loại làm phẳng này bằng cách liên hệ với người quản lý tài khoản kỹ thuật.
Nhóm video
Các yêu cầu giá thầu cho một nhóm video có nhiều cơ hội quảng cáo sẽ được làm phẳng,
tức là mỗi yêu cầu giá thầu là dành cho một cơ hội quảng cáo riêng lẻ trong nhóm đó.
Điều này cho phép bạn đặt giá thầu cho nhiều cơ hội quảng cáo cho một nhóm quảng cáo nhất định.
Đo lường mở
Đo lường mở cho phép bạn chỉ định các nhà cung cấp bên thứ ba cung cấp dịch vụ đo lường và xác minh độc lập cho quảng cáo được phân phát đến môi trường ứng dụng di động.
Bạn có thể xác định xem nhà xuất bản có hỗ trợ Đo lường mở trong yêu cầu giá thầu hay không bằng cách kiểm tra xem cơ hội quảng cáo có loại trừ thuộc tính OmsdkType:
OMSDK 1.0 có trong Thuộc tính mẫu quảng cáo mà nhà xuất bản có thể loại trừ hay không. Bạn có thể tìm thấy thuộc tính này trong thuộc tính battr cho Biểu ngữ hoặc Video , tuỳ thuộc vào định dạng.
Để biết thêm thông tin về cách diễn giải các yêu cầu giá thầu chứa tín hiệu Đo lường mở, hãy tham khảo bài viết về SDK Đo lường mở trên Trung tâm trợ giúp.
Yêu cầu giá thầu mẫu
Các phần sau đây cho thấy các yêu cầu giá thầu mẫu cho nhiều loại quảng cáo.
Lưu ý: Các mẫu Protobuf bao gồm các đường liên kết tải xuống các yêu cầu giá thầu tuần tự tương tự. Các giá trị này không được đảm bảo là giống nhau.
Biểu ngữ ứng dụng
OpenRTB Protobuf
Ví dụ minh họa
Yêu cầu tuần tự
id : "8361O9Ep6E42p52Hu6v18o"
imp {
id : "1"
banner {
w : 300
h : 50
pos : ABOVE_THE_FOLD
api : MRAID_1
api : MRAID_2
wmax : 390
hmax : 61
wmin : 261
hmin : 46
format {
w : 300
h : 50
}
format {
w : 390
h : 61
}
[ com . google . doubleclick . banner_ext ] {
flexslot {
wmin : 261
wmax : 390
hmin : 46
hmax : 61
}
}
}
displaymanager : "GoogleMobileAds-iOS"
displaymanagerver : "11.2.0"
tagid : "5609900911"
bidfloor : 0.01
bidfloorcur : "USD"
secure : true
exp : 3600
clickbrowser : true
metric {
type : "click_through_rate"
value : 0.0028797138947993517
vendor : "EXCHANGE"
}
metric {
type : "viewability"
value : 0.92
vendor : "EXCHANGE"
}
[ com . google . doubleclick . imp ] {
billing_id : 70614819650
publisher_settings_list_id : 3994817494897795207
publisher_settings_list_id : 8449380548613820850
allowed_vendor_type : 550
allowed_vendor_type : 79
ampad : AMP_AD_NOT_ALLOWED
skadn {
sourceapp : "com.google.testapp"
skadnetids : "Y8HK1z22"
versions : "2.0"
versions : "2.1"
fidelities : STOREKIT_RENDERED_ADS
fidelities : VIEW_THROUGH_ADS
}
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
billable_event_rate_bid_adjustment {
bid_adjustment : 0.9408176
creative_type : HTML_SNIPPET
}
ae : SERVER_SIDE_AUCTION
}
}
app {
name : "Test App"
ver : "4.6.3"
bundle : "com.google.testapp"
publisher {
id : "pub-2905535032168301"
[ com . google . doubleclick . publisher ] {
country : "JP"
}
}
content {
url : "https://www.google.com"
livestream : false
language : "ja"
}
storeurl : "https://www.google.com"
[ com . google . doubleclick . app ] {
inventorypartnerdomain : "OMITTED"
}
}
device {
ua : "OMITTED"
ip : "192.168.1.0"
geo {
lat : 0.0
lon : 0.0
country : "JPN"
region : "JP-13"
type : IP
utcoffset : 540
accuracy : 26487
[ com . google . doubleclick . geo ] {
geo_criteria_id : 20636
}
}
carrier : "70002"
make : "Apple"
model : "iPhone13,2"
os : "iOS"
osv : "16.1.1"
connectiontype : CELL_4G
devicetype : HIGHEND_PHONE
lmt : true
hwv : "iPhone13,2"
w : 390
h : 844
pxratio : 3.0
sua {
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "605"
version : "1"
}
platform {
brand : "iPhone"
version : "16"
version : "1"
}
mobile : true
bitness : "64"
model : "iPhone"
source : USER_AGENT_STRING
}
[ com . google . doubleclick . device ] {
atts : 2
}
}
user {
[ com . google . doubleclick . user ] {
session {
duration : 61
}
}
}
at : FIRST_PRICE
tmax : 1000
cur : "USD"
bcat : "IAB14-1"
bcat : "IAB7-39"
source {
schain {
complete : true
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : true
}
ver : "1.0"
}
[ com . google . doubleclick . source ] {
omidpn : "Google"
omidpv : "afma-sdk-i-v11.2.0"
schain {
complete : 1
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : 1
}
ver : "1.0"
}
}
}
[ com . google . doubleclick . bid_request ] {
google_query_id : "ANy-z60259-oh0d8s5Z26f34EZa77T0p62zWhI2939jRL32216xlr9483rnAC6t07lL0ky4q"
fcap_scope : FREQUENCY_CAPPING_SCOPE_APP
privacy_treatments {
allow_user_data_collection : true
}
}
JSON OpenRTB
Ví dụ minh họa
{
"id" : "8361O9Ep6E42p52Hu6v18o" ,
"imp" : [
{
"id" : "1" ,
"banner" : {
"w" : 300 ,
"h" : 50 ,
"pos" : 1 ,
"api" : [
3 ,
5
],
"wmax" : 390 ,
"hmax" : 61 ,
"wmin" : 261 ,
"hmin" : 46 ,
"format" : [
{
"w" : 300 ,
"h" : 50
},
{
"w" : 390 ,
"h" : 61
}
],
"ext" : {
"flexslot" : {
"wmin" : 261 ,
"wmax" : 390 ,
"hmin" : 46 ,
"hmax" : 61
}
}
},
"displaymanager" : "GoogleMobileAds-iOS" ,
"displaymanagerver" : "11.2.0" ,
"tagid" : "5609900911" ,
"bidfloor" : 0.01 ,
"bidfloorcur" : "USD" ,
"secure" : 1 ,
"exp" : 3600 ,
"clickbrowser" : 1 ,
"metric" : [
{
"type" : "click_through_rate" ,
"value" : 0.0028797138947993517 ,
"vendor" : "EXCHANGE"
},
{
"type" : "viewability" ,
"value" : 0.92 ,
"vendor" : "EXCHANGE"
}
],
"ext" : {
"billing_id" : [
"70614819650"
],
"publisher_settings_list_id" : [
"3994817494897795207" ,
"8449380548613820850"
],
"allowed_vendor_type" : [
550 ,
79
],
"ampad" : 2 ,
"skadn" : {
"sourceapp" : "com.google.testapp" ,
"skadnetids" : [
"Y8HK1z22"
],
"versions" : [
"2.0" ,
"2.1"
],
"fidelities" : [
1 ,
0
]
},
"creative_enforcement_settings" : {
"policy_enforcement" : 2 ,
"publisher_blocks_enforcement" : 1
},
"auction_environment" : 0 ,
"billable_event_rate_bid_adjustment" : [
{
"bid_adjustment" : 0.9408176 ,
"creative_type" : 1
}
],
"ae" : 0
}
}
],
"app" : {
"name" : "Test App" ,
"ver" : "4.6.3" ,
"bundle" : "com.google.testapp" ,
"publisher" : {
"id" : "pub-2905535032168301" ,
"ext" : {
"country" : "JP"
}
},
"content" : {
"url" : "https://www.google.com" ,
"livestream" : 0 ,
"language" : "ja"
},
"storeurl" : "https://www.google.com" ,
"ext" : {
"inventorypartnerdomain" : "OMITTED"
}
},
"device" : {
"ua" : "OMITTED" ,
"ip" : "192.168.1.0" ,
"geo" : {
"lat" : 0.0 ,
"lon" : 0.0 ,
"country" : "JPN" ,
"region" : "JP-13" ,
"type" : 2 ,
"utcoffset" : 540 ,
"accuracy" : 26487 ,
"ext" : {
"geo_criteria_id" : 20636
}
},
"carrier" : "70002" ,
"make" : "Apple" ,
"model" : "iPhone13,2" ,
"os" : "iOS" ,
"osv" : "16.1.1" ,
"connectiontype" : 6 ,
"devicetype" : 4 ,
"lmt" : 1 ,
"hwv" : "iPhone13,2" ,
"w" : 390 ,
"h" : 844 ,
"pxratio" : 3.0 ,
"sua" : {
"browsers" : [
{
"brand" : "Mozilla" ,
"version" : [
"5" ,
"0"
]
},
{
"brand" : "AppleWebKit" ,
"version" : [
"605" ,
"1"
]
}
],
"platform" : {
"brand" : "iPhone" ,
"version" : [
"16" ,
"1"
]
},
"mobile" : 1 ,
"bitness" : "64" ,
"model" : "iPhone" ,
"source" : 3
},
"ext" : {
"atts" : 2
}
},
"user" : {
"ext" : {
"session" : {
"duration" : 61
}
}
},
"at" : 1 ,
"tmax" : 1000 ,
"cur" : [
"USD"
],
"bcat" : [
"IAB14-1" ,
"IAB7-39"
],
"source" : {
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
},
"ext" : {
"omidpn" : "Google" ,
"omidpv" : "afma-sdk-i-v11.2.0" ,
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
}
}
},
"ext" : {
"google_query_id" : "ANy-z60259-oh0d8s5Z26f34EZa77T0p62zWhI2939jRL32216xlr9483rnAC6t07lL0ky4q" ,
"fcap_scope" : 4 ,
"privacy_treatments" : {
"allow_user_data_collection" : 1
}
}
}
Google (Không dùng nữa)
Ví dụ minh họa
Yêu cầu tuần tự
id : "%\360\313c\223\244&\242H\313\345\032T\223^\3325p;e\320\275\333"
ip : "\300\250"
user_agent : "OMITTED"
url : "https://www.google.com"
detected_language : "en"
adslot {
id : 1
width : 300
width : 250
height : 250
height : 250
excluded_attribute : 14
excluded_attribute : 30
allowed_vendor_type : 566
allowed_vendor_type : 113
excluded_sensitive_category : 36
excluded_sensitive_category : 31
matching_ad_data {
billing_id : 99718422589
minimum_cpm_micros : 40000
}
slot_visibility : ABOVE_THE_FOLD
ad_block_key : 1885999125
publisher_settings_list_id : 3855970278395809335
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
viewability : 79
click_through_rate : 0.00562083
allowed_ad_types : ALLOWED_AD_TYPE_BANNER
is_amp_page : DIALECT_HTML
amp_ad_requirement_type : AMP_AD_NOT_ALLOWED
api : OMID_1
api : MRAID_1
omidpn : "Google"
omidpv : "afma-sdk-i-v11.3.0"
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
impression_expiration_seconds : 3600
billable_event_rate_bid_adjustment {
bid_adjustment : 1.0
creative_type : HTML_SNIPPET
}
excluded_app_ids : "1359763701"
excluded_app_ids : "367003839"
supported_auction_environment : SERVER_SIDE_AUCTION
display_manager : "GoogleMobileAds-iOS"
display_manager_version : "11.3.0"
}
is_test : false
timezone_offset : 330
mobile {
app_id : "195751234"
is_app : true
is_mobile_web_optimized : true
app_name : "Test App"
skadn {
sourceapp : "195751234"
skadnetids : "DofiF4X5"
versions : "2.0"
versions : "2.1"
supported_fidelity_types : VIEW_THROUGH_ADS
supported_fidelity_types : STOREKIT_RENDERED_ADS
}
}
geo_criteria_id : 1007776
publisher_settings_list_id : 8761862033459127079
publisher_type : PUBLISHER_OWNED_AND_OPERATED
partner_id : 9618759969316406640
device {
device_type : HIGHEND_PHONE
platform : "iphone"
brand : "Apple"
model : "iPhone15,3"
os_version {
major : 18
minor : 0
}
carrier_id : 0
screen_width : 430
screen_height : 932
screen_pixel_ratio_millis : 3000
screen_orientation : PORTRAIT
hardware_version : "iPhone15,3"
limit_ad_tracking : true
app_tracking_authorization_status : DENIED
connection_type : CELL_4G
}
publisher_country : "SG"
publisher_id : "pub-1111111111111111"
response_deadline_ms : 1000
google_query_id : "ANy-z77R39-62EWf097071AiV91giun09eX9bwHu5TL506725r73P656pqL7A344LmT9485F"
auction_type : FIRST_PRICE
geo {
lat : 0.0
lon : 0.0
country : "IND"
region : "IN-KL"
city : "Cochin"
utcoffset : 330
accuracy : 11461
}
user_agent_data {
platform {
brand : "iPhone"
version : "18"
version : "0"
}
mobile : true
model : "iPhone"
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "605"
version : "1"
}
bitness : "64"
source : USER_AGENT_STRING
}
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_APP
privacy_treatments {
allow_user_data_collection : true
}
inventory_partner_domain : "OMITTED"
session_duration_seconds : 660
Quảng cáo xen kẽ trong ứng dụng
OpenRTB Protobuf
Ví dụ minh họa
Yêu cầu tuần tự
id : "27q8F4ja125b5Ay5Lg5I8Y"
imp {
id : "1"
banner {
w : 368
h : 740
pos : AD_POSITION_FULLSCREEN
api : MRAID_1
api : MRAID_2
format {
w : 368
h : 740
}
format {
w : 300
h : 600
}
}
displaymanager : "GoogleMobileAds-Android"
displaymanagerver : "21.5.0"
instl : true
tagid : "7072441745"
bidfloor : 0.01
bidfloorcur : "USD"
secure : true
exp : 14400
clickbrowser : true
metric {
type : "click_through_rate"
value : 0.026930272579193115
vendor : "EXCHANGE"
}
metric {
type : "viewability"
value : 0.82
vendor : "EXCHANGE"
}
[ com . google . doubleclick . imp ] {
billing_id : 14443955188
publisher_settings_list_id : 7634109184153514733
publisher_settings_list_id : 4552400977800686866
allowed_vendor_type : 4374
allowed_vendor_type : 4651
ampad : AMP_AD_NOT_ALLOWED
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
is_app_open_ad : true
ae : SERVER_SIDE_AUCTION
}
}
app {
name : "Test App"
ver : "9.1.6"
bundle : "com.google.testapp"
publisher {
id : "pub-8897222327395144"
[ com . google . doubleclick . publisher ] {
country : "TH"
}
}
content {
url : "https://www.google.com"
userrating : "4.7"
livestream : false
language : "en"
}
storeurl : "https://www.google.com"
[ com . google . doubleclick . app ] {
inventorypartnerdomain : "OMITTED"
}
}
device {
ua : "OMITTED"
geo {
lat : 0.0
lon : 0.0
country : "IND"
region : "IN-OR"
zip : "751024"
type : IP
utcoffset : 330
accuracy : 5126
[ com . google . doubleclick . geo ] {
geo_criteria_id : 9149991
}
}
ipv6 : "2401:4900:3da4::"
carrier : "70210"
make : "Samsung"
model : "SM-A705GM"
os : "android"
osv : "11"
connectiontype : WIFI
devicetype : HIGHEND_PHONE
lmt : true
w : 384
h : 812
pxratio : 2.813
sua {
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "537"
version : "36"
}
platform {
brand : "Android"
version : "11"
}
mobile : true
model : "SM-A705GM"
source : USER_AGENT_STRING
}
[ com . google . doubleclick . device ] {
session_id : "LFcNok-qRI2ea_Z5FPgRiA"
}
}
user {
[ com . google . doubleclick . user ] {
session {
duration : 89
}
}
}
at : FIRST_PRICE
tmax : 300
cur : "USD"
bcat : "IAB23-3"
bcat : "IAB23-4"
source {
schain {
complete : true
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : true
}
ver : "1.0"
}
[ com . google . doubleclick . source ] {
omidpn : "Google"
omidpv : "afma-sdk-a-v243220999.224400000.1"
schain {
complete : 1
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : 1
}
ver : "1.0"
}
}
}
[ com . google . doubleclick . bid_request ] {
google_query_id : "ANy-z7C179-E2Rj2VZOiHt5vMyI25Z3W94Lk71Tbz95m005IfNm8OP88j46C27ovLV5yV57m"
fcap_scope : FREQUENCY_CAPPING_SCOPE_APP
privacy_treatments {
allow_user_data_collection : true
}
}
JSON OpenRTB
Ví dụ minh họa
{
"id" : "27q8F4ja125b5Ay5Lg5I8Y" ,
"imp" : [
{
"id" : "1" ,
"banner" : {
"w" : 368 ,
"h" : 740 ,
"pos" : 7 ,
"api" : [
3 ,
5
],
"format" : [
{
"w" : 368 ,
"h" : 740
},
{
"w" : 300 ,
"h" : 600
}
]
},
"displaymanager" : "GoogleMobileAds-Android" ,
"displaymanagerver" : "21.5.0" ,
"instl" : 1 ,
"tagid" : "7072441745" ,
"bidfloor" : 0.01 ,
"bidfloorcur" : "USD" ,
"secure" : 1 ,
"exp" : 14400 ,
"clickbrowser" : 1 ,
"metric" : [
{
"type" : "click_through_rate" ,
"value" : 0.026930272579193115 ,
"vendor" : "EXCHANGE"
},
{
"type" : "viewability" ,
"value" : 0.82 ,
"vendor" : "EXCHANGE"
}
],
"ext" : {
"billing_id" : [
"14443955188"
],
"publisher_settings_list_id" : [
"7634109184153514733" ,
"4552400977800686866"
],
"allowed_vendor_type" : [
4374 ,
4651
],
"ampad" : 2 ,
"excluded_creatives" : [
{
"buyer_creative_id" : "EXCLUDED_BUYER_CREATIVE_ID"
},
{
"buyer_creative_id" : "EXCLUDED_BUYER_CREATIVE_ID"
}
],
"creative_enforcement_settings" : {
"policy_enforcement" : 2 ,
"publisher_blocks_enforcement" : 1
},
"auction_environment" : 0 ,
"is_app_open_ad" : 1 ,
"ae" : 0
}
}
],
"app" : {
"name" : "Test App" ,
"ver" : "9.1.6" ,
"bundle" : "com.google.testapp" ,
"publisher" : {
"id" : "pub-8897222327395144" ,
"ext" : {
"country" : "TH"
}
},
"content" : {
"url" : "https://www.google.com" ,
"userrating" : "4.7" ,
"livestream" : 0 ,
"language" : "en"
},
"storeurl" : "https://www.google.com" ,
"ext" : {
"inventorypartnerdomain" : "OMITTED"
}
},
"device" : {
"ua" : "OMITTED" ,
"geo" : {
"lat" : 0.0 ,
"lon" : 0.0 ,
"country" : "IND" ,
"region" : "IN-OR" ,
"zip" : "751024" ,
"type" : 2 ,
"utcoffset" : 330 ,
"accuracy" : 5126 ,
"ext" : {
"geo_criteria_id" : 9149991
}
},
"ipv6" : "2401:4900:3da4::" ,
"carrier" : "70210" ,
"make" : "Samsung" ,
"model" : "SM-A705GM" ,
"os" : "android" ,
"osv" : "11" ,
"connectiontype" : 2 ,
"devicetype" : 4 ,
"lmt" : 1 ,
"w" : 384 ,
"h" : 812 ,
"pxratio" : 2.813 ,
"sua" : {
"browsers" : [
{
"brand" : "Mozilla" ,
"version" : [
"5" ,
"0"
]
},
{
"brand" : "AppleWebKit" ,
"version" : [
"537" ,
"36"
]
}
],
"platform" : {
"brand" : "Android" ,
"version" : [
"11"
]
},
"mobile" : 1 ,
"model" : "SM-A705GM" ,
"source" : 3
},
"ext" : {
"session_id" : "LFcNok-qRI2ea_Z5FPgRiA"
}
},
"user" : {
"ext" : {
"session" : {
"duration" : 89
}
}
},
"at" : 1 ,
"tmax" : 300 ,
"cur" : [
"USD"
],
"bcat" : [
"IAB23-3" ,
"IAB23-4"
],
"source" : {
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
},
"ext" : {
"omidpn" : "Google" ,
"omidpv" : "afma-sdk-a-v243220999.224400000.1" ,
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
}
}
},
"ext" : {
"google_query_id" : "ANy-z7C179-E2Rj2VZOiHt5vMyI25Z3W94Lk71Tbz95m005IfNm8OP88j46C27ovLV5yV57m" ,
"fcap_scope" : 4 ,
"privacy_treatments" : {
"allow_user_data_collection" : 1
}
}
}
Google (Không dùng nữa)
Ví dụ minh họa
Yêu cầu tuần tự
id : "\275\302\334\306\350\275\013\246\272\341\347:\001\261e\316\266A\345-\275KY"
user_agent : "OMITTED"
url : "https://www.google.com"
detected_language : "fa"
adslot {
id : 1
width : 756
width : 336
height : 384
height : 280
excluded_attribute : 27
excluded_attribute : 18
allowed_vendor_type : 414
allowed_vendor_type : 780
excluded_sensitive_category : 19
excluded_sensitive_category : 4
matching_ad_data {
billing_id : 12608068331
billing_id : 32735556853
minimum_cpm_micros : 530000
}
matching_ad_data {
billing_id : 57993817261
billing_id : 38977320457
minimum_cpm_micros : 220000
}
slot_visibility : ABOVE_THE_FOLD
excluded_product_category : 10137
excluded_product_category : 13314
ad_block_key : 9588004964
publisher_settings_list_id : 5660377215376132006
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
viewability : 74
click_through_rate : 0.010888527
allowed_ad_types : ALLOWED_AD_TYPE_BANNER
is_amp_page : DIALECT_HTML
amp_ad_requirement_type : AMP_AD_NOT_ALLOWED
api : OMID_1
api : MRAID_1
omidpn : "Google"
omidpv : "afma-sdk-a-v243220999.241199000.1"
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
impression_expiration_seconds : 3600
supported_auction_environment : SERVER_SIDE_AUCTION
display_manager : "GoogleMobileAds-Android"
display_manager_version : "23.1.0"
}
is_test : false
timezone_offset : 210
mobile {
app_id : "com.google.testapp"
is_app : true
is_interstitial_request : true
is_mobile_web_optimized : true
app_name : "Test App"
app_rating : 4.392222
}
geo_criteria_id : 2276
publisher_settings_list_id : 12210881757835437691
publisher_type : PUBLISHER_OWNED_AND_OPERATED
partner_id : 5268591861321003271
device {
device_type : HIGHEND_PHONE
platform : "android"
brand : "Samsung"
model : "SM-A546E"
os_version {
major : 14
}
carrier_id : 0
screen_width : 756
screen_height : 384
screen_pixel_ratio_millis : 2813
screen_orientation : LANDSCAPE
limit_ad_tracking : false
connection_type : CELL_4G
}
publisher_country : "GB"
publisher_id : "pub-1111111111111111"
response_deadline_ms : 300
google_query_id : "ANy-zCczd2-28ZNY4j78b8024p1s4MJUg62G4F8H3P1YS544377wezcJVi4h3I9LB3y7yW80"
auction_type : FIRST_PRICE
geo {
lat : 0.0
lon : 0.0
country : "DEU"
utcoffset : 210
accuracy : 346648
}
user_agent_data {
platform {
brand : "Android"
version : "14"
}
mobile : true
model : "SM-A546E"
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "537"
version : "36"
}
bitness : "64"
source : USER_AGENT_STRING
}
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_DEVICE
privacy_treatments {
ip : IP_REDACTED
user_agent : USER_AGENT_COARSE
non_personalized_ads_reason : PUBLISHER_DECLARED_NPA
allow_user_data_collection : false
}
inventory_partner_domain : "OMITTED"
navigation_type : NAVIGATION_TYPE_UNKNOWN
session_duration_seconds : 25
Quảng cáo xen kẽ dạng video trong ứng dụng
OpenRTB Protobuf
Ví dụ minh họa
Yêu cầu tuần tự
id : "Z75GBa308fk6hn20L15573"
imp {
id : "1"
video {
mimes : "video/mp4"
linearity : LINEAR
maxduration : 600
w : 808
h : 393
startdelay : 0
playbackmethod : AUTO_PLAY_SOUND_ON
pos : AD_POSITION_FULLSCREEN
api : MRAID_1
api : MRAID_2
protocols : VAST_2_0
protocols : VAST_3_0
skip : true
placement : FLOATING_PLACEMENT
playbackend : COMPLETION_OR_USER
maxseq : 2
poddur : 30
plcmt : PLCMT_INTERSTITIAL
[ com . google . doubleclick . video ] {
inferredplcmt : PLCMT_INTERSTITIAL
}
}
displaymanager : "GoogleMobileAds-iOS"
displaymanagerver : "11.7.0"
instl : true
tagid : "4967856214"
bidfloor : 0.01
bidfloorcur : "USD"
secure : true
exp : 3600
clickbrowser : true
metric {
type : "click_through_rate"
value : 0.1879923790693283
vendor : "EXCHANGE"
}
metric {
type : "video_completion_rate"
value : 0.5191752910614014
vendor : "EXCHANGE"
}
rwdd : true
[ com . google . doubleclick . imp ] {
billing_id : 11004606416
publisher_settings_list_id : 8773808361916105146
publisher_settings_list_id : 3073503389278955207
allowed_vendor_type : 39523
allowed_vendor_type : 237
is_rewarded_inventory : true
ampad : AMP_AD_NOT_ALLOWED
skadn {
sourceapp : "com.google.testapp"
skadnetids : "O5O88B57"
versions : "2.0"
versions : "2.1"
fidelities : VIEW_THROUGH_ADS
fidelities : STOREKIT_RENDERED_ADS
skoverlay : true
}
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
ae : SERVER_SIDE_AUCTION
}
}
app {
name : "Test App"
ver : "4.90.0"
bundle : "com.google.testapp"
publisher {
id : "pub-7879459471889169"
[ com . google . doubleclick . publisher ] {
country : "TR"
}
}
content {
url : "https://www.google.com"
livestream : false
language : "ar"
}
storeurl : "https://www.google.com"
[ com . google . doubleclick . app ] {
inventorypartnerdomain : "OMITTED"
}
}
device {
ua : "OMITTED"
geo {
lat : 0.0
lon : 0.0
country : "SAU"
region : "SA-02"
city : "Jiddah"
type : IP
utcoffset : 180
accuracy : 25209
[ com . google . doubleclick . geo ] {
geo_criteria_id : 1012089
}
}
ipv6 : "2001:16a4:253::"
make : "Apple"
model : "iPhone12,1"
os : "iOS"
osv : "17.4.1"
connectiontype : CELL_4G
devicetype : HIGHEND_PHONE
ifa : "cd6a5706-5a73-4ab8-a2bb-cd19244bf295"
lmt : false
hwv : "iPhone12,1"
w : 896
h : 414
pxratio : 2.0
sua {
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "605"
version : "1"
}
platform {
brand : "iPhone"
version : "17"
version : "4"
}
mobile : true
bitness : "64"
model : "iPhone"
source : USER_AGENT_STRING
}
[ com . google . doubleclick . device ] {
atts : 3
}
}
user {
id : "19G1O820z9ay0DxfvVm89xd7Gbh"
[ com . google . doubleclick . user ] {
session {
}
idage : 2592000
}
}
at : FIRST_PRICE
tmax : 1500
cur : "USD"
bcat : "IAB7-39"
bcat : "IAB14-1"
bapp : "372513032"
source {
schain {
complete : true
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : true
}
ver : "1.0"
}
[ com . google . doubleclick . source ] {
omidpn : "Google"
omidpv : "afma-sdk-i-v11.7.0"
schain {
complete : 1
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : 1
}
ver : "1.0"
}
}
}
[ com . google . doubleclick . bid_request ] {
google_query_id : "ANy-z8zAo9-0x39o5pDG1Y19AT868LK88gvsh49Y6357Sb40978n97j8nn75XXGGp19xFp5E"
fcap_scope : FREQUENCY_CAPPING_SCOPE_DEVICE
privacy_treatments {
allow_user_data_collection : true
}
}
JSON OpenRTB
Ví dụ minh họa
{
"id" : "Z75GBa308fk6hn20L15573" ,
"imp" : [
{
"id" : "1" ,
"video" : {
"mimes" : [
"video/mp4"
],
"linearity" : 1 ,
"maxduration" : 600 ,
"w" : 808 ,
"h" : 393 ,
"startdelay" : 0 ,
"playbackmethod" : [
1
],
"pos" : 7 ,
"api" : [
3 ,
5
],
"protocols" : [
2 ,
3
],
"skip" : 1 ,
"placement" : 5 ,
"playbackend" : 1 ,
"maxseq" : 2 ,
"poddur" : 30 ,
"plcmt" : 3 ,
"ext" : {
"inferredplcmt" : 3
}
},
"displaymanager" : "GoogleMobileAds-iOS" ,
"displaymanagerver" : "11.7.0" ,
"instl" : 1 ,
"tagid" : "4967856214" ,
"bidfloor" : 0.01 ,
"bidfloorcur" : "USD" ,
"secure" : 1 ,
"exp" : 3600 ,
"clickbrowser" : 1 ,
"metric" : [
{
"type" : "click_through_rate" ,
"value" : 0.1879923790693283 ,
"vendor" : "EXCHANGE"
},
{
"type" : "video_completion_rate" ,
"value" : 0.5191752910614014 ,
"vendor" : "EXCHANGE"
}
],
"rwdd" : 1 ,
"ext" : {
"billing_id" : [
"11004606416"
],
"publisher_settings_list_id" : [
"8773808361916105146" ,
"3073503389278955207"
],
"allowed_vendor_type" : [
39523 ,
237
],
"is_rewarded_inventory" : 1 ,
"ampad" : 2 ,
"skadn" : {
"sourceapp" : "com.google.testapp" ,
"skadnetids" : [
"O5O88B57"
],
"versions" : [
"2.0" ,
"2.1"
],
"fidelities" : [
0 ,
1
],
"skoverlay" : 1
},
"creative_enforcement_settings" : {
"policy_enforcement" : 2 ,
"publisher_blocks_enforcement" : 1
},
"auction_environment" : 0 ,
"ae" : 0
}
}
],
"app" : {
"name" : "Test App" ,
"ver" : "4.90.0" ,
"bundle" : "com.google.testapp" ,
"publisher" : {
"id" : "pub-7879459471889169" ,
"ext" : {
"country" : "TR"
}
},
"content" : {
"url" : "https://www.google.com" ,
"livestream" : 0 ,
"language" : "ar"
},
"storeurl" : "https://www.google.com" ,
"ext" : {
"inventorypartnerdomain" : "OMITTED"
}
},
"device" : {
"ua" : "OMITTED" ,
"geo" : {
"lat" : 0.0 ,
"lon" : 0.0 ,
"country" : "SAU" ,
"region" : "SA-02" ,
"city" : "Jiddah" ,
"type" : 2 ,
"utcoffset" : 180 ,
"accuracy" : 25209 ,
"ext" : {
"geo_criteria_id" : 1012089
}
},
"ipv6" : "2001:16a4:253::" ,
"make" : "Apple" ,
"model" : "iPhone12,1" ,
"os" : "iOS" ,
"osv" : "17.4.1" ,
"connectiontype" : 6 ,
"devicetype" : 4 ,
"ifa" : "cd6a5706-5a73-4ab8-a2bb-cd19244bf295" ,
"lmt" : 0 ,
"hwv" : "iPhone12,1" ,
"w" : 896 ,
"h" : 414 ,
"pxratio" : 2.0 ,
"sua" : {
"browsers" : [
{
"brand" : "Mozilla" ,
"version" : [
"5" ,
"0"
]
},
{
"brand" : "AppleWebKit" ,
"version" : [
"605" ,
"1"
]
}
],
"platform" : {
"brand" : "iPhone" ,
"version" : [
"17" ,
"4"
]
},
"mobile" : 1 ,
"bitness" : "64" ,
"model" : "iPhone" ,
"source" : 3
},
"ext" : {
"atts" : 3
}
},
"user" : {
"id" : "19G1O820z9ay0DxfvVm89xd7Gbh" ,
"ext" : {
"idage" : 2592000
}
},
"at" : 1 ,
"tmax" : 1500 ,
"cur" : [
"USD"
],
"bcat" : [
"IAB7-39" ,
"IAB14-1"
],
"bapp" : [
"372513032"
],
"source" : {
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
},
"ext" : {
"omidpn" : "Google" ,
"omidpv" : "afma-sdk-i-v11.7.0" ,
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
}
}
},
"ext" : {
"google_query_id" : "ANy-z8zAo9-0x39o5pDG1Y19AT868LK88gvsh49Y6357Sb40978n97j8nn75XXGGp19xFp5E" ,
"fcap_scope" : 3 ,
"privacy_treatments" : {
"allow_user_data_collection" : 1
}
}
}
Google (Không dùng nữa)
Ví dụ minh họa
Yêu cầu tuần tự
id : "\r[\217Z\313$\317\325\226\261\321\1775\317O7#\003\232\315\322y\242"
ip : "\300\250"
user_agent : "OMITTED"
url : "https://www.google.com"
detected_language : "ja"
adslot {
id : 1
width : 393
width : 375
height : 734
height : 667
excluded_attribute : 17
excluded_attribute : 20
allowed_vendor_type : 38523
allowed_vendor_type : 797
matching_ad_data {
billing_id : 95400492935
minimum_cpm_micros : 1610000
}
slot_visibility : ABOVE_THE_FOLD
ad_block_key : 2826108213
publisher_settings_list_id : 4043976311652409571
viewability : 87
click_through_rate : 0.2761753
video_completion_rate : 0.43977627
is_rewarded : true
allowed_ad_types : ALLOWED_AD_TYPE_VIDEO
is_amp_page : DIALECT_HTML
amp_ad_requirement_type : AMP_AD_NOT_ALLOWED
session_depth : 1
api : OMID_1
api : MRAID_1
omidpn : "Google"
omidpv : "afma-sdk-i-v9.14.0"
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
impression_expiration_seconds : 3600
supported_auction_environment : SERVER_SIDE_AUCTION
display_manager : "GoogleMobileAds-iOS"
display_manager_version : "9.14.0"
}
is_test : false
cookie_version : 1
google_user_id : "502CF94564uk2a9qWk698927A00"
timezone_offset : 540
mobile {
app_id : "751592940"
is_app : true
is_interstitial_request : true
is_mobile_web_optimized : true
encrypted_advertising_id : "\371\014\274[\224\356\250D\210\224\023\2518\230P.\000\325j1\310\341\215i\336\2063\213a\276b\263\236\201\007n"
app_name : "Test App"
advertising_id : "}\372\006\246c\347\275s\243|\353\326\272\305\021|"
skadn {
sourceapp : "751592940"
skadnetids : "113tdmXM"
versions : "2.0"
versions : "2.1"
supported_fidelity_types : STOREKIT_RENDERED_ADS
supported_fidelity_types : VIEW_THROUGH_ADS
}
}
video {
videoad_start_delay : 0
video_ad_skippable : REQUIRE_SKIPPABLE
skippable_max_ad_duration : 600000
allowed_video_formats : VIDEO_MP4
max_ads_in_pod : 2
end_cap_support : END_CAP_OPTIONAL
playback_method : AUTO_PLAY_SOUND_ON
is_clickable : true
placement : INTERSTITIAL
protocols : VAST_2_0
protocols : VAST_3_0
is_livestream : false
playback_cessation_mode : COMPLETION_OR_USER
max_pod_duration_seconds : 30
plcmt : PLCMT_INTERSTITIAL
inferred_plcmt : PLCMT_INTERSTITIAL
}
cookie_age_seconds : 1987200
geo_criteria_id : 9198798
publisher_settings_list_id : 11747008975924952385
publisher_type : PUBLISHER_OWNED_AND_OPERATED
partner_id : 2681496334840881279
device {
device_type : HIGHEND_PHONE
platform : "iphone"
brand : "Apple"
model : "iPhone17,1"
os_version {
major : 18
minor : 0
micro : 1
}
carrier_id : 0
screen_width : 393
screen_height : 852
screen_pixel_ratio_millis : 3000
screen_orientation : PORTRAIT
hardware_version : "iPhone17,1"
limit_ad_tracking : false
app_tracking_authorization_status : AUTHORIZED
connection_type : WIFI
}
publisher_country : "JP"
publisher_id : "pub-1111111111111111"
response_deadline_ms : 1000
google_query_id : "ANy-zFwQ7x-eW9k8bHJRKvLLM9e761HV19R7ov42ZD0Xgyt270Y690867s819cwM7RA163W7"
auction_type : FIRST_PRICE
geo {
lat : 0.0
lon : 0.0
country : "JPN"
region : "JP-34"
city : "Hiroshima"
utcoffset : 540
accuracy : 6105
}
user_agent_data {
platform {
brand : "iPhone"
version : "18"
version : "0"
}
mobile : true
model : "iPhone"
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "605"
version : "1"
}
bitness : "64"
source : USER_AGENT_STRING
}
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_DEVICE
privacy_treatments {
allow_user_data_collection : true
}
inventory_partner_domain : "OMITTED"
session_duration_seconds : 370
Ứng dụng gốc
OpenRTB Protobuf
Ví dụ minh họa
Yêu cầu tuần tự
id : "3rF2U7Feg24806GjUY2Lr5"
imp {
id : "1"
displaymanager : "GoogleMobileAds-Android"
displaymanagerver : "22.3.0"
tagid : "3320317218"
bidfloor : 0.01
bidfloorcur : "USD"
secure : true
native {
ver : "1.2"
api : MRAID_1
api : MRAID_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
data {
type : SPONSORED
len : 25
}
}
assets {
id : 5
required : true
img {
type : MAIN
wmin : 1200
hmin : 627
}
}
assets {
id : 6
img {
type : LOGO
wmin : 100
hmin : 100
}
}
eventtrackers {
event : IMPRESSION
methods : IMG
}
privacy : true
}
}
exp : 3600
clickbrowser : true
metric {
type : "click_through_rate"
value : 0.10741956532001495
vendor : "EXCHANGE"
}
metric {
type : "viewability"
value : 0.58
vendor : "EXCHANGE"
}
[ com . google . doubleclick . imp ] {
billing_id : 29846056590
publisher_settings_list_id : 4793646945897060511
publisher_settings_list_id : 3704654811398966070
allowed_vendor_type : 780
allowed_vendor_type : 237
ampad : AMP_AD_NOT_ALLOWED
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
billable_event_rate_bid_adjustment {
bid_adjustment : 1.2858465
creative_type : NATIVE
}
ae : SERVER_SIDE_AUCTION
}
}
app {
name : "Test App"
bundle : "com.google.testapp"
publisher {
id : "pub-9497839363952914"
[ com . google . doubleclick . publisher ] {
country : "HK"
}
}
content {
url : "https://www.google.com"
userrating : "4.4"
livestream : false
language : "ar"
}
storeurl : "https://www.google.com"
[ com . google . doubleclick . app ] {
inventorypartnerdomain : "OMITTED"
}
}
device {
ua : "OMITTED"
ip : "192.168.1.0"
geo {
lat : 0.0
lon : 0.0
country : "EGY"
region : "EG-ALX"
city : "Alexandria"
type : IP
utcoffset : 180
accuracy : 2052
[ com . google . doubleclick . geo ] {
geo_criteria_id : 9198011
}
}
make : "Xiaomi"
model : "M2006C3MG"
os : "android"
osv : "10"
connectiontype : CELL_4G
devicetype : HIGHEND_PHONE
lmt : false
w : 360
h : 725
pxratio : 2.0
sua {
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "537"
version : "36"
}
platform {
brand : "Android"
version : "10"
}
mobile : true
model : "M2006C3MG"
source : USER_AGENT_STRING
}
}
user {
[ com . google . doubleclick . user ] {
session {
duration : 14
}
}
}
at : FIRST_PRICE
tmax : 300
cur : "USD"
source {
schain {
complete : true
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : true
}
ver : "1.0"
}
[ com . google . doubleclick . source ] {
omidpn : "Google"
omidpv : "afma-sdk-a-v243799999.232400000.1"
schain {
complete : 1
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : 1
}
ver : "1.0"
}
}
}
[ com . google . doubleclick . bid_request ] {
google_query_id : "ANy-z2g135-A631Sj54M16BCG6dC277E40D9nL3r921i0k2974f1q051601623F0i9232692"
fcap_scope : FREQUENCY_CAPPING_SCOPE_BROWSER
privacy_treatments {
non_personalized_ads_reason : USER_OPT_OUT
allow_user_data_collection : false
}
}
JSON OpenRTB
Ví dụ minh họa
{
"id" : "3rF2U7Feg24806GjUY2Lr5" ,
"imp" : [
{
"id" : "1" ,
"displaymanager" : "GoogleMobileAds-Android" ,
"displaymanagerver" : "22.3.0" ,
"tagid" : "3320317218" ,
"bidfloor" : 0.01 ,
"bidfloorcur" : "USD" ,
"secure" : 1 ,
"native" : {
"ver" : "1.2" ,
"api" : [
3 ,
5
],
"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,\"data\":{\"type\":1,\"len\":25}},{\"id\":5,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":6,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1}"
},
"exp" : 3600 ,
"clickbrowser" : 1 ,
"metric" : [
{
"type" : "click_through_rate" ,
"value" : 0.10741956532001495 ,
"vendor" : "EXCHANGE"
},
{
"type" : "viewability" ,
"value" : 0.58 ,
"vendor" : "EXCHANGE"
}
],
"ext" : {
"billing_id" : [
"29846056590"
],
"publisher_settings_list_id" : [
"4793646945897060511" ,
"3704654811398966070"
],
"allowed_vendor_type" : [
780 ,
237
],
"ampad" : 2 ,
"excluded_creatives" : [
{
"buyer_creative_id" : "EXCLUDED_BUYER_CREATIVE_ID"
},
{
"buyer_creative_id" : "EXCLUDED_BUYER_CREATIVE_ID"
}
],
"creative_enforcement_settings" : {
"policy_enforcement" : 2 ,
"publisher_blocks_enforcement" : 1
},
"auction_environment" : 0 ,
"billable_event_rate_bid_adjustment" : [
{
"bid_adjustment" : 1.2858465 ,
"creative_type" : 3
}
],
"ae" : 0
}
}
],
"app" : {
"name" : "Test App" ,
"bundle" : "com.google.testapp" ,
"publisher" : {
"id" : "pub-9497839363952914" ,
"ext" : {
"country" : "HK"
}
},
"content" : {
"url" : "https://www.google.com" ,
"userrating" : "4.4" ,
"livestream" : 0 ,
"language" : "ar"
},
"storeurl" : "https://www.google.com" ,
"ext" : {
"inventorypartnerdomain" : "OMITTED"
}
},
"device" : {
"ua" : "OMITTED" ,
"ip" : "192.168.1.0" ,
"geo" : {
"lat" : 0.0 ,
"lon" : 0.0 ,
"country" : "EGY" ,
"region" : "EG-ALX" ,
"city" : "Alexandria" ,
"type" : 2 ,
"utcoffset" : 180 ,
"accuracy" : 2052 ,
"ext" : {
"geo_criteria_id" : 9198011
}
},
"make" : "Xiaomi" ,
"model" : "M2006C3MG" ,
"os" : "android" ,
"osv" : "10" ,
"connectiontype" : 6 ,
"devicetype" : 4 ,
"lmt" : 0 ,
"w" : 360 ,
"h" : 725 ,
"pxratio" : 2.0 ,
"sua" : {
"browsers" : [
{
"brand" : "Mozilla" ,
"version" : [
"5" ,
"0"
]
},
{
"brand" : "AppleWebKit" ,
"version" : [
"537" ,
"36"
]
}
],
"platform" : {
"brand" : "Android" ,
"version" : [
"10"
]
},
"mobile" : 1 ,
"model" : "M2006C3MG" ,
"source" : 3
}
},
"user" : {
"ext" : {
"session" : {
"duration" : 14
}
}
},
"at" : 1 ,
"tmax" : 300 ,
"cur" : [
"USD"
],
"source" : {
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
},
"ext" : {
"omidpn" : "Google" ,
"omidpv" : "afma-sdk-a-v243799999.232400000.1" ,
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
}
}
},
"ext" : {
"google_query_id" : "ANy-z2g135-A631Sj54M16BCG6dC277E40D9nL3r921i0k2974f1q051601623F0i9232692" ,
"fcap_scope" : 2 ,
"privacy_treatments" : {
"non_personalized_ads_reason" : [
3
],
"allow_user_data_collection" : 0
}
}
}
Google (Không dùng nữa)
Ví dụ minh họa
Yêu cầu tuần tự
id : "\\>\313j\000>Rh\321\301\367[\212\'j\204\273/\242\304\231\221\335"
ip : "\300\250"
user_agent : "OMITTED"
url : "https://www.google.com"
detected_language : "ja"
adslot {
id : 1
excluded_attribute : 25
excluded_attribute : 34
allowed_vendor_type : 3
allowed_vendor_type : 42
excluded_sensitive_category : 36
excluded_sensitive_category : 4
matching_ad_data {
billing_id : 41106584355
billing_id : 30773030290
minimum_cpm_micros : 130000
}
slot_visibility : ABOVE_THE_FOLD
excluded_product_category : 10031
ad_block_key : 1332130058
publisher_settings_list_id : 8685019249309350543
publisher_settings_list_id : 9740837501405857020
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
viewability : 83
allowed_ad_types : ALLOWED_AD_TYPE_NATIVE
is_amp_page : DIALECT_HTML
amp_ad_requirement_type : AMP_AD_NOT_ALLOWED
api : MRAID_1
api : MRAID_2
native_ad_template {
required_fields : 83
recommended_fields : 388
headline_max_safe_length : 25
body_max_safe_length : 90
call_to_action_max_safe_length : 15
image_width : 1200
image_height : 627
app_icon_width : 100
app_icon_height : 100
}
omidpn : "Google"
omidpv : "afma-sdk-i-v11.5.0"
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
impression_expiration_seconds : 14400
billable_event_rate_bid_adjustment {
bid_adjustment : 1.0
creative_type : NATIVE
}
supported_auction_environment : SERVER_SIDE_AUCTION
display_manager : "GoogleMobileAds-iOS"
display_manager_version : "11.5.0"
}
is_test : false
timezone_offset : 540
mobile {
app_id : "627009739"
is_app : true
is_mobile_web_optimized : true
app_name : "Test App"
skadn {
sourceapp : "627009739"
skadnetids : "l6x39K4z"
versions : "2.0"
versions : "2.1"
supported_fidelity_types : STOREKIT_RENDERED_ADS
supported_fidelity_types : VIEW_THROUGH_ADS
}
}
postal_code : "10011"
geo_criteria_id : 9161820
publisher_type : PUBLISHER_OWNED_AND_OPERATED
device {
device_type : HIGHEND_PHONE
platform : "iphone"
brand : "Apple"
model : "iPhone10,3"
os_version {
major : 16
minor : 7
micro : 10
}
carrier_id : 0
screen_width : 375
screen_height : 812
screen_pixel_ratio_millis : 3000
screen_orientation : PORTRAIT
hardware_version : "iPhone10,3"
limit_ad_tracking : true
app_tracking_authorization_status : RESTRICTED
connection_type : WIFI
}
publisher_country : "US"
publisher_id : "pub-1111111111111111"
response_deadline_ms : 300
google_query_id : "ANy-zrk77i-KbW4i79W0c018hwPx3aS9rl10TU52SMd7Sv82r01g5O4D20sxKTj53Xrr9VK0"
auction_type : FIRST_PRICE
geo {
lat : 0.0
lon : 0.0
country : "JPN"
region : "JP-36"
zip : "771-0212"
utcoffset : 540
accuracy : 1031
}
user_agent_data {
platform {
brand : "iPhone"
version : "16"
version : "7"
}
mobile : true
model : "iPhone"
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "605"
version : "1"
}
bitness : "64"
source : USER_AGENT_STRING
}
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"
Video trên web
OpenRTB Protobuf
Ví dụ minh họa
Yêu cầu tuần tự
id : "474xe8G3edB9ZG60IaK880"
imp {
id : "1"
video {
mimes : "video/mp4"
linearity : LINEAR
w : 300
h : 250
playbackmethod : ENTER_SOUND_OFF
pos : ABOVE_THE_FOLD
api : OMID_1
protocols : VAST_2_0
protocols : VAST_3_0
skip : true
placement : IN_ARTICLE_PLACEMENT
playbackend : LEAVING_OR_USER
plcmt : PLCMT_NO_CONTENT_STANDALONE
[ com . google . doubleclick . video ] {
inferredplcmt : PLCMT_NO_CONTENT_STANDALONE
embeddedoffsite : true
}
}
displaymanager : "GOOGLE"
tagid : "8378930064"
bidfloor : 0.19
bidfloorcur : "USD"
secure : true
exp : 3600
metric {
type : "click_through_rate"
value : 0.0012572698760777712
vendor : "EXCHANGE"
}
metric {
type : "viewability"
value : 0.62
vendor : "EXCHANGE"
}
[ com . google . doubleclick . imp ] {
billing_id : 47460168025
publisher_settings_list_id : 5764601004062573461
publisher_settings_list_id : 9583254202940413383
allowed_vendor_type : 3
allowed_vendor_type : 42
dfp_ad_unit_code : "/3049200/google/test"
ampad : AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
buyer_generated_request_data {
data : "Test Data"
}
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
}
allowed_restricted_category : 33
allowed_restricted_category : 32
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
ae : SERVER_SIDE_AUCTION
}
}
site {
page : "https://www.google.com"
publisher {
id : "pub-1111111111111111"
[ com . google . doubleclick . publisher ] {
country : "US"
}
}
content {
livestream : false
producer {
}
language : "en"
}
mobile : true
[ com . google . doubleclick . site ] {
amp : DIALECT_HTML
page_visibility : VISIBILITY_STATE_VISIBLE
inventorypartnerdomain : "OMITTED"
ntype : NAVIGATION_TYPE_NAVIGATE
}
}
device {
ua : "OMITTED"
geo {
lat : 0.0
lon : 0.0
country : "USA"
region : "TX"
metro : "618"
city : "Houston"
zip : "77032"
type : IP
utcoffset : - 300
accuracy : 3682
[ com . google . doubleclick . geo ] {
geo_criteria_id : 9027607
}
}
ipv6 : "2600:100d:b045::"
carrier : "70092"
make : "Samsung"
model : "sm-a037u"
os : "android"
osv : "13"
devicetype : HIGHEND_PHONE
lmt : false
w : 412
h : 915
pxratio : 1.75
sua {
browsers {
brand : "Google Chrome"
version : "129"
version : "0"
}
browsers {
brand : "Not=A?Brand"
version : "8"
version : "0"
}
platform {
brand : "Android"
version : "13"
version : "0"
}
mobile : true
model : "SM-A037U"
source : CLIENT_HINTS_HIGH_ENTROPY
}
}
user {
buyeruid : "8cw7780874mg61q5MBecJyQ8hXIoYQPM"
customdata : "l7898Ufx682216u9F0WUQsxMFr1956dw76p8ZAdpwA3586Y2"
data {
segment {
id : "OMITTED"
}
segment {
id : "OMITTED"
}
[ com . google . doubleclick . data ] {
segtax : 601
}
}
[ com . google . doubleclick . user ] {
eids {
source : "OMITTED"
uids {
id : "12JD92JD8078S8J29SDOAKC0EF230337"
}
}
eids {
source : "OMITTED"
uids {
id : "12JD92JD8078S8J29SDOAKC0EF230337"
}
}
}
}
at : FIRST_PRICE
tmax : 350
cur : "USD"
regs {
gpp : "OMITTED"
}
source {
schain {
complete : true
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : 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
}
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : 1
}
ver : "1.0"
}
}
}
[ com . google . doubleclick . bid_request ] {
bid_feedback {
request_id : "V68ZT9H20868b1ze4z5rWa"
creative_status_code : 80
event_notification_token {
payload : "token"
}
buyer_creative_id : "test_creative_id_175726"
minimum_bid_to_win : 8.62
feedbacktype : BID_FEEDBACK
}
google_query_id : "ANy-z732H2-9Z57W2Ufp82238m3DQ5T47oEIDlSkITGYWkX1CgL2VPch1wbeQV6kb1631u7h"
fcap_scope : FREQUENCY_CAPPING_SCOPE_NONE
}
JSON OpenRTB
Ví dụ minh họa
{
"id" : "474xe8G3edB9ZG60IaK880" ,
"imp" : [
{
"id" : "1" ,
"video" : {
"mimes" : [
"video/mp4"
],
"linearity" : 1 ,
"w" : 300 ,
"h" : 250 ,
"playbackmethod" : [
6
],
"pos" : 1 ,
"api" : [
7
],
"protocols" : [
2 ,
3
],
"skip" : 1 ,
"placement" : 3 ,
"playbackend" : 2 ,
"plcmt" : 4 ,
"ext" : {
"inferredplcmt" : 4 ,
"embeddedoffsite" : 1
}
},
"displaymanager" : "GOOGLE" ,
"tagid" : "8378930064" ,
"bidfloor" : 0.19 ,
"bidfloorcur" : "USD" ,
"secure" : 1 ,
"exp" : 3600 ,
"metric" : [
{
"type" : "click_through_rate" ,
"value" : 0.0012572698760777712 ,
"vendor" : "EXCHANGE"
},
{
"type" : "viewability" ,
"value" : 0.62 ,
"vendor" : "EXCHANGE"
}
],
"ext" : {
"billing_id" : [
"47460168025"
],
"publisher_settings_list_id" : [
"5764601004062573461" ,
"9583254202940413383"
],
"allowed_vendor_type" : [
3 ,
42
],
"dfp_ad_unit_code" : "/3049200/google/test" ,
"ampad" : 3 ,
"buyer_generated_request_data" : [
{
"data" : "Test 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
},
"allowed_restricted_category" : [
33 ,
32
],
"creative_enforcement_settings" : {
"policy_enforcement" : 1 ,
"publisher_blocks_enforcement" : 1
},
"auction_environment" : 0 ,
"ae" : 0
}
}
],
"site" : {
"page" : "https://www.google.com" ,
"publisher" : {
"id" : "pub-1111111111111111" ,
"ext" : {
"country" : "US"
}
},
"content" : {
"livestream" : 0 ,
"language" : "en"
},
"mobile" : 1 ,
"ext" : {
"amp" : 0 ,
"page_visibility" : 1 ,
"inventorypartnerdomain" : "OMITTED" ,
"ntype" : 1
}
},
"device" : {
"ua" : "OMITTED" ,
"geo" : {
"lat" : 0.0 ,
"lon" : 0.0 ,
"country" : "USA" ,
"region" : "TX" ,
"metro" : "618" ,
"city" : "Houston" ,
"zip" : "77032" ,
"type" : 2 ,
"utcoffset" : - 300 ,
"accuracy" : 3682 ,
"ext" : {
"geo_criteria_id" : 9027607
}
},
"ipv6" : "2600:100d:b045::" ,
"carrier" : "70092" ,
"make" : "Samsung" ,
"model" : "sm-a037u" ,
"os" : "android" ,
"osv" : "13" ,
"devicetype" : 4 ,
"lmt" : 0 ,
"w" : 412 ,
"h" : 915 ,
"pxratio" : 1.75 ,
"sua" : {
"browsers" : [
{
"brand" : "Google Chrome" ,
"version" : [
"129" ,
"0"
]
},
{
"brand" : "Not=A?Brand" ,
"version" : [
"8" ,
"0"
]
}
],
"platform" : {
"brand" : "Android" ,
"version" : [
"13" ,
"0"
]
},
"mobile" : 1 ,
"model" : "SM-A037U" ,
"source" : 2
}
},
"user" : {
"buyeruid" : "8cw7780874mg61q5MBecJyQ8hXIoYQPM" ,
"customdata" : "l7898Ufx682216u9F0WUQsxMFr1956dw76p8ZAdpwA3586Y2" ,
"data" : [
{
"segment" : [
{
"id" : "OMITTED"
},
{
"id" : "OMITTED"
}
],
"ext" : {
"segtax" : 601
}
}
],
"ext" : {
"eids" : [
{
"source" : "OMITTED" ,
"uids" : [
{
"id" : "12JD92JD8078S8J29SDOAKC0EF230337"
}
]
},
{
"source" : "OMITTED" ,
"uids" : [
{
"id" : "12JD92JD8078S8J29SDOAKC0EF230337"
}
]
}
]
}
},
"at" : 1 ,
"tmax" : 350 ,
"cur" : [
"USD"
],
"regs" : {
"gpp" : "OMITTED"
},
"source" : {
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
},
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
},
"ext" : {
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
},
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
}
}
},
"ext" : {
"bid_feedback" : [
{
"request_id" : "V68ZT9H20868b1ze4z5rWa" ,
"creative_status_code" : 80 ,
"event_notification_token" : {
"payload" : "token"
},
"buyer_creative_id" : "test_creative_id_175726" ,
"minimum_bid_to_win" : 8.62 ,
"feedbacktype" : 1
}
],
"google_query_id" : "ANy-z732H2-9Z57W2Ufp82238m3DQ5T47oEIDlSkITGYWkX1CgL2VPch1wbeQV6kb1631u7h" ,
"fcap_scope" : 1
}
}
Google (Không dùng nữa)
Ví dụ minh họa
Yêu cầu tuần tự
id : "J#\010\024\351\000\207\247\265\033\315\nA\251\257}\216\313\206\214\323\312\215"
ip : "\300\250"
user_agent : "OMITTED"
url : "https://www.google.com"
detected_language : "ja"
adslot {
id : 1
width : 1176
width : 480
height : 1046
height : 800
excluded_attribute : 7
excluded_attribute : 16
allowed_vendor_type : 4513
allowed_vendor_type : 485
excluded_sensitive_category : 36
excluded_sensitive_category : 31
matching_ad_data {
billing_id : 75752641104
billing_id : 20395399239
minimum_cpm_micros : 40000
}
matching_ad_data {
billing_id : 97958384088
billing_id : 56530052009
minimum_cpm_micros : 530000
}
slot_visibility : ABOVE_THE_FOLD
ad_block_key : 5888439717
publisher_settings_list_id : 4545709109957121468
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 : 86
allowed_restricted_category_for_deals : 32
allowed_restricted_category_for_deals : 33
renderer : GOOGLE
is_rewarded : true
allowed_ad_types : ALLOWED_AD_TYPE_VIDEO
is_amp_page : DIALECT_HTML
amp_ad_requirement_type : AMP_AD_NOT_ALLOWED
session_depth : 1
api : OMID_1
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_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
cookie_version : 1
google_user_id : "0bQri772Ba4h145n2m5dRK2e7IM"
timezone_offset : 540
mobile {
is_interstitial_request : true
}
video {
max_ad_duration : 30000
video_ad_skippable : BLOCK_SKIPPABLE
allowed_video_formats : VIDEO_MP4
end_cap_support : END_CAP_OPTIONAL
playback_method : CLICK_TO_PLAY
is_clickable : true
placement : INTERSTITIAL
protocols : VAST_2_0
protocols : VAST_3_0
playback_cessation_mode : COMPLETION_OR_USER
plcmt : PLCMT_INTERSTITIAL
inferred_plcmt : PLCMT_INTERSTITIAL
}
cookie_age_seconds : 57024000
hosted_match_data : "\207r9\204\322\022\324Ezf\263\305\373\3153\311\271i\305"
geo_criteria_id : 1009341
publisher_settings_list_id : 6038657471597087436
bid_response_feedback {
request_id : "\373\263!2t;\224C\363\372\224\220\376red"
creative_status_code : 79
event_notification_token : "token"
buyer_creative_id : "test_creative_id_378410"
minimum_bid_to_win : 114000000
feedback_type : BID_FEEDBACK
}
publisher_type : PUBLISHER_OWNED_AND_OPERATED
partner_id : 3153428956954513893
device {
device_type : PERSONAL_COMPUTER
platform : "Windows"
limit_ad_tracking : false
}
publisher_country : "JP"
publisher_id : "pub-1111111111111111"
response_deadline_ms : 350
google_query_id : "ANy-zz9y8d-2p0141lC5k418ht4e0FOF2M06a40So6pmPJim2U4LWw2hERI5310mnf649802"
auction_type : FIRST_PRICE
geo {
lat : 0.0
lon : 0.0
country : "JPN"
region : "JP-14"
city : "Saiwai"
utcoffset : 540
accuracy : 1785
}
user_agent_data {
platform {
brand : "Windows"
version : "10"
version : "0"
}
mobile : false
architecture : "x86"
browsers {
brand : "Google Chrome"
version : "129"
version : "0"
}
browsers {
brand : "Not=A?Brand"
version : "8"
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_BROWSER
privacy_treatments {
allow_user_data_collection : true
}
inventory_partner_domain : "OMITTED"
Biểu ngữ trên web dành cho thiết bị di động cho bên đặt giá thầu trên Ad Exchange
OpenRTB Protobuf
Ví dụ minh họa
Yêu cầu tuần tự
id : "W5rO389B0p836803G6tI3T"
imp {
id : "1"
banner {
w : 320
h : 50
pos : ABOVE_THE_FOLD
expdir : LEFT
expdir : RIGHT
expdir : UP
expdir : DOWN
api : MRAID_1
api : MRAID_2
format {
w : 320
h : 50
}
format {
w : 320
h : 100
}
}
displaymanager : "GoogleMobileAds-Android"
displaymanagerver : "23.1.0"
tagid : "3758755668"
bidfloor : 0.11
bidfloorcur : "USD"
secure : true
exp : 3600
clickbrowser : true
metric {
type : "viewability"
value : 0.71
vendor : "EXCHANGE"
}
[ com . google . doubleclick . imp ] {
billing_id : 50962964480
dfp_ad_unit_code : "/5025729/google/test"
ampad : AMP_AD_NOT_ALLOWED
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
}
}
app {
name : "Test App"
ver : "6.8.1"
bundle : "com.google.testapp"
publisher {
id : "pub-6120362493380457"
[ com . google . doubleclick . publisher ] {
country : "PL"
}
}
content {
url : "https://www.google.com"
userrating : "4.5"
livestream : false
language : "pl"
}
storeurl : "https://www.google.com"
[ com . google . doubleclick . app ] {
inventorypartnerdomain : "OMITTED"
}
}
device {
ua : "OMITTED"
ip : "192.168.1.0"
geo {
lat : 0.0
lon : 0.0
country : "POL"
region : "PL-MZ"
city : "Warsaw"
zip : "04"
type : IP
utcoffset : 120
accuracy : 2263
[ com . google . doubleclick . geo ] {
geo_criteria_id : 9061066
}
}
carrier : "70872"
make : "Samsung"
model : "SM-A346B"
os : "android"
osv : "14"
connectiontype : CELL_4G
devicetype : HIGHEND_PHONE
ifa : "1f3ed9c7-e8d8-4cec-9167-2811375e2cbe"
lmt : false
w : 384
h : 758
pxratio : 2.813
sua {
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "537"
version : "36"
}
platform {
brand : "Android"
version : "14"
}
mobile : true
bitness : "64"
model : "SM-A346B"
source : USER_AGENT_STRING
}
}
user {
id : "a9S5d7s7r38o1q8ifv4U80GBxKA"
[ com . google . doubleclick . user ] {
consented_providers_settings {
consented_providers : 1215
consented_providers : 2567
additional_consent : "OMITTED"
}
consent : "OMITTED"
session {
duration : 464
}
idage : 25920000
}
}
at : FIRST_PRICE
tmax : 1000
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 ] {
omidpn : "Google"
omidpv : "afma-sdk-a-v243799999.241199000.1"
schain {
complete : 1
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : 1
}
ver : "1.0"
}
}
}
[ com . google . doubleclick . bid_request ] {
google_query_id : "ANy-z4luKF-u274F3WU34uUUoQ7E82k3L42z23v2K4T1k0eA7Rw8Xb6JeXDG6K703e88p491"
fcap_scope : FREQUENCY_CAPPING_SCOPE_DEVICE
}
JSON OpenRTB
Ví dụ minh họa
{
"id" : "W5rO389B0p836803G6tI3T" ,
"imp" : [
{
"id" : "1" ,
"banner" : {
"w" : 320 ,
"h" : 50 ,
"pos" : 1 ,
"expdir" : [
1 ,
2 ,
3 ,
4
],
"api" : [
3 ,
5
],
"format" : [
{
"w" : 320 ,
"h" : 50
},
{
"w" : 320 ,
"h" : 100
}
]
},
"displaymanager" : "GoogleMobileAds-Android" ,
"displaymanagerver" : "23.1.0" ,
"tagid" : "3758755668" ,
"bidfloor" : 0.11 ,
"bidfloorcur" : "USD" ,
"secure" : 1 ,
"exp" : 3600 ,
"clickbrowser" : 1 ,
"metric" : [
{
"type" : "viewability" ,
"value" : 0.71 ,
"vendor" : "EXCHANGE"
}
],
"ext" : {
"billing_id" : [
"50962964480"
],
"dfp_ad_unit_code" : "/5025729/google/test" ,
"ampad" : 2 ,
"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
}
}
],
"app" : {
"name" : "Test App" ,
"ver" : "6.8.1" ,
"bundle" : "com.google.testapp" ,
"publisher" : {
"id" : "pub-6120362493380457" ,
"ext" : {
"country" : "PL"
}
},
"content" : {
"url" : "https://www.google.com" ,
"userrating" : "4.5" ,
"livestream" : 0 ,
"language" : "pl"
},
"storeurl" : "https://www.google.com" ,
"ext" : {
"inventorypartnerdomain" : "OMITTED"
}
},
"device" : {
"ua" : "OMITTED" ,
"ip" : "192.168.1.0" ,
"geo" : {
"lat" : 0.0 ,
"lon" : 0.0 ,
"country" : "POL" ,
"region" : "PL-MZ" ,
"city" : "Warsaw" ,
"zip" : "04" ,
"type" : 2 ,
"utcoffset" : 120 ,
"accuracy" : 2263 ,
"ext" : {
"geo_criteria_id" : 9061066
}
},
"carrier" : "70872" ,
"make" : "Samsung" ,
"model" : "SM-A346B" ,
"os" : "android" ,
"osv" : "14" ,
"connectiontype" : 6 ,
"devicetype" : 4 ,
"ifa" : "1f3ed9c7-e8d8-4cec-9167-2811375e2cbe" ,
"lmt" : 0 ,
"w" : 384 ,
"h" : 758 ,
"pxratio" : 2.813 ,
"sua" : {
"browsers" : [
{
"brand" : "Mozilla" ,
"version" : [
"5" ,
"0"
]
},
{
"brand" : "AppleWebKit" ,
"version" : [
"537" ,
"36"
]
}
],
"platform" : {
"brand" : "Android" ,
"version" : [
"14"
]
},
"mobile" : 1 ,
"bitness" : "64" ,
"model" : "SM-A346B" ,
"source" : 3
}
},
"user" : {
"id" : "a9S5d7s7r38o1q8ifv4U80GBxKA" ,
"ext" : {
"consented_providers_settings" : {
"consented_providers" : [
"1215" ,
"2567"
],
"additional_consent" : "OMITTED"
},
"consent" : "OMITTED" ,
"session" : {
"duration" : 464
},
"idage" : 25920000
}
},
"at" : 1 ,
"tmax" : 1000 ,
"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" : {
"omidpn" : "Google" ,
"omidpv" : "afma-sdk-a-v243799999.241199000.1" ,
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
}
}
},
"ext" : {
"google_query_id" : "ANy-z4luKF-u274F3WU34uUUoQ7E82k3L42z23v2K4T1k0eA7Rw8Xb6JeXDG6K703e88p491" ,
"fcap_scope" : 3
}
}
OpenRTB Protobuf
Ví dụ minh họa
Yêu cầu tuần tự
id : "o9j8MO3eW468670y7CVv1A"
imp {
id : "1"
banner {
w : 300
h : 250
pos : ABOVE_THE_FOLD
battr : VIDEO_IN_BANNER_AUTO_PLAY
battr : VIDEO_IN_BANNER_USER_INITIATED
api : MRAID_1
api : MRAID_2
format {
w : 300
h : 250
}
format {
w : 320
h : 50
}
}
video {
mimes : "video/mp4"
linearity : LINEAR
w : 300
h : 250
battr : VIDEO_IN_BANNER_AUTO_PLAY
battr : VIDEO_IN_BANNER_USER_INITIATED
playbackmethod : ENTER_SOUND_OFF
pos : ABOVE_THE_FOLD
api : MRAID_1
api : MRAID_2
protocols : VAST_2_0
protocols : VAST_3_0
skip : true
placement : IN_FEED_PLACEMENT
playbackend : LEAVING_OR_USER
plcmt : PLCMT_NO_CONTENT_STANDALONE
[ com . google . doubleclick . video ] {
inferredplcmt : PLCMT_NO_CONTENT_STANDALONE
embeddedoffsite : true
}
}
displaymanager : "GoogleMobileAds-Android"
displaymanagerver : "22.3.0"
tagid : "6247365183"
bidfloor : 0.01
bidfloorcur : "USD"
secure : true
native {
ver : "1.2"
api : MRAID_1
api : MRAID_2
battr : VIDEO_IN_BANNER_AUTO_PLAY
battr : VIDEO_IN_BANNER_USER_INITIATED
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
required : true
img {
type : ICON
wmin : 100
hmin : 100
}
}
assets {
id : 6
data {
type : RATING
len : 5
}
}
assets {
id : 7
data {
type : PRICE
len : 15
}
}
eventtrackers {
event : IMPRESSION
methods : IMG
}
privacy : true
}
}
exp : 3600
clickbrowser : true
metric {
type : "viewability"
value : 0.64
vendor : "EXCHANGE"
}
metric {
type : "session_depth"
value : 7.0
vendor : "EXCHANGE"
}
[ com . google . doubleclick . imp ] {
billing_id : 21221902373
billing_id : 53569531917
publisher_settings_list_id : 7651048085774412615
publisher_settings_list_id : 3305930710629093223
allowed_vendor_type : 3
allowed_vendor_type : 42
ampad : AMP_AD_NOT_ALLOWED
creative_enforcement_settings {
policy_enforcement : POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
publisher_blocks_enforcement : PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
}
auction_environment : SERVER_SIDE_AUCTION
billable_event_rate_bid_adjustment {
bid_adjustment : 1.1452553
creative_type : HTML_SNIPPET
}
ae : SERVER_SIDE_AUCTION
}
}
app {
name : "Test App"
ver : "14.27.7"
bundle : "com.google.testapp"
publisher {
id : "pub-8822142511593237"
[ com . google . doubleclick . publisher ] {
country : "SE"
}
}
content {
url : "https://www.google.com"
userrating : "4.5"
livestream : false
producer {
}
language : "en"
}
storeurl : "https://www.google.com"
[ com . google . doubleclick . app ] {
inventorypartnerdomain : "OMITTED"
}
}
device {
ua : "OMITTED"
ip : "192.168.1.0"
geo {
lat : 0.0
lon : 0.0
country : "NGA"
region : "NG-LA"
city : "Lagos"
zip : "106104"
type : IP
utcoffset : 60
accuracy : 1559
[ com . google . doubleclick . geo ] {
geo_criteria_id : 9198908
}
}
make : "Xiaomi"
model : "23129RAA4G"
os : "android"
osv : "14"
connectiontype : WIFI
devicetype : HIGHEND_PHONE
ifa : "94b6ef8c-99d8-4997-98d2-c2377bd7abd1"
lmt : false
w : 393
h : 792
pxratio : 2.75
sua {
browsers {
brand : "Mozilla"
version : "5"
version : "0"
}
browsers {
brand : "AppleWebKit"
version : "537"
version : "36"
}
platform {
brand : "Android"
version : "14"
}
mobile : true
bitness : "64"
model : "23129RAA4G"
source : USER_AGENT_STRING
}
}
user {
id : "04X9BE2175274aL0C296l24WI68"
[ com . google . doubleclick . user ] {
session {
duration : 439
}
idage : 7776000
}
}
at : FIRST_PRICE
tmax : 1500
cur : "USD"
cur : "EUR"
bcat : "IAB23-9"
bcat : "IAB14-1"
bapp : "com.ayoba.ayoba"
source {
schain {
complete : true
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : true
}
ver : "1.0"
}
[ com . google . doubleclick . source ] {
omidpn : "Google"
omidpv : "afma-sdk-a-v243799999.232400000.1"
schain {
complete : 1
nodes {
asi : "testssp.com"
sid : "pub-1111111111111111"
hp : 1
}
ver : "1.0"
}
}
}
[ com . google . doubleclick . bid_request ] {
google_query_id : "ANy-zM284h-2Q24Y9v315v54F50lLaqQ3hq549685jR3ack28k6J6Ko65F1aS73r197eM8zX"
fcap_scope : FREQUENCY_CAPPING_SCOPE_DEVICE
privacy_treatments {
allow_user_data_collection : false
}
}
JSON OpenRTB
Ví dụ minh họa
{
"id" : "o9j8MO3eW468670y7CVv1A" ,
"imp" : [
{
"id" : "1" ,
"banner" : {
"w" : 300 ,
"h" : 250 ,
"pos" : 1 ,
"battr" : [
6 ,
7
],
"api" : [
3 ,
5
],
"format" : [
{
"w" : 300 ,
"h" : 250
},
{
"w" : 320 ,
"h" : 50
}
]
},
"video" : {
"mimes" : [
"video/mp4"
],
"linearity" : 1 ,
"w" : 300 ,
"h" : 250 ,
"battr" : [
6 ,
7
],
"playbackmethod" : [
6
],
"pos" : 1 ,
"api" : [
3 ,
5
],
"protocols" : [
2 ,
3
],
"skip" : 1 ,
"placement" : 4 ,
"playbackend" : 2 ,
"plcmt" : 4 ,
"ext" : {
"inferredplcmt" : 4 ,
"embeddedoffsite" : 1
}
},
"displaymanager" : "GoogleMobileAds-Android" ,
"displaymanagerver" : "22.3.0" ,
"tagid" : "6247365183" ,
"bidfloor" : 0.01 ,
"bidfloorcur" : "USD" ,
"secure" : 1 ,
"native" : {
"ver" : "1.2" ,
"api" : [
3 ,
5
],
"battr" : [
6 ,
7
],
"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,\"required\":1,\"img\":{\"type\":1,\"wmin\":100,\"hmin\":100}},{\"id\":6,\"data\":{\"type\":3,\"len\":5}},{\"id\":7,\"data\":{\"type\":6,\"len\":15}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1}"
},
"exp" : 3600 ,
"clickbrowser" : 1 ,
"metric" : [
{
"type" : "viewability" ,
"value" : 0.64 ,
"vendor" : "EXCHANGE"
},
{
"type" : "session_depth" ,
"value" : 7.0 ,
"vendor" : "EXCHANGE"
}
],
"ext" : {
"billing_id" : [
"21221902373" ,
"53569531917"
],
"publisher_settings_list_id" : [
"7651048085774412615" ,
"3305930710629093223"
],
"allowed_vendor_type" : [
3 ,
42
],
"ampad" : 2 ,
"creative_enforcement_settings" : {
"policy_enforcement" : 2 ,
"publisher_blocks_enforcement" : 1
},
"auction_environment" : 0 ,
"billable_event_rate_bid_adjustment" : [
{
"bid_adjustment" : 1.1452553 ,
"creative_type" : 1
}
],
"ae" : 0
}
}
],
"app" : {
"name" : "Test App" ,
"ver" : "14.27.7" ,
"bundle" : "com.google.testapp" ,
"publisher" : {
"id" : "pub-8822142511593237" ,
"ext" : {
"country" : "SE"
}
},
"content" : {
"url" : "https://www.google.com" ,
"userrating" : "4.5" ,
"livestream" : 0 ,
"language" : "en"
},
"storeurl" : "https://www.google.com" ,
"ext" : {
"inventorypartnerdomain" : "OMITTED"
}
},
"device" : {
"ua" : "OMITTED" ,
"ip" : "192.168.1.0" ,
"geo" : {
"lat" : 0.0 ,
"lon" : 0.0 ,
"country" : "NGA" ,
"region" : "NG-LA" ,
"city" : "Lagos" ,
"zip" : "106104" ,
"type" : 2 ,
"utcoffset" : 60 ,
"accuracy" : 1559 ,
"ext" : {
"geo_criteria_id" : 9198908
}
},
"make" : "Xiaomi" ,
"model" : "23129RAA4G" ,
"os" : "android" ,
"osv" : "14" ,
"connectiontype" : 2 ,
"devicetype" : 4 ,
"ifa" : "94b6ef8c-99d8-4997-98d2-c2377bd7abd1" ,
"lmt" : 0 ,
"w" : 393 ,
"h" : 792 ,
"pxratio" : 2.75 ,
"sua" : {
"browsers" : [
{
"brand" : "Mozilla" ,
"version" : [
"5" ,
"0"
]
},
{
"brand" : "AppleWebKit" ,
"version" : [
"537" ,
"36"
]
}
],
"platform" : {
"brand" : "Android" ,
"version" : [
"14"
]
},
"mobile" : 1 ,
"bitness" : "64" ,
"model" : "23129RAA4G" ,
"source" : 3
}
},
"user" : {
"id" : "04X9BE2175274aL0C296l24WI68" ,
"ext" : {
"session" : {
"duration" : 439
},
"idage" : 7776000
}
},
"at" : 1 ,
"tmax" : 1500 ,
"cur" : [
"USD" ,
"EUR"
],
"bcat" : [
"IAB23-9" ,
"IAB14-1"
],
"bapp" : [
"com.ayoba.ayoba"
],
"source" : {
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
},
"ext" : {
"omidpn" : "Google" ,
"omidpv" : "afma-sdk-a-v243799999.232400000.1" ,
"schain" : {
"complete" : 1 ,
"nodes" : [
{
"asi" : "testssp.com" ,
"sid" : "pub-1111111111111111" ,
"hp" : 1
}
],
"ver" : "1.0"
}
}
},
"ext" : {
"google_query_id" : "ANy-zM284h-2Q24Y9v315v54F50lLaqQ3hq549685jR3ack28k6J6Ko65F1aS73r197eM8zX" ,
"fcap_scope" : 3 ,
"privacy_treatments" : {
"allow_user_data_collection" : 0
}
}
}
Google (Không dùng nữa)
Ví dụ minh họa
Yêu cầu tuần tự
id : "\3213\327N\305\205|\363P-\002\271\321\255\2422a\336\344w\032\315\364"
ip : "\300\250"
user_agent : "OMITTED"
url : "https://www.google.com"
detected_language : "ko"
adslot {
id : 1
width : 336
width : 300
height : 280
height : 250
excluded_attribute : 16
excluded_attribute : 34
allowed_vendor_type : 3
allowed_vendor_type : 42
excluded_sensitive_category : 36
excluded_sensitive_category : 27
matching_ad_data {
billing_id : 46229095026
minimum_cpm_micros : 6000000
direct_deal {
direct_deal_id : 41020803
fixed_cpm_micros : 6000000
deal_type : AUCTION_PACKAGE
}
direct_deal {
direct_deal_id : 83063356
fixed_cpm_micros : 6000000
deal_type : AUCTION_PACKAGE
}
}
matching_ad_data {
billing_id : 97161713426
billing_id : 54565593373
minimum_cpm_micros : 60000
}
slot_visibility : BELOW_THE_FOLD
excluded_product_category : 10031
excluded_product_category : 10080
ad_block_key : 1676780364
publisher_settings_list_id : 4302366834898588447
publisher_settings_list_id : 5535773595467535705
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
excluded_creatives {
buyer_creative_id : "EXCLUDED_BUYER_CREATIVE_ID"
}
iframing_state : UNKNOWN_IFRAME_STATE
viewability : 3
click_through_rate : 0.00045286646
renderer : GOOGLE
allowed_ad_types : ALLOWED_AD_TYPE_NATIVE
allowed_ad_types : ALLOWED_AD_TYPE_BANNER
is_amp_page : DIALECT_HTML
amp_ad_requirement_type : AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
session_depth : 1
api : OMID_1
flexible_adslot_settings {
max_width : 412
max_height : 371
min_width : 300
min_height : 250
}
native_ad_template {
required_fields : 81
recommended_fields : 132
headline_max_safe_length : 25
body_max_safe_length : 90
call_to_action_max_safe_length : 15
image_width : 1200
image_height : 627
app_icon_width : 100
app_icon_height : 100
style_id : 188124
style_height : 250
style_width : 300
}
native_ad_template {
required_fields : 25
recommended_fields : 36
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
logo_width : 100
logo_height : 100
style_id : 192343
style_height : 250
style_width : 300
}
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
cookie_version : 1
google_user_id : "s13Tq1N7711701GoYey29S07G4O"
timezone_offset : 540
mobile {
app_id : "com.google.testapp"
is_app : false
is_mobile_web_optimized : true
app_name : "Test App"
app_rating : 4.0387864
}
video {
video_ad_skippable : ALLOW_SKIPPABLE
allowed_video_formats : VIDEO_MP4
playback_method : INITIATE_ON_ENTERING_VIEWPORT_SOUND_OFF
is_clickable : true
placement : IN_ARTICLE
protocols : VAST_2_0
protocols : VAST_3_0
playback_cessation_mode : LEAVING_OR_USER
plcmt : PLCMT_NO_CONTENT_STANDALONE
inferred_plcmt : PLCMT_NO_CONTENT_STANDALONE
}
cookie_age_seconds : 28512000
hosted_match_data : "\017\345\237\340\225\030\327\003\332\303-\t\267\244E\365*K\367"
geo_criteria_id : 9207704
publisher_type : PUBLISHER_OWNED_AND_OPERATED
device {
device_type : HIGHEND_PHONE
platform : "android"
brand : "Samsung"
model : "sm-n981n"
os_version {
major : 13
}
carrier_id : 0
screen_width : 412
screen_height : 915
screen_pixel_ratio_millis : 2625
screen_orientation : PORTRAIT
limit_ad_tracking : false
}
publisher_country : "KR"
publisher_id : "pub-1111111111111111"
response_deadline_ms : 350
google_query_id : "ANy-zPlGA9-Bn8zO1n4y6DiyW32gF8LE7901694954EJXoV4WF7nMGDL3Ao08pJ88w463SK6"
auction_type : FIRST_PRICE
geo {
lat : 0.0
lon : 0.0
country : "KOR"
region : "KR-29"
city : "Gwangju"
utcoffset : 540
accuracy : 3889
}
user_agent_data {
platform {
brand : "Android"
version : "13"
version : "0"
}
mobile : true
model : "SM-N981N"
browsers {
brand : "Chromium"
version : "130"
version : "0"
}
browsers {
brand : "Android WebView"
version : "130"
version : "0"
}
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_BROWSER
privacy_treatments {
allow_user_data_collection : false
}
inventory_partner_domain : "OMITTED"
navigation_type : NAVIGATION_TYPE_NAVIGATE
