DV360 OpenRTB 規格

查閱本頁面時，請備妥 OpenRTB 2.6 規格。

Display & Video 360 不支援 OpenRTB 規格中的所有欄位， 且可能適用細微差異。本文件的各個章節包含 Display & Video 360 導入作業的專屬資訊和建議。除非另有指示，否則您也應遵循 OpenRTB 規格中的規範。

系統會剖析但不支援部分欄位。這些欄位必須格式正確，但不會影響出價結果。

出價要求規格

出價要求是 HTTP Post 要求，內含出價要求物件。主體的格式定義於 Content-Type 標頭中。

相應的回應是不出價的 HTTP 204 (沒有主體)，或是包含出價回應主體的 HTTP 200。

如果出價要求格式錯誤，系統可能會傳回 HTTP 200，並在主體中填入 nbr 欄位，表示出價回應。

回應格式由 Accept 標頭控制。

JSON 格式

如果未提供可接受的 MIME 類型，系統會使用預設格式。

JSON 要求和回應遵循 IAB OpenRTB 2.6 規格。以下文件說明擴充功能和欄位支援。

標頭 Content-Type: application/json 表示 JSON 出價要求，Accept: application/json 表示出價回應應採用 JSON 格式。

Protobuf 格式

注意：Protobuf 支援功能目前為 Beta 版，如有興趣，請與 DV360 聯絡。

JSON 要求和回應遵循 IAB OpenRTB 2.6 Protobuf 規格。

擴充功能僅支援部分功能，如有興趣，請與 DV360 聯絡。

傳送 Content-Type: application/x-protobuf 標頭，表示 Protobuf 出價要求，並設定 Accept: application/x-protobuf，接收 Protobuf 出價回應。

出價要求物件

欄位 類型 詳細資料
id 字串 必填。
出價要求的專屬 ID。這項資訊可用於識別個別要求，但僅限於要求放送後的一段時間。
imp 曝光陣列 至少需要 1 個 imp 物件。

音訊 Pod 支援多個 imp 物件。
如果是其他用途 (例如網頁上有多個獨立版位)，系統會使用第一個 imp 物件，其餘則會捨棄。
site 地點 網站要求必須提供這項資訊。
site 和 app 互斥。
app 應用程式 應用程式要求必須提供這項資訊。
app 和 site 互斥。
device 裝置 必填。
user 使用者 必填。
test 整數 不支援。
at 整數 1：最高價得標競價，廣告主需支付出價金額。
2 (預設)：次高價得標競價，廣告主只需支付略高於次高出價者的金額。
3：底價位於要求中，與競爭出價無關。
tmax 整數 選填，預設為每個整合的自訂值。
wseat 字串陣列 允許的買家席位清單。
除非允許所有廣告主出價，否則建議使用這項功能。
未設定表示沒有限制。
bseat 字串陣列 應封鎖出價的買方席位清單。系統會禁止列出的買方對交易和公開競價出價。
allimps 整數 不支援。
cur 字串陣列

選用，但強烈建議使用。 預設值為每個整合服務。

出價要求中的幣別必須與整合期間註冊的其中一種幣別相符。

強烈建議每個交易所支援單一貨幣。
wlang 字串陣列 不支援。
bcat 字串陣列 使用 IAB 內容類別封鎖廣告主類別。
未設定：沒有封鎖的類別。
badv 字串陣列 根據廣告主提供的網域指定遭封鎖的廣告主。
Unset is no blocked advertisers.
bapp 字串陣列 不支援。
source 資料來源 schain 的半必填欄位。
regs Regs 選填。
ext 出價要求擴充功能 選填。

出價要求擴充功能物件

欄位 類型 詳細資料
schain 供應鏈 新的整合作業應改用來源中的 BidRequest.source.schain 欄位。
purch 整數 「付費流量」參數是指從非自有、併購或透過其他獎勵活動而得的資源重新導向而來的流量。
這是根據新的 MRC IVT 2.0 規格。

在買方報表中，這項資訊會稱為「發布商流量來源」，並顯示下列其中一個值：
0 (預設)：未定義 - 出價要求中未傳送值。 無法擷取值；
1：付費流量 - 從其他非自有資源重新導向而來的流量 (自他處取得或來自獎勵活動)。
2：自然流量 - 直接輸入網址、網站搜尋或應用程式下載。

gdemsignals 字串 GMA SDK 的 SCAR API 信號 Blob。
建議用於 GMA SDK 流量，否則請勿使用。
disable_gma_format int 如果已提供 gdemsignals，這個屬性則變成選用屬性，否則為禁用欄位。
0 (預設)：如果填入 gdemsignals，出價回應的廣告素材會是 JSON Blob。
1：系統也會提供廣告代碼，而非 JSON Blob。

來源物件

欄位 類型 詳細資料
fd 整數 負責最終曝光銷售決策的實體
0 (預設)：由交易所決定。
1：由上游來源決定。
tid 字串 不支援。
pchain 字串 不支援。
schain 供應鏈 幾乎在所有情況下都必須提供這項資訊。

建議您提供這個欄位，而非透過出價要求擴充功能或來源擴充功能提供 schain。

ext 來源擴充功能 選填。

來源擴充功能物件

強烈建議您使用這項擴充功能，因為這會影響 DV3 向客戶回報的可視度指標。如果 OMID 合作夥伴名稱「不在」IAB 認證清單中，我們必須按照 MRC 的規定，分別回報可視度指標和 MRC 認證指標。瞭解詳情。

