進一步瞭解巨集 (包括巨集與 Ad Manager 搭配運作的方式)，以及顯示、追蹤和其他影片巨集的完整清單。
跳至清單中的特定巨集
廣告請求巨集
這裡顯示的廣告請求巨集僅適用於隨選影片內容來源或直播活動的動態廣告插播廣告代碼 (DAI)。這類巨集不適用於 VAST 廣告素材。
如要通過 Ad Manager 巨集驗證以進行重新導向，通常需要方括號巨集。
| 巨集 |
|---|
[APIFRAMEWORKS] |
sdk_apis 參數。
| 巨集 |
|---|
[APPBUNDLE] |
an 參數。
| 巨集 |
|---|
%%ASSET_KEY%% |
這會展開成直播活動代碼。
| 巨集 |
|---|
[BREAKPOSITION] |
VAST 4.1 巨集。傳回值：
1：片頭廣告2：片中廣告
3：片尾廣告
4：獨立廣告
0：不屬於上述/其他
| 巨集 |
|---|
%%BREAK_DURATION%% |
[BREAKMAXDURATION] |
目前廣告插播長度 (以秒為單位)。
[BREAKMAXDURATION] 只適用於不允許使用 %%BREAK_DURATION%% 的 Ad Manager 重新導向。
| 巨集 |
|---|
[CACHEBUSTING] |
隨機數字。
| 巨集 |
|---|
[CLIENTUA] |
用戶端使用的播放器和 VAST ID。
| 巨集 |
|---|
%%CMS_ID%% |
這會展開成目前播放中的 Ad Manager 內容來源 ID (「CMS ID」)。這個值不會出現在 MRSS 動態饋給中，但會顯示在 Ad Manager 介面中。
| 巨集 |
|---|
[DOMAIN] |
VAST 4.1 巨集。串流建立參照網址的網域。
| 巨集 |
|---|
%%FW_CAID%% |
僅限隨選影片 - 來自 MRSS 動態饋給的 FreeWheel 自訂廣告素材資源 ID
| 巨集 |
|---|
%%GDPR%% |
GDPR 參數。
| 巨集 |
|---|
[GDPRCONSENT] |
gdpr_consent 參數。
| 巨集 |
|---|
[GOOGLE_INSTREAM_VIDEO_NONCE] |
指定參數。
| 巨集 |
|---|
[IFA] |
取自 RDID 參數的可重設廣告 ID。只有在隱私權標記 (例如 tfcd 和 is_lat) 允許時，廣告 ID 才會傳送到主要廣告請求。
| 巨集 |
|---|
[IFATYPE] |
DAI ID 類型參數。只有在隱私權標記 (例如 tfcd 和 is_lat) 允許時，IFA 類型才會傳送到主要廣告請求。
| 巨集 |
|---|
[LIMITEDTRACKING] |
LTD 參數。
| 巨集 |
|---|
[MEDIAMIME] |
VAST 4.1 巨集：以半形逗號分隔的支援媒體 MIME 類型清單。
| 巨集 |
|---|
[OMIDPARTNER] |
VAST 4.1 巨集：omid_p 參數。
| 巨集 |
|---|
[PAGEURL] |
VAST 4.1 巨集：串流建立參照網址。
| 巨集 |
|---|
[REGULATIONS] |
VAST 4.1 巨集：以半形逗號分隔的清單，根據參數列出適用規範。如果 tfcd=1，系統會新增「coppa」，如果 gdpr=1，系統會新增「gdpr」。
| 巨集 |
|---|
[SERVERSIDE] |
| 巨集 |
|---|
%%SPLICE_INSERT_EVENT_ID%% |
%%SPLICE_INSERT_UPID%% |
%%TIME_SIGNAL_EVENT_ID%% |
%%TIME_SIGNAL_UPID%% |
%%TIME_SIGNAL_UPID_RAW%% |
%%AFMM_CBC%% |
這會展開成 SCTE-35 信號。
| 巨集 |
|---|
%%STREAM_ID%% |
這會展開成目前播放中的內容來源工作階段串流 ID。
| 巨集 |
|---|
%%TFCD%% |
展開為 tfcd 參數的值。
| 巨集 |
|---|
%%TFUA%% |
tfua 參數。
| 巨集 |
|---|
[TIMESTAMP] |
VAST 4.0 巨集 - 目前的時間戳記，採用 ISO 8601 格式。
| 巨集 |
|---|
[TRANSACTIONID] |
VAST 4.1 巨集：用於將來源端的廣告請求鏈結起來的 ID。
| 巨集 |
|---|
%%US_PRIVACY%% |
展開為 us_privacy 參數的值。
| 巨集 |
|---|
%%USER_AGENT%% |
[DEVICEUA] |
向使用者顯示廣告的裝置上的使用者代理程式。
[DEVICEUA] 巨集可提供預期的功能。| 巨集 |
|---|
%%USER_IP%% |
[DEVICEIP] |
[IP_ADDRESS] |
這會展開成使用者 IP 位址。
[IP_ADDRESS] 只適用於不允許使用 %%USER_IP%% 的 Ad Manager 重新導向。
| 巨集 |
|---|
%%VIDEO_DURATION%% |
僅限隨選影片：來自 MRSS 動態饋給的影片長度 (以毫秒為單位)。
| 巨集 |
|---|
%%VIDEO_DURATION_SEC%% |
這會展開成影片長度 (以秒為單位)。
| 巨集 |
|---|
%%VIDEO_ID%% |
僅限隨選影片 - 來自 MRSS 動態饋給的 CMS 內容 ID。
| 巨集 |
|---|
%%VIDEO_TITLE%% |
僅限隨選影片 - 來自 MRSS 動態饋給的影片標題。
VAST 追蹤巨集
[CACHEBUSTING] 和 [ERRORCODE] 巨集均符合 VAST 4.0 規格 (請參閱「2.3.7 Macros」)。
| 巨集 |
|---|
[CACHEBUSTING] |
這會展開成 8 位隨機數字。
| 巨集 |
|---|
[ERRORCODE] |
這會展開成 VAST 錯誤代碼。
