本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# ORTB 欄位參考
此頁面是 OpenRTB 競價請求中每個欄位的完整參考。欄位的分類方式是 MediaTailor 如何處理它們，以及 APS 是否需要或建議它們以獲得最佳廣告填滿。
如需完整的 OpenRTB 2.6 規格，請參閱 [IAB OpenRTB 2.6 規格](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md)。
## 欄位類別
| Category | 意義 | 您的動作 |
| --- | --- | --- |
| 強制性 | 範本中必須存在 。如果遺失，MediaTailor 會擲回錯誤。 | 您必須提供這些項目。 |
| 由 EMT 硬式編碼 | MediaTailor 一律使用主控台組態中的值或目前時段內容來設定這些值。您的範本值會遭到覆寫。 | 請勿在範本中設定這些項目。 |
| APS 建議 | MediaTailor 不嚴格要求，但 APS 建議這些項目以獲得更好的廣告填滿和鎖定。缺少建議欄位可能會導致填充率較低或無出價回應。 | 強烈建議您這麼做。 |
| 選用 | 只有在您提供時，才會包含在競價請求中。無預設值。 | 如果與您的使用案例相關，請提供 。 |
## `app` 物件
| 欄位 | Category | 備註 |
| --- | --- | --- |
| app | 強制性 | app 物件必須存在於您的範本中。 |
| app.bundle | 強制性 | 您應用程式的套件 ID （例如 G15147002586)。不得為空白。 |
| app.storeurl | 強制性 | 應用程式存放區 URL （例如，https://apps.apple.com/us/app/yourapp/id123)。 |
| app.publisher.id | 由 EMT 硬式編碼 | 一律PublisherId從主控台組態將 設定為您的 。 |
| app.content | 強制性 （物件） | 如果您省略此項目，MediaTailor 會傳送空Content物件。提供內容中繼資料以更好地鎖定目標。 |
| app.name | APS 建議 | 用於識別的應用程式名稱。 |
| app.id | APS 建議 | APS 中的應用程式識別符。 |
| app.domain | APS 建議 | 應用程式網域。 |
| app.content.genre | APS 建議 | 內容類型 （例如，、"Sport""News")。 |
| app.content.contentrating | APS 建議 | 內容評分 （例如，、"TV-G""TV-14")。 |
| app.content.language | APS 建議 | 內容語言 (ISO-639-1)。 |
| app.content.id | APS 建議 | 內容識別符。 |
| app.content.title | APS 建議 | 內容標題。 |
| app.content.episode | APS 建議 | 片段編號。 |
| app.content.len | APS 建議 | 內容長度，以秒為單位。 |
| app.cat | 選用 | 內容類別 (IAB 分類）。 |
| app.sectioncat | 選用 | 區段類別。 |
| app.pagecat | 選用 | 頁面類別。 |
| app.ver | 選用 | 應用程式版本。 |
| app.privacypolicy | 選用 | 1 = 具有隱私權政策。 |
| app.paid | 選用 | 1 = 付費應用程式。 |
| app.keywords | 選用 | 逗號分隔的關鍵字。 |
| app.kwarray | 選用 | 關鍵字做為陣列。 |
| app.inventorypartnerdomain | 選用 | 庫存合作夥伴網域。 |
| app.ext | 選用 | 延伸物件 （傳遞）。 |
## `device` 物件
| 欄位 | Category | 備註 |
| --- | --- | --- |
| device | 強制性 | device 物件必須存在於您的範本中。 |
| device.ua | 強制性 | 使用者代理程式字串。不得為空白。請使用 {{session.user\_agent}}。 |
| device.ip | 強制性 | IPv4 地址。不得為空白。請使用 {{session.client\_ip}}。 |
| device.lmt | 選用 （預設：0) | 限制廣告追蹤旗標。 0 = 允許追蹤， 1 = 追蹤受限。如果您的範本中未提供 ，則 預設為 0。 |
| device.devicetype | EMT 硬式編碼 （預設值：3) | 如果未提供MediaTailor 會設定 3（連線電視）。如果存在，則會使用您的值。 |
| device.make | APS 建議 | 裝置製造商 （例如 "Samsung"、)"Apple"。 |
| device.model | APS 建議 | 裝置模型 （例如，、"Tizen TV""iPhone")。 |
| device.os | APS 建議 | 作業系統 （例如 "Tizen"、)"iOS"。 |
| device.osv | APS 建議 | 作業系統版本。 |
| device.h | APS 建議 | 螢幕高度，以像素為單位。 |
| device.w | APS 建議 | 螢幕寬度，以像素為單位。 |
| device.language | APS 建議 | 裝置語言 (ISO-639-1)。 |
| device.ifa | APS 建議 | 裝置廣告 ID。並非所有裝置都有一個 （例如 Web 瀏覽器）。 |
| device.dnt | APS 建議 | 請勿追蹤旗標。 |
| device.geo | 選用 | 具有 country、lat、 的地理物件lon。 |
| device.sua | 選用 | 結構化使用者代理程式 (UA-CH)。 |
| device.ipv6 | 選用 | IPv6 地址。 |
| device.hwv | 選用 | 硬體版本。 |
| device.connectiontype | 選用 | 連線類型 (WiFi、行動網路等）。 |
| device.carrier | 選用 | 電信業者名稱。 |
| device.mccmnc | 選用 | 行動國家/網路代碼。 |
| device.ext | 選用 | 延伸物件 （傳遞）。 |
## `imp` (impression) 物件
您的範本在 陣列中必須只包含**一個**`imp`物件。
| 欄位 | Category | 備註 |
| --- | --- | --- |
| imp[0].video | 強制性 | video 物件必須存在。 |
| imp[0].video.mimes | 強制性 | 支援的 MIME 類型 （例如 ["video/mp4"])。 |
| imp[0].video.protocols | 選用 | 支援的 VAST 通訊協定。如果省略，MediaTailor 會使用硬式編碼的備用 [1, 2, 3, 4, 5, 6, 7, 8]。請參閱以下通訊協定列舉參考。 |
| imp[0].video.minduration | 由 EMT 硬式編碼 | MinimumUnfilledDuration 從 主控台將 設定為您的 。 |
| imp[0].video.maxduration | EMT 硬式編碼 | 設定為實際未填充持續時間 （秒）。 |
| imp[0].video.maxseq | EMT 硬式編碼 | 計算：floor(unfilled\_duration / 6)。APS 建議 maxseq或 poddur 傳回多個廣告。 |
| imp[0].video.poddur | 由 EMT 硬式編碼 | 設定為未填充持續時間 （秒）。 |
| imp[0].video.startdelay | 選用 | 啟動延遲。 0 = 前導、-1= 一般中導、-2= 後導、> 0= 中導位移，以秒為單位。-1 用於即時中轉休息時間。硬式編碼後援：6。 |
| imp[0].video.w | APS 建議 | 影片寬度，以像素為單位。 |
| imp[0].video.h | APS 建議 | 影片高度，以像素為單位。 |
| imp[0].video.plcmt | APS 建議 | 置放類型 (1 = 串流中）。 |
| imp[0].video.podid | APS 建議 | Pod 識別符。 |
| imp[0].video.slotinpod | APS 建議 | Pod 中的槽位置。 |
| imp[0].video.ext.slotId | 選用 （預設："default\_slot\_id") | 來自 APS 主控台的 APS 插槽 ID。預設值有效，但提供您的實際槽 ID 可讓 APS 套用特定槽的目標和樓層定價。 |
| imp[0].bidfloor | 選用 （預設：1.0) | CPM 的最低出價。 |
| imp[0].secure | 選用 （預設：1) | 1 = 需要 HTTPS URLs。 |
| imp[0].id | 選用 | 印模 ID。如果未提供，則自動產生。 |
| imp[0].tagid | 選用 | 標籤/置放 ID。 |
| imp[0].bidfloorcur | 選用 | 出價下限貨幣 （預設 USD)。 |
| imp[0].ssai | 選用 | SSAI 指標。 |
| imp[0].exp | 選用 | 印模的過期時間。 |
| imp[0].rqddurs | 選用 | 請求的持續時間陣列。 |
| imp[0].mincpmpersec | 選用 | 每秒最低 CPM。 |
| imp[0].pmp | 選用 | 私有市集物件。 |
| imp[0].ext | 選用 | 延伸物件 （傳遞）。 |
### 通訊協定列舉參考
| Value | 通訊協定 |
| --- | --- |
| 1 | VAST 1.0 |
| 2 | VAST 2.0 |
| 3 | VAST 3.0 |
| 4 | VAST 1.0 包裝函式 |
| 5 | VAST 2.0 包裝函式 |
| 6 | VAST 3.0 包裝函式 |
| 7 | VAST 4.0 |
| 8 | VAST 4.0 包裝函式 |
| 9\+ | 達斯 |
## 最上層欄位
| 欄位 | Category | 備註 |
| --- | --- | --- |
| id | EMT 硬式編碼 | 自動產生： {sessionId}\_{availId} 格式 （例如 abc123-def456\_78901)。用於將競價請求與工作階段日誌建立關聯。 |
| cur | 選用 （預設：["USD"]) | 允許的貨幣。 |
| ext.integrationType | EMT 硬式編碼 | 一律設定為 "EMT"。 |
| bcat | 選用 | 封鎖廣告類別 (IAB 分類）。您的範本值會依原狀傳送至 APS。 |
| badv | 選用 | 封鎖的廣告商網域。 |
| bapp | 選用 | 封鎖的應用程式套件 IDs。 |
| test | 選用 | 測試模式旗標。 |
| at | 選用 | 競標類型。 |
| tmax | 選用 | 等待出價回應的時間上限 （毫秒）。 |
| wseat | 選用 | 允許買方座位。 |
| bseat | 選用 | 封鎖買方座位。 |
| wlang | 選用 | 允許的創意語言。 |
| source | 選用 | 供應鏈的來源物件。 |
| ext | 選用 | 您的自訂擴充功能欄位會與 EMT 的 合併integrationType。 |
## `user` 物件
| 欄位 | Category | 備註 |
| --- | --- | --- |
| user | APS 建議 (EU) | 取得 GDPR 同意的歐洲流量必填。 |
| user.consent | APS 建議 (EU) | GDPR 同意字串 (TCF)。 |
| user.id | 選用 | 使用者 ID。 |
| user.buyeruid | 選用 | 買方特定的使用者 ID。 |
| user.eids | 選用 | 擴充識別符 (LiveRamp、UID2 等）。 |
| user.data | 選用 | 使用者資料區段。 |
| user.ext | 選用 | 延伸物件。 |
## `regs` 物件
| 欄位 | Category | 備註 |
| --- | --- | --- |
| regs | APS 建議 | 包含 以符合法規。 |
| regs.coppa | APS 建議 （美國） | COPPA 旗標 (1 = 子導向）。 |
| regs.us\_privacy | APS 建議 （美國） | 美國隱私權/CCPA 字串。 |
| regs.gdpr | APS 建議 (EU) | GDPR 適用 (1 = 是）。 |
| regs.gpp | APS 建議 | 全球隱私權平台字串。對於美國觀眾us\_privacy而言，偏好 ，可產生更好的填充率。請參閱 [最佳實務](yield-optimization-best-practices.md)。 |
| regs.gpp\_sid | APS 建議 | GPP IDs （例如，[7]美國國民）。當 gpp 存在時為必要。 |
| regs.ext | 選用 | 延伸物件。 |
## 後續步驟
+ 如需複製貼上範本，請參閱[範例 範本](yield-optimization-examples.md)。
+ 如需最大化填充速率的建議，請參閱 [最佳實務](yield-optimization-best-practices.md)。