欄位 類型 詳細資料
omidpn 字串 OM SDK 整合 ID，這與 OMID 合作夥伴物件的「name」參數相同。
omidpv 字串 OM SDK 整合版本。這與 OMID 合作夥伴物件的「versionString」參數相同。
schain 供應鏈 新的整合作業應改用 Source 中的 schain 欄位。

Regs 物件

欄位 類型 詳細資料
coppa 整數 0 (預設)：COPPA 不適用於這項要求。
1：這項要求適用於《兒童網路隱私保護法》(COPPA)。
ext Regs 擴充功能 選填。

Regs 擴充功能物件

欄位 類型 詳細資料
gdpr 整數 指出出價要求是否來自歐洲經濟區。
0 (預設)：非歐洲經濟區。
1：歐洲經濟區，
詳情請參閱 GDPR 適用的同意聲明提供者解決方案。
us_privacy 字串 請按照 IAB Tech Lab 提供的技術規格，導入 us_privacy 字串。

當我們在出價要求中收到 us_privacy 字串，且 IAB 字串指出使用者未選擇不採用時，Display & Video 360 就會針對這類要求出價。我們不會將 IAB 信號進一步套用到其他供應商。如果 IAB 字串指出使用者已選擇不採用，Google 就不會針對這類要求出價。

Imp 物件

欄位 類型 詳細資料
id 字串 出價要求情境中，這個曝光的專屬 ID (通常值會從 1 開始，並針對 n 個曝光遞增至 n)。
metric 物件 不支援。
banner 橫幅 橫幅廣告商機的必填欄位。
video 影片 影片廣告商機的必要欄位。
audio 音訊 音訊廣告商機的必要條件。
native 原生 這是原生廣告商機的必要項目。
pmp Pmp 這項曝光適用的私人交易市場交易。
displaymanager 字串 負責顯示廣告 (通常是影片或行動廣告) 的廣告中介服務合作夥伴、SDK 技術或播放器名稱。部分廣告伺服器會使用這項功能，根據合作夥伴自訂廣告程式碼。建議用於影片和/或應用程式。
displaymanagerver 字串 負責顯示廣告的廣告中介服務合作夥伴、SDK 技術或播放器版本 (通常是影片或行動裝置)。部分廣告伺服器會使用這項功能，根據合作夥伴自訂廣告程式碼。建議用於影片和/或應用程式。
instl 整數 0 (預設)：非插頁式廣告。
1：廣告為插頁式或全螢幕。
tagid 字串 用來啟動競價的特定廣告刊登位置或廣告代碼的 ID。這項資訊有助於排解任何問題，或供買方進行最佳化。
bidfloor 浮點值 以千次曝光出價表示的這項曝光最低出價。
bidfloorcur 字串

使用 ISO-4217 字母代碼指定的貨幣。

clickbrowser 整數

指出在應用程式中點選廣告素材時開啟的瀏覽器類型。
0 (預設)：內嵌
1：原生

請注意，iOS 9.x 裝置中的 Safari 檢視控制器會視為這個欄位的原生瀏覽器。
secure 整數 如果這項曝光需要安全的 HTTPS 網址，或不安全的 HTTP 網址。
0 (預設)：不安全
1：安全
iframebuster 字串陣列
exp 整數 DV360 會設定出價到期時間，不考慮合作夥伴在這個欄位中傳送的值。如果曝光事件是在曝光過時時間範圍 (通常為 1 小時) 後收到，系統會將其視為過時並捨棄，DV360 也不會將其視為可計費事件。
rwdd 整數 指出使用者觀看廣告後是否會獲得獎勵。
0 (預設)：未獲得獎勵
1：已獲得獎勵

通常，導入影片廣告後，使用者就能免費閱讀額外的新聞文章、在遊戲中獲得額外生命，或是享有贊助的無廣告音樂工作階段。獎勵通常會在影片廣告播放完畢後發放。

Imp 擴充功能物件

欄位 類型 詳細資料
bcrid 字串 應封鎖的廣告素材 ID 清單。
欄位 類型 詳細資料
format 格式陣列 支援的格式清單。
w 整數

h 和 w 會合併到 format 欄位。

建議改用 format。
h 整數

h 和 w 會合併到 format 欄位。

建議改用 format。
wmax 整數 不支援。
hmax 整數 不支援。
wmin 整數 不支援。
hmin 整數 不支援。
btype 整數陣列 封鎖的橫幅廣告類型清單：

1：HTML 文字廣告
2：HTML 橫幅廣告
3：JavaScript 廣告
4：IFrame 廣告

battr 整數陣列 支援下列值：

1：音訊自動播放
2：音訊由使用者啟動
3：可展開式自動
4：可展開式點擊啟動
5：可展開式滑鼠游標啟動
6：橫幅中的影片自動播放
7：橫幅中的影片由使用者啟動
8：彈出式(上方/下方/離開時)
9：煽情或暗示性內容
10：「惱人」，例如：晃動、閃爍、閃動、極端動畫、笑臉
11：問卷調查
12：僅限文字
13：使用者互動式 (遊戲)
14：Windows 對話方塊或警示樣式
15：有音訊開啟/關閉按鈕
16：廣告可略過
17：Flash

pos 整數 廣告位置：

0 (預設)：不明
1：首屏
2： 不支援：可能位於首屏下方
3：首屏下方
4：頁首
5：頁尾
6：側欄
7：全螢幕
mimes 字串陣列 不支援。

