View a markdown version of this page

ORTB 欄位參考 - AWS Elemental MediaTailor
欄位類別app 物件device 物件imp (impression) 物件最上層欄位user 物件regs 物件後續步驟

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

ORTB 欄位參考

此頁面是 OpenRTB 競價請求中每個欄位的完整參考。欄位的分類方式是 MediaTailor 如何處理它們，以及 APS 是否需要或建議它們以獲得最佳廣告填滿。

如需完整的 OpenRTB 2.6 規格，請參閱 IAB OpenRTB 2.6 規格。

欄位類別

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而言，偏好 ，可產生更好的填充率。請參閱 最佳實務。
regs.gpp_sid APS 建議 GPP IDs （例如，[7]美國國民）。當 gpp 存在時為必要。
regs.ext 選用 延伸物件。

後續步驟