秒针-URL代码回传剧目参数格式说明

秒针的URL监测代码包含有特殊双下划线宏标记(即macro)。媒体(投放系统)按照一定格式替换这些标记,即可通过URL将剧目及其相关信息实时传递给秒针AdMonitor。详细说明如下:

• 相关标记 (Standard Macro)

对于剧目信息所使用的标记,秒针提供相应带标记的URL,媒体只需将标记替换为对应实际参数即可。常用标记如下:

标记      描述 举例
__DRA__ 媒体代号和剧集ID XXX_XMjM4MzMyMTEy
__POS__ 视频贴片位置和位序 pre_1
__APP__ 客户端平台类型和名称 iOS_MyAppHD

• 举例1(__DRA__)

秒针原始的监测URL为:

http://g.cn.miaozhen.com/x/k=2002456&p=6rS96&dx=0&rt=2&nd=__DRA__&np=__POS__&nn=__APP__&o=

媒体需要给秒针传递当前曝光/点击所在页面的剧集id,则实际使用的监测URL类似(假设媒体代号为XXX,此剧集id为XMjM4MzMyMTEy):

http://g.cn.miaozhen.com/x/k=2002456&p=6rS96&dx=0&rt=2&nd=XXX_XMjM4MzMyMTEy&np=__POS__&nn=__APP__&o=

注:DRA由两部分组成,其格式为 媒体代号_剧集ID (例如 XXX_123abc)。其中媒体代号由媒体和秒针共同约定;剧集ID一般采用媒体代表剧集内容的唯一ID,由字母/数字组成(A-Za- z0-9)。

注:媒体需事先准备好API接口和相应的接口说明文档,秒针根可通过该API接口实时请求并获取剧目ID对应的剧目名称、剧目类型等信息。

• 举例2(__POS__)

秒针原始的监测URL为:

http://g.cn.miaozhen.com/x/k=2002456&p=6rS96&dx=0&rt=2&nd=__DRA__&np=__POS__&nn=__APP__&o=

媒体需要给秒针传递贴片位序,则实际使用的监测URL类似(假设贴片的位序为2):

http://g.cn.miaozhen.com/x/k=2002456&p=6rS96&dx=0&rt=2&nd=__DRA__&np=pre_1&nn=__APP__&o=

注:POS由两部分组成,其格式为 贴片位置_位序 (例如pre_1)。其中贴片位置pre表示前贴、mid表示中贴、post表示后贴;位序表示在这个位置中,本物料的位置序号,同一位置一系列连续贴片中,第1个播放的物料的位序为1,第2个播放的物料的位序为2,第3个播放的物料的位序为3,以此类推。

• 举例3(__APP__)

秒针原始的监测URL为:

http://g.cn.miaozhen.com/x/k=2002456&p=6rS96&dx=0&rt=2&nd=__DRA__&np=__POS__&nn=__APP__&o=

对于PC客户端或移动APP,媒体需要给秒针传递客户端平台类型和名称,则实际使用的监测URL类似(假设此广告用户使用iPad名为MyApp的客户端观看该广告):

http://g.cn.miaozhen.com/x/k=2002456&p=6rS96&dx=0&rt=2&nd=__DRA__&np=__POS__&nn=iOS_MyAppHD&o=

注:APP由两部分组成,其格式为 平台_客户端名称 (例如iOS_MyAppHD)。其中平台可根据实际情况从以下几个中选择:Win、Mac、iOS、Android、WP;客户端名称自定义,必须由数字、大小写字母组成,若为Pad版请在结尾包含大写关键字“HD”以示区分。