DV360 會對所有橫幅廣告素材使用 text/html。

topframe 整數 0 (預設)：橫幅會以 iframe 形式放送。
1：不支援：橫幅會顯示在頂端影格。
expdir 整數陣列 1：左
2：右
3：上
4：下
5：可展開的全螢幕
api 整數陣列 支援的 API 架構

1：左
2：右
3：上
4：下
5：可展開的全螢幕

id 字串 橫幅物件的 ID，在曝光中應為不重複。

建議搭配影片物件使用 banner 物件。

vcm 整數

僅適用於搭配影片物件使用的 banner。

0：橫幅會與影片廣告素材同時顯示。
1：橫幅是影片結束後的片尾畫面。

格式物件

欄位 類型 詳細資料
w 整數 寬度 (以裝置獨立像素為單位)。
h 整數 高度 (以裝置無關像素為單位)。
wratio 整數 不支援。
hratio 整數 不支援。
wmin 整數 不支援。

影片物件

強烈建議您在出價要求中指定影片刊登位置。如果缺少刊登位置欄位，系統會將其歸類為不明刊登位置。詳情請參閱這篇文章。

欄位 類型 詳細資料
mimes 字串陣列 至少須提供一個 MIME 類型。

video/flv 或 video/x-f4v
video/mp4、video/x-mp4 或 application/mp4
video/webm 或 video/x-webm
video/x-ms-wmv
video/3gpp
video/ogg 或 application/ogg
application/javascript 或 application/x-javascript

minduration 整數 影片長度下限 (以秒為單位)，預設為無下限。
maxduration 整數 影片長度上限 (以秒為單位)，預設為無上限。
protocols 整數陣列 至少須提供一個支援的通訊協定。

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：DAAST 1.0
10：DAAST 1.0 包裝函式

w 整數 影片播放器的寬度 (以裝置獨立像素為單位)。
h 整數 影片播放器的高度 (以裝置獨立像素為單位)。
startdelay 整數 片頭、片中或片尾廣告刊登位置的開始延遲時間 (以秒為單位)。
placement 整數 強烈建議在出價要求中指定影片的 plcmt (和/或) 刊登位置。 如果兩個欄位都缺少，系統會將其歸類為不明刊登位置。

0 (預設)：不明
1：串流內
2：橫幅內
3：文章內
4：動態消息內
5：浮動

注意：如要將影片刊登位置/曝光視為串流內廣告 (刊登位置或 Plcmt 類型 1)，必須將「聲音」設為開啟，並在「播放方法」中正確發出信號 (值為 1、3、4 和 5 皆符合資格)。
plcmt 整數 強烈建議在出價要求中指定影片的 plcmt (和/或) 刊登位置。 如果兩個欄位都缺少，系統會將其歸類為不明刊登位置。

0 (預設)：不明
1：串流內廣告
2：隨附內容
3：插頁式廣告
4：無內容/獨立式廣告

注意：如要將影片刊登位置/曝光視為串流內廣告 (刊登位置或 Plcmt 類型 1)，必須將影片刊登位置/曝光設為「開啟音效」，並在「播放方法」中正確發出信號 (值為 1、3、4 和 5 皆符合資格)。

注意：如果同時提供 plcmt 和 placement，系統會優先採用 plcmt。請參閱 IAB 指南，瞭解如何遷移至 plcmt。

注意： plcmt: Accompanying Content (2) 視為 placement: In Article (3)
plcmt: No Content/Standalone (4) 視為 placement: In feed (4)
placement: In Banner 在 plcmt 中沒有對應項目
linearity 整數 不支援。
skip 整數 影片播放器是否允許略過廣告。

0 (預設)：不可略過
1：可略過
skipmin 整數 不支援。
skipafter 整數 不支援。
sequence 整數 如果同一個出價要求提供多個廣告曝光， 序號可協調放送多個廣告素材。
battr 整數陣列 已封鎖的廣告素材屬性。
maxextended 整數 如果允許擴展，擴展影片廣告的長度上限。

0 (預設)：不允許延長
-1：允許延長，且沒有時間限制
>0：支援延長播放的時間 (以秒為單位)，超過 maxduration 值。

minbitrate 整數 最低位元率 (以 Kbps 為單位)。
maxbitrate 整數 位元率上限 (Kbps)。
boxingallowed 整數 指出是否允許將 4:3 內容以上下黑邊形式顯示在 16:9 視窗中

0：不允許
1 (預設)：允許
playbackmethod 整數陣列 可能使用的播放方法。如未指定，則可使用任何方法。

0 (預設)：不明
1：自動播放，開啟音效
2：自動播放，關閉音效
3：點選即可播放
4：滑鼠懸停
5：進入可視區域時啟動，開啟音效
6：進入可視區域時啟動，關閉音效

注意：所有預設關閉音效的曝光 (播放方式為 2、6 或 0)，都必須發出信號，指出刊登位置類型為 2、3、4 或 5 (oRTB 2.5)，或刊登位置子類型為 2、3 或 4。
playbackend 整數 導致播放結束的事件。

1：影片完整播放或使用者終止播放
2：離開可視區域或使用者終止播放
3：離開可視區域後，會繼續以浮動視窗播放，直到完整播放或使用者終止播放
delivery 整數陣列 支援的提交方式。如未指定，則假設所有項目都受支援。

1：串流
2：漸進式
pos 整數 廣告在畫面上的位置。

