出價方可以在單一出價回應中,為多位買家購買廣告空間。舉例來說,需求端平台 (DSP) 可能會使用出價應用程式,為多位行銷人或代理商 (即買家) 購買廣告空間。本指南說明如何編寫出價方程式碼,處理代表多位買家傳送的單一要求。
背景
在某些情況下,廣告聯播網或代理交易中心可能會選擇與一或多個需求端平台合作。透過 DSP 放送廣告的買家有兩種做法:
- 需求端平台會為非買家的行銷人或代理商購買廣告空間。在此情況下,需求端平台會收到一項出價要求,並以一項出價回應。Google 會直接向 DSP 收取費用。
- 需求端平台會為行銷人或代理商 (即買方) 購買廣告空間。需求端平台會收到一項出價要求,其中包含與符合資格買方相關聯的多個帳單 ID,並可代表每個買方分別出價。在這個模式中,Google 會向買方收費,而非需求端平台。本指南的其餘部分著重於這個情境。
設定和預先指定
Google 會傳送出價要求,其中包含與買方相關聯的一或多個帳單 ID,以及指定曝光的預先指定目標設定。這些欄位可透過 BidRequest.imp.ext.billing_id 欄位找到。
如果 BidRequest 包含多位買家的帳單 ID,則必須提供 BidResponse.seatbid.bid.ext.billing_id,Google 才能判斷要將出價與哪個帳戶建立關聯。系統會篩除未設定該欄位的任何回覆。如果 BidRequest 只包含單一帳單 ID,這個欄位仍為選填。
預先指定範例
出價者代表兩位買方出價,其中一位的帳單 ID 為 123,另一位則為 124。出價者設定一個預先指定目標設定 (帳單 ID 為 213),指定英文;另一個設定 (帳單 ID 為 231) 則指定個人電腦。下文說明不同類型的曝光在競價要求中顯示的帳單 ID。
| 曝光說明 | 出價要求中的帳單 ID |
|---|---|
| 個人電腦上的日文內容。 | 123、124、231 |
| 手機上顯示的英文內容。 | 123、124、213 |
| 個人電腦上的英文內容。 | 123、124、213、231 |
出價要求範例
以下是 BidRequest 的範例。您會發現這些要求中有多個帳單 ID,因為這些要求適用於多個帳戶。
OpenRTB Protobuf
顯示範例
序列化要求id: "2Ic9Szo73ub9164McIS5z4" imp { id: "1" banner { w: 300 h: 250 pos: ABOVE_THE_FOLD format { w: 300 h: 250 } format { w: 320 h: 100 } } tagid: "3354852099" bidfloor: 1.0 bidfloorcur: "JPY" secure: true exp: 3600 metric { type: "click_through_rate" value: 0.0004362155741546303 vendor: "EXCHANGE" } metric { type: "viewability" value: 0.07 vendor: "EXCHANGE" } [com.google.doubleclick.imp] { billing_id: 14872229026 billing_id: 65822939644 publisher_settings_list_id: 5996751740207644979 publisher_settings_list_id: 7279221809215794243 allowed_vendor_type: 0 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" } allowed_restricted_category: 32 creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES } gpid: "/7780786/example.com/homepage/image_top" } } site { page: "https://www.google.com" publisher { id: "pub-1111111111111111" [com.google.doubleclick.publisher] { country: "GB" } } content { language: "en" } [com.google.doubleclick.site] { amp: DIALECT_HTML page_visibility: VISIBILITY_STATE_VISIBLE uact { wasact: true isact: false } ntype: NAVIGATION_TYPE_NAVIGATE } } device { ua: "OMITTED" geo { lat: 0.0 lon: 0.0 country: "GBR" region: "GB-ENG" zip: "S11" type: IP utcoffset: 60 accuracy: 2754 [com.google.doubleclick.geo] { geo_criteria_id: 9046364 } } ipv6: "2a02:c7c:c202::" language: "en" os: "X11" devicetype: PERSONAL_COMPUTER w: 1536 h: 864 pxratio: 1.25 sua { browsers { brand: "Google Chrome" version: "147" version: "0" } browsers { brand: "Not.A/Brand" version: "8" version: "0" } platform { brand: "Chrome OS" version: "16610" version: "57" } mobile: false architecture: "x86" bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } } user { data { id: "0" segment { id: "OMITTED" } segment { id: "OMITTED" } [com.google.doubleclick.data] { segtax: 4 } } consent: "OMITTED" [com.google.doubleclick.user] { consented_providers_settings { consented_providers: 2577 consented_providers: 2309 additional_consent: "OMITTED" } consent: "OMITTED" eids { source: "OMITTED_SOURCE" uids { id: "OMITTED_ID" } } eids { source: "OMITTED_SOURCE" uids { id: "OMITTED_ID" } } } } at: FIRST_PRICE tmax: 500 cur: "BRL" cur: "GBP" bcat: "3" bcat: "4" regs { [com.google.doubleclick.regs] { gdpr: true } } source { schain { complete: true nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: true } ver: "1.0" } } cattax: GOOGLE_CATEGORIES [com.google.doubleclick.bid_request] { google_query_id: "ANy-zcBbZN-AVQv37tjp208071nti0SFDv2FtD6776DgTHiouw72l227G6q3tZ1777nj5N4A" fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE privacy_treatments { allow_user_data_collection: true } }
OpenRTB JSON
顯示範例
{ "id": "2Ic9Szo73ub9164McIS5z4", "imp": [ { "id": "1", "banner": { "w": 300, "h": 250, "pos": 1, "format": [ { "w": 300, "h": 250 }, { "w": 320, "h": 100 } ] }, "tagid": "3354852099", "bidfloor": 1.0, "bidfloorcur": "JPY", "secure": 1, "exp": 3600, "metric": [ { "type": "click_through_rate", "value": 0.0004362155741546303, "vendor": "EXCHANGE" }, { "type": "viewability", "value": 0.07, "vendor": "EXCHANGE" } ], "ext": { "billing_id": [ "14872229026", "65822939644" ], "publisher_settings_list_id": [ "5996751740207644979", "7279221809215794243" ], "allowed_vendor_type": [ 0 ], "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" } ], "allowed_restricted_category": [ 32 ], "creative_enforcement_settings": { "policy_enforcement": 2, "publisher_blocks_enforcement": 1 }, "gpid": "/7780786/example.com/homepage/image_top" } } ], "site": { "page": "https://www.google.com", "publisher": { "id": "pub-1111111111111111", "ext": { "country": "GB" } }, "content": { "language": "en" }, "ext": { "amp": 0, "page_visibility": 1, "uact": { "wasact": 1, "isact": 0 }, "ntype": 1 } }, "device": { "ua": "OMITTED", "geo": { "lat": 0.0, "lon": 0.0, "country": "GBR", "region": "GB-ENG", "zip": "S11", "type": 2, "utcoffset": 60, "accuracy": 2754, "ext": { "geo_criteria_id": 9046364 } }, "ipv6": "2a02:c7c:c202::", "language": "en", "os": "X11", "devicetype": 2, "w": 1536, "h": 864, "pxratio": 1.25, "sua": { "browsers": [ { "brand": "Google Chrome", "version": [ "147", "0" ] }, { "brand": "Not.A/Brand", "version": [ "8", "0" ] } ], "platform": { "brand": "Chrome OS", "version": [ "16610", "57" ] }, "mobile": 0, "architecture": "x86", "bitness": "64", "source": 2 } }, "user": { "data": [ { "id": "0", "segment": [ { "id": "OMITTED" }, { "id": "OMITTED" } ], "ext": { "segtax": 4 } } ], "consent": "OMITTED", "ext": { "consented_providers_settings": { "consented_providers": [ "2577", "2309" ], "additional_consent": "OMITTED" }, "consent": "OMITTED", "eids": [ { "source": "OMITTED_SOURCE", "uids": [ { "id": "OMITTED_ID" } ] }, { "source": "OMITTED_SOURCE", "uids": [ { "id": "OMITTED_ID" } ] } ] } }, "at": 1, "tmax": 500, "cur": [ "BRL", "GBP" ], "bcat": [ "3", "4" ], "regs": { "ext": { "gdpr": 1 } }, "source": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" } }, "cattax": 500, "ext": { "google_query_id": "ANy-zcBbZN-AVQv37tjp208071nti0SFDv2FtD6776DgTHiouw72l227G6q3tZ1777nj5N4A", "fcap_scope": 1, "privacy_treatments": { "allow_user_data_collection": 1 } } }