您可以選擇提供下列任何一個指定目標參數。
在建立或設定隨選影片 (VOD) 內容來源,或者為動態廣告插播設定直播活動時,您需要指定預設的影片廣告代碼。所有 DAI 串流都會預設使用這個廣告代碼及其參數。廣告代碼參數同時適用於片中廣告和片頭廣告。如果希望播放器針對特定的串流提出特別要求,可以使用這些選項來設定。
可覆寫的 Ad Manager 廣告代碼參數
跳至特定的參數:
addtl_consent an ciu_szs cust_params description_url gdpr gdpr_consent idtype is_lat |
iu ltd mpt mpv npa ppid ptpl ptpln rdid |
rdp sid sz tfcd trt vconp vpa vpmute wta |
覆寫預設廣告代碼
當影片播放器請求串流時,預設廣告代碼會用於您在使用者介面中所指定的目的。不過,您可以在串流請求中覆寫該代碼的某些參數。您只能覆寫下列參數。
瞭解如何使用 IMA SDK 或使用 SSB 覆寫預設廣告代碼。
參數 | 說明 | 範例值 | |
---|---|---|---|
iu |
目前的廣告單元。 格式如下: |
iu=/6062/video/example_unit |
|
cust_params |
應該用於 Ad Manager 廣告活動指定目標的鍵/值組合。有些平台需要進行網址編碼。 使用適用於 HTML5 的 IMA DAI SDK 時,則不需要進行網址編碼,因為系統會自動對該值進行編碼。如果這個參數已在 HTML5 上編碼,就會無法運作。 |
具有多個鍵/值組合的範例如下:
SSB 串流:編碼並串連整個
Chromecast:
Roku:編碼並串連整個
Android:不將任何部分編碼。
|
|
sz |
只要覆寫預設廣告代碼中的 請勿在大小後面加上「 |
sz=400x300 |
|
tfcd |
替廣告請求設定兒童導向內容標記。 當動態廣告插播請求包含 |
|
|
這個值應描述網頁上播放的影片。這可以是目前內嵌影片播放器的網頁,也可以是含有影片說明文字的網頁。 IMA SDK 不會自動設定這個參數,您必須手動設定。 |
經過網址編碼的例子: 未經編碼的例子: |
||
ppid |
發布商提供的 ID (PPID) 可由發布商傳送給系統,以便用於設定展示頻率上限、目標對象區隔和指定目標、廣告依序輪播,以及其他以目標對象為基礎的跨裝置廣告放送控制項。瞭解詳情 | ppid= |
|
ciu_szs |
用英文逗號隔開的隨播廣告大小清單。 只有使用 HTML5 SDK 時,DAI 才支援隨播廣告。 |
ciu_szs=728x90,300x250 |
|
mpt |
指出合作夥伴播放器的名稱。這大多會由與 SDK 整合的合作夥伴 (例如 JWPlayer、Brightcove、Ooyala 等) 使用。 |
mpt=JWPlayer |
|
mpv |
指出合作夥伴播放器的版本。此參數是用來表示與 SDK 整合的合作夥伴播放器版本,應與 |
mpv=2.1 |
|
ptpl |
廣告時段範本 ID。
您在 Ad Manager 介面中查看廣告插播範本的設定時,可以在 Ad Manager 網址中找到這個 ID。這會顯示為 |
ptpl=1234 |
|
ptpln |
廣告時段範本名稱。這對應於 Ad Manager 中的「名稱」欄位,而不是顯示名稱。
|
ptpln=my_break_template |
|
an |
由於大部分的程式輔助影片廣告都需要這個參數,因此這個參數應該用於從行動應用程式和連網電視裝置發出的請求。* IMA SDK 會自動填入這個參數,但您必須使用 DAI API 和 SSB (非 SDK 環境) 手動指定。 * 雖然應用程式名稱應採用使用者可理解的形式,但在 iOS 和 tvOS 中,SDK 無法存取 9 位數的 App Store ID。在這些情況下,SDK 會透過 |
|
|
ltd |
指出是否要讓發布商在未取得 Cookie 或其他本機 ID 的使用同意聲明下,以受限的方式放送廣告。瞭解詳情 | ltd=1 |
|
rdid |
針對原生應用程式 (一般網站和行動版網站不適用),SDK 會將用於指定使用者的可重設裝置 ID 傳入您的串流請求,使用的參數包括 rdid 、idtype 和 is_lat 。在 SSB 串流中,您必須以明確的參數形式傳遞這些參數,就跟在用戶端影片廣告解決方案請求中一樣。
|
查看可重設裝置 ID 的詳細例子。 | |
trt |
將流量指定為購買的流量或其他類型。 |
未定義的流量類型: 購買的流量類型: 自然流量類型: |
|
aconp |
建議依據:MRC影片評估指南
指出播放器是否打算連續播放一組內容影片,類似電視節目。 如果連續播放為「開啟」,則可能的值為 如果狀態不明,請勿設定這個參數。 |
連續播放「開啟」:vconp=2 連續播放「關閉」: |
|
vpa |
建議依據:MRC影片評估指南
指出廣告是自動播放還是點擊後才開始播放。 如果頁面會等待使用者動作,則可能的值為 如果狀態不明,請勿設定這個參數。 |
自動播放:vpa=auto 點擊: |
|
vpmute |
建議依據:MRC影片評估指南
指出開始播放廣告影片時,播放器是否設為靜音。 如果設為靜音,可能的值為 如果狀態不明,請勿設定這個參數。 |
已靜音:vpmute=1 已取消靜音: |
|
npa |
廣告請求的個人化設定。建議您及早在代碼中指定這個參數,以免網址遭到截斷。
只要指定 |
npa=1 |
|
gdpr gdpr_consent |
這些欄位是用來透過內送和外寄的 Cookie 同步請求傳遞「資訊公開和同意聲明架構第 2.0 版」同意聲明資訊。 |
請參閱 GDPR 規格。 |
|
addtl_consent |
已獲得使用者同意但未註冊 IAB 的 Google 廣告技術供應商清單。 |
請參閱額外同意聲明規格。 |
|
rdp |
您必須特別設定 |
|
|
sid |
這種類型的廣告 ID 可保障隱私權,且只能用於設定展示頻率上限。根據 IAB 的 IFA 指南,這個參數應以 UUID 格式填入。瞭解詳情 如要停止傳遞工作階段 ID,您可以設定 |
|
|
wta |
代表影片播放器是否支援顯示「為什麼會顯示這則廣告?」。 使用 IMA SDK 時,系統會自動支援這項功能。如果不使用 IMA SDK,影片播放器就必須導入 VAST SSB 不支援 WTA。 如果您使用 Ad Exchange,就必須填寫這個欄位。瞭解詳情 * 除了連網電視裝置以外,不需要支援 |
支援: 不支援: |
使用 IMA SDK 覆寫預設廣告代碼
影片播放器使用 IMA SDK 請求 DAI 串流時,可能會傳遞稱為「adTagParameters
」的欄位。您可以使用鍵/值組合來設定這個類似字典的結構,並使用上表所列的 Ad Manager 廣告代碼參數做為其中的鍵。
adTagParameters
欄位的導入方式因程式語言或平台而稍有不同。詳情請參閱 iOS、Android、tvOS、Chromecast、HTML5 開發說明文件,或 DAI 播放器和應用程式開發指南中的其他說明文件。
透過 SDK 設定 adTagParameters
您在 iOS、tvOS 和 Android 應用程式中透過 SDK 設定 cust_params
或 description_url
時,不應將字串進行網址編碼。您在傳遞 cust_params
時,可以使用「&
」將所有鍵/值組合串連成單一字串。
舉例來說,如果要將 cust_params
的值設為 sport=football&city=newyork
:
使用未編碼值的 adTagParams
結構會是:
{
"tfcd": 1,
"iu": "/987654321/path/to/adunit",
"cust_params": "sport=football&city=newyork",
"description_url": "http://www.sample.com/golf.html",
"ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
使用適用於 HTML5 串流請求編碼值的 adTagParameters
結構會是:
{
"tfcd": 1,
"iu": "/987654321/path/to/adunit",
"cust_params": "sport%3Dfootball%26city%3Dnewyork",
"description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
"ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
使用適用於 Roku 串流請求編碼值的 adTagParams
結構會是:
request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"
使用 DAI API 覆寫預設廣告代碼 (Beta 版)
當影片播放器使用 DAI API 請求動態廣告插播串流時,可以選擇傳遞鍵/值組合,並使用上表所列的 Ad Manager 廣告代碼參數做為其中的鍵。
這些參數應包含在 HTTP POST 要求主體中一併傳送,並且無論是線性/直播和 VOD,格式類型都必須為 application/x‑www‑form‑urlencoded
。
請參閱 DAI API 導入範例。
使用 SSB 覆寫預設廣告代碼
以下是 SSB 預設 VOD 廣告代碼的修改範例。被覆寫的播放器或應用程式傳遞參數會醒目顯示。
隨選影片範例 |
示例 | |
---|---|
基礎 VOD 串流網址 | http://dai.google.com/ondemand/hls/content/ |
(包含指定的廣告單元) | http://dai.google.com/ondemand/hls/content/ |
(包含被覆寫的 鍵/值) |
http://dai.google.com/ondemand/hls/content/ |
(包含兒童導向內容 宣告) |
http://dai.google.com/ondemand/hls/content/ |
(同時包含被覆寫的廣告單元、鍵/值、 自訂 description_url 以及兒童導向內容宣告) |
http://dai.google.com/ondemand/hls/content/ |
直播線性串流例子 |
示例 | |
---|---|
基礎直播線性串流網址 | https://dai.google.com/linear/hls/event/<asset_key> |
(包含指定的廣告單元) | https://dai.google.com/linear/hls/event/<asset_key> |
(包含被覆寫的鍵/值) | https://dai.google.com/linear/hls/event/<asset_key> |
(包含兒童導向內容 宣告) |
https://dai.google.com/linear/hls/event/<asset_key> |
(同時包含被覆寫的廣告單元、鍵/值、 自訂 description_url 以及兒童導向內容宣告) |
https://dai.google.com/linear/hls/event/<asset_key> |
在特定的直播內容中動態更新指定目標參數
您可以使用 IMA DAI SDK 中的replaceAdTagParameters 方法,在特定使用者觀看串流內容的過程中,動態更新該使用者的指定資料。