0 (預設)：不明
1：首屏
2： 不支援：可能位於首屏下方
3：首屏下方
4：頁首
5：頁尾
6：側欄
7：全螢幕
companionad 橫幅陣列 隨播廣告 (如有)。
api 整數陣列

0 (預設)：不明
1：VPAID 1
2：VPAID 2
3：MRAID 1
4：ORMMA
5：MRAID 2
6：MRAID 3
7：OMID 1 - 必須啟用，才能使用 OMID 進行 Active View 評估。
8：SIMID 1
companiontype 整數陣列 不支援。
maxseq 整數 動態影片廣告連播中傳回的廣告數量上限。
poddur 整數陣列 動態影片廣告連播的時間長度上限 (以秒為單位)。

影片物件支援的擴充功能

欄位 類型 詳細資料
rewarded 整數 這個欄位用於指出請求是否為獎勵請求。這應以整數形式傳送。

0 (預設)：未獲得獎勵
1：獲得獎勵

音訊物件

欄位 類型 詳細資料
mimes 字串陣列 至少須提供一個 MIME 類型。

audio/m4a、audio/mp4 或 audio/x-m4a
audio/mpeg 或 audio/mp3
audio/ogg 或 audio/x-ogg

minduration 整數 廣告長度下限 (秒)。
maxduration 整數 廣告長度上限 (秒)。
protocols 整數陣列

3：VAST 3.0
6：VAST 3.0 包裝函式
7：VAST 4.0
8：VAST 4.0 包裝函式
startdelay 整數 片頭、片中或片尾廣告刊登位置的開始延遲時間 (以秒為單位)。

-2：片尾廣告
-1：片中廣告
0：片頭廣告
>0：片中廣告

sequence 整數 不支援。
battr 整數陣列 不支援。
maxextended 整數 不支援。
minbitrate 整數 最低位元率 (以 Kbps 為單位)。
maxbitrate 整數 位元率上限 (Kbps)。
delivery 整數陣列 不支援。
companionad 橫幅物件陣列 任何橫幅隨播廣告素材的版位。
api 整數陣列 這個曝光支援的 API 架構清單。

7：Omid V1

companiontype 整數陣列 不支援。
maxseq 整數陣列 不支援。
feed 整數 音訊動態饋給類型。

1：音樂服務
2：廣播
3：Podcast

stitched 整數 不支援。
nvol 整數 不支援。

原生物件

詳情請參閱 DV360 原生廣告規格。

欄位 類型 詳細資料
request 字串 編碼的原生 JSON 物件字串。
ver 字串 1.0：不支援
1.1：不支援
1.2
api 整數陣列 這個曝光支援的 API 架構清單。

7：Omid V1

battr 整數陣列 不支援。

PMP 物件

欄位 類型 詳細資料
private_auction 整數 0 (預設)：允許所有出價
1：僅限交易
deals 交易物件陣列 要納入的交易。

特惠物件

欄位 類型 詳細資料
id 字串 每個 ID 的 PMP 物件最多只能包含一個交易物件。
bidfloor 雙人床 千次曝光出價的最低出價。

如果 at=3，則為必要欄位。

bidfloorcur 字串 使用 ISO-4217 字母代碼指定的貨幣。

如未指定，則預設為出價要求幣別。

at 整數 如未指定，預設會比對 bid_request.at。

1：最高價
2：次高價
3：固定價格

wseat 字串陣列 符合交易資格的合作夥伴 ID。

沒有座位表示沒有座位限制。

wadomain 字串陣列 允許對這筆交易出價的廣告主網域。

沒有席位表示沒有網域限制。

guar 整數 這個欄位用於指出交易是否為保證交易。應以整數形式傳送。

廣告交易平台必須取得許可，DV360 才能接受保證交易；如要申請許可，請與我們聯絡。

如果您的交易平台目前使用其他機制，向 DV360 發出有保證交易的信號，請與我們聯絡，討論改用這個偏好的擴充功能。

0 (預設)：無保證
1：保證

ext 交易額外資訊 選填。

交易物件支援的擴充功能

欄位 類型 詳細資料
guaranteed 整數 這個欄位用於指出交易是否為保證交易。應以整數形式傳送。

廣告交易平台必須取得許可，DV360 才能接受保證交易；如要申請許可，請與我們聯絡。

如果您的交易平台目前使用其他機制，向 DV360 發出有保證交易的信號，請與我們聯絡，討論改用這個偏好的擴充功能。

0 (預設)：無保證
1：保證

建議使用 deal.guar 代替這個欄位。

網站物件

欄位 類型 詳細資料
id 字串 廣告交易平台上的網站 ID。
name 字串 不支援。
domain 字串 網站的網域。

建議在 site.page 中傳送完整網址，而不是只填入 site.domain。

cat 字串陣列 不支援。
sectioncat 字串陣列 不支援。
pagecat 字串陣列 不支援。
page 字串 要顯示曝光的完整網址。

建議您傳送完整網址，以利指定目標。

ref 字串 導致導覽至目前頁面的參照網址。
search 字串 不支援。
mobile 整數 不支援。
privacypolicy 整數 不支援。
publisher 發布商物件 網站發布者的詳細資料。
content 內容物件 網站內容的詳細資料。
keywords 字串 (CSV 格式) 不支援。
ext 網站額外資訊 網站物件的擴充功能。

網站擴充功能物件

欄位 類型 詳細資料
inventorypartnerdomain 字串 用於連網電視廣告空間共用，請參閱 IAB 連網電視應用程式新增說明。

應用程式物件

