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>查看更多</MobileText>
                        <PCText>查看更多</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>一天中的时间。您的大致位置（例如国家或地区）。您可能访问过的网站或应用。</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 声明。
广告	广告的根元素，表示一个单独的广告。它包含视频播放器显示和跟踪广告创意所需的全部信息。 由于这是一种常见做法，Exoclick 目前在每个 VAST 响应中仅支持一个广告。 Ad 的“id”属性表示竞价活动 ID。
内联	包含播放和跟踪广告所需的所有文件和 URI 的元素。
广告系统	包含提供广告的系统描述性名称的元素，每个广告投放方都必须提供。
广告标题	未提供。
曝光	包含该广告曝光跟踪 URI 的元素。曝光 id 属性表示该曝光的广告服务器 ID。
错误	包含一个 URI，当广告播放发生错误时播放器使用它通知广告服务器。如果 URI 包含 [ERRORCODE] 宏，视频播放器必须用错误代码填充该宏。
创意	一个或多个的容器元素 <Creative> 用于为广告提供创意文件的元素。对于 InLine 广告， <Creatives> 元素会嵌套执行和跟踪广告所需的所有文件。
创意	每个元素都包含嵌套元素，这些元素使用以下嵌套子元素来描述所投放广告的类型： 线性 或 非线性 广告。Exoclick 仅提供一个 <Creative> 每个 VAST 响应仅提供一个元素。Creative sequence 属性表示序列，因此对于单个创意，其“sequence”值为 1。Exoclick Creative id 属性表示获胜创意 ID。
线性	用于设置以线性方式在流媒体内容中播放的视频格式广告，这意味着在流媒体内容之前、在中途间歇期间或在流媒体内容之后播放。Linear 创意至少必须包含 <Duration> 元素，用于传达预期运行时长，以及一个 <MediaFiles> 元素，用于提供广告执行所需的视频文件。Exoclick 还提供 TrackingEvents, VideoClicks 和 Icons （可选）。Linear skipoffset 属性标识何时向最终用户提供跳过控件。
时长	用于表示广告 Linear 组件的预期播放时长。时间值的格式为 HH:MM:SS.
媒体文件	一个或多个的容器元素 <MediaFile> 元素，每个都包含一个 CDATA 包装的 URI，指向要为 Linear 创意下载或流式传输的媒体文件。Linear 创意通常是视频文件，但也可以使用静态图像。Exoclick 仅支持单个 媒体文件 ，不支持跨设备或不同比特率的 MediaFile。
媒体文件	元素包含所投放媒体文件的 URI。MediaFile delivery 属性 - 取值为 progressive 用于渐进式下载协议（如 HTTP），或 streaming 用于流式协议。MediaFile type 属性 - 文件容器的 MIME 类型，例如 video/mp4 ，用于 MP4。
VideoClicks	用于指定当广告显示时，如果用户直接在视频播放器框架内点击，视频播放器应执行什么操作的元素。当提供 <VideoClicks> 元素时，它包含一个子 <ClickThrough> 元素，其中包含 URI（或 <ClickTracking> 在 Wrapper 情况下）。
点击跳转	这是一个点击 URI，当广告观看者点击广告时会重定向到广告主网站。 clickthrough 仅可在 内联 格式中使用，并在线性广告单元无法处理点击跳转时使用。
TrackingEvents	用于将跟踪信息发送回广告服务器的元素。 <TrackingEvents> 元素可能包含一个或多个 <Tracking> 元素。 <Tracking> 的 event 属性使广告服务器能够为其想跟踪的事件包含单独的跟踪 URI。Tracking 的“event”属性 - Exoclick 已准备好处理 曝光, 进度, 完成，但在大多数情况下只返回 进度 。Tracking offset 属性 - 当 Linear 创意的进度达到指定值时，会触发所包含的 URI。如果在将 offset 设置为百分比值时尚未知晓时长，则 progress 事件可能会被忽略。
Icons	用于在线性广告中投放图标。Exoclick 在 Icons 下仅提供一个 Icon。可通过设置 imp.ext.icons_support = 0 在 RTB 请求中禁用它。
图标	包含 <IconClicks> 元素。
图标点击	用于在新窗口中加载信息页面，以及跟踪用户何时点击广告的元素。
IconClickThrough	元素包含信息页面的 URI。当用户点击图标时，视频播放器必须在新窗口中加载此页面。
扩展	用于广告服务器定义的自定义扩展的元素。它必须包含 <Extension> 元素。
扩展	用于每个自定义功能的元素
TitleCTA	用于支持 CTA 的自定义元素，它包含以下元素： <MobileText>, <PCText>, <DisplayUrl>, <Tracking>.
移动端文本/PC 文本	元素包含 CTA 文本，例如 查看更多 或 立即订阅.
显示网址	可选的友好域名。
跟踪	点击跟踪 URI。在 Exoclick 上，可通过设置发送将其禁用 imp.ext.video_cta = 0 在 RTB 请求中禁用它。
DSA	用于支持 DSA 的自定义元素，它包含以下元素： <Behalf>, <Paid>, <WhyThisAd>, <ClickThrough>。 数字服务法 免责声明。
代表 和 已付费	为此广告付费的广告主名称
为什么是这则广告	收集到的具体用户信息
点击跳转	相关的附加信息 DSA