原生廣告會配合周圍內容和視覺設計設定格式，藉此提高曝光率和點擊率。原生廣告廣告空間可用於行動應用程式、電腦版網站和行動版網站。如要進一步瞭解原生廣告，請參閱「原生廣告總覽」。
公開出價和授權買家都支援原生廣告。
以下是原生廣告的工作流程：
- 廣告空間傳送原生廣告呼叫給 Google。呼叫指定一或兩種原生廣告範本，每個範本都會指定偏好的原生欄位。
- Google 向買家傳送 RTB 出價要求，其中包含廣告空間所要求的欄位清單。
- 有興趣的買方透過回應傳回要求的欄位。
- Google 舉行競價選出得標出價，並向發布商傳送買家提供的廣告素材資源。
- 發布商將素材資源組合成原生廣告，並根據網站的設計調整廣告風格。
訊息格式
Google 支援 JSON 和 Protobuf 中的 OpenRTB 規範。
針對 OpenRTB Protobuf 原生廣告，下列欄位與規格不同：
| JSON | JSON 類型 | Protobuf | Protobuf 類型 |
|---|---|---|---|
BidRequest.imp[].native.request |
string |
BidRequest.imp[].native.request_native |
NativeRequest |
BidResponse.seatbid[].bid[].adm |
string |
BidResponse.seatbid[].bid[].adm_native |
NativeResponse |
OpenRTB Protobuf 欄位是 Protobuf 訊息，而非字串。
如果您使用 OpenRTB Protobuf 導入作業，端點會收到含有 BidRequest.imp.native.request_native 而非 BidRequest.imp.native.request 的出價要求。此外，端點必須傳回填入 BidResponse.seatbid.bid.adm_native 而非 BidResponse.seatbid.bid.adm 的出價回應，否則會從競價中篩除。
如果您使用買方 SDK來算繪原生廣告，請務必在提交素材資源以供審查時，在 declared_ad 中加入圖片 type。
原生廣告範本
原生廣告範本會說明原生廣告的元件，並決定出價要求中 OpenRTB 的 NativeRequest 或已淘汰的 Google RTB 通訊協定 NativeAdTemplate 的內容和結構。Google 支援兩種最常見的原生廣告範本，分別適用於非影片和影片原生廣告：
- 應用程式安裝廣告範本：宣傳並提高行動應用程式安裝量。
- 內容廣告範本：品牌或網路廣告的文字和圖像組合更為通用。
- 影片應用程式安裝廣告範本
- 影片內容廣告範本
其他範本對欄位、規格和大小可能有不同的規定。
應用程式安裝廣告範本
必填和建議欄位
下表中的欄位標示為「必填」或「建議」。規則如下：
- 標有「必填」的欄位為出價方必填欄位。
- 出價方不需要使用標示為「建議」的欄位，且如果提供這些欄位，出版商可以選擇是否顯示 (例如星號評分)。
- 行動號召 (CTA) 一律會標示為「建議」，因為如果出價方未傳送 CTA，系統會指派預設 CTA，但如果出價方傳送 CTA，系統一律會顯示 CTA。
下表列出應用程式安裝廣告範本的欄位。行動應用程式會使用這些欄位建立原生應用程式安裝廣告。
| 欄位 | 說明 | 是否為必填或建議項目？ | 是否一律顯示？ | 建議的圖片大小/半形字元上限 | 範例 |
|---|---|---|---|---|---|
| 廣告標題 | 應用程式名稱 | 必填 | 是 | 25 個半形字元 | Flood-It! |
| 圖片 | 應用程式的螢幕截圖或其他相關圖片 | 必填 | 否 | 視發布商所需的顯示比例而定，可為 1,200 像素 x 627 像素或 600 像素 x 600 像素。 | <遊戲「Flood-It!」的螢幕截圖> |
| 內文 | 應用程式的主文 | 必填 | 否 | 90 個半形字元 | 看似簡單，但挑戰性十足，令人愛不釋手！ |
| 應用程式圖示 | 應用程式圖示 | 必填 | 否 | 128 x 128 像素 | <Flood-it! 應用程式圖示> |
| 行動號召 | 偏好的使用者動作 | 建議 | 是 | 15 個字元 | 安裝 |
| 星級評等 | 代表應用程式在應用程式商店的評分的星星數量 (0 到 5 顆星) | 建議 | 否 | 0 - 5 | 4.5 |
| 價格 | 應用程式的費用 | 建議 | 否 | 15 個字元 | 免費 |
文字長度相關注意事項
如果買方傳送的文字素材資源 (例如內文) 長度超過建議的字元上限，Google 或發布商可能會截斷文字並省略。請注意，中文、日文和韓文的可輸入字元數是「超過指定值後可能會被截斷」值的一半。例如，英文的標題上限為 90 個半形字元，中文則是 45 個半形字元。
圖片大小相關注意事項
發布商可以：
- 對稱裁剪主圖片，裁剪掉的比例最高可達 20%。
- 在不變更顯示比例的情況下縮放圖片。
- 系統可能會篩除顯示比例與高度和寬度明顯不同的圖片。
內容廣告範本
下表列出內容廣告範本的欄位。發布商會使用這些欄位建立原生內容廣告。
| 欄位 | 說明 | 是否為必填或建議項目？ | 是否一律顯示？ | 建議圖片大小/字元上限 * | 範例 |
|---|---|---|---|---|---|
| 廣告標題 | 廣告標題 | 必填 | 是 | 25 個半形字元 | 最低房貸利率 |
| 圖片 | 廣告主要圖片 | 必填 | 否 | 視發布商所需的顯示比例而定，可為 1,200 像素 x 627 像素或 600 像素 x 600 像素。 | <廣告的主要圖片> |
| 內文 | 廣告素材 | 必填 | 否 | 90 個半形字元 | 你的布魯克林住家 - 價格更便宜，而且比你想像的更快！ |
| 標誌 | 廣告主標誌或其他相關小圖片 | 建議 | 否 | 128 x 128 像素 | <NY Mortgage Inc. 的標誌> |
| 行動號召 | 使用者偏好的動作 | 建議 | 否 | 15 個字元 | 詢價 |
| 廣告主 | 廣告主或品牌的識別文字 | 必填 | 否 | 25 個半形字元 | NY Mortgage Inc. |
影片應用程式安裝廣告範本
| 欄位 | 說明 | 是否為必填或建議項目？ | 是否一律顯示？ | 建議圖片大小/字元上限數量 * | 範例 |
|---|---|---|---|---|---|
| 影片 | 播放影片廣告所需的必要素材資源都在這個影片 VAST 回應中。 | 必要 | 否 | - | 包含 Flood-It! 的 VAST XML 網址影片廣告 |
| 標題 | 應用程式名稱 | 必要 | 是 | 25 個半形字元 | Flood-It! |
| 圖片 | 在影片廣告被點擊之前或載入期間，播放器中顯示的圖像 (縮圖)。 | 必要 | 否 | 應與影片的顯示比例一致 (例如 16: 9 影片為 1280x720，640x480 影片為 4x3)。 | 遊戲「Flood-It!」的螢幕截圖。或從影片中 |
| 內文 | 應用程式的主文 | 必要 | 否 | 90 個半形字元 | 看似簡單，但挑戰性十足，令人愛不釋手！ |
| 應用程式圖示 | 應用程式圖示 | 必要 | 否 | 128 x 128 像素 | Flood-it! 應用程式圖示 |
| 行動號召 | 偏好的使用者動作 | 必要 | 是 | 15 個字元 | 安裝 |
| 星級評等 | 代表應用程式在應用程式商店中的評分的星號數量 (0 到 5 顆星) | 建議 | 否 | 0 - 5 | 4.5 |
| 價格 | 應用程式的費用 | 建議 | 否 | 15 個字元 | 免費 |
限制
影片：所有影片都必須採用 VAST 網址或 VAST 代碼的格式。無法指定 WebM、MP4 等原始影片檔案。
文字長度：如果買方在回應中指定文字素材資源 (例如
body)，Google 或發布商可能會截斷並省略該文字。請注意，中文、日文和韓文的可輸入字元數是「長度上限」值的一半。例如：英文的標題上限為 90，中文則是 45。圖片大小：發布商可以：
- 對稱裁剪主圖片，但只能在一個維度 (高度或寬度) 裁剪，裁剪掉的比例最高可達 20%。
- 縮放圖片，但不變更顯示比例。
應用程式安裝廣告示例
影片內容廣告範本
| 欄位 | 說明 | 是否為必填或建議項目？ | 是否一律顯示？ | 建議圖片大小/字元上限數量 * | 範例 |
|---|---|---|---|---|---|
| 影片 | 播放影片廣告所需的必要素材資源都在這個影片 VAST 回應中。 | 必要 | 是 | - | 包含 Flood-It! 的 VAST XML 網址影片廣告 |
| 標題 | 廣告標題 | 必要 | 是 | 25 個半形字元 | 最低房貸利率 |
| 圖片 | 在影片廣告被點擊之前或載入期間，播放器中顯示的圖像 (縮圖)。 | 必要 | 否 | 應與影片的顯示比例一致 (例如 16: 9 影片為 1280x720，640x480 影片為 4x3)。 | 影片的螢幕截圖 |
| 內文 | 廣告內容 | 必要 | 否 | 90 個半形字元 | 你的布魯克林甜蜜家園 - 比你想像的更便宜，更快到貨！ |
| 標誌 | 廣告主標誌或其他相關的小型圖片 | 建議 | 否 | 128 x 128 像素 | NY Mortgage Inc. 的標誌 |
| 行動號召 | 使用者偏好的動作 | 必要 | 否 | 15 個字元 | 取得報價 |
| 廣告主 | 廣告主或品牌的識別文字 | 必要 | 否 | 25 個半形字元 | NY Mortgage Inc. |
中繼資料欄位
下列元資料欄位可供所有支援的廣告範本共用：
| Google RTB 通訊協定 | OpenRTB 等值 | 說明 |
|---|---|---|
NativeAd.click_link_url |
Link.url |
使用者點按廣告後，瀏覽器會呼叫的網址。
可做為重新導向鏈結的第一個步驟，最終會導向到達網頁。針對原生廣告，建議您使用 click_link_url 做為欄位，設定使用者最終前往的目的地。如果是動態到達網頁，則必須使用這個欄位。 |
Ad.click_through_url |
Bid.adomain |
如果出價方打算出價，就必須設定此屬性。這是程式碼片段的到達網頁網址集合，包括使用者點選顯示廣告後會前往的網址，以及在轉譯廣告中顯示的任何網址。請勿加入與最終到達網頁無關的廣告伺服器中介呼叫。傳回片段或影片廣告，但宣告沒有 對於非原生廣告，這項功能不會用於點擊追蹤或任何其他廣告功能，只會用於到達網頁網址宣告。 針對原生廣告，如果未設定 |
NativeAd.click_tracking_urls |
Link.clicktrackers |
選用設定。可讓廣告客戶追蹤使用者對廣告的點擊次數的其他網址。 |
Ad.ad_choices_destination_url |
BidExt.ad_choices_destination_url |
連結至廣告偏好設定或停用頁面。如果有此標誌，原生廣告素材就會加上標準 AdChoices 圖示，並連結到這個網址。系統支援原生廣告，但出價回應中的原生訊息不包含這項資訊。 |
Ad.impression_tracking_url |
NativeResponse.imptrackers |
原生曝光應使用 Authorized Buyers 即時出價 proto 中的 impression_tracking_url 或 OpenRTB 中的原生曝光追蹤器追蹤。 |
Google RTB 通訊協定必要和建議欄位
required_fields 和 recommended_fields 是由發布商指定。我們將說明如何轉譯這些位元欄位，以判斷欄位是否為必填或建議填寫。
位元欄位會使用二進位值的每個位元來儲存 true 或 false 陳述式，這等同於傳送許多布林信號 (例如 is_logo_required 或 is_header_required)，但所有信號都會一起打包。
範例
在本範例中，我們會使用 required_fields 值 1085。
首先找出等同的二進位值：
10000111101
取得二進位值後，您可以檢查位元，瞭解欄位是否為必填欄位 (1) 或非必填欄位 (0)。
下表將欄位對應至二進位值中的位址。從右至左讀取二進位，其中 1 位元會對應至二進位值最右邊的位置。
| 欄位 | 二進位值位置 (由右至左) |
|---|---|
HEADLINE |
1 |
BODY |
2 |
CALL_TO_ACTION |
4 |
ADVERTISER |
8 |
IMAGE |
16 |
LOGO |
32 |
APP_ICON |
64 |
STAR_RATING |
128 |
PRICE |
256 |
STORE |
512 |
VIDEO |
1024 |
以範例二進位值 10000111101 來說，第 1 位元 (最右邊) 是 1，表示這是必要值。根據表格，1 位元對應至 HEADLINE。
2 位元 (從右邊算起的第二個值) 是 0，表示「不」需要。2 位元對應至 BODY。
以下是本例中所有已解譯的必填欄位：
| 值 | 說明 | 必填與否 |
|---|---|---|
1 |
VIDEO |
是 |
0 |
STORE |
否 |
0 |
PRICE |
否 |
0 |
STAR_RATING |
否 |
0 |
APP_ICON |
否 |
1 |
LOGO |
是 |
1 |
IMAGE |
是 |
1 |
ADVERTISER |
是 |
1 |
CALL_TO_ACTION |
是 |
0 |
BODY |
否 |
1 |
HEADLINE |
是 |
出價要求中的原生廣告範本表示法
收到含有原生廣告空間的出價要求時，系統會根據所使用的通訊協定，以不同形式納入原生廣告範本。我們建議使用 OpenRTB，因為 Google 通訊協定已淘汰。
在 OpenRTB 中，原生廣告範本會透過 NativeRequest 訊息加以描述。在 Google RTB 通訊協定中，會使用 NativeAdTemplate 說明。這些訊息會提供原生廣告空間的詳細資訊，包括：
- 必要或建議填寫的欄位。
- 圖片、標誌和應用程式圖示的尺寸。
- 廣告算繪樣式的規格。
OpenRTB 素材資源 ID
OpenRTB 會在出價要求中傳遞資產陣列，描述您應在回應中傳回的原生廣告結構。請注意，要求中的每個素材資源都會有 ID，且必須在回應中指定對應的素材資源。如需這些 ID 在要求和回應之間的對應方式示例，請參閱原生出價要求範例和原生出價回應範例。
出價回應中原生廣告的表示法
在出價原生廣告空間時，買方必須填入出價要求中指定的必要欄位。在 OpenRTB 中，您可以使用 BidResponse.seatbid.bid.adm_native 執行這項操作 (使用 Protobuf)，或使用 BidResponse.seatbid.bid.adm 執行這項操作 (使用 JSON)。如果是已淘汰的 Google 通訊協定，則可使用 BidResponse.ad.native_ad 欄位完成這項操作。
出價要求範例
非影片出價要求
顯示範例
序列化要求id: "l6210s8bS8Uc726V81B821" imp { id: "1" tagid: "3019814809" bidfloor: 0.06 bidfloorcur: "USD" secure: true native { ver: "1.2" request_native { ver: "1.2" assets { id: 1 required: true title { len: 25 } } assets { id: 2 required: true data { type: DESC len: 90 } } assets { id: 3 data { type: CTATEXT len: 15 } } assets { id: 4 required: true img { type: MAIN wmin: 1200 hmin: 627 } } assets { id: 5 img { type: LOGO wmin: 100 hmin: 100 } } eventtrackers { event: IMPRESSION methods: IMG } privacy: true [com.google.doubleclick.native_ext] { style_id: 497439 style_height: 1 style_width: 1 style_layout_type: FLUID } } } exp: 3600 metric { type: "click_through_rate" value: 0.0006697923527099192 vendor: "EXCHANGE" } metric { type: "viewability" value: 0.05 vendor: "EXCHANGE" } [com.google.doubleclick.imp] { billing_id: 50577321529 dfp_ad_unit_code: "/3711494/google/test" ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED buyer_generated_request_data { data: "Test Data" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } open_bidding { is_open_bidding: true } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN } auction_environment: SERVER_SIDE_AUCTION ae: SERVER_SIDE_AUCTION } } site { page: "https://www.google.com" publisher { id: "pub-1111111111111111" [com.google.doubleclick.publisher] { country: "FR" } } content { livestream: false language: "fr" } [com.google.doubleclick.site] { amp: DIALECT_HTML page_visibility: VISIBILITY_STATE_VISIBLE inventorypartnerdomain: "" ntype: NAVIGATION_TYPE_NAVIGATE } } device { ua: "OMITTED" geo { lat: 0.0 lon: 0.0 country: "FRA" region: "FR-C" zip: "63120" type: IP utcoffset: 120 accuracy: 6948 [com.google.doubleclick.geo] { geo_criteria_id: 9112278 } } ipv6: "2a01:cb14:8183::" os: "Windows" devicetype: PERSONAL_COMPUTER lmt: false pxratio: 1.0 sua { browsers { brand: "Chromium" version: "130" version: "0" } browsers { brand: "Microsoft Edge" version: "130" version: "0" } platform { brand: "Windows" version: "15" version: "0" } mobile: false architecture: "x86" bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } } user { [com.google.doubleclick.user] { consented_providers_settings { consented_providers: 1712 consented_providers: 2316 additional_consent: "OMITTED" } consent: "OMITTED" eids { source: "OMITTED" uids { id: "12JD92JD8078S8J29SDOAKC0EF230337" } } } } at: FIRST_PRICE tmax: 350 cur: "USD" regs { gpp: "OMITTED" [com.google.doubleclick.regs] { gdpr: true } } source { schain { complete: true nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: true } ver: "1.0" } [com.google.doubleclick.source] { schain { complete: 1 nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: 1 } ver: "1.0" } } } [com.google.doubleclick.bid_request] { google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v" fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE }
顯示範例
{ "id": "l6210s8bS8Uc726V81B821", "imp": [ { "id": "1", "tagid": "3019814809", "bidfloor": 0.06, "bidfloorcur": "USD", "secure": 1, "native": { "ver": "1.2", "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}" }, "exp": 3600, "metric": [ { "type": "click_through_rate", "value": 0.0006697923527099192, "vendor": "EXCHANGE" }, { "type": "viewability", "value": 0.05, "vendor": "EXCHANGE" } ], "ext": { "billing_id": [ "50577321529" ], "dfp_ad_unit_code": "/3711494/google/test", "ampad": 3, "buyer_generated_request_data": [ { "data": "Test Data" } ], "excluded_creatives": [ { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" }, { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" } ], "open_bidding": { "is_open_bidding": 1 }, "creative_enforcement_settings": { "policy_enforcement": 1, "publisher_blocks_enforcement": 2 }, "auction_environment": 0, "ae": 0 } } ], "site": { "page": "https://www.google.com", "publisher": { "id": "pub-1111111111111111", "ext": { "country": "FR" } }, "content": { "livestream": 0, "language": "fr" }, "ext": { "amp": 0, "page_visibility": 1, "inventorypartnerdomain": "OMITTED", "ntype": 1 } }, "device": { "ua": "OMITTED", "geo": { "lat": 0.0, "lon": 0.0, "country": "FRA", "region": "FR-C", "zip": "63120", "type": 2, "utcoffset": 120, "accuracy": 6948, "ext": { "geo_criteria_id": 9112278 } }, "ipv6": "2a01:cb14:8183::", "os": "Windows", "devicetype": 2, "lmt": 0, "pxratio": 1.0, "sua": { "browsers": [ { "brand": "Chromium", "version": [ "130", "0" ] }, { "brand": "Microsoft Edge", "version": [ "130", "0" ] } ], "platform": { "brand": "Windows", "version": [ "15", "0" ] }, "mobile": 0, "architecture": "x86", "bitness": "64", "source": 2 } }, "user": { "ext": { "consented_providers_settings": { "consented_providers": [ "1712", "2316" ], "additional_consent": "OMITTED" }, "consent": "OMITTED", "eids": [ { "source": "OMITTED", "uids": [ { "id": "12JD92JD8078S8J29SDOAKC0EF230337" } ] } ] } }, "at": 1, "tmax": 350, "cur": [ "USD" ], "regs": { "gpp": "OMITTED", "ext": { "gdpr": 1 } }, "source": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" }, "ext": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" } } }, "ext": { "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v", "fcap_scope": 1 } }
顯示範例
序列化要求id: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx" ip: "\300\250" user_agent: "OMITTED" url: "https://www.google.com" detected_language: "it" adslot { id: 1 excluded_attribute: 14 excluded_attribute: 32 allowed_vendor_type: 42 allowed_vendor_type: 144 excluded_sensitive_category: 36 excluded_sensitive_category: 19 matching_ad_data { billing_id: 74792558829 billing_id: 11204117851 minimum_cpm_micros: 390000 } matching_ad_data { billing_id: 44428418146 billing_id: 91112044263 minimum_cpm_micros: 110000 } slot_visibility: BELOW_THE_FOLD excluded_product_category: 10366 excluded_product_category: 11504 ad_block_key: 8767661977 publisher_settings_list_id: 7807286827624818876 publisher_settings_list_id: 8186380472781289268 allowed_restricted_category: 32 allowed_restricted_category: 33 excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } iframing_state: UNKNOWN_IFRAME_STATE viewability: 6 allowed_restricted_category_for_deals: 32 allowed_restricted_category_for_deals: 33 click_through_rate: 0.0010397299 allowed_ad_types: ALLOWED_AD_TYPE_NATIVE is_amp_page: DIALECT_HTML amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED secure_signals { data: "Test Data: bw44G12BFZ" source: "OMITTED" } consented_providers_settings { tcf_consent_string: "OMITTED" additional_consent_string: "OMITTED" } regs_gdpr: true native_ad_template { required_fields: 17 recommended_fields: 0 headline_max_safe_length: 90 body_max_safe_length: 90 call_to_action_max_safe_length: 15 advertiser_max_safe_length: 25 image_width: 1200 image_height: 627 style_id: 749853 style_layout_type: FLUID style_height: 1 style_width: 1 } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES } auction_environment: SERVER_SIDE_AUCTION impression_expiration_seconds: 3600 supported_auction_environment: SERVER_SIDE_AUCTION } is_test: false timezone_offset: 120 geo_criteria_id: 1008463 bid_response_feedback { request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301" creative_status_code: 1 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 220000 feedback_type: BID_FEEDBACK } bid_response_feedback { request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G" creative_status_code: 80 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 3450000 feedback_type: BID_FEEDBACK } publisher_type: PUBLISHER_OWNED_AND_OPERATED device { device_type: PERSONAL_COMPUTER platform: "Windows" screen_pixel_ratio_millis: 1000 limit_ad_tracking: false } publisher_country: "IT" publisher_id: "pub-1111111111111111" response_deadline_ms: 350 google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6" auction_type: FIRST_PRICE geo { lat: 0.0 lon: 0.0 country: "ITA" region: "IT-MI" city: "Milan" utcoffset: 120 accuracy: 6821 } user_agent_data { platform { brand: "Windows" version: "10" version: "0" } mobile: false architecture: "x86" browsers { brand: "Chromium" version: "128" version: "0" } browsers { brand: "Not;A=Brand" version: "24" version: "0" } bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } page_visibility: VISIBILITY_STATE_VISIBLE supply_chain { complete: true nodes { advertising_system_identifier: "testdomain.com" seller_identifier: "pub-1111111111111111" handles_payment: true } version: "1.0" } frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE privacy_treatments { allow_user_data_collection: true } inventory_partner_domain: "OMITTED"
影片出價要求
{ id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123", ip: "\0338\355", google_user_id: "CAESEJ1ur2l94_8ruuu", cookie_version: 1, cookie_age_seconds: 5184000, hosted_match_data: "W9ABDAAAAGR67nl0", user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36", publisher_country: "IN", geo_criteria_id: 1007796, timezone_offset: 330, publisher_id: "pub-2230723027927371", seller_network_id: 989, url: "https://m.example.com", detected_language: [en], google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q", auction_type: "SECOND_PRICE", device: { device_type: "HIGHEND_PHONE", platform: "android", brand: "coolpad", model: "cp8298_i00", os_version: { major: 5, minor: 1 }, carrier_id: 70210, screen_width: 360, screen_height: 640, screen_pixel_ratio_millis: 2000 }, mobile: { is_app: false, is_mobile_web_optimized: true, DEPRECATED_platform: "android", DEPRECATED_mobile_device_type: "HIGHEND_PHONE", DEPRECATED_brand: "coolpad", DEPRECATED_model: "cp8298_i00", DEPRECATED_os_version: { os_version_major: 5, os_version_minor: 1 }, DEPRECATED_screen_width: 360, DEPRECATED_screen_height: 640, DEPRECATED_carrier_id: 70210, DEPRECATED_device_pixel_ratio_millis: 2000 }, publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED", adslot: [{ id: 1, ad_block_key: 2882274820, width: [300,250], height: [250,250], excluded_attribute: [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22], allowed_vendor_type: [42,144,575,698,704,743,776,785,793,797,808,828,832,885], excluded_sensitive_category: [36,27,19,4,23,30,10,3,31,5,8,37,18], excluded_product_category: [10031,11669,13423,13525,13566,13589,13612,13740], excluded_creatives: [{ buyer_creative_id: "1234567.1234567890-ssl" }], matching_ad_data: [{ billing_id: [6629616415,51386650457], minimum_cpm_micros: 1380000, direct_deal: [{ direct_deal_id: 410401, fixed_cpm_micros: 1360000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true },{ direct_deal_id: 240644, fixed_cpm_micros: 1500000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true }] },{ billing_id: [1234567890], minimum_cpm_micros: 1380000 }], publisher_settings_list_id: [12109930661871909476,11138951146123409010], slot_visibility: "BELOW_THE_FOLD", viewability: 30, click_through_rate: 0.0010072842, iframing_state: "UNKNOWN_IFRAME_STATE", native_ad_template: [{ required_fields: 1065, recommended_fields: 4, headline_max_safe_length: 25, body_max_safe_length: 90, call_to_action_max_safe_length: 15, advertiser_max_safe_length: 25, logo_width: 100, logo_height: 100, style_id: 199892, style_height: 250, style_width: 300 }], sticky_settings: { }, renderer: "GOOGLE", is_amp_page: "DIALECT_HTML", amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED", allowed_ad_types: [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE], session_depth: 1, internal_data: { } }], response_deadline_ms: 122, is_test: false }
出價回應範例
非影片出價回應
顯示範例
序列化回應id: "22i22S9494PQl819H7Ld5K" seatbid { bid { id: "2GTnPXOn76gg1C6574T" impid: "1" price: 0.24 adid: "test_creative_id_713312" adomain: "google.com" crid: "test_creative_id_713312" exp: 300 language: "xx" adm_native { ver: "1.2" assets { id: 1 title { text: "Luxury Mars Cruises" } } assets { id: 2 data { value: "Visit the planet in a luxury spaceship." } } assets { id: 3 data { value: "Book today" } } assets { id: 4 img { url: "https://native.test.com/image?id=123456" w: 1200 h: 627 } } assets { id: 5 img { url: "https://native.test.com/logo?id=123456" w: 1200 h: 1200 } } link { url: "https://www.google.com" clicktrackers: "https://native.test.com/click?id=123456" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED" } [com.google.doubleclick.bid] { event_notification_token { payload: "token" } billing_id: 50577321529 third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" } } seat: "5249:9218:332606" } cur: "USD"
顯示範例
{ "id": "22i22S9494PQl819H7Ld5K", "seatbid": [ { "bid": [ { "id": "2GTnPXOn76gg1C6574T", "impid": "1", "price": 0.24, "adid": "test_creative_id_713312", "adomain": [ "google.com" ], "crid": "test_creative_id_713312", "exp": 300, "language": "xx", "ext": { "event_notification_token": { "payload": "token" }, "billing_id": "50577321529", "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" }, "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}" } ], "seat": "5249:9218:332606" } ], "cur": "USD" }
顯示範例
序列化回應ad { adslot { id: 1 max_cpm_micros: 110734 min_cpm_micros: 0 billing_id: 74792558829 deal_id: 0 } click_through_url: "google.com" attribute: 47 attribute: 8 buyer_creative_id: "test_creative_id_907643" advertiser_name: "Google" native_ad { headline: "Luxury Mars Cruises" body: "Visit the planet in a luxury spaceship." call_to_action: "Book today" advertiser: "Galactic Luxury Cruises" image { url: "https://native.test.com/image?id=123456" width: 800 height: 800 } logo { url: "https://native.test.com/logo?id=123456" width: 200 height: 200 } price: "\342\202\254 225" click_link_url: "https://www.google.com" } impression_tracking_url: "https://test.com/imp?id=123456" impression_tracking_url: "https://test.com/imp?id=123456" ad_choices_destination_url: "https://test.com/preferences" event_notification_token: "token" dsa_transparency { buyer_render: true } } processing_time_ms: 27
影片出價回應
bid_response { ad { ... click_through_url: "https://www.exampleDomain.com" impression_tracking_url: "https://my_impression_tracking_url.com/" ad_choices_destination_url: "https://my_ad_choices_destination_url.com/" ... native_ad { headline: "Lowest mortgage rates" video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast" call_to_action: "Get a quote" advertiser: "NY Mortgage Inc." image { url: "https://www.example.net/mypromoimage.png" width: 1200 height: 700 } logo { url: "https://www.example.net/mylogo.png" width: 200 height: 200 } click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1" click_tracking_urls: "https://my_click_tracking_url.com/" } } }