欄位 類型 詳細資料
id 字串 廣告交易平台上的應用程式 ID。
name 字串 應用程式名稱，可應發布商要求設定別名。

發布商可以直接在無 SDK 請求 (大多是連網電視) 中提供應用程式名稱。

bundle 字串 必要元素。

如果是 iOS，則必須是數字型 App Store ID。我們不接受反向 DNS 樣式的軟體包 ID。

如果是連網電視應用程式，建議您傳遞商店定義的應用程式 ID。請遵守最近發布的 IAB OTT/連網電視商店指派 ID 相關規範。
domain 字串 網域，例如 mygame.foo.com
storeurl 字串 這是驗證 app-ads.txt 和連網電視應用程式商店的必要資訊。
cat 字串陣列 不支援。
sectioncat 字串陣列 不支援。
pagecat 字串陣列 不支援。
ver 字串 不支援。
privacypolicy 整數 不支援。
paid 整數 不支援。
publisher 發布商物件 應用程式發布者資訊。
content 內容物件 應用程式內容資訊。
keywords 字串 (csv 格式) 不支援。
ext 應用程式額外資訊 應用程式物件的擴充功能。

應用程式額外資訊物件

欄位 類型 詳細資料
inventorypartnerdomain 字串 用於連網電視廣告空間共用，請參閱 IAB 連網電視應用程式新增說明。

內容物件

建議您盡可能傳遞這些屬性。

欄位 類型 詳細資料
id 字串 可明確識別內容的 ID。
episode 整數 內容集數 (通常適用於影片內容)。
title 字串 建議用於連網電視、影片和音訊請求。
series 字串 建議用於連網電視、影片和音訊請求。
season 字串 內容季別的標籤。
artist 字串 內容的藝人。
genre 字串 最能貼切描述內容的類型。DV360 建議為連網電視、影片和音訊要求提供這項信號。
DV360 支援這個欄位的幾種影片類型值分類：
  • Google 類型清單 (下載)
  • IAB 電視/電影/運動類別 (下載)
  • Nielsen 的 Gracenote 影片類型分類
album 字串 內容所屬的專輯，通常是音訊內容。
isrc 字串 符合 ISO-3901 的國際標準錄音錄影資料代碼。
producer Producer 物件 內容製作人的詳細資料。
url 字串 內容網址。
cat 字串陣列 說明內容的 IAB 內容類別。
prodq 整數 製作品質：

0 (預設)：不明
1：專業
2：專業消費者
3：使用者原創

videoquality 整數 不支援。
context 整數 內容類型：

1：影片
2：遊戲
3：音樂
4：應用程式
5：文字
6：其他
7：不明

