查看或下載支援即時出價通訊協定的檔案。
原子
| 檔案 | 說明 | 版本 | 上次更新時間 |
|---|---|---|---|
| cookie-bulk-upload.proto | 請使用這則訊息大量上傳使用者指定資料。 | v.24 | 2024 年 3 月 27 日 |
| openrtb.proto | Google 支援使用 JSON 或 Protobuf 編碼的 OpenRTB 通訊協定。如果使用 OpenRTB/Protobuf，就必須安裝這個通訊協定。以及支援欄位的說明文件，以及這些欄位與 Google 原生通訊協定的對應說明。 | 2.6 | 2024 年 3 月 23 日 |
| openrtb-adx.proto | Google 的 OpenRTB 通訊協定包含部分擴充功能 (以獨立通訊協定提供)。 | v.171 | 2024 年 4 月 17 日 |
| publisher-settings.proto | 即時出價工具聯播網專用的一組發布商設定。 | v.13 | 2024 年 2 月 5 日 |
| realtime-bidding.proto | Google Authorized Buyers 即時出價通訊協定。這是 Google 用於要求出價的訊息。BidRequest 包含單一曝光中的廣告版位。 |
v.324 | 2024 年 4 月 17 日 |
公開 Beta 版通訊協定
| 檔案 | 說明 | 版本 | 上次更新時間 |
|---|---|---|---|
| openrtb-adx.proto | Google 的 OpenRTB 通訊協定包含部分擴充功能 (以獨立通訊協定提供)。 | v.174 | 2024 年 4 月 17 日 |
| realtime-bidding.proto | Google Authorized Buyers 即時出價通訊協定。這是 Google 用於要求出價的訊息。BidRequest 包含單一曝光中的廣告版位。 |
v.331 | 2024 年 4 月 17 日 |
參考資料
字典 (按一下即可下載 .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 欄位中。這個欄位會指定與片段相關聯的廣告素材所代表的
廣告客戶。這份清單會列出廣告交易平台中的廣告客戶，
並不代表任何買方代表的廣告客戶。 |
| 品牌 | 在 Client Access API 中使用的品牌清單。 |
| 買方可宣告的廣告素材屬性 | 用於 BidResponse 中的 attribute 欄位。這個欄位說明廣告素材的買方可宣告屬性，這些屬性不得顯示在 BidRequest 的 excluded_attribute 中。 |
| 呼叫狀態碼 | performancereport 方法呼叫傳回的狀態碼。 |
| 內容標籤 | 用於 BidRequest 的 detected_content_labels 欄位中。 |
| Cookie 比對工具狀態碼 | 用於即時出價通訊協定成效報表的 cookieMatcherStatusRate 欄位中。如要瞭解可用的程式碼，請參閱 Cookie 比對指南。 |
| 廣告素材狀態碼 | 使用於 以即時意見回饋傳回creative_status_code。 |
| 代管比對狀態碼 | 用於即時出價通訊協定成效報表的 hostedMatchStatusRate 欄位中。 |
| 沒有出價原因 | 標準無出價原因值，需在 Authorized Buyers 出價通訊協定的 BidResponse.no_bid_reason 欄位中指定。 |
| 可預先指定的廣告素材屬性 | 在 Buyer REST API 公開的 PretargetingConfig 資源中使用 supportedCreativeAttribute 欄位。這個欄位說明瞭與單一預先指定設定相對應的所有廣告素材中，預期會顯示的廣告素材屬性。 |
| 發布商可排除的廣告素材屬性 | 用於 BidRequest 的 excluded_attribute 欄位中。這個欄位說明發布商不允許的廣告素材類型。例如，它們可能會指定是否允許使用 Cookie，或是是否允許媒體和/或文字廣告。 |
| 發布商產業 | 用於 BidRequest 的 detected_vertical 欄位中。這個欄位可指定廣告顯示網頁所屬產業 (與關鍵字類似)。Google 會檢索網頁並判斷使用的產業別，藉此產生這個欄位。 |
| 賣方聯播網 ID | 用於 BidRequest 的 seller_network_id 欄位中。這個欄位會指定發布商屬於哪個賣方聯播網。這個檔案的內容會根據賣方聯播網 ID 的值遞增排序。 |
| 供應商 | 用於 BidRequest 的 allowed_vendor_type 欄位中。這個欄位會列出要放送的廣告素材允許哪些互動式多媒體供應商，
例如 Campaign Monitor 和 VoiceFive。包含已淘汰 |
參考表 (按一下即可下載 CSV) |
|
| Android 行動應用程式 | 可指定的 Android 行動應用程式清單，其中包含應用程式 ID、類別 ID 和人類可讀的應用程式名稱。 |
| 地理區域表格 | 這個資料表是用來解碼 BidRequest 的 geo_criteria_id 欄位。詳情請參閱指定地理區域。 |
| LGPD 供應商 |
可向 LGPD 流量放送廣告的廣告個人化服務供應商清單，包含其 ID、人類可讀的名稱、隱私權網址，以及可歸因給供應商的網域清單。系統會透過 Authorized Buyers 出價通訊協定中的 BidRequest.adslot.regs_lgpd 欄位，以及 OpenRTB 出價通訊協定中的 BidRequest.regs.ext.lgpd 欄位，表示對特定出價要求強制執行 LGPD。 |
| 行動電信業者 | 行動電信業者清單。 |
| 行動裝置 | 行動裝置清單。 |
| 行動作業系統 | 行動作業系統清單。 |
| 供應商 | 將廣告個人化供應商 ID 對應至使用者可理解的名稱、隱私權政策網址，以及可歸因於供應商的網域清單。目前，提供者用於 AdX 通訊協定的 BidRequest.AdSlot.consented_providers_settings 欄位，以及適用於 OpenRTB 通訊協定的 BidRequest.User.UserExt.consented_providers_settings。在這些欄位中，列出的供應商會根據發布商向歐洲經濟區內國家/地區的使用者提供使用者同意聲明。 |
發佈者設定
向帳戶代表要求 publisher-settings.pb.gz 檔案。
廣告素材審核政策主題
在即時出價 API 的 審核期間，您可以使用這個檔案中的政策主題來篩選廣告素材
以 CSV 檔案格式下載政策主題檔案。上次更新日期：2022 年 4 月 18 日