通知

仅在 Google Ad Manager 360 中提供。

动态广告插播宏

请参阅宏的相关详情(包括它们在 Ad Manager 中的运作方式,以及呈现宏、跟踪宏和其他视频宏的完整列表)。

全部展开  全部收起

广告请求宏

此处显示的广告请求宏只能用在视频点播内容来源直播视频流动态广告插播广告代码 (DAI) 中。它们不适用于 VAST 广告素材。

带方括号的宏通常必须顺利通过 Ad Manager 宏验证才能进行重定向。

API 框架
 
[APIFRAMEWORKS]
 

sdk_apis 参数。

 
app bundle
 
[APPBUNDLE]
 

一个参数。

素材资源键
 
%%ASSET_KEY%%
 

会展开为直播活动代码。

广告插播位置
 
[BREAKPOSITION]
 

VAST 4.1 宏。返回如下值:

1:对于前贴片广告
2:对于中贴片广告
3:对于后贴片广告
4:对于独立广告
0:不属于上述任何一种/其他
广告插播时长上限
 
%%BREAK_DURATION%%
[BREAKMAXDURATION]
 

当前广告插播时长(以秒为单位)。

[BREAKMAXDURATION] 只能用于不允许使用 %%BREAK_DURATION%% 的 Ad Manager 重定向。

缓存无效化
 
[CACHEBUSTING]
 

一个随机数字。

客户端 ID
 
[CLIENTUA]
 

所用播放器和 VAST 客户端的 ID。

CMS ID
 
%%CMS_ID%%
 

会展开为当前正在播放的 Ad Manager 内容来源 ID(“CMS ID”)。此值不会在您的 MRSS Feed 中显示,但会在 Ad Manager 界面中显示。

网域
 
[DOMAIN]
 

VAST 4.1 宏。视频流创建引荐网址的域名。

FW CAID
 
%%FW_CAID%%
 

仅限 VOD - MRSS Feed 中的 FreeWheel 自定义素材资源 ID

GDPR
 
%%GDPR%%
 

gdpr 参数。

依照 GDPR 征求用户意见
 
[GDPRCONSENT]
 

gdpr_consent 参数。

Google 插播视频广告 Nonce
 
[GOOGLE_INSTREAM_VIDEO_NONCE]
 

givn 参数。

IFA
 
[IFA]
 

从 rdid 参数中提取的可重置广告 ID。仅当隐私标志(例如 tfcd 和 is_lat)允许时,系统才会将广告 ID 传递给主要广告请求。

IFA 类型
 
[IFATYPE]
 

DAI idtype 参数。仅当隐私标志(例如 tfcd 和 is_lat)允许时,系统才会将 IFA 类型传递给主要广告请求。

限制跟踪
 
[LIMITEDTRACKING]
 

ltd 参数。

媒体 MIME
 
[MEDIAMIME]
 

VAST 4.1 宏:支持的媒体 MIME 类型的逗号分隔列表。

非个性化广告
 
%%NPA%%
 

会展开为数值 1,以将请求标记为非个性化广告请求。

此宏用于受 GDPR 约束的广告请求,并且只能在动态广告插播广告代码中使用。查看其他与 GDPR 有关的宏

OMID 合作伙伴
 
[OMIDPARTNER]
 

VAST 4.1 宏:omid_p 参数。

网页网址
 
[PAGEURL]
 

VAST 4.1 宏:视频流创建引荐网址。

展示位置类型
 
[PLACEMENTTYPE]
 

VAST 4.1 宏:对于 DAI,其值始终为 1(插播广告)。

请参阅 AdCOM 展示位置子类型视频

法规
 
[REGULATIONS]
 

VAST 4.1 宏:根据参数列出的适用法规的逗号分隔列表。若 tfcd=1,则会添加“coppa”;若 gdpr=1,则会添加“gdpr”。

服务器端
 
[SERVERSIDE]
  VAST 4.1 宏 - 始终为 1。
SCTE-35
 
%%SPLICE_INSERT_EVENT_ID%%
%%SPLICE_INSERT_UPID%%
%%TIME_SIGNAL_EVENT_ID%%
%%TIME_SIGNAL_UPID%%
%%TIME_SIGNAL_UPID_RAW%%
%%AFMM_CBC%%
 

会展开为 SCTE-35 信号

流 ID
 
%%STREAM_ID%%
 

会展开为当前正在播放的内容来源的会话流 ID

TFCD
 
%%TFCD%%
 

会展开为 tfcd 参数的值。

TFUA
 
%%TFUA%%
 

tfua 参数。

时间戳
 
[TIMESTAMP]
 

VAST 4.0 宏 - 采用 ISO 8601 格式的当前时间戳。

交易 ID
 
[TRANSACTIONID]
 

VAST 4.1 宏 - 用于关联发起端的广告请求链的标识符。

美国隐私设置
 
%%US_PRIVACY%%
 

会展开为 us_privacy 参数的值。

用户代理
 
%%USER_AGENT%%
[DEVICEUA]
 

向最终用户呈现广告的设备的用户代理。

对于 VAST 重定向,只有 [DEVICEUA] 宏会提供预期的功能。
用户 IP 地址
 
%%USER_IP%%
[DEVICEIP]
[IP_ADDRESS]
 

会展开为用户的 IP 地址。

[IP_ADDRESS] 只能用于不允许使用 %%USER_IP%% 的 Ad Manager 重定向。

视频时长
 
%%VIDEO_DURATION%%
 

仅限 VOD - 视频时长(以毫秒为单位),来自 MRSS Feed。

视频时长(以秒为单位)
 
%%VIDEO_DURATION_SEC%%
 

会展开为视频的时长(以秒为单位)。

视频 ID
 
%%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 错误代码。

对于与 DAI 问题排查或服务中断相关的任何问题,请与发布商支持团队联系

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
主菜单
18290763328129572105
true
搜索支持中心
true
true
true
true
true
148
false
false