VAST 标签
XML 示例
<?xml version="1.0" encoding="UTF-8"?>
<VAST version="3.0">
<Ad id="1111111">
<InLine>
<AdSystem>Exoclick</AdSystem>
<AdTitle/>
<Impression id="exotr">
<![CDATA[https://syndication.myadserver.com/vregister.php?a=vimp&tracking_event=impression&idzone=22222&data=abcd]]></Impression>
<Error>
<![CDATA[https://syndication.myadserver.com/vregister.php?a=vview&errorcode=[ERRORCODE]&idzone=22222]]></Error>
<Creatives>
<Creative sequence="1" id="12345">
<Linear skipoffset="00:00:05">
<Duration>00:00:20.54</Duration>
<TrackingEvents>
<Tracking id="prog_1" event="progress" offset="00:00:10.000">
<![CDATA[https://syndication.myadserver.com/vregister.php?a=vview&tracking_event=progress&progress=00:00:10.000&idzone=22222&data=abcd]]></Tracking>
</TrackingEvents>
<VideoClicks>
<ClickThrough>
<![CDATA[https://syndication.myadserver.com/click.php?data=abcd]]></ClickThrough>
</VideoClicks>
<MediaFiles>
<MediaFile delivery="progressive" type="video/mp4">
<![CDATA[https://static.myadserver.com/library/12345/myvideo.mp4]]></MediaFile>
</MediaFiles>
<Icons>
<Icon>
<IconClicks>
<IconClickThrough>exoclick.com</IconClickThrough>
</IconClicks>
</Icon>
</Icons>
</Linear>
</Creative>
</Creatives>
<Extensions>
<Extension>
<TitleCTA>
<MobileText>View More</MobileText>
<PCText>View More</PCText>
<DisplayUrl><![CDATA[]]></DisplayUrl>
<Tracking><![CDATA[https://syndication.myadserver.com/click.php?data=abcd]]></Tracking>
</TitleCTA>
</Extension>
<Extension>
<DSA>
<Behalf>Exoclick SL</Behalf>
<Paid>Exoclick SL</Paid>
<WhyThisAd>The time of day. Your general location (e.g. country or region). Websites or apps you may have visited.</WhyThisAd>
<ClickThrough>
<![CDATA[ https://a.magsrv.com/about-this-ad.html?data=eyJhZHZlcnRpc2VyX25hbWUiOiJFeG9jbGljayBTTCJ9 ]]>
</ClickThrough>
</DSA>
</Extension>
</Extensions>
</InLine>
</Ad>
</VAST>
属性
选项 | 说明 |
---|---|
<?xml version="1.0" encoding="UTF-8"?> | 已定义版本和编码的 XML 序言。 |
Ad | 代表单个广告的广告根元素。它包含视频播放器显示和跟踪广告创意所需的所有信息。 ***广告 "id "属性代表竞价广告系列 ID。 |
在线 | 元素,其中包含播放和跟踪广告所需的所有文件和 URI。 |
广告系统 | 元素,包含广告服务系统的描述性名称,每个广告服务方都必须提供。 |
广告标题 | **未提供。 |
印象 | 包含广告印象跟踪 URI 的元素。印象 id 属性表示该印象的广告服务器 id。 |
错误 | 元素,该元素包含一个 URI,当广告播放出现错误时,播放器会使用该 URI 通知广告服务器。如果 URI 包含一个 [ERRORCODE] 宏,视频播放器必须用错误代码填充该宏。 |
创意 | 一个或多个 的容器元素。<Creative> 元素的容器元素。对于 InLine 广告,<Creatives> 元素嵌套了执行和跟踪广告所需的所有文件。 |
创意 | 每个元素都包含嵌套元素,这些嵌套元素使用 "线性 "或 "非线性 "广告的嵌套子元素来描述所提供的广告类型。Exoclick 只为每个 VAST 响应提供一个<Creative> 元素。创意 "序列 "属性表示序列,因此对于单个创意值,"序列 "将为 1。Exoclick 创意 id 属性表示获胜创意 ID。 |
线性 | 设置在流媒体内容中线性播放的视频格式广告,即在流媒体内容之前、中场休息期间或流媒体内容之后播放。线性广告创意至少要包含<Duration> 元素来传达预期的运行时间,以及一个 <MediaFiles> 元素,用于提供执行广告所需的视频文件。Exoclick 还提供 "TrackingEvents"(跟踪事件)、"VideoClicks"(视频点击)和 "Icons"(图标)(可选)。线性 skipoffset 属性可确定何时向最终用户提供跳过控件。 |
持续时间 | 元素,用于表示广告线性部分的预期播放时长。时间值的格式可以是 HH:MM:SS 。 |
媒体文件 | 元素的容器元素。<MediaFile> 元素的容器元素,每个元素都包含一个 CDATA 封装 URI,指向要下载或流式传输的线性创意媒体文件。线性创意通常是视频文件,但也可以使用静态图像。Exoclick 仅支持单个媒体文件 ,不支持跨设备或不同比特率的媒体文件。 |
媒体文件 | 元素包含所提供媒体文件的 URI。媒体文件 delivery 属性 - 用于渐进下载协议(如 HTTP)的 progressive 或用于流媒体协议的 streaming 。媒体文件 type 属性 - 文件容器的 MIME 类型,如 MP4 的 video/mp4 。 |
视频点击 | 元素,用于指定如果用户在显示广告时直接点击视频播放器框架内的广告,视频播放器应该做什么。当提供<VideoClicks> 元素时,该元素包含一个子元素 <ClickThrough> 元素(或 <ClickTracking> 元素)。 |
点击通过 | 是一个点击 URI,当广告浏览者点击广告时会重定向到广告商的网站。点击直通 "仅适用于 "InLine "格式,在线性广告单元无法处理点击直通时使用。 |
跟踪事件 | 元素用于向广告服务器发送跟踪信息。该<TrackingEvents> 元素可包含一个或多个 <Tracking> 元素。元素的事件属性<Tracking> 元素的事件属性使广告服务器能够为其希望跟踪的事件包含单独的跟踪 URI。跟踪 "事件 "属性 - Exoclick 为 "印象"、"进展 "和 "完成 "做好了准备,但在大多数情况下只返回 "进展"。跟踪 offset 属性--当线性创意的进度符合指定值时,包含的 URI 将被触发。如果偏移设置为百分比值时不知道持续时间,进度事件可能会被忽略。 |
图标 | 用于与线性广告一起发布图标。Exoclick 只在图标下提供一个图标。可以通过在 RTB 请求中设置 imp.ext.icons_support = 0 来禁用它。 |
图标 | 元素包含 <IconClicks> 元素。 |
图标点击 | 用于在新窗口中加载信息页面以及跟踪用户点击广告时间的元素。 |
图标点击穿越 | 元素包含信息页面的 URI。当用户点击图标时,视频播放器必须在新窗口中加载该页面。 |
扩展名 | 用于自定义扩展的元素,由广告服务器定义。它必须包含<Extension> 元素。 |
扩展 | 每个自定义功能的元素用途 |
标题CTA | 自定义元素支持 CTA,它包含以下元素:<MobileText> , <PCText> , <DisplayUrl> , <Tracking> . |
移动文本/PCText | 元素包含 CTA 文本,如 "查看更多 "或 "立即订阅"。 |
显示位置 | 可选择友好域名。 |
跟踪 | 点击跟踪 URI。在 Exoclick 上,可以通过在 RTB 请求中设置发送 imp.ext.video_cta = 0 来禁用它。 |
DSA | Custom element to support DSA, it has following elements: <Behalf> , <Paid> , <WhyThisAd> , <ClickThrough> . The Digital Service Act disclaimer. |
一半 "和 "已付 | 为此广告付费的广告商名称 |
为什么要做这个广告 | 收集到的具体用户信息 |
点击进入 | Additional information related to DSA |