查看或下載支援即時出價通訊協定的檔案。
通訊協定
| 檔案 | 說明 | 版本 | 上次更新日期 |
|---|---|---|---|
| cookie-bulk-upload.proto | 請使用這則訊息，大量上傳使用者指定資料。 | v.24 | 2024 年 3 月 27 日 |
| openrtb.proto | Google 支援 OpenRTB 通訊協定 (使用 JSON 或 Protobuf) 編碼。如果您使用 OpenRTB/Protobuf，就必須啟用此通訊協定。此外， 包含支援的欄位以及 Google 的 原生通訊協定 | 2.6 | 2024 年 8 月 1 日 |
| openrtb-adx.proto | Google 的 OpenRTB 通訊協定包括部分擴充功能，在獨立的 proto 中提供。 | v.177 | 2024 年 8 月 6 日 |
| publisher-settings.proto | 即時出價工具聯播網專用的一組發布商設定。 | v.13 | 2024 年 2 月 5 日 |
| realtime-bidding.proto | Google 的 Authorized Buyers RTB 通訊協定這是 Google 使用的訊息
請求出價BidRequest 包含來自
單一曝光 |
v.330 | 2024 年 8 月 6 日 |
開放 Beta 版 Protos
| 檔案 | 說明 | 版本 | 上次更新日期 |
|---|---|---|---|
| openrtb-adx.proto | Google 的 OpenRTB 通訊協定包括部分擴充功能，在獨立的 proto 中提供。 | v.182 | 2024 年 8 月 6 日 |
| realtime-bidding.proto | Google 的 Authorized Buyers RTB 通訊協定這是 Google 使用的訊息
請求出價BidRequest 包含來自
單一曝光 |
v.340 | 2024 年 8 月 6 日 |
參考資料
字典 (點選即可下載 .txt 檔案) |
|
|---|---|
| 廣告產品類別 | 用於以下欄位的 excluded_product_category 欄位：
BidRequest。這個欄位描述產品類別
發布商禁止使用的服務，例如發布商
不想代管網路銀行相關廣告。 |
| 廣告限制類別 | 用於以下欄位的 allowed_restricted_category 欄位：
BidRequest 和 restricted_category 欄位
BidResponse。allowed_restricted_category
欄位會說明通常限制、但明確相關的類別
例如包含
酒精飲料相關內容。 |
| 廣告敏感類別 | 用於以下欄位的 excluded_sensitive_category 欄位：
BidRequest 和 category 欄位
BidResponse。excluded_sensitive_category
欄位描述了發布商不允許的敏感類別。
例如，如果發布商不想代管
政治。 |
| 廣告主 | 用於 SnippetStatusItem 的 advertiser_id 欄位。這個
欄位會指定與
程式碼片段這份清單會反映整個廣告交易平台的廣告客戶，
未反映任何買方代表的廣告客戶。 |
| 品牌 | Client Access API 中使用的品牌清單。 |
| 買方可宣告的廣告素材屬性 | 用於 BidResponse 中的 attribute 欄位。
此欄位旨在說明廣告素材中買方可宣告的屬性，
不會顯示在下列位置的excluded_attribute：
BidRequest。 |
| 呼叫狀態碼 | performancereport 方法傳回的狀態碼
呼叫。 |
| 內容標籤 | 用於detected_content_labels
BidRequest。 |
| Cookie 比對器狀態碼 | 用於即時出價通訊協定的 cookieMatcherStatusRate 欄位中
成效報表Cookie 比對一文中會說明可用的代碼
指南。 |
| 廣告素材狀態碼 | 使用於 creative_status_code 會即時傳回
意見回饋。
|
| 代管比對狀態碼 | 用於即時出價通訊協定的 hostedMatchStatusRate 欄位中
成效報表 |
| 沒有出價原因 | 標準無出價原因值必須在 BidResponse.no_bid_reason 欄位中提供
Authorized Buyers 出價通訊協定。
|
| 預先指定的廣告素材屬性 | 用於supportedCreativeAttribute
Pre 指定 Config 資源在 Buyer REST API 中公開。這個欄位
列出了所有廣告素材中應會出現的廣告素材屬性
每個委刊項對應單一預先指定設定 |
| 發布商可排除的廣告素材屬性 | 用於以下欄位的 excluded_attribute 欄位：
BidRequest。這個欄位會說明
未獲得發布商許可例如，他們可能會指定
限制是否允許使用 Cookie、是否允許媒體和/或文字
允許廣告。 |
| 發布商產業 | 用於以下欄位的 detected_vertical 欄位：
BidRequest。此欄位可用來指定產業 (類似
關鍵字)。由 Google 產生
] 欄位。 |
| 供應商 | 用於以下欄位的 allowed_vendor_type 欄位：
BidRequest。這個欄位會列出哪些互動式多媒體供應商，例如
廣告活動監控器和 VoiceFive 允許放送的廣告素材
按發布商指定的名稱包含已停用的供應商
|
| 資料供應商 | 用於以下欄位的 SegmentData.id 欄位：
BidRequest。這個欄位包含的
發布商提供的信號。 |
參考表格 (按一下即可下載 CSV 檔案) |
|
| Android 行動應用程式 | 可指定的 Android 行動應用程式清單，包括應用程式 ID、類別 ID、 以及人類可讀的應用程式名稱 |
| 地理區域表 | 用於解碼 geo_criteria_id 欄位
BidRequest。詳情請參閱「指定地理區域」一文
可能不準確或不適當 |
| LGPD 供應商 |
允許透過 LGPD 流量放送的廣告個人化供應商清單。
名稱、人類可讀的名稱、隱私權網址和網域清單
可歸因於供應器被稱為 LGPD 違規處置
透過BidRequest.adslot.regs_lgpd
欄位，而
BidRequest.regs.ext.lgpd 欄位。
|
| 行動電信業者 | 行動電信業者清單。 |
| 行動裝置 | 行動裝置清單。 |
| 行動作業系統 | 行動作業系統清單。 |
| 供應商 | 將廣告個人化提供者 ID 對應到人類可讀的名稱，以及隱私權
政策網址，以及可歸因於供應商的網域清單。
供應商目前用於
AdX 的「BidRequest.AdSlot.consented_providers_settings」欄位
通訊協定和
BidRequest.User.UserExt.consented_providers_settings (適用於 OpenRTB)
因此效能相當卓越在這些欄位中，所列供應商已取得使用者同意聲明
供歐洲經濟區境內使用者存取 |
發佈者設定
透過您的帳戶要求 publisher-settings.pb.gz 檔案
代表。
廣告素材審核政策主題
您可以使用這個檔案中的政策主題，篩選下列期間的廣告素材： 查看即時出價 API
下載 匯出政策主題的 CSV 檔案。上次更新日期：2022 年 4 月 18 日