Stay organized with collections
Save and categorize content based on your preferences.
A real-time bidding interaction begins when Google sends a bid request to
your application. This guide explains how to code your application to
process the bid request.
Parse Protobuf request
Google sends a bid request as a serialized protocol buffer attached as the
binary payload of an HTTP POST request. The Content-Type is set to
application/octet-stream. See Example bid request for an example.
You must parse this request into an instance of the BidRequest
message. Depending on your chosen protocol, BidRequest is defined
in either openrtb.proto or the deprecated
realtime-bidding.proto, which can be obtained from the
reference data page. You can parse the message
using the ParseFromString() method in the generated class for the
BidRequest. For example, the following C++ code parses a request
given a POST payload in a string:
Once you have the BidRequest you can then work with it as an
object, extracting and interpreting the fields you need. For example, in
C++ iterating through deals in an OpenRTB `BidRequest` could look like
the following:
You receive a bid request when a publisher's ad inventory is targeted by
one or more of your
pretargeting configurations. BidRequest.imp.ext.billing_id
will be populated with the billing IDs of any eligible buyers, and relevant
pretargeting configurations. Additionally, for
deal
inventory, you can find billing IDs associated with the relevant buyer
using BidRequest.imp.pmp.deal.ext.billing_id. Only billing IDs of
buyers included in the bid request may be specified when placing a bid.
If multiple billing IDs are included in the bid request, you must specify
the billing ID of the buyer you intend to attribute your bid to with the
BidResponse.seatbid.bid.ext.billing_id field.
Dictionary files
The bid request uses identifiers defined in dictionary files, which are
available on the reference data
page.
Google RTB protocol bid URL macros
Optionally, some fields of the BidRequest can be inserted into
the URL used in the HTTP POST request. This is useful, for example, if you use
a lightweight frontend that load balances over multiple backends using a value
from the request. Contact your technical account manager to request support for
new macros.
Macro
Description
%%GOOGLE_USER_ID%%
Replaced with the google_user_id
from the BidRequest. For example, the bidder URL
Bid requests sent to exchange and network bidders participating in Open
Bidding are similar to those of Authorized Buyers participating in standard
real-time bidding. Open Bidding customers will receive a small number of
additional fields, and a few existing fields may have alternative uses. These
include the following:
OpenRTB
Authorized Buyers
Details
BidRequest.imp[].ext.dfp_ad_unit_code
BidRequest.adslot[].dfp_ad_unit_code
Contains the publisher's Ad Manager network code followed by the ad
unit hierarchy, separated by forward slashes.
As an example, this would appear with formatting similar to:
/1234/cruises/mars.
BidRequest.user.data[].segment[]
BidRequest.adslot[].exchange_bidding.key_value[]
Repeated key-value pairs sent from publisher to exchange bidder.
You can determine that the values are key-value pairs sent by the
publisher when BidRequest.user.data[].name is set to
“Publisher Passed”.
Declare allowed vendors
Technology vendors which provide services such as research, remarketing, and
ad serving may play a role in the interaction between buyers and sellers. Only
vendors which Google has vetted for participation in Authorized Buyers
interactions are allowed.
To understand the BidRequest and create your
BidResponse, you need to be aware of the two different
possibilities for declaring technology vendors:
Other vendors can only participate if they are declared in the
BidRequest:
In the BidRequest, the
BidRequest.imp.ext.allowed_vendor_type field specifies
which vendors the seller allows. Vendors that will be sent in the
allowed_vendor_type are listed in the
vendors.txt
dictionary file.
Example bid request
The following examples represent human-readable samples of the Protobuf and
JSON requests.
OpenRTB Protobuf
Show me the example
id:"803txXnQe99Y0e3070L5xO"imp{id:"1"banner{w:468h:60pos:BELOW_THE_FOLDexpdir:LEFTexpdir:RIGHTexpdir:UPexpdir:DOWNformat{w:468h:60}format{w:300h:50}}displaymanager:"GOOGLE"tagid:"1614017459"bidfloor:0.01bidfloorcur:"USD"secure:trueexp:3600metric{type:"viewability"value:0.25vendor:"EXCHANGE"}metric{type:"session_depth"value:1.0vendor:"EXCHANGE"}[com.google.doubleclick.imp]{billing_id:51570472186dfp_ad_unit_code:"/2336960/google/test"ampad:AMP_AD_ALLOWED_AND_NOT_EARLY_RENDEREDexcluded_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_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN}auction_environment:SERVER_SIDE_AUCTIONae:SERVER_SIDE_AUCTION}}site{page:"https://www.google.com"publisher{id:"pub-1111111111111111"[com.google.doubleclick.publisher]{country:"US"}}content{livestream:falselanguage:"en"}[com.google.doubleclick.site]{amp:DIALECT_HTMLpage_visibility:VISIBILITY_STATE_VISIBLEinventorypartnerdomain:"OMITTED"}}device{ua:"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36"geo{lat:0.0lon:0.0country:"IND"region:"IN-UP"type:IPutcoffset:330accuracy:8141}ipv6:"2409:4053:401::"os:"X11"devicetype:PERSONAL_COMPUTERlmt:falsepxratio:2.0sua{browsers{brand:"Google Chrome"version:"123"version:"0"}browsers{brand:"Not:A-Brand"version:"8"version:"0"}platform{brand:"Linux"}mobile:falsearchitecture:"x86"bitness:"64"source:CLIENT_HINTS_HIGH_ENTROPY}}user{id:"k5953o8KM7C3P2t45EoXQN6273h"buyeruid:"i8VSc4u14C8hQCB3e6Tm8Od7z1S0542c"customdata:"08135N21ki8nbhM99rBJEGsU9kO5Mr99Hs10eeh3M8tn1o3q"[com.google.doubleclick.user]{idage:2592000}}at:FIRST_PRICEtmax:300cur:"USD"source{schain{complete:truenodes{asi:"testssp.com"sid:"pub-1111111111111111"hp:true}nodes{asi:"testssp.com"sid:"pub-1111111111111111"hp:true}ver:"1.0"}}[com.google.doubleclick.bid_request]{google_query_id:"ANy-z0q198-VH9uWi641a7Nr5j1TA39TZM09b659F35vRZhyf532904TZ7cR3UPC71174eAi"fcap_scope:FREQUENCY_CAPPING_SCOPE_BROWSER}
OpenRTB JSON
Show me the example
{"id":"219DAI11M3120s2d8M4xgR","imp":[{"id":"1","banner":{"w":300,"h":250,"pos":3,"battr":[6,7],"wmax":300,"hmax":250,"wmin":200,"hmin":200,"format":[{"w":300,"h":250},{"w":200,"h":200}]},"displaymanager":"GOOGLE","tagid":"7820275329","bidfloor":0.08,"bidfloorcur":"USD","secure":1,"exp":3600,"metric":[{"type":"click_through_rate","value":0.00022253872884903103,"vendor":"EXCHANGE"},{"type":"viewability","value":0.01,"vendor":"EXCHANGE"}],"ext":{"billing_id":["54460865479"],"publisher_settings_list_id":["5406346852112173352","7576925985766584885"],"allowed_vendor_type":[3,42],"ampad":3,"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,"ae":0}}],"site":{"page":"https://www.google.com","publisher":{"id":"pub-1111111111111111","ext":{"country":"GB"}},"content":{"livestream":0,"language":"en"},"mobile":1,"ext":{"amp":0,"page_visibility":1,"inventorypartnerdomain":"OMITTED"}},"device":{"ua":"Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Mobile Safari/537.36","ip":"192.168.1.0","geo":{"lat":0.0,"lon":0.0,"country":"GBR","region":"GB-ENG","city":"Leeds","type":2,"utcoffset":60,"accuracy":7356},"carrier":"70062","make":"Apple","model":"iphone","os":"iOS","osv":"17.4.1","devicetype":4,"lmt":0,"w":393,"h":852,"pxratio":3,"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},},"user":{"ext":{"consented_providers_settings":{"consented_providers":["1800","2878"],"additional_consent":"OMITTED"},"consent":"OMITTED"}},"at":1,"tmax":300,"cur":["USD"],"bcat":["IAB23-5","IAB23-7"],"regs":{"ext":{"gdpr":1}},"source":{"schain":{"complete":1,"nodes":[{"asi":"testssp.com","sid":"pub-1111111111111111","hp":1}],"ver":"1.0"},"ext":{"schain":{"complete":1,"nodes":[{"asi":"testssp.com","sid":"pub-1111111111111111","hp":1}],"ver":"1.0"}}},"ext":{"google_query_id":"ANy-z1n326-9P8x09i2I5f85oXp7N1r61w0p681H008U29MK56111D9VJn1nRRp4P7eB5Y9H","fcap_scope":5,"privacy_treatments":{"allow_user_data_collection":1}}}
Google (Deprecated)
Show me the example
id:"\2509\326c\203\245\3079!\301\334U\316Wz\240_\252\367S\230)\303"user_agent:"Mozilla/5.0 (Linux; Android 10; SM-J610FN; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/123.0.0.0 Mobile Safari/537.36 (Mobile)"url:"https://www.google.com"detected_language:"fr"adslot{id:1width:320width:300height:50height:50excluded_attribute:22excluded_attribute:95allowed_vendor_type:3allowed_vendor_type:42excluded_sensitive_category:36excluded_sensitive_category:19matching_ad_data{billing_id:30279159795billing_id:91462636804minimum_cpm_micros:520000}matching_ad_data{billing_id:20531517860billing_id:81128918204minimum_cpm_micros:40000}slot_visibility:ABOVE_THE_FOLDexcluded_product_category:10159ad_block_key:1008473386publisher_settings_list_id:2398179148724909589publisher_settings_list_id:2783982084227045767excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}viewability:99allowed_ad_types:ALLOWED_AD_TYPE_BANNERis_amp_page:DIALECT_HTMLamp_ad_requirement_type:AMP_AD_NOT_ALLOWEDconsented_providers_settings{consented_providers:976consented_providers:1127additional_consent_string:"OMITTED"}regs_gdpr:trueapi:OMID_1api:MRAID_1flexible_adslot_settings{max_width:320max_height:50min_width:214min_height:33}omidpn:"Google"omidpv:"afma-sdk-a-v240304999.12451000.1"creative_enforcement_settings{policy_enforcement:POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES}auction_environment:SERVER_SIDE_AUCTIONimpression_expiration_seconds:3600supported_auction_environment:SERVER_SIDE_AUCTION}is_test:falsetimezone_offset:120mobile{app_id:"com.google.testapp"is_app:trueapp_name:"Test App"app_rating:4.2959895}postal_code:"10011"geo_criteria_id:1001400publisher_type:PUBLISHER_OWNED_AND_OPERATEDdevice{device_type:HIGHEND_PHONEplatform:"android"brand:"Samsung"model:"SM-J610FN"os_version{major:10}carrier_id:0screen_width:412screen_height:798screen_pixel_ratio_millis:1750screen_orientation:PORTRAITlimit_ad_tracking:falseconnection_type:WIFI}publisher_country:"DE"publisher_id:"pub-1111111111111111"response_deadline_ms:1000google_query_id:"ANy-zlKU2N-bX715350yWM17iAQg20R03ek41611E29hE35cvag5h91O1gYs9308t71bZ9k7"auction_type:FIRST_PRICEgeo{lat:50.46lon:4.85country:"BEL"region:"BE-WNA"city:"Namur"zip:"5000"utcoffset:120accuracy:7471}user_agent_data{platform{brand:"Android"version:"10"}mobile:truemodel:"SM-J610FN"browsers{brand:"Mozilla"version:"5"version:"0"}browsers{brand:"AppleWebKit"version:"537"version:"36"}source:USER_AGENT_STRING}supply_chain{complete:truenodes{advertising_system_identifier:"testdomain.com"seller_identifier:"pub-1111111111111111"handles_payment:true}version:"1.0"}frequency_capping_scope:FREQUENCY_CAPPING_SCOPE_NONEprivacy_treatments{ip:IP_REDACTEDuser_agent:USER_AGENT_COARSENEDnon_personalized_ads_reason:PUBLISHER_DECLARED_NPAallow_user_data_collection:falsedevice_storage_restriction_reason:INSUFFICIENT_USER_CONSENT}inventory_partner_domain:"OMITTED"
To convert the bid request into a binary form, like you would get from the
POST payload in a real request, you can do the following (in C++). Note,
however, that this is not applicable to OpenRTB JSON.
Real-time feedback is available to Authorized Buyers, as well
as exchanges and networks using Open Bidding.
Bid response feedback is supported on the subsequent bid request for both
OpenRTB and the deprecated Google RTB protocol. For OpenRTB, it is sent in
BidRequest.ext.bid_feedback.
In addition to the default fields sent in Bid Response Feedback, you can
also send custom data in the bid response using the
BidResponse.seatbid.bid.ext.event_notification_token field. The
event_notification_token is arbitrary data known only to the
bidder that might help with debugging, for example: a new targeting ID or
bidding ID representing a new tactic, or metadata associated with the creative
known only to the bidder. For details, see
OpenRTB Extensions Protocol Buffer
for OpenRTB or the deprecated
Google RTB protocol.
When Authorized Buyers sends a bid request to a bidder, the bidder replies
with a BidResponse. If the bidder has real-time feedback enabled,
then in a subsequent bid request, Authorized Buyers sends feedback on the
response in a BidFeedback message:
messageBidFeedback{//TheuniqueidfromBidRequest.id.optionalstringrequest_id=1;//Thestatuscodeforthead.Seecreative-status-codes.txtinthe//technicaldocumentationforalistofids.optionalint32creative_status_code=2;//Ifthebidwontheauction,thisisthepricepaidinyouraccount//currency.Ifthebidparticipatedintheauctionbutwasout-bid,this//istheCPMthatshouldhavebeenexceededinordertowin.Thisisnot//setifthebidwasfilteredpriortotheauction,ifthepublisheror//winningbidderhasoptedoutofpricefeedbackorifyouraccounthas//optedoutofsharingwinningpriceswithotherbidders.Forfirst-price//auctions,minimum_bid_to_winispopulatedinsteadofthisfield.optionaldoubleprice=3;//Theminimumbidvaluenecessarytohavetheauction,inyouraccount//currency.Ifyourbidwontheauction,thisisthesecondhighestbid//thatwasnotfiltered(includingthefloorprice).Ifyourbiddidnot//wintheauction,thisisthewinningcandidate's bid. This field will//onlybepopulatedifyourbidparticipatedinafirst-priceauction,and//willnotbepopulatedifyourbidwasfilteredpriortotheauction.optionaldoubleminimum_bid_to_win=6;//Theminimumbidvaluenecessarytohavewontheserver-sidecomponentof//theoverallauctiongiventhattherewasalsoaninterestgroupbidding//componenttotheoverallauctionwhichranusingtheProtectedAudience//API.ThevalueisexpressedinCPMofthebuyeraccountcurrency.The//minimumbidtowinfortheoverallauction,includingbidsfromthe//server-sideandtheon-deviceinterestgroupcomponents,ispopulatedin//theminimum_bid_to_winfieldofthesameBidFeedbackobject.optionaldoublesscminbidtowin=14;//Billableeventratemultiplierthatwasappliedtothisbidduring//ranking.Theadjustmentreflectsthelikelihoodthatyourbidwould//generateabillableevent(namely,theadrenderssuccessfully)ifitwon//theauction,relativetotheprobabilitythatotherbidsgeneratea//billableeventiftheywontheauction.Thisadjustmentcanbelargeror//smallerthan1.Thisaffectsthefinalrankingintheauctiononly;in//particular,thismultiplierdoesnotaffectthepaymentorwhetherthe//bidclearsanyfloorprice.optionalfloatbillable_event_rate_bid_adjustment=13[default=1];//WhenapublisherusesanRTBauctionandwaterfall-basedSDKmediationon//thesamequery,thewinnerofthereal-timeauctionmustalsocompetein//amediationwaterfall(whichisorderedbyprice)towintheimpression.//Ifthebidparticipatedintheauctionandtherewasnowaterfall,the//valueofthisfieldis0.Ifthebidparticipatedintheauctionand//therewasawaterfall,thevalueofthisfieldisapricerepresentinga//samplebidfromtheeligiblemediationnetworksthatwerehigherthanthe//auctionwinner,weightedbyexpectedfillrate.Thisfieldcanbeused//inconjunctionwithminimum_bid_to_wintotrainbiddingmodels.TheCPM//isinyouraccountcurrency.optionaldoublesampled_mediation_cpm_ahead_of_auction_winner=8;messageEventNotificationToken{//Thecontentsofthetoken.optionalstringpayload=1;}//Thetokenincludedinthecorrespondingbid.optionalEventNotificationTokenevent_notification_token=4;//ThecreativeIDincludedinthecorrespondingbid.optionalstringbuyer_creative_id=5;//Possibletypesofbidresponsefeedbackobjects.enumFeedbackType{FEEDBACK_TYPE_UNSPECIFIED=0;//Feedbackforabidthatwassubmittedonabidresponse.BID_FEEDBACK=1;//Feedbackforaninterestgroupbuyersubmittedonabidresponseto//particpateinaninterestgroupbiddingcomponentoftheauctionrun//usingtheProtectedAudienceAPI.INTEREST_GROUP_BUYER_FEEDBACK=2;}//ThetypeoftheBidFeedbackmessage.Googlewillsendseparate//BidFeedbackobjectsfor://a)Eachbidsubmittedonabidresponse//b)Eachbuyersubmittedonabidresponsetoparticpateinaninterest//groupbiddingcomponentoftheauctionrunusingtheProtectedAudience//API.optionalFeedbackTypefeedbacktype=15;//Originofaninterestgroupbuyerthatwasincludedinthebidresponse.//Thisfieldispopulatedonlyforfeedbackwhereabidderoptedinan//interestgroupbuyertoparticipateintheinterestgroupbidding//componentoftheoverallauctionrunusingtheProtectedAudienceAPI.//Tolearnmoreaboutorigins,seehttps://www.rfc-editor.org/rfc/rfc6454.//TolearnmoreaboutinterestgroupbiddingandtheProtectedAudience//API,see//https://developers.google.com/authorized-buyers/rtb/fledge-origin-trial.optionalstringbuyerorigin=16;//Thestatuscodeforthesubmittedinterestgroupbuyer.Thisfieldis//onlypopulatedinthefeedbackforaninterestgroupbuyerthatabidder//requestedtoenterintotheinterestgroupauctionthroughthebid//response.Individualcreativestatuscodesofbidssubmittedbythebuyer//intheon-deviceinterestgroupauctionarenotavailable.See//https://storage.googleapis.com/adx-rtb-dictionaries/interest-group-buyer-status-codes.txt//foralistofinterestgroupbuyerstatuscodes.optionalint32igbuyerstatus=17;}
From this message, the first field you should check is
bid_feedback.creative_status_code; you can find the code
meaning in
creative-status-codes.txt. Note that if you win the bid, you can opt out
from the price feedback. For more information, see How to
opt-out.
The real-time feedback includes the bid request ID and one of the
following:
Auction outcome
Real-time feedback
The buyer didn't submit a bid.
Nothing.
The buyer submitted a bid that was filtered out before reaching
the auction.
For an app impression and a creative status code of 83, the
app publisher could have been using a mediation waterfall and therefore the
winning bid would have competed against other demand in the publisher's
passback waterfall chain. Learn how to use
sampled_mediation_cpm_ahead_of_auction_winner when
bidding.
Sample
The following is a sample of real-time feedback as seen in supported
protocols:
OpenRTB Protobuf
Show me the example
id:"Wa0N08928Q93A1985Aj71s"imp{id:"1"banner{w:428h:846pos:AD_POSITION_FULLSCREENexpdir:LEFTexpdir:RIGHTexpdir:UPexpdir:DOWNapi:MRAID_1api:MRAID_2format{w:428h:846}format{w:414h:736}}displaymanager:"GoogleMobileAds-iOS"displaymanagerver:"10.12.0"instl:truetagid:"7674739358"bidfloor:0.01bidfloorcur:"USD"secure:trueexp:3600clickbrowser:truemetric{type:"click_through_rate"value:0.12990431487560272vendor:"EXCHANGE"}metric{type:"viewability"value:0.91vendor:"EXCHANGE"}[com.google.doubleclick.imp]{billing_id:25325587657ampad:AMP_AD_NOT_ALLOWEDopen_bidding{is_open_bidding:true}skadn{sourceapp:"com.google.testapp"skadnetids:"M8jiSyxV"skadnetids:"lZ95E155"versions:"2.0"versions:"2.1"fidelities:VIEW_THROUGH_ADSfidelities:STOREKIT_RENDERED_ADS}creative_enforcement_settings{policy_enforcement:POLICY_ENFORCEMENT_PLATFORM_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN}auction_environment:SERVER_SIDE_AUCTIONae:SERVER_SIDE_AUCTION}}app{name:"Test App"bundle:"com.google.testapp"publisher{id:"pub-7874601938215096"[com.google.doubleclick.publisher]{country:"CN"}}content{url:"https://www.google.com"livestream:falselanguage:"en"}storeurl:"https://www.google.com"[com.google.doubleclick.app]{inventorypartnerdomain:"OMITTED"}}device{ua:"Mozilla/5.0 (iPhone; CPU iPhone OS 16_3_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"ip:"192.168.1.0"geo{lat:0.0lon:0.0country:"MYS"region:"MY-13"city:"Kuching"zip:"93350"type:IPutcoffset:480accuracy:3372}make:"Apple"model:"iPhone14,3"os:"iOS"osv:"16.3.1"connectiontype:WIFIdevicetype:HIGHEND_PHONElmt:truehwv:"iPhone14,3"w:428h:926pxratio:3.0sua{browsers{brand:"Mozilla"version:"5"version:"0"}browsers{brand:"AppleWebKit"version:"605"version:"1"}platform{brand:"iPhone"version:"16"version:"3"}mobile:truebitness:"64"model:"iPhone"source:USER_AGENT_STRING}[com.google.doubleclick.device]{atts:2}}at:FIRST_PRICEtmax:1000cur:"USD"source{schain{complete:truenodes{asi:"testssp.com"sid:"pub-1111111111111111"hp:true}ver:"1.0"}[com.google.doubleclick.source]{omidpn:"Google"omidpv:"afma-sdk-i-v10.12.0"schain{complete:1nodes{asi:"testssp.com"sid:"pub-1111111111111111"hp:1}ver:"1.0"}}}[com.google.doubleclick.bid_request]{bid_feedback{request_id:"0I3TcIJ0r6cmPH750Be7b1"creative_status_code:79event_notification_token{payload:"token"}buyer_creative_id:"test_creative_id_151612"minimum_bid_to_win:0.14sampled_mediation_cpm_ahead_of_auction_winner:2.222233feedbacktype:BID_FEEDBACK}google_query_id:"ANy-zv49ep-83k2i3iDL3q449a2D1l824ye020uBq6B1wnPqWz1657JQ4LF11N71794cU0n9"fcap_scope:FREQUENCY_CAPPING_SCOPE_APP}
OpenRTB JSON
Show me the example
{"id":"B2zmta620ms2392240eM5R","imp":[{"id":"1","banner":{"w":300,"h":250,"pos":3,"wmax":300,"hmax":250,"wmin":0,"hmin":46,"format":[{"w":300,"h":250},{"w":180,"h":150}]},"displaymanager":"GOOGLE","tagid":"3178683015","bidfloor":0.06,"bidfloorcur":"USD","secure":1,"exp":3600,"metric":[{"type":"click_through_rate","value":0.0010899954941123724,"vendor":"EXCHANGE"},{"type":"viewability","value":0.28,"vendor":"EXCHANGE"}],"ext":{"billing_id":["76252023422"],"publisher_settings_list_id":["7226782477948422193","2459752148771775747"],"allowed_vendor_type":[3,42],"ampad":3,"creative_enforcement_settings":{"policy_enforcement":2,"publisher_blocks_enforcement":1},"auction_environment":0,"ae":0}}],"site":{"page":"https://www.google.com","publisher":{"id":"pub-1111111111111111","ext":{"country":"TR"}},"content":{"livestream":0,"language":"tr"},"ext":{"amp":0,"page_visibility":1,"inventorypartnerdomain":"OMITTED"}},"device":{"ua":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36","ip":"192.168.1.0","geo":{"lat":0.0,"lon":0.0,"country":"TUR","region":"TR-01","city":"Adana","type":2,"utcoffset":180,"accuracy":7060},"os":"Windows","devicetype":2,"lmt":0,"pxratio":1.25,"sua":{"browsers":[{"brand":"Chromium","version":["124","0"]},{"brand":"Google Chrome","version":["124","0"]}],"platform":{"brand":"Windows","version":["7","0"]},"mobile":0,"architecture":"x86","bitness":"64","source":2},},"at":1,"tmax":300,"cur":["USD"],"bcat":["IAB23-6","IAB23-8"],"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":"0S7s2muW9tFzp8zl35u97n","creative_status_code":80,"event_notification_token":{"payload":"token"},"buyer_creative_id":"test_creative_id_383532","minimum_bid_to_win":0.01,"feedbacktype":1}],"google_query_id":"ANy-z3QP2f-48p8d0ucFkGmd99q36HPgSg4o8b89L0989N0RoS0x56mYMJd4087NT0d21W99","fcap_scope":5,"privacy_treatments":{"allow_user_data_collection":1}}}
Google (Deprecated)
Show me the example
id:"(\001\334X\nH\034\230.\244 R/\370\204/\270\265\255H\322h\366"ip:"\300\250"user_agent:"Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"url:"https://www.google.com"detected_language:"en"adslot{id:1width:320height:50excluded_attribute:18excluded_attribute:27allowed_vendor_type:485allowed_vendor_type:4648excluded_sensitive_category:4excluded_sensitive_category:23matching_ad_data{billing_id:18273476630billing_id:57564954457minimum_cpm_micros:634720000}matching_ad_data{billing_id:51346235308billing_id:16770443752minimum_cpm_micros:4037930000}slot_visibility:ABOVE_THE_FOLDad_block_key:5409661012publisher_settings_list_id:8938951914739109978excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}viewability:94click_through_rate:0.0002517347allowed_ad_types:ALLOWED_AD_TYPE_BANNERis_amp_page:DIALECT_HTMLamp_ad_requirement_type:AMP_AD_NOT_ALLOWEDsession_depth:1api:OMID_1api:MRAID_1omidpn:"Google"omidpv:"afma-sdk-i-v8.13.0"creative_enforcement_settings{policy_enforcement:POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES}auction_environment:SERVER_SIDE_AUCTIONimpression_expiration_seconds:3600supported_auction_environment:SERVER_SIDE_AUCTIONdisplay_manager:"GoogleMobileAds-iOS"display_manager_version:"8.13.0"}is_test:falsecookie_version:1google_user_id:"qM75u4Pq2e1DYmuo3J1w534y786"timezone_offset:-300mobile{app_id:"549642335"is_app:trueencrypted_advertising_id:"\357\005\250`f\022\357Y\372$\177\005\325\036\334a]\241\014\367g_\032\262w,nG\265\312:Iw\037\347y"app_name:"Test App"advertising_id:"\272\026\206F\222\250\re\253\350G\235\241h\303\271"}cookie_age_seconds:20736000postal_code:"10011"geo_criteria_id:9012672publisher_settings_list_id:3625423117835077640bid_response_feedback{request_id:"\220\366\320/\025\000Z\212K\"\020\364\232\247\326Q"creative_status_code:80event_notification_token:"token"buyer_creative_id:"test_creative_id_180631"minimum_bid_to_win:11650000feedback_type:BID_FEEDBACK}publisher_type:PUBLISHER_OWNED_AND_OPERATEDpartner_id:7759509030857009145device{device_type:HIGHEND_PHONEplatform:"iphone"brand:"Apple"model:"iPhone13,2"os_version{major:16minor:6}carrier_id:0screen_width:390screen_height:844screen_pixel_ratio_millis:3000screen_orientation:PORTRAIThardware_version:"iPhone13,2"limit_ad_tracking:falseapp_tracking_authorization_status:AUTHORIZEDconnection_type:WIFI}publisher_country:"US"publisher_id:"pub-1111111111111111"response_deadline_ms:1000google_query_id:"ANy-z8184S-12cH23V6vlS7A862Qr799b3g4uh5Y8a21SDWf3XC22u9KS5KSn1053a97039y"auction_type:FIRST_PRICEgeo{lat:34.37lon:-87.44country:"USA"region:"AL"metro:"691"zip:"35651"utcoffset:-300accuracy:7879}user_agent_data{platform{brand:"iPhone"version:"16"version:"6"}mobile:truemodel:"iPhone"browsers{brand:"Mozilla"version:"5"version:"0"}browsers{brand:"AppleWebKit"version:"605"version:"1"}bitness:"64"source:USER_AGENT_STRING}supply_chain{complete:truenodes{advertising_system_identifier:"testdomain.com"seller_identifier:"pub-1111111111111111"handles_payment:true}version:"1.0"}frequency_capping_scope:FREQUENCY_CAPPING_SCOPE_DEVICEprivacy_treatments{allow_user_data_collection:true}inventory_partner_domain:"OMITTED"
Build a bidding model for first-price auctions
After placing a bid in a first-price auction, you will receive real-time
feedback including the minimum_bid_to_win and
sampled_mediation_cpm_ahead_of_auction_winner fields if the bid
was not filtered from the auction. These signals can be used to inform your
bidding logic on how much higher or lower your bid could have been in order to
win the impression.
minimum_bid_to_win: The minimum bid that could have been
placed to win the real-time bidding auction. If you won the auction, this will
be the lowest bid you could have placed while still winning. If you lost the
auction, this will be the winning bid.
sampled_mediation_cpm_ahead_of_auction_winner: If there are
other networks in the mediation chain, the
value of this field is a price representing a sample bid from one of the
eligible mediation networks that were higher than the auction winner, weighted
by expected fill rate. This will be set to 0 if none of the networks in the
mediation chain are expected to fill, or if the publisher does not use SDK
mediation.
How it works
In order to describe the calculations used to determine the possible values
for minimum_bid_to_win and
sampled_mediation_cpm_ahead_of_auction_winner, we first need to
define the following:
The following represents the CPMs in the mediation chain in descending order:
\[C_1, C_2, …, C_n\]
The following represents the corresponding fill rates for the CPMs in the
mediation chain:
\[f_1, f_2, …, f_n\]
The following is a function used to determine the expected CPM and its
probability from mediation chain element \(i\), based on the given fill
rate:
\(X_i = \{C_i\) with probability \(f_i\); \(0\) with probability \(1 - f_i\}\)
The final winning mediation chain will be:
\[\{C_1, C_2, …, C_K, W\}\]
where \(W\) is the winning bid, and \(C_K > W >= C_{K+1}\)
The reserve price, or floor, is denoted as \(F\).
The runner-up bid is denoted as \(R\).
Calculations for auction winner
Field
Calculation
minimum_bid_to_win
\(max\{F, R, X_{K+1}, …, X_n\}\)
sampled_mediation_cpm_ahead_of_auction_winner
\(\{C_i\) with probability \(\prod_{j=1}^{i-1}(1-f_j) \cdot f_i \div \prod_{j=1}^{K}(1-f_j)\}\)
For \(1 <= i <= K\).
Calculations for auction loser
Field
Calculation
minimum_bid_to_win
\(max\{F, W\}\)
sampled_mediation_cpm_ahead_of_auction_winner
\(max\{X_1, …, X_K\}\)
Example with a simple mediation chain
Assume a publisher uses both real-time bidding and an SDK mediation chain as
follows:
SDK Mediation Chain
Expected CPM
Fill Rate
Network 1
\(C_1 = $3.00\)
\(f_1 = 5\%\)
Network 2
\(C_2 = $2.00\)
\(f_2 = 45\%\)
Network 3
\(C_3 = $0.50\)
\(f_3 = 80\%\)
Network 4
\(C_4 = $0.10\)
\(f_4 = 85\%\)
Assume the following as the result of the RTB auction:
RTB Auction
CPM
Auction Winner (W)
$1.00
Auction Runner-UP (R)
$0.05
Reserve Price / Floor (F)
$0
Bid that won the auction
The following is an example of how values and probabilities for
minimum_bid_to_win and
sampled_mediation_cpm_ahead_of_auction_winner are calculated for a
bid that won.
The following is an example of how values and probabilities for
minimum_bid_to_win and
sampled_mediation_cpm_ahead_of_auction_winner are calculated for a
bids that lost.
minimum_bid_to_win
Probability
\(max(F, W) = $1.00\)
\(100\%\)
sampled_mediation_cpm_ahead_of_auction_winner
Probability
\(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\%\)
Bid flattening
Bid flattening describes the processing of a single complex
BidRequest into multiple bid requests that are sent to your
application. When a bid request is flattened, you can tell which bid requests
were part of the original because they will have an identical value in the
BidRequest.ext.google_query_id field.
Bid flattening is enabled by default, but you can contact your account
manager if you would prefer to disable it.
Ad formats
Some ad opportunities can accept multiple formats. With bid flattening, each
format is sent in a distinct bid request where attributes such as eligible
billing IDs are relevant to the format specified in the request.
Bid requests containing the following formats will be flattened into
distinct bid requests:
Banner
Video
Audio
Native
Ad format flattening example
Below is an example showing a simplified OpenRTB JSON bid request without ad
format flattening in comparison to an equivalent set of flatenned requests:
An ad opportunity for a given bidder can be applicable to various deal
types, in addition to the open auction. With bid flattening for deals, one bid
request will be sent for the open auction, and one for each type of fixed-price
deal. In practice, ad constraints can differ between auctions and fixed-price
deal types, for example, for a given video ad opportunity that is available to
both the open auction and a fixed-price deal, a bidder will receive distinct
bid requests for each where constraints such as maximum ad duration and whether
skippable ads are allowed can differ. As a result, flattening applied to the ad
opportunity lets you more easily discern the ad constraints for the open
auction and the fixed-price deal.
Max skippable video duration
Google's protocol and OpenRTB implementation support the following fields
for video duration and skipability:
Duration
Skippable duration
Skipability
Google protocol
max_ad_duration
skippable_max_ad_duration
video_ad_skippable
OpenRTB
maxduration
n/a
skip
This means that while the Google protocol can have a granular skippable
and non-skippable duration, the OpenRTB implementation only has a single
maximum duration value.
Prior to bid flattening, OpenRTB's maxduration would be set to
the lower of the Google protocol's max_ad_duration and
skippable_max_ad_duration fields. This behavior has now changed to
sending two separate bid requests when these values differ: one representing
the maxduration for skippable and the other for non-skippable
opportunities.
The following examples show how a Google protocol request translates
to OpenRTB before and after bid flattening. The equivalent Google protocol
request has a max_ad_duration of 15 and a
skippable_max_ad_duration of 60.
Example
max_ad_duration
skip (true OR false)
Original request without flattening
15
true
Flattened request #1: Non-skippable
15
false
Flattened request #2: Skippable
60
true
Skippable video duration bid request flattening will only take place when
these conditions are met:
The request allows video.
Both skip and no-skip videos are allowed, and the two respective max
durations differ in value.
This request is Private Auction or Open Auction-eligible.
The bidder account has active OpenRTB endpoints.
You can opt out from this type of flattening by contacting your technical
account manager.
Video pods
Bid requests for a video pod with multiple ad opportunities are flattened,
such that each bid request is for an individual ad opportunity from that pod.
This enables you to bid on multiple ad opportunities for a given pod.
Open Measurement
Open Measurement lets you specify third-party vendors that provide
independent measurement and verification services for ads served to mobile app
environments.
You can determine whether a publisher supports Open Measurement in the bid
request by checking whether the ad opportunity excludes the OmsdkType:
OMSDK 1.0 attribute found in Publisher-excludable
creative attributes. This would be found under the battr
attribute for Banner
or Video, depending
on the format.
For more information on how to interpret bid requests containing Open
Measurement signals, refer to the Open Measurement
SDK Help Center article.
Sample bid requests
The following sections show sample bid requests for different ad types.
App banner
OpenRTB Protobuf
Show me the example
id:"38V61KXKxB63Yk8o3G6P38"imp{id:"1"banner{w:320h:50pos:ABOVE_THE_FOLDapi:MRAID_1api:MRAID_2format{w:320h:50}}displaymanager:"GoogleMobileAds-Android"displaymanagerver:"22.6.0"tagid:"6163632333"bidfloor:0.04bidfloorcur:"USD"secure:trueexp:3600clickbrowser:truemetric{type:"click_through_rate"value:0.00265840464271605vendor:"EXCHANGE"}metric{type:"viewability"value:0.99vendor:"EXCHANGE"}[com.google.doubleclick.imp]{billing_id:67427969102publisher_settings_list_id:4626521705809021216publisher_settings_list_id:8961571116051095682allowed_vendor_type:113allowed_vendor_type:566ampad:AMP_AD_NOT_ALLOWEDexcluded_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_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES}auction_environment:SERVER_SIDE_AUCTIONae:SERVER_SIDE_AUCTION}}app{name:"Test App"bundle:"com.google.testapp"publisher{id:"pub-2997181131115025"[com.google.doubleclick.publisher]{country:"SG"}}content{url:"https://www.google.com"userrating:"4.5"livestream:falselanguage:"es"}storeurl:"https://www.google.com"[com.google.doubleclick.app]{inventorypartnerdomain:"OMITTED"}}device{ua:"Mozilla/5.0 (Linux; Android 14; SM-G998U Build/UP1A.231005.007; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/123.0.6312.118 Mobile Safari/537.36 (Mobile; afma-sdk-a-v241358038.241358038.0)"ip:"192.168.1.0"geo{lat:0.0lon:0.0country:"SLV"city:"Soyapango"type:IPutcoffset:-360accuracy:2669}make:"Samsung"model:"SM-G998U"os:"android"osv:"14"connectiontype:WIFIdevicetype:HIGHEND_PHONElmt:falsew:384h:779pxratio:2.813sua{browsers{brand:"Mozilla"version:"5"version:"0"}browsers{brand:"AppleWebKit"version:"537"version:"36"}platform{brand:"Android"version:"14"}mobile:truebitness:"64"model:"SM-G998U"source:USER_AGENT_STRING}}at:FIRST_PRICEtmax:300cur:"USD"bcat:"IAB23-1"bcat:"IAB7-36"source{schain{complete:truenodes{asi:"testssp.com"sid:"pub-1111111111111111"hp:true}ver:"1.0"}[com.google.doubleclick.source]{omidpn:"Google"omidpv:"afma-sdk-a-v240304999.234310000.1"schain{complete:1nodes{asi:"testssp.com"sid:"pub-1111111111111111"hp:1}ver:"1.0"}}}[com.google.doubleclick.bid_request]{google_query_id:"ANy-z128zE-MC22DP3W65flJoxSet5n2U738TRR92N5E76wd7Bh38KuU08Tyt67or0Od0b3q"fcap_scope:FREQUENCY_CAPPING_SCOPE_DEVICEprivacy_treatments{allow_user_data_collection:true}}
OpenRTB JSON
Show me the example
{"id":"r87mLfJ195K96b48857234","imp":[{"id":"1","banner":{"w":390,"h":61,"pos":1,"api":[3,5],"wmax":390,"hmax":61,"wmin":261,"hmin":46,"format":[{"w":390,"h":61},{"w":320,"h":50}]},"displaymanager":"GoogleMobileAds-iOS","displaymanagerver":"11.2.0","tagid":"2022397433","bidfloor":0.04,"bidfloorcur":"USD","secure":1,"exp":3600,"clickbrowser":1,"metric":[{"type":"click_through_rate","value":4.110196186957182e-06,"vendor":"EXCHANGE"},{"type":"viewability","value":0,"vendor":"EXCHANGE"}],"ext":{"billing_id":["82346236545"],"publisher_settings_list_id":["5491354135157496540","9146398712997475724"],"allowed_vendor_type":[445,776],"ampad":2,"allowed_restricted_category":[33],"skadn":{"sourceapp":"com.google.testapp","skadnetids":["5c39728P"],"versions":["2.0","2.1"],"fidelities":[1,0]},"creative_enforcement_settings":{"policy_enforcement":2,"publisher_blocks_enforcement":1},"auction_environment":0,"ae":0}}],"app":{"name":"Test App","bundle":"com.google.testapp","publisher":{"id":"pub-1242890569860107","ext":{"country":"SG"}},"content":{"url":"https://www.google.com","livestream":0,"language":"en"},"storeurl":"https://www.google.com","ext":{"inventorypartnerdomain":"OMITTED"}},"device":{"ua":"Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148","geo":{"lat":0.0,"lon":0.0,"country":"USA","region":"MI","metro":"563","zip":"49512","type":2,"utcoffset":-240,"accuracy":2082},"ipv6":"2601:404:d980::","make":"Apple","model":"iPhone14,7","os":"iOS","osv":"17.4.1","connectiontype":2,"devicetype":4,"lmt":1,"hwv":"iPhone14,7","w":390,"h":844,"pxratio":3,"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":2}},"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-i-v11.2.0","schain":{"complete":1,"nodes":[{"asi":"testssp.com","sid":"pub-1111111111111111","hp":1}],"ver":"1.0"}}},"ext":{"google_query_id":"ANy-z62LCy-as7Eko7z4957U01DLmn1o5VEX66Mm2j8763ahN2zV77j721K17752LzuUR571","fcap_scope":4,"privacy_treatments":{"allow_user_data_collection":1}}}
Google (Deprecated)
Show me the example
id:"1\200\2149CH\354\224S\002G>\276\3068\264Z\316\203Hz\010\334"ip:"\300\250"user_agent:"Mozilla/5.0 (Linux; Android 13; SM-A032M Build/TP1A.220624.014; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/123.0.6312.118 Mobile Safari/537.36 (Mobile; afma-sdk-a-v241518064.241518064.0)"url:"https://www.google.com"detected_language:"pt"adslot{id:1width:300width:320height:250height:50excluded_attribute:13excluded_attribute:18allowed_vendor_type:745allowed_vendor_type:4513excluded_sensitive_category:4excluded_sensitive_category:31matching_ad_data{billing_id:16751333146minimum_cpm_micros:10000}slot_visibility:ABOVE_THE_FOLDad_block_key:6911419491publisher_settings_list_id:3488369073734770391excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}viewability:66allowed_ad_types:ALLOWED_AD_TYPE_BANNERis_amp_page:DIALECT_HTMLamp_ad_requirement_type:AMP_AD_NOT_ALLOWEDapi:OMID_1api:MRAID_1flexible_adslot_settings{max_width:336max_height:280min_width:168min_height:0}regs_lgpd:trueomidpn:"Google"omidpv:"afma-sdk-a-v240304999.224400000.1"creative_enforcement_settings{policy_enforcement:POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES}auction_environment:SERVER_SIDE_AUCTIONimpression_expiration_seconds:3600supported_auction_environment:SERVER_SIDE_AUCTIONdisplay_manager:"GoogleMobileAds-Android"display_manager_version:"21.5.0"}is_test:falsetimezone_offset:-180mobile{app_id:"com.google.testapp"is_app:trueapp_name:"Test App"app_rating:4.6296206}geo_criteria_id:1001533publisher_settings_list_id:12488741028105368323publisher_type:PUBLISHER_OWNED_AND_OPERATEDpartner_id:8688212468768627166device{device_type:HIGHEND_PHONEplatform:"android"brand:"Samsung"model:"SM-A032M"os_version{major:13}carrier_id:0screen_width:360screen_height:730screen_pixel_ratio_millis:2000screen_orientation:PORTRAITlimit_ad_tracking:falseconnection_type:WIFI}publisher_country:"BR"publisher_id:"pub-1111111111111111"response_deadline_ms:1000google_query_id:"ANy-z6684B-S9K9375rD1B53ZdYA2RQi090I2bJ579yi0CF0N8A60v821V52F938j142LOzW"auction_type:FIRST_PRICEgeo{lat:-12.98lon:-38.5country:"BRA"region:"BR-BA"city:"Salvador"utcoffset:-180accuracy:14885}user_agent_data{platform{brand:"Android"version:"13"}mobile:truemodel:"SM-A032M"browsers{brand:"Mozilla"version:"5"version:"0"}browsers{brand:"AppleWebKit"version:"537"version:"36"}bitness:"64"source:USER_AGENT_STRING}supply_chain{complete:truenodes{advertising_system_identifier:"testdomain.com"seller_identifier:"pub-1111111111111111"handles_payment:true}version:"1.0"}frequency_capping_scope:FREQUENCY_CAPPING_SCOPE_BROWSERprivacy_treatments{non_personalized_ads_reason:USER_OPT_OUTallow_user_data_collection:false}inventory_partner_domain:"OMITTED"
{"id":"8460Dv0171574mt7n9tOQ9","imp":[{"id":"1","banner":{"w":428,"h":846,"pos":7,"api":[3,5],"format":[{"w":428,"h":846},{"w":414,"h":736}]},"displaymanager":"GoogleMobileAds-iOS","displaymanagerver":"10.10.0","instl":1,"tagid":"4914454382","bidfloor":0.01,"bidfloorcur":"USD","secure":1,"exp":3600,"clickbrowser":1,"metric":[{"type":"click_through_rate","value":0.560609757900238,"vendor":"EXCHANGE"},{"type":"viewability","value":0.97,"vendor":"EXCHANGE"}],"ext":{"billing_id":["73848702501"],"publisher_settings_list_id":["9781603598081027997","9488077458915289715"],"allowed_vendor_type":[698,414],"ampad":2,"excluded_creatives":[{"buyer_creative_id":"EXCLUDED_BUYER_CREATIVE_ID"},{"buyer_creative_id":"EXCLUDED_BUYER_CREATIVE_ID"}],"skadn":{"sourceapp":"com.google.testapp","skadnetids":["43D4r5x9"],"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","bundle":"com.google.testapp","publisher":{"id":"pub-5842596021161378","ext":{"country":"IN"}},"content":{"url":"https://www.google.com","livestream":0,"language":"en"},"storeurl":"https://www.google.com","ext":{"inventorypartnerdomain":"OMITTED"}},"device":{"ua":"Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148","geo":{"lat":0.0,"lon":0.0,"country":"SAU","region":"SA-02","city":"Jiddah","zip":"23462","type":2,"utcoffset":180,"accuracy":1291},"ipv6":"2a02:9b0:4047::","carrier":"71681","make":"Apple","model":"iPhone14,8","os":"iOS","osv":"17.4.1","connectiontype":6,"devicetype":4,"lmt":1,"hwv":"iPhone14,8","w":428,"h":926,"pxratio":3,"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":2}},"at":1,"tmax":1000,"cur":["USD"],"bcat":["IAB23-4","IAB18-5"],"source":{"schain":{"complete":1,"nodes":[{"asi":"testssp.com","sid":"pub-1111111111111111","hp":1}],"ver":"1.0"},"ext":{"omidpn":"Google","omidpv":"afma-sdk-i-v10.10.0","schain":{"complete":1,"nodes":[{"asi":"testssp.com","sid":"pub-1111111111111111","hp":1}],"ver":"1.0"}}},"ext":{"google_query_id":"ANy-z562Q0-p46Tz77U15Ie9774Mnu3QIa45V73X99r9NR1694g5301D186q8ZFJ57Ja8L78","fcap_scope":4,"privacy_treatments":{"allow_user_data_collection":1}}}
Google (Deprecated)
Show me the example
id:"(\232m\232xp\035\326w\260\250\262\205\r:\313\373:3\215!L\234"ip:"\300\250"user_agent:"Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"url:"https://www.google.com"detected_language:"en"adslot{id:1width:398width:320height:744height:480excluded_attribute:19excluded_attribute:18allowed_vendor_type:828allowed_vendor_type:4697matching_ad_data{billing_id:37034094959billing_id:19705546350minimum_cpm_micros:200000}slot_visibility:ABOVE_THE_FOLDad_block_key:7260775726publisher_settings_list_id:1906995857014069503viewability:91click_through_rate:0.021559697allowed_ad_types:ALLOWED_AD_TYPE_BANNERis_amp_page:DIALECT_HTMLamp_ad_requirement_type:AMP_AD_NOT_ALLOWEDapi:OMID_1api:MRAID_1omidpn:"Google"omidpv:"afma-sdk-i-v11.2.0"creative_enforcement_settings{policy_enforcement:POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES}auction_environment:SERVER_SIDE_AUCTIONimpression_expiration_seconds:14400billable_event_rate_bid_adjustment{bid_adjustment:1.1087964creative_type:HTML_SNIPPET}supported_auction_environment:SERVER_SIDE_AUCTIONdisplay_manager:"GoogleMobileAds-iOS"display_manager_version:"11.2.0"}is_test:falsetimezone_offset:480mobile{app_id:"500811620"is_app:trueis_interstitial_request:trueapp_name:"Test App"skadn{sourceapp:"500811620"skadnetids:"41dEOEaD"skadnetids:"580dmbSX"versions:"2.0"versions:"2.1"supported_fidelity_types:VIEW_THROUGH_ADSsupported_fidelity_types:STOREKIT_RENDERED_ADSskoverlay:true}is_app_open_ad:true}geo_criteria_id:20827publisher_settings_list_id:18428013069233776176publisher_type:PUBLISHER_OWNED_AND_OPERATEDpartner_id:4672461785023090980device{device_type:HIGHEND_PHONEplatform:"iphone"brand:"Apple"model:"iPhone11,8"os_version{major:16minor:6micro:1}carrier_id:0screen_width:414screen_height:896screen_pixel_ratio_millis:2000screen_orientation:PORTRAIThardware_version:"iPhone11,8"limit_ad_tracking:trueapp_tracking_authorization_status:NOT_DETERMINEDconnection_type:WIFI}publisher_country:"SG"publisher_id:"pub-1111111111111111"response_deadline_ms:1000google_query_id:"ANy-z06138-98U8A68As2n5q57SoKI3EBuB5RV414N6krfd385z0q1c9o28Bv3176Zw2LuJe"auction_type:FIRST_PRICEgeo{lat:10.24lon:123.79country:"PHL"region:"PH-CEB"utcoffset:480accuracy:39443}user_agent_data{platform{brand:"iPhone"version:"16"version:"6"}mobile:truemodel:"iPhone"browsers{brand:"Mozilla"version:"5"version:"0"}browsers{brand:"AppleWebKit"version:"605"version:"1"}bitness:"64"source:USER_AGENT_STRING}supply_chain{complete:truenodes{advertising_system_identifier:"testdomain.com"seller_identifier:"pub-1111111111111111"handles_payment:true}version:"1.0"}frequency_capping_scope:FREQUENCY_CAPPING_SCOPE_APPprivacy_treatments{allow_user_data_collection:true}inventory_partner_domain:"OMITTED"
App interstitial video
OpenRTB Protobuf
Show me the example
id:"378836oi92t144hpA8Nv3X"imp{id:"1"video{mimes:"video/mp4"maxduration:60w:375h:667startdelay:0playbackmethod:AUTO_PLAY_SOUND_ONpos:ABOVE_THE_FOLDapi:MRAID_1api:MRAID_2protocols:VAST_2_0protocols:VAST_3_0skip:falseplacement:UNDEFINED_VIDEO_PLACEMENTplaybackend:COMPLETION_OR_USER}displaymanager:"GOOGLE"instl:truetagid:"4107980261"bidfloor:0.01bidfloorcur:"USD"secure:truemetric{type:"click_through_rate"value:0.0364835150539875vendor:"EXCHANGE"}metric{type:"video_completion_rate"value:0.02888789027929306vendor:"EXCHANGE"}[com.google.doubleclick.imp]{billing_id:80831705186publisher_settings_list_id:2080323352414623499publisher_settings_list_id:2258624117197706769allowed_vendor_type:342allowed_vendor_type:698is_rewarded_inventory:trueampad:AMP_AD_NOT_ALLOWEDskadn{version:"2.2"sourceapp:"532115234"skadnetids:"E499wc36"versions:"2.0"versions:"2.1"fidelities:STOREKIT_RENDERED_ADSfidelities:VIEW_THROUGH_ADS}creative_enforcement_settings{policy_enforcement:POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_APPLIESis_default:true}auction_environment:SERVER_SIDE_AUCTION}}app{name:"Test App"bundle:"532115234"publisher{id:"pub-8927593002710190"[com.google.doubleclick.publisher]{country:"CN"}}content{url:"https://www.google.com"livestream:falselanguage:"zh"}storeurl:"https://www.google.com"[com.google.doubleclick.app]{}}device{ua:"Mozilla/5.0 (iPhone; CPU iPhone OS 15_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"ip:"192.168.1.0"geo{lat:0.0lon:0.0country:"CHN"region:"CN-33"city:"Hangzhou"type:IPaccuracy:44240}carrier:"70120"make:"apple"model:"iphone"os:"iOS"osv:"15.4.4"devicetype:HIGHEND_PHONElmt:truehwv:"8"w:375h:667pxratio:2.0[com.google.doubleclick.device]{user_agent_data{platform{brand:"iPhone"version:"15"version:"4"}mobile:truemodel:"iPhone"}atts:2}}user{[com.google.doubleclick.user]{}}at:FIRST_PRICEtmax:300cur:"USD"source{[com.google.doubleclick.source]{omidpn:"Google"omidpv:"afma-sdk-i-v8.12.0"schain{complete:1nodes{asi:"google.com"sid:"pub-4000453616931440"hp:1}ver:"1.0"}}}[com.google.doubleclick.bid_request]{google_query_id:"ANy-zp09u8-d20rQ521040dqz39K771Lr9102b031Z15C45Q9q7AB414SnDWG5Rj96Z77W66"}
Google (Deprecated)
Show me the example
id:"%w\237\340\331q\305 e\350\324\017Ho\274f\177#\316\231\004\024y"ip:"\300\250"user_agent:"Mozilla/5.0 (iPhone; CPU iPhone OS 16_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"url:"https://www.google.com"detected_language:"te"adslot{id:1width:1170width:768height:2532height:1024excluded_attribute:17excluded_attribute:26allowed_vendor_type:797allowed_vendor_type:38523matching_ad_data{billing_id:82632801525billing_id:33577396948minimum_cpm_micros:200000}slot_visibility:ABOVE_THE_FOLDad_block_key:8662832267publisher_settings_list_id:1529810617400603626viewability:99click_through_rate:0.75363326video_completion_rate:0.07627885is_rewarded:trueallowed_ad_types:ALLOWED_AD_TYPE_VIDEOis_amp_page:DIALECT_HTMLamp_ad_requirement_type:AMP_AD_NOT_ALLOWEDapi:MRAID_1api:MRAID_2creative_enforcement_settings{policy_enforcement:POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES}auction_environment:SERVER_SIDE_AUCTIONimpression_expiration_seconds:3600supported_auction_environment:SERVER_SIDE_AUCTIONdisplay_manager:"GoogleMobileAds-iOS"display_manager_version:"7.55.0"}is_test:falsetimezone_offset:300mobile{app_id:"734009722"is_app:trueis_interstitial_request:trueapp_name:"Test App"}video{videoad_start_delay:0max_ad_duration:30000video_ad_skippable:BLOCK_SKIPPABLEallowed_video_formats:VIDEO_MP4max_ads_in_pod:2end_cap_support:END_CAP_OPTIONALplayback_method:CLICK_TO_PLAYis_clickable:trueplacement:INTERSTITIALprotocols:VAST_2_0protocols:VAST_3_0is_livestream:falseplayback_cessation_mode:COMPLETION_OR_USERmax_pod_duration_seconds:30plcmt:PLCMT_INTERSTITIALinferred_plcmt:PLCMT_INTERSTITIAL}geo_criteria_id:2392publisher_settings_list_id:7852789180056851229publisher_type:PUBLISHER_OWNED_AND_OPERATEDpartner_id:7934642581646184119device{device_type:HIGHEND_PHONEplatform:"iphone"brand:"Apple"model:"iPhone13,2"os_version{major:16minor:5}carrier_id:0screen_width:1170screen_height:2532screen_pixel_ratio_millis:3000screen_orientation:PORTRAIThardware_version:"iPhone13,2"limit_ad_tracking:falseconnection_type:WIFI}publisher_country:"US"publisher_id:"pub-1111111111111111"response_deadline_ms:1000google_query_id:"ANy-zz7hC6-w4hX445M724Cr7459S5M13Rw47SH672s9ygi8d8H1LN21ky6939KaU50lQsJR"auction_type:FIRST_PRICEgeo{lat:36.2lon:138.25country:"JPN"utcoffset:300accuracy:463340}user_agent_data{platform{brand:"iPhone"version:"16"version:"5"}mobile:truemodel:"iPhone"browsers{brand:"Mozilla"version:"5"version:"0"}browsers{brand:"AppleWebKit"version:"605"version:"1"}bitness:"64"source:USER_AGENT_STRING}supply_chain{complete:truenodes{advertising_system_identifier:"testdomain.com"seller_identifier:"pub-1111111111111111"handles_payment:true}version:"1.0"}frequency_capping_scope:FREQUENCY_CAPPING_SCOPE_NONEprivacy_treatments{allow_user_data_collection:true}inventory_partner_domain:"OMITTED"
App native
OpenRTB Protobuf
Show me the example
id:"5P52J8388TSRzc920ct7p5"imp{id:"1"displaymanager:"GoogleMobileAds-iOS"displaymanagerver:"10.14.0"tagid:"6553352351"bidfloor:0.03bidfloorcur:"USD"secure:truenative{ver:"1.2"api:MRAID_1api:MRAID_2battr:VIDEO_IN_BANNER_AUTO_PLAYbattr:VIDEO_IN_BANNER_USER_INITIATEDrequest_native{ver:"1.2"assets{id:1required:truetitle{len:25}}assets{id:2required:truedata{type:DESClen:90}}assets{id:3data{type:CTATEXTlen:15}}assets{id:4required:truedata{type:SPONSOREDlen:25}}assets{id:5required:trueimg{type:MAINwmin:1200hmin:627}}assets{id:6img{type:LOGOwmin:100hmin:100}}eventtrackers{event:IMPRESSIONmethods:IMG}}}exp:3600clickbrowser:truemetric{type:"viewability"value:0.39vendor:"EXCHANGE"}metric{type:"session_depth"value:1.0vendor:"EXCHANGE"}[com.google.doubleclick.imp]{billing_id:52078759229billing_id:88594274551publisher_settings_list_id:5866545268236998203publisher_settings_list_id:3494845642358232123allowed_vendor_type:42allowed_vendor_type:79ampad:AMP_AD_NOT_ALLOWEDexcluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}skadn{sourceapp:"com.google.testapp"skadnetids:"200O3kQr"versions:"2.0"versions:"2.1"fidelities:STOREKIT_RENDERED_ADSfidelities:VIEW_THROUGH_ADS}creative_enforcement_settings{policy_enforcement:POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES}auction_environment:SERVER_SIDE_AUCTIONae:SERVER_SIDE_AUCTION}}app{name:"Test App"bundle:"com.google.testapp"publisher{id:"pub-9816179305584184"[com.google.doubleclick.publisher]{country:"LU"}}content{url:"https://www.google.com"livestream:falselanguage:"uk"}storeurl:"https://www.google.com"[com.google.doubleclick.app]{inventorypartnerdomain:"OMITTED"}}device{ua:"Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"geo{lat:0.0lon:0.0country:"UKR"region:"UA-46"city:"L\'viv"zip:"79000"type:IPutcoffset:180accuracy:6246[com.google.doubleclick.geo]{geo_criteria_id:1012859}}ipv6:"2a02:2378:106a::"carrier:"71710"make:"Apple"model:"iPhone12,1"os:"iOS"osv:"17.4.1"connectiontype:CELL_4Gdevicetype:HIGHEND_PHONEifa:"b\'\\t:>vF\\xb9\\x9e4\\x86k\\xde\\x99\\xbe\\xb6\\x88\\x83\'"lmt:falsehwv:"iPhone12,1"w:414h:896pxratio:2.0sua{browsers{brand:"Mozilla"version:"5"version:"0"}browsers{brand:"AppleWebKit"version:"605"version:"1"}platform{brand:"iPhone"version:"17"version:"4"}mobile:truebitness:"64"model:"iPhone"source:USER_AGENT_STRING}[com.google.doubleclick.device]{atts:3}}user{id:"8Er98D3U5PK59538kL30LhIZkab"}at:FIRST_PRICEtmax:300cur:"USD"bcat:"IAB7-39"bcat:"IAB9"bapp:"1038653883"bapp:"372513032"source{schain{complete:truenodes{asi:"testssp.com"sid:"pub-1111111111111111"hp:true}ver:"1.0"}[com.google.doubleclick.source]{omidpn:"Google"omidpv:"afma-sdk-i-v10.14.0"schain{complete:1nodes{asi:"testssp.com"sid:"pub-1111111111111111"hp:1}ver:"1.0"}}}[com.google.doubleclick.bid_request]{google_query_id:"ANy-z0n8D1-K6FKO2zNI26Z4yp738UAjYOUTxw2V054413Lpv107q2A97RS96j68N9J53N9K"fcap_scope:FREQUENCY_CAPPING_SCOPE_DEVICEprivacy_treatments{allow_user_data_collection:false}}
OpenRTB JSON
Show me the example
{"id":"IDnDvM76w32NI830aSeOLg","imp":[{"id":"1","displaymanager":"GoogleMobileAds-iOS","displaymanagerver":"10.14.0","tagid":"8614649788","bidfloor":1.63,"bidfloorcur":"USD","secure":1,"native":{"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]}]}","ver":"1.2","api":[3,5],"battr":[6,7]},"exp":14400,"clickbrowser":1,"metric":[{"type":"viewability","value":0.66,"vendor":"EXCHANGE"},{"type":"session_depth","value":1,"vendor":"EXCHANGE"}],"ext":{"billing_id":["30567639040"],"publisher_settings_list_id":["9263869437120754969","6380991891694941170"],"allowed_vendor_type":[42,144],"ampad":2,"excluded_creatives":[{"buyer_creative_id":"EXCLUDED_BUYER_CREATIVE_ID"},{"buyer_creative_id":"EXCLUDED_BUYER_CREATIVE_ID"}],"skadn":{"sourceapp":"com.google.testapp","skadnetids":["345vh5bv"],"versions":["2.0","2.1"],"fidelities":[1,0]},"creative_enforcement_settings":{"policy_enforcement":2,"publisher_blocks_enforcement":1},"auction_environment":0,"ae":0}}],"app":{"name":"Test App","bundle":"com.google.testapp","publisher":{"id":"pub-5146744635924393","ext":{"country":"US"}},"content":{"url":"https://www.google.com","livestream":0,"language":"en"},"storeurl":"https://www.google.com","ext":{"inventorypartnerdomain":"OMITTED"}},"device":{"ua":"Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 PrebidMobile/2.0.4","ip":"192.168.1.0","geo":{"lat":0.0,"lon":0.0,"country":"USA","region":"WA","metro":"881","city":"Quincy","zip":"98848","type":2,"utcoffset":-420,"accuracy":19022},"make":"Apple","model":"iPhone15,3","os":"iOS","osv":"17.4.1","connectiontype":2,"devicetype":4,"ifa":"76RVV351f5D7z7905j9Dhy5kawZNAvn548d3","lmt":0,"hwv":"iPhone15,3","w":430,"h":932,"pxratio":3,"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":"V3G2P745W97j342y3bgMZzO8B19","ext":{"session":{"duration":14}}},"at":1,"tmax":300,"cur":["USD"],"bcat":["IAB23-1","IAB9"],"bapp":["1427744264"],"source":{"schain":{"complete":1,"nodes":[{"asi":"testssp.com","sid":"pub-1111111111111111","hp":1}],"ver":"1.0"},"ext":{"omidpn":"Google","omidpv":"afma-sdk-i-v10.14.0","schain":{"complete":1,"nodes":[{"asi":"testssp.com","sid":"pub-1111111111111111","hp":1}],"ver":"1.0"}}},"ext":{"google_query_id":"ANy-z70v0W-6x9m76YuuU237u44yc6fL3Ouo00tZhzmz1rL58xQr1V6tg59Qu5j2f4LEMbPZ","fcap_scope":3,"privacy_treatments":{"allow_user_data_collection":1}}}
Google (Deprecated)
Show me the example
id:"\304a\2145\337\260\351\265\0170E\035s\260\203\240\3645M\213d\231)"ip:"\300\250"user_agent:"Mozilla/5.0 (Linux; Android 14; SM-F711B Build/UP1A.231005.007; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/123.0.6312.118 Mobile Safari/537.36 (Mobile; afma-sdk-a-v241517039.241517039.0)"url:"https://www.google.com"detected_language:"nl"adslot{id:1excluded_attribute:25excluded_attribute:114allowed_vendor_type:42allowed_vendor_type:79excluded_sensitive_category:36excluded_sensitive_category:27matching_ad_data{billing_id:32132054378billing_id:19164334712minimum_cpm_micros:1450000}matching_ad_data{billing_id:13390832794billing_id:80810593642minimum_cpm_micros:78120000}slot_visibility:ABOVE_THE_FOLDexcluded_product_category:10137excluded_product_category:10231ad_block_key:5513314873publisher_settings_list_id:3686438009801411181publisher_settings_list_id:2386502705811569074allowed_restricted_category:33excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}viewability:81allowed_restricted_category_for_deals:33click_through_rate:0.026668096allowed_languages:"en"allowed_languages:"nl"allowed_ad_types:ALLOWED_AD_TYPE_NATIVEis_amp_page:DIALECT_HTMLamp_ad_requirement_type:AMP_AD_NOT_ALLOWEDsession_depth:166consented_providers_settings{tcf_consent_string:"OMITTED"additional_consent_string:"OMITTED"}regs_gdpr:trueapi:MRAID_1api:MRAID_2native_ad_template{required_fields:27recommended_fields:36headline_max_safe_length:25body_max_safe_length:90call_to_action_max_safe_length:15advertiser_max_safe_length:25image_width:800image_height:800logo_width:200logo_height:200}native_ad_template{required_fields:83recommended_fields:388headline_max_safe_length:25body_max_safe_length:90call_to_action_max_safe_length:15image_width:1200image_height:627app_icon_width:100app_icon_height:100}omidpn:"Google"omidpv:"afma-sdk-a-v240304999.234310000.1"creative_enforcement_settings{policy_enforcement:POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES}auction_environment:SERVER_SIDE_AUCTIONimpression_expiration_seconds:3600supported_auction_environment:SERVER_SIDE_AUCTIONdisplay_manager:"GoogleMobileAds-Android"display_manager_version:"22.6.0"}is_test:falsecookie_version:1google_user_id:"7L986AX24bG4ANQ91i8sd54fB22"timezone_offset:120mobile{app_id:"com.google.testapp"is_app:trueencrypted_advertising_id:"\341\220\325\205%\025\246_/\307\374fy\2062\270\270\204X\230\210@h\272\344\177\370\253e\367\262i=U\030$"app_name:"Test App"app_rating:4.0450907advertising_id:"\315\361Ro$|\362I\355\261:\265Z\300@\242"}cookie_age_seconds:2592000postal_code:"10011"geo_criteria_id:1001092encrypted_hyperlocal_set:"\275\237\311:\263\326\270h\337^\013`/m\316\330\036\007\313\265\346\351\275\346<U\344#a\376\301\342\270\303\2767\310j%\327\351aA\312\200\247]IQ\241\341L\2431\215<\377\033V\310\230\305\371\025\032K\365\372\3365p|\353\216\251JSf\364\367\220H\232\342Cq\256\206<\236\311"bid_response_feedback{request_id:"\253\245\326\202\206\303q\202\307\016\257\236\317\rL\250"creative_status_code:80event_notification_token:"token"buyer_creative_id:"test_creative_id_658408"minimum_bid_to_win:120000feedback_type:BID_FEEDBACK}publisher_type:PUBLISHER_OWNED_AND_OPERATEDhyperlocal_set{hyperlocal{corners{latitude:0.0longitude:0.0}corners{latitude:0.0longitude:0.0}corners{latitude:0.0longitude:0.0}corners{latitude:0.0longitude:0.0}}center_point{latitude:0.0longitude:0.0}}device{device_type:HIGHEND_PHONEplatform:"android"brand:"Samsung"model:"SM-F711B"os_version{major:14}carrier_id:0screen_width:360screen_height:801screen_pixel_ratio_millis:3000screen_orientation:PORTRAITlimit_ad_tracking:falseconnection_type:WIFI}publisher_country:"BE"publisher_id:"pub-1111111111111111"response_deadline_ms:300google_query_id:"ANy-z01131-SRYIYklKNjC6Iw9Z99Jt2713Cf3WC111fe9wZa3e2wB0yC6A51Bt0R4x25142"auction_type:FIRST_PRICEgeo{lat:50.89lon:4.28country:"BEL"region:"BE-VBR"city:"Asse"zip:"1731"utcoffset:120accuracy:2191}user_agent_data{platform{brand:"Android"version:"14"}mobile:truemodel:"SM-F711B"browsers{brand:"Mozilla"version:"5"version:"0"}browsers{brand:"AppleWebKit"version:"537"version:"36"}bitness:"64"source:USER_AGENT_STRING}supply_chain{complete:truenodes{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_DEVICEprivacy_treatments{allow_user_data_collection:false}inventory_partner_domain:"OMITTED"
Web video
Google (Deprecated)
Show me the example
id:"\350\243\202\2349\243\014\244\372\020Y;\r\007\031\214{\232\261\3752%\035"ip:"\300\250"user_agent:"Mozilla/5.0 (iPhone; CPU iPhone OS 14_8_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1"url:"https://www.google.com"detected_language:"ja"adslot{id:1width:320width:360height:570height:592excluded_attribute:19excluded_attribute:13allowed_vendor_type:3allowed_vendor_type:42excluded_sensitive_category:36excluded_sensitive_category:4matching_ad_data{billing_id:34223090460minimum_cpm_micros:16000000direct_deal{direct_deal_id:17775265fixed_cpm_micros:16000000deal_type:AUCTION_PACKAGE}}matching_ad_data{billing_id:86280326995billing_id:71601885715minimum_cpm_micros:120000}slot_visibility:NO_DETECTIONexcluded_product_category:10137excluded_product_category:10609ad_block_key:5853321589publisher_settings_list_id:2539996898654608860publisher_settings_list_id:7335705698915428874allowed_restricted_category:33excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}excluded_creatives{buyer_creative_id:"EXCLUDED_BUYER_CREATIVE_ID"}iframing_state:UNKNOWN_IFRAME_STATEviewability:100allowed_restricted_category_for_deals:33click_through_rate:0.5914875renderer:GOOGLEis_rewarded:trueallowed_ad_types:ALLOWED_AD_TYPE_VIDEOis_amp_page:DIALECT_HTMLamp_ad_requirement_type:AMP_AD_ALLOWED_AND_NOT_EARLY_RENDEREDcreative_enforcement_settings{policy_enforcement:POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES}auction_environment:SERVER_SIDE_AUCTIONimpression_expiration_seconds:3600}is_test:falsemobile{is_app:falseis_mobile_web_optimized:true}video{video_ad_skippable:ALLOW_SKIPPABLEallowed_video_formats:VIDEO_MP4playback_method:CLICK_TO_PLAYis_clickable:trueplacement:INTERSTITIALprotocols:VAST_2_0protocols:VAST_3_0playback_cessation_mode:COMPLETION_OR_USER}geo_criteria_id:1009310seller_network_id:4766bid_response_feedback{request_id:"\327(\005>\257u\241U~\350s\211\010\3615\334"creative_status_code:80event_notification_token:"token"buyer_creative_id:"test_creative_id_702979"minimum_bid_to_win:328000000}publisher_type:PUBLISHER_OWNED_AND_OPERATEDdevice{device_type:HIGHEND_PHONEplatform:"iphone"brand:"apple"model:"iphone"os_version{major:14minor:8micro:1}carrier_id:0screen_width:375screen_height:667screen_pixel_ratio_millis:2000limit_ad_tracking:false}publisher_country:"JP"publisher_id:"pub-1111111111111111"response_deadline_ms:300google_query_id:"ANy-zd34Gv-NJ6B8Zsd8j4NV0r6F8P69920cL9Q88372fjS7EO9DQZ9Y69qUQ2l6L8R2M903"auction_type:FIRST_PRICEgeo{lat:35.69lon:139.7country:"JPN"region:"JP-13"city:"Shinjuku"accuracy:2852}user_agent_data{platform{brand:"iPhone"version:"14"version:"8"}mobile:truemodel:"iPhone"browsers{brand:"Mozilla"version:"5"version:"0"}browsers{brand:"AppleWebKit"version:"605"version:"1"}bitness:"64"}page_visibility:VISIBILITY_STATE_VISIBLEsupply_chain{complete:truenodes{advertising_system_identifier:"google.com"seller_identifier:"pub-1111111111111111"handles_payment:true}version:"1.0"}frequency_capping_scope:FREQUENCY_CAPPING_SCOPE_SITEprivacy_treatments{allow_user_data_collection:true}inventory_partner_domain:"OMITTED"
Mobile web banner for exchange bidder
OpenRTB Protobuf
Show me the example
id:"6gXB0gc0938Ow444j0j623"imp{id:"1"banner{w:320h:50pos:ABOVE_THE_FOLDexpdir:LEFTexpdir:RIGHTexpdir:UPexpdir:DOWNformat{w:320h:50}format{w:300h:50}}tagid:"7128811473"bidfloor:0.01bidfloorcur:"USD"secure:trueexp:3600metric{type:"click_through_rate"value:0.00012312238686718047vendor:"EXCHANGE"}metric{type:"viewability"value:0.98vendor:"EXCHANGE"}[com.google.doubleclick.imp]{billing_id:46483683815dfp_ad_unit_code:"/3253397/google/test"ampad:AMP_AD_ALLOWED_AND_NOT_EARLY_RENDEREDexcluded_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_POLICYpublisher_blocks_enforcement:PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN}auction_environment:SERVER_SIDE_AUCTIONae:SERVER_SIDE_AUCTION}}site{page:"https://www.google.com"publisher{id:"pub-1111111111111111"[com.google.doubleclick.publisher]{country:"US"}}content{livestream:falselanguage:"en"}mobile:true[com.google.doubleclick.site]{amp:DIALECT_HTMLpage_visibility:VISIBILITY_STATE_VISIBLEinventorypartnerdomain:"OMITTED"}}device{ua:"Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Mobile Safari/537.36"ip:"192.168.1.0"geo{lat:0.0lon:0.0country:"IND"region:"IN-MH"city:"Mumbai"zip:"400066"type:IPutcoffset:330accuracy:1439}make:"Xiaomi"model:"22120rn86i"os:"android"osv:"14"devicetype:HIGHEND_PHONElmt:falsew:360h:825pxratio:2.0sua{browsers{brand:"Chromium"version:"124"version:"0"}browsers{brand:"Google Chrome"version:"124"version:"0"}platform{brand:"Android"version:"14"version:"0"}mobile:truemodel:"22120RN86I"source:CLIENT_HINTS_HIGH_ENTROPY}}at:FIRST_PRICEtmax:300cur:"USD"source{schain{complete:truenodes{asi:"testssp.com"sid:"pub-1111111111111111"hp:true}nodes{asi:"testssp.com"sid:"pub-1111111111111111"hp:true}ver:"1.0"}}[com.google.doubleclick.bid_request]{google_query_id:"ANy-z0k831-U6Nsse2Zs380x9jWlM98I735gC6c3602K1swV8ex1390yK9kO53353X64953A"fcap_scope:FREQUENCY_CAPPING_SCOPE_BROWSER}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-11-01 UTC."],[],[]]