contentrating 字串 建議用於音訊和影片/連網電視，因為我們將開始根據這項屬性做出決策。
userrating 字串 星級、喜歡次數等。
qagmediarating 整數 依據 [QAG 指南](http://www.iab.net/ne_guidelines) 評估媒體分級。

1：所有目標對象
2：12 歲以上
3：成熟內容
keywords 字串 (csv 格式) 不支援。
livestream 整數 如果內容是直播內容。

0：未直播
1：內容正在直播

sourcerelationship 整數

0：間接
1：直接

len 整數 內容長度 (以秒為單位)。

建議用於連網電視/影片和音訊請求。

language 字串 (ISO-639-1-alpha-2) 內容的語言。
embeddable 整數 指出內容是否可嵌入 (例如可嵌入的影片播放器)

0：無法嵌入
1：可嵌入

data 資料物件陣列 其他資料。

製作人物件

欄位 類型 詳細資料
id 字串 不支援。
name 字串 不支援。
cat 字串陣列 不支援。
domain 字串 生產者的最高層級網域。

資料物件

欄位 類型 詳細資料
id 字串 資料供應商的 ID。
name 字串 資料供應商的交易所名稱。
segment 區隔物件陣列 實際資料值。
ext 資料額外資訊 資料物件的擴充功能。

資料物件支援的擴充功能

欄位 類型 詳細資料
segtax 整數 分類 ID，詳情請參閱「區隔分類」。
segclass 字串 產生分類中區隔 ID 的分類器版本。

區隔物件

欄位 類型 詳細資料
id 字串 資料供應商專屬的資料區隔 ID。
name 字串 資料區隔名稱。
value 字串 資料區隔的值。

發布者物件

欄位 類型 詳細資料
id 字串 必填。
name 字串 不支援。
cat 字串陣列 不支援。
domain 字串 不支援。

裝置物件

欄位 類型 詳細資料
ua 字串 必填。
sua UserAgent 物件 結構化使用者代理程式資訊。
geo 地理區域物件 裝置的位置。
dnt 整數 瀏覽器標頭中設定的「請勿追蹤」旗標。

0：追蹤不受限制
1：請勿追蹤

lmt 整數 商業上認可的「限制廣告追蹤」信號。

0：追蹤不受限制
1：追蹤必須遵守商業指南的限制

ip 字串 如果使用 IPv4，則為必填。

如果 IP 位址遭到截斷，則必須在 device.ext.truncated_ip 中宣告。

ipv6 字串 如果使用 IPv6，則為必填參數。

如果 IP 位址遭到截斷，則必須在 device.ext.truncated_ip 中宣告。

devicetype 整數 強烈建議所有廣告空間類型使用。用於提升裝置類型辨識準確度。
make 字串
model 字串
os 字串 裝置的作業系統。

ios：在應用程式要求中，這會識別 iOS 流量。
android：如果 ua 或 sua 無法識別裝置，則用於識別 Android 裝置。
[anything else]：用於診斷，可找出問題。

這個欄位不區分大小寫。

osv 字串 不支援。
hwv 字串 裝置的硬體版本。
h 整數 螢幕的實際高度 (以像素為單位)。
w 整數 螢幕的實體寬度 (以像素為單位)。
ppi 整數 不支援。
pxratio 雙人床 實體像素與裝置獨立像素的比例。
js 整數 不支援。
geofetch 整數 不支援。
flashver 字串 不支援。
language 字串 (ISO-639-1-alpha-2) 裝置語言。
carrier 字串 不支援。
mccmnc 字串 不支援。
connectiontype 整數 網路連線類型
ifa 字串 廣告主可公開使用的 ID。
didsha1 字串 不支援。
didmd5 字串 不支援。
dpidsha1 字串 不支援。
dpidmd5 字串 不支援。
macsha1 字串 不支援。
macmd5 字串 不支援。
ext 裝置擴充功能 裝置物件的擴充功能。

裝置物件支援的擴充功能

如果 ip 遭到變更或截斷，強烈建議您傳送下列擴充功能，避免流量遭宣告為無效流量。

欄位 類型 詳細資料
truncated_ip 整數 指出出價要求的 device.ip 欄位中的 IP 位址是否遭到截斷。

0：未截斷
1：已截斷

預設為未截斷，如果 IP 位址已截斷，則為必填欄位。

如果未聲明，出價要求可能會歸類為無效流量。

ifa_type 字串 指出 device.ifa 欄位的來源，是裝置本身提供，還是由供應鏈中的發布商或賣方平台產生。

aaid：Android TV
rida：Roku
afai：Amazon Fire
idfa：Apple tvOS
msai：Xbox/Microsoft
dpid：一般裝置平台 ID
ppid：發布商提供的 ID
sspid：SSP 提供的 ID
sessionid：短期工作階段 ID (僅限頻率上限)

attestation_token 字串 (Base64 編碼) 以裝置為基礎的認證權杖，適用於支援該裝置驗證等級的交易。
atts 整數 (僅限 iOS) 傳遞的整數，代表應用程式的應用程式追蹤授權狀態。

0：未確定
1：受限
2：遭拒
3：已授權

cdep 字串 Chrome 淘汰第三方 Cookie 的標籤。

請參閱「 Chrome 協助測試」和「 IAB 社群規格

UserAgent 物件

欄位 類型 詳細資料
browsers BrandVersion 物件陣列 每個 BrandVersion 物件都會識別瀏覽器或類似的軟體元件。
platform BrandVersion 物件 識別平台。
mobile 整數 0 (預設)：代理程式偏好「電腦」或「完整」內容。
1：代理程式偏好「行動版」內容。
architecture 字串 裝置架構，例如「x86」或「arm」。
bitness 字串 裝置的位元數，例如 64 位元架構的「64」。
model 字串 裝置型號。
source 整數 用來建立這個物件的資料來源，請參閱「 清單：User-Agent 來源」。建議在傳遞 UserAgent 物件時使用。

BrandVersion 物件

欄位 類型 詳細資料
brand 字串 品牌 ID，例如「Chrome」或「Windows」。必填。
version 字串陣列 版本元件序列，依階層遞減順序排列 (主要、次要、微型等)。

地理位置物件

欄位 類型 詳細資料
lat 雙人床 不支援。
lon 雙人床 不支援。
type 整數 不支援。
accuracy 整數 不支援。
lastfix 整數 不支援。
ipservice 整數 不支援。
country 字串 不支援。
region 字串 不支援。
regionfips104 字串 不支援。
metro 字串 不支援。
city 字串 不支援。
zip 字串 不支援。
utcoffset 整數 不支援。

使用者物件

欄位 類型 詳細資料
id 字串 如果 Google 代管 ID 對照表，則支援這項功能。
buyeruid 字串 如果賣方平台託管 ID 對照表，則支援這項功能。
yob 整數 建議用於指定客層。
gender 字串 建議用於指定客層。
keywords 字串 (CSV) 不支援。
customdata 字串 不支援。
geo 地理區域物件 不支援。
data 資料物件陣列 其他資料。
eids 擴充 ID 物件陣列 交易所提供的擴充 ID 執行個體。
ext 使用者擴充功能 使用者物件的擴充功能。

使用者物件支援的擴充功能

欄位 類型 詳細資料
consent 字串 (具網路安全性的 Base64) IAB 同意聲明字串。

包含中繼資料，說明使用者同意收集哪些資訊，以及允許哪些供應商使用這些資訊。

這個值是採用自訂二進位格式的網路安全 Base64 編碼二進位字串。
us_privacy 字串 使用者是否已看過《加州消費者隱私法》或類似法律的相關規定。
consented_providers_settings.consented_providers 外部物件 (consented_providers_settings)，包裝內部整數陣列 (consented_providers)。 透過資訊公開和同意聲明架構收集 GDPR 同意聲明時，這個欄位會列出使用者同意的廣告技術供應商，這些供應商並未參與資訊公開和同意聲明架構。請參閱「Google 額外同意聲明技術規格」。
eids 擴充 ID 物件陣列 交易所提供的擴充 ID 執行個體。

擴充 ID 物件

欄位 類型 詳細資料
source 字串 ID 提供者
uids 擴充 ID UID 物件陣列 實際 ID

擴充 ID UID 物件

欄位 類型 詳細資料
id 字串 識別碼本身。
atype 整數 與這個 ID 相關聯的使用者代理程式類型。

供應鏈物件

欄位 類型 詳細資料
complete 整數 0 (預設)：供應鏈不完整。
1：供應鏈已完整回報給發布者。
ver 字串 必填。
值的格式為「major.minor」，例如版本 1.0 的字串為「1.0」。
nodes 供應鏈節點陣列 必填。

在完整的供應鏈中，第一個節點代表交易涉及的初始廣告系統和賣家 ID，也就是網站、應用程式或其他媒介的擁有者。

在不完整的供應鏈中，這代表第一個已知的節點。最後一個節點代表傳送這項出價要求的實體。

供應鏈節點物件

欄位 類型 詳細資料
asi 字串 這是指出價工具連結的賣方平台、廣告交易平台或標頭包裝函式等系統的標準網域名稱。這可能是用來進行 WHOIS 及反向 IP 查詢的系統運作網域 (如果與上層公司網域不同的話)，以便指明委派系統的擁有權。

如果 ads.txt 檔案存在，這個值應與該檔案中用來識別賣家的值相同。
sid 字串 這是指廣告系統內與賣方或經銷商帳戶相關聯的 ID。其中包含的值必須與賣方平台/廣告交易平台指定欄位中交易 (即 OpenRTB 出價要求) 所用的值相同。

如果是 OpenRTB 交易，這個欄位通常包含 publisher.id。 若是 OpenDirect 交易，則大多是發布商的機構組織 ID。

長度應限制在 64 個字元內。

rid 字串 賣方發出的要求 OpenRTB RequestId。
name 字串 公司 (法律實體) 名稱，該公司會透過指定 seller_id 交易的廣告空間營利。

這個值為選填，如果廣告系統的 sellers.json 檔案中已有這個值，請勿填寫。

domain 字串 這個節點代表的實體商家網域名稱。

這個值為選填，如果廣告系統的 sellers.json 檔案中已有這個值，請勿填寫。

hp 整數 指出這個節點是否會參與廣告空間的付款流程。

1：asi 欄位中的廣告系統會向 sid 欄位中的賣方付款，而賣方負責向鏈結中的前一個節點付款。
0：這個節點未參與廣告空間的付款流程。

對於 SupplyChain 1.0 版，這個屬性一律應為 1。因為預期規格的未來版本會導入非付款處理節點，所以必須明確納入。

實作者應確保支援這個欄位，並在傳送至下游廣告系統的出價要求中建構 SupplyChain 物件時，將這個欄位傳播出去。

出價回應規格

BidResponse 物件

屬性 支援 實作詳情 一律通過
id 如果發生剖析錯誤，這可能是「0」，而非出價要求 ID。 是
seatbid
bidid
cur 如果發生剖析錯誤，系統就不會傳遞這項資訊。對於有效的出價要求流量，系統一律會提供 cur。 是
customdata
nbr 只有在出價要求發生問題時，才會顯示這項資訊。可能的值包括：
2：無效要求
12：違反 Ads.txt 授權規定
16：供應鏈不完整
17：供應鏈節點遭到封鎖
注意：如果系統偵測到違反 (app-)ads.txt 或供應鏈的具體情況，部分 (1%) 回應會填入代碼 12、16 或 17。所有其他無效要求都會填入代碼 2。
包含 NBR 的要求看起來會像這樣： 
{
  "id": "0",
  "nbr": 2,
  "ext": {
    "err": "Bid request body was empty.",
    "errHelp": "https://.../ortb-spec"
  }
}
ext 如果出價要求 ext 有問題，可能包含有助於診斷錯誤的資訊 (如支援)。

BidResponse 物件支援的擴充功能

屬性 實作詳情
err

使用者可理解的出價要求錯誤說明。回應案例包括：

  • 出價要求主體為空白。
  • 出價要求使用的幣別不在特定廣告交易平台的允許清單中。
  • 出價要求未包含可接受的 MIME 類型。
errHelp 這個網頁的連結。

Seatbid 物件

屬性 支援 實作詳情 一律通過
出價 是
帳戶名額 是
群組

出價物件

屬性 支援 實作詳情 一律通過
id 是
impid 是
價格 是
nurl
樹瘤
lurl
adm
adid
adomain
bundle
iurl
cid 是
crid 是
策略
cat
attr
api
通訊協定
qagmediarating
language
dealid
w
小時
wratio
hratio
exp

出價物件支援的擴充功能

屬性 實作詳情
apis 如果同時支援 OMID 和 MRAID，DV360 會傳送 seatbid.bid.apis。DV360 會將 OMID_1 和 MRAID 設為整數陣列。

廣告放送選項

OpenRTB 規格的 4.3 節提供兩種不同的放送選項：

  • 在得標通知中放送標記
  • 出價中放送的標記

DV360 支援這兩種方式。

  • 如果是橫幅廣告，DV360 一律會在 adm 欄位中傳回標記。您可以選擇是否在得標通知中放送標記。
  • 對於使用 VAST 通訊協定的影片/音訊廣告，DV360 支援根據交易平台合作夥伴的需求，在 adm 欄位或得標通知的回應中傳回 VAST XML。

請參閱 OpenRTB 規格，瞭解這兩種選項的優缺點。

最佳做法

強烈建議使用 Display & Video 360 的合作夥伴 ID 做為席位 ID。不建議使用交易所專屬的席位 ID。

請確認發布商有 ads.txt 檔案，或應用程式有相關聯的 app-ads.txt 檔案，且檔案中列出您為授權賣方或經銷商。瞭解詳情。

此外，請確保出價要求中傳送的資訊一致。舉例來說，app.bundle 必須與行動裝置資訊和 app.storeurl 一致。

連網電視

傳遞 device.ifa 和 device.lmt 時，請遵守 IAB OTT IFA 指南。此外，您也應導入 device.ext.ifa_type，確保符合相關規範。所有 CTV 展示頻率上限和指定目標對象功能都必須有 IFA 才能運作。

此外，請遵守最近發布的 IAB OTT/連網電視商店指派 ID 規範，其中定義了如何為連網電視應用程式傳遞 app.bundle，主要使用應用程式商店定義的 ID。

Active View 評估

Active View 是 Google 技術，用於評估曝光是否可視，以及可視時間長度。Active View 會對多媒體和影片廣告使用 OMID。如要使用 OMID 啟用評估功能，交易平台必須在 OpenRTB 要求中加入下列欄位，讓 DV360 瞭解用戶端是否支援 OMID。

  • 必要：在競價要求中加入 API 架構 (Video.api=7，適用於 OMSDK)。Active View 必須使用 OMID 才能進行評估，因此這項設定為必要。
  • 建議：Source.Ext中強烈建議在 omidpn 和 omidpv 中加入，因為這會影響 DV360 向客戶回報可視度指標的方式。如果 OMID 合作夥伴名稱未列在 IAB 認證清單中，根據 MRC 規定，我們必須分別回報可視度指標和 MRC 認證指標。瞭解詳情

常見問題

DV360 是否支援廣告交易平台自訂擴充功能？
可以。除了本規格中列出的擴充功能，Display & Video 360 也可能視情況支援自訂擴充功能。建議在整合期間指定及測試自訂擴充功能。
DV360 是否支援獎勵影片？
可以，請將獎勵影片擴充功能傳送給我們。
我的許多廣告空間都顯示為「客層不明」，如何提高客層涵蓋率？
在傳送至 DV360 的出價要求中填入 user.yob 和 user.gender，提高涵蓋範圍。
DV360 是否有每個區域的端點？
否，我們在全球使用單一端點，並會自動將要求傳送至最近的資料中心，因此無法提供特定區域的端點。
伺服器對伺服器 (s2s) 請求有哪些規定？
與我們聯絡，要求將您加入許可清單。必須轉送用戶端 User-Agent，並確保在回應 s2s VAST 擷取時停用/忽略 Cookie。
DV360 是否支援 OMID？
只要在出價要求時聲明啟用 OMID，我們就能使用 OMID 評估可視度。詳情請參閱第 24 至 25 頁。
你們支援哪個版本的 Native？您是否有任何原生需求？
我們只支援原生廣告第 1.2 版。原生廣告規格。
DV360 是否支援以 GZIP 格式傳送的出價要求？
DV360 可以接收以 gzip 壓縮的出價要求，如果 Accept-Encoding 標頭指出支援這類要求，DV360 就會以 gzip 壓縮的回應回覆。
DV360 是否支援 DBURL？
目前還不支援。
DV360 是否支援勝敗通知？
目前無法。如果您認為我們應支援這項功能，請
提供更多詳細資料。
DV360 是否需要 App.name 才能指定目標？
否，DV360 會使用 App.name 做為參考，但指定目標時不需要使用，App.bundle會用於指定目標。
DV360 是否支援在單一出價要求中傳送多個廣告大小？
是的，我們會考量橫幅格式中所有符合資格的廣告素材尺寸。
DV360 是否支援在同一個出價要求中傳送多種格式？
我們對多格式出價要求的支援有限，但正在努力改善。我們支援插頁式廣告的多媒體和影片格式，但目前不支援多媒體和原生格式。如果您傳送多格式出價要求，請提出測試要求。
DV360 是否支援在同一個要求中混用不同類型的曝光？
目前僅支援影片/橫幅插頁式廣告。我們正在開發原生/橫幅和影片/橫幅廣告。如有其他組合，請與我們的團隊聯絡。
在同一個要求中，多個帳戶是否可以針對一或多個這類曝光機會，各自送出多個出價？
是。
針對同一要求中的多個這類曝光機會，DV360 是否有解決方案或特定需求，可限制或顯示同一廣告主的廣告？
DV360 會強制執行一項規定，即每個廣告主針對每個請求，最多只能對一個曝光機會出價。我們希望 SSP 能有意義地將 imp 物件分組，例如全都在同一網頁上、全都在同一應用程式中等。
DV360 是否支援在同一個出價要求中傳送多個曝光？
DV360 目前支援多個曝光音訊物件。不過，我們需要測試/啟用每個想使用這項功能的交易所。詳情請參閱出價要求規格。我們正努力將這項功能擴展到其他格式： 
{
id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38",
seatbid {
bid {
  id: "0",
  impid: "234232",
  price: 41.373926619828261,
  adid: "123",
  adm: "...",
  adomain: "xxx.com",
  cid: "0",
  crid: "123",
  dealid: "sample-deal-id-1",
  language: "xx",
},
bid {
  id: "1",
  impid: "234255",
  price: 2.34192037470726,
  adid: "234",
  adm: "...",
  adomain: "xyz.com",
  cid: "0",
  crid: "234",
  dealid: "sample-deal-id-2",
  language: "xx",
},
seat: "123456"
},
cur: "EUR"
}

與我們聯絡

如有任何問題或疑慮，請聯絡交易所支援團隊。