查看或下載支援即時出價通訊協定的檔案。
Protos
| 檔案 | 說明 | 版本 | 上次更新日期 |
|---|---|---|---|
| cookie-bulk-upload.proto | 使用這則訊息大量上傳使用者指定目標資料。 | v.24 | 2024 年 3 月 27 日 |
| openrtb.proto | Google 支援 OpenRTB 通訊協定，可使用 JSON 或 Protobuf 編碼。如果您使用 OpenRTB/Protobuf，就必須使用這個 proto。並提供支援的欄位說明文件，以及這些欄位與 Google 原生通訊協定的對應關係。 | 2.6 | 2024 年 11 月 18 日 |
| openrtb-adx.proto | Google 的 OpenRTB 通訊協定包含部分擴充功能，這些功能會在個別的 proto 中提供。 | v.183 | 2024 年 12 月 10 日 |
| publisher-settings.proto | 一組專屬於即時出價方聯播網的發布商設定。 | v.14 | 2024 年 2 月 5 日 |
| realtime-bidding.proto | Google 的 Authorized Buyers RTB 通訊協定。這是 Google 用來要求出價的訊息。BidRequest 包含單一曝光的廣告版位。 |
v.331 | 2024 年 11 月 1 日 |
公開測試版原型
| 檔案 | 說明 | 版本 | 上次更新日期 |
|---|---|---|---|
| openrtb-adx.proto | Google 的 OpenRTB 通訊協定包含部分擴充功能，這些功能會在個別的 proto 中提供。 | v.189 | 2024 年 12 月 10 日 |
| realtime-bidding.proto | Google 的 Authorized Buyers RTB 通訊協定。這是 Google 用來要求出價的訊息。BidRequest 包含單一曝光的廣告版位。 |
v.342 | 2024 年 10 月 31 日 |
參考資料
字典 (按一下即可下載 .txt 檔案) |
|
|---|---|
| 廣告產品類別 | 用於 BidRequest 的 excluded_product_category 欄位。這個欄位會說明發布商不允許的產品和服務類別，例如發布商不想放送與網路銀行相關的廣告。 |
| 廣告限制類別 | 用於 BidRequest 的 allowed_restricted_category 欄位和 BidResponse 的 restricted_category 欄位。allowed_restricted_category 欄位會說明通常受限制的類別，但發布商明確聲明允許的類別，例如含有酒精飲料相關內容的廣告。 |
| 敏感廣告類別 | 用於 BidRequest 的 excluded_sensitive_category 欄位和 BidResponse 的 category 欄位。excluded_sensitive_category 欄位會說明發布商不允許的敏感類別，例如發布商不想放送與政治相關的廣告。 |
| 廣告主 | 用於 SnippetStatusItem 的 advertiser_id 欄位。這個欄位會指定與片段相關聯的廣告素材所代表的廣告客戶。這份清單會顯示廣告交易平台上的廣告主，而不會顯示任何買方所代表的廣告主。 |
| 品牌 | 在用戶端存取權 API 中使用的品牌清單。 |
| 買方可聲明的廣告素材屬性 | 用於 BidResponse 中的 attribute 欄位。這個欄位會說明廣告素材中的買方宣告屬性，且不得出現在 BidRequest 的 excluded_attribute 中。 |
| 呼叫狀態碼 | performancereport 方法呼叫傳回的狀態碼。 |
| 內容標籤 | 用於 BidRequest 的 detected_content_labels 欄位。 |
| Cookie 比對器狀態碼 | 用於 RTB 協定成效報表的 cookieMatcherStatusRate 欄位。如需可用的代碼說明，請參閱Cookie 比對指南。 |
| 廣告素材狀態代碼 | 使用於 即時回饋中傳回的creative_status_code。 |
| 代管比對狀態碼 | 用於 RTB 協定成效報表的 hostedMatchStatusRate 欄位。 |
| 沒有出價原因 | 授權買家出價通訊協定中的 BidResponse.no_bid_reason 欄位會提供標準的未出價原因值。 |
| 可預先指定目標的廣告素材屬性 | 用於 Buyer REST API 公開的 PretargetingConfig 資源中的 supportedCreativeAttribute 欄位。這個欄位會說明單一預先指定設定對應的所有廣告素材中，預期會出現的廣告素材屬性。 |
| 發布者可排除的廣告素材屬性 | 用於 BidRequest 的 excluded_attribute 欄位。這個欄位說明發布商不允許的廣告素材類型。舉例來說，他們可能會指定 Cookie 使用權限或媒體和/或文字廣告的使用權限。 |
| 發布商產業別 | 用於 BidRequest 的 detected_vertical 欄位。這個欄位會指定廣告將顯示的網頁類別 (類似關鍵字)。Google 會透過檢索網頁並判斷使用哪些垂直類別，產生這個欄位。 |
| 供應商 | 用於 BidRequest 的 allowed_vendor_type 欄位。這個欄位會列出發布商指定的互動式多媒體供應商 (例如 Campaign Monitor 和 VoiceFive)，可用於放送廣告素材。包含已淘汰的 |
| 資料提供者 | 用於 BidRequest 的 SegmentData.id 欄位。這個欄位包含提供發布商提供的信號的實體相關資訊。 |
參考表格 (按一下即可下載 CSV) |
|
| Android 行動應用程式 | 可指定的 Android 行動應用程式清單，包括應用程式 ID、類別 ID 和人類可讀的應用程式名稱。 |
| 地理資料表 | 用於解碼 BidRequest 的 geo_criteria_id 欄位的表格。詳情請參閱「地理指定目標」。 |
| LGPD 供應商 |
可在 LGPD 流量中放送的廣告個人化供應商清單，包括 ID、人類可讀名稱、隱私權網址，以及可歸因於供應商的網域清單。您可以在特定出價要求中，透過 Authorized Buyers 出價通訊協定的 BidRequest.adslot.regs_lgpd 欄位和 OpenRTB 出價通訊協定的 BidRequest.regs.ext.lgpd 欄位，指出 LGPD 的執行方式。 |
| 行動電信業者 | 行動電信業者清單。 |
| 行動裝置 | 行動裝置清單。 |
| 行動作業系統 | 行動作業系統清單。 |
| 供應商 | 將 Google 地圖廣告個人化供應商 ID 轉換為人類可讀的名稱、隱私權政策網址，以及可歸因於供應商的網域清單。目前，供應商會用於 AdX 通訊協定的 BidRequest.AdSlot.consented_providers_settings 欄位，以及 OpenRTB 通訊協定的 BidRequest.User.UserExt.consented_providers_settings 欄位。在這些欄位中，列出的供應商已取得使用者同意聲明，可為歐洲經濟區國家/地區的使用者提供服務。 |
發佈者設定
請向帳戶代表索取 publisher-settings.pb.gz 檔案。
廣告素材審查政策主題
您可以使用這個檔案中的政策主題，在即時出價 API 審查期間篩除廣告素材。
以 CSV 檔案格式下載政策主題。上次更新日期：2022 年 4 月 18 日