请参阅宏的相关详情(包括它们在 Ad Manager 中的运作方式,以及呈现宏、跟踪宏和其他视频宏的完整列表)。
您可以通过下方列表中的链接跳转至特定宏
广告请求宏
此处显示的广告请求宏只能用在视频点播内容来源或直播视频流的动态广告插播广告代码 (DAI) 中。它们不适用于 VAST 广告素材。
带方括号的宏通常必须顺利通过 Ad Manager 宏验证才能进行重定向。
宏 |
---|
[APIFRAMEWORKS] |
sdk_apis 参数。
宏 |
---|
[APPBUNDLE] |
一个参数。
宏 |
---|
%%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 Feed 中显示,但会在 Ad Manager 界面中显示。
宏 |
---|
[DOMAIN] |
VAST 4.1 宏。视频流创建引荐网址的域名。
宏 |
---|
%%FW_CAID %% |
仅限 VOD - MRSS Feed 中的 FreeWheel 自定义素材资源 ID
宏 |
---|
%%GDPR%% |
gdpr 参数。
宏 |
---|
[GDPRCONSENT] |
gdpr_consent 参数。
宏 |
---|
[GOOGLE_INSTREAM_VIDEO_NONCE] |
givn 参数。
宏 |
---|
[IFA] |
从 rdid 参数中提取的可重置广告 ID。仅当隐私标志(例如 tfcd 和 is_lat)允许时,系统才会将广告 ID 传递给主要广告请求。
宏 |
---|
[IFATYPE] |
DAI idtype 参数。仅当隐私标志(例如 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 宏 - 用于关联发起端的广告请求链的标识符。
宏 |
---|
%%US_PRIVACY%% |
会展开为 us_privacy
参数的值。
宏 |
---|
%%USER_AGENT%% |
[DEVICEUA] |
向最终用户呈现广告的设备的用户代理。
[DEVICEUA]
宏会提供预期的功能。宏 |
---|
%%USER_IP%% |
[DEVICEIP] |
[IP_ADDRESS] |
会展开为用户的 IP 地址。
[IP_ADDRESS]
只能用于不允许使用 %%USER_IP%%
的 Ad Manager 重定向。
宏 |
---|
%%VIDEO_DURATION%% |
仅限 VOD - 视频时长(以毫秒为单位),来自 MRSS Feed。
宏 |
---|
%%VIDEO_DURATION_SEC%% |
会展开为视频的时长(以秒为单位)。
宏 |
---|
%%VIDEO_ID%% |
仅限 VOD - 来自 MRSS Feed 的 CMS Content ID。
宏 |
---|
%%VIDEO_TITLE%% |
仅限 VOD - 来自 MRSS Feed 的视频标题。
VAST 跟踪宏
[CACHEBUSTING]
和 [ERRORCODE]
这两个宏都遵循 VAST 4.0 规范(请参阅“2.3.7 宏”部分)。
宏 |
---|
[CACHEBUSTING] |
会展开为一个 8 位随机数。
宏 |
---|
[ERRORCODE] |
会展开为 VAST 错误代码。