本手册讲解如何正确添加AdMonitor监测代码(PC端可见曝光部分)。媒体需要确保传递给秒针监测代码用于判定可见曝光的页面元素是真实的广告元素且秒针监测代码在广告素材正确展示后才能被触发。

1. PC端可见曝光监测

AdMonitor PC端可见曝光监测代码形式统一为 JS代码。JS代码分为A、B两部分，其中“Part A”为单个广告页面共用，需将其嵌入所有监测点位所在页面；“Part B”则与可见曝光监测位置一一对应，每个监测点位需要使用其相应的Part B。一个页面可以出现多个Part B，用于监测不同广告点位的可见状态。

嵌入秒针PC端可见曝光监测代码的步骤：

  1. 在所有监测页面嵌入“Part A”。

  2. 在需监测的位置嵌入“Part B”。

1.1. 嵌入Part A

请先在所有需要监测的页面嵌入基础代码（下称Part A），使其出现在HTML页面源代码的 <head> 和 </head> 之间。如仅允许将代码加在<body>内部，请务必保证Part A出现在Part B之前。Part A为异步加载程序，故不会影响页面本身的加载速度。

  • Part A 通用版 【代码编号1a-1】 

    <script type='text/javascript'>

//<![CDATA[

//Miaozhen Base Code Start

  _mzh=window._mzh || []; _mzvh = window._mzvh || []; _mzt=window._mzt || []; _mz_dp=window._mz_dp || [];

  (function (doc) {

  var t=parseInt((new Date()).getTime()/1000);

  var v=t-t%300;

  var js=doc.createElement("script"),

  fs=doc.getElementsByTagName("script")[0];

  js.src="http://js.miaozhen.com/tv.js?v="+v;

  fs.parentNode.insertBefore(js, fs);

  })(document);

  function _mz_viewability_imp(id,url,timeout) {_mzvh.push({ad:id,url:url,timeout:timeout});}

  function _mz_viewability_imp_video(id,url,timeout) {_mzvh.push({ad:id,url:url,duration:2,timeout:timeout});}

  function _mz_viewability_imp_stop(id,url) {_mzvh.push({ad:id,url:url,stop:true});}

//Miaozhen Base Code End

//]]>

</script>

1.2. 嵌入Part B

嵌入Part B之前，请首先确认Part A已添加（否则监测代码无法正确执行）。按Miaozhen AE所给的代码列表，嵌入Part B，使得广告元素被正确展示后执行相应的PartB代码。

  • Part B的形式为一串JS代码，一共有三个接口。实际操作时，请正确传入AE所给代码列表。

    • Part B 接口1 【代码编号2b-1】 

      _mz_viewability_imp('{ELEMENT_ID}', '{URL}', {TIMEOUT});

      Display类型可见曝光监测接口。{ELEMENT_ID}为广告元素参数，需要媒体替换为真实的广告元素ID，媒体需要保证页面所监测的元素ID存在，并且名称唯一，否则监测代码无法正确执行。 {URL}为监测url参数，媒体需要替换为真实的监测url。{TIMEOUT}为可选参数，表示经过{TIMEOUT}秒，将自动停止监测；不传该参数或该参数为null，则不自动停止监测

      秒针建议超时设置为300秒

    • Part B 接口2【代码编号2b-2】 

      _mz_viewability_imp_video('{ELEMENT_ID}', '{URL}', {TIMEOUT});

      Video类型可见曝光监测接口。{ELEMENT_ID}为广告元素参数，需要媒体替换为真实的广告元素ID，媒体需要保证页面所监测的元素ID存在，并且名称唯一，否则监测代码无法正确执行。 {URL}为监测url参数，媒体需要替换为真实的监测url。{TIMEOUT}为可选参数，表示经过{TIMEOUT}秒，将自动停止监测；不传该参数或该参数为null，则不自动停止监测

      秒针建议超时设置为广告时长，例如15秒的贴片超时设置为15秒

    • Part B 接口3 【代码编号2b-3】 

      _mz_viewability_imp_stop('{ELEMENT_ID}', '{URL}');

      结束指定可见曝光监测接口。用于手动停止可见曝光的监测，例如当视频贴片广告已经播放完毕或切换到其他广告，应调用此接口停止可见曝光状态监听。{ELEMENT_ID}为广告元素参数，需要媒体替换为真实的广告元素ID，媒体需要保证页面所监测的元素ID存在，并且名称唯一，否则监测代码无法正确执行。 {URL}为监测url参数，媒体需要替换为真实的监测url。