mip-pix 统计

将 mip-pix 组件直接引入,可发送带有自定义参数的请求,用于统计页面访问情况。这些参数主要包括页面打开时间点,页面title和当面页面地址。

标题内容
类型通用
所需脚本

组件使用场景

组件本身在页面不可见,但本元素只有滚动到屏幕可见范围内才触发初始化,发送请求(原理参考MIP生命周期-firstInviewCallback),所以<mip-pix>有以下活用方法:

  1. 在页面首屏或在<body>开始标签后引入,可以统计页面展现PV。
  2. 在正文末尾引用,可以统计文章的真实阅读量(阅读完毕)。
  3. 紧挨一条广告引用,可以统计这条广告的真实展现量。
  4. 在其它组件中将 mip-pix 动态插入,通过修改自定义统计参数,可以实时发送统计。

示例

接入方提供一个接收请求的服务地址,例如:https://www.mipengine.org/a.gif

警告: 由于 mip-cache 为 https 环境,mip-pix 中 src 参数指向的服务器地址必须支持 https。

如果服务地址不支持 HTTPS,可以使用百度云加速或类似产品的HTTPS代理服务,向服务地址定向发送请求。

简单示例

    <mip-pix src="https://www.mipengine.org/a.gif?t=${TIME}&title=${TITLE}&host=${HOST}"></mip-pix>

mip-pix会自动匹配参数,生成请求地址,最终请求为:

https://www.mipengine.org/tj.gif?t=1487307586286&title=random_title&host=http%3A%2F%2Fwww.mipengine.org%2Findex.html

参数缺省写法

    <mip-pix src="https://www.mipengine.org/a.gif"></mip-pix>

mip-pix会自动添加t, title, host参数,最终请求为:

https://www.mipengine.org/tj.gif?t=1487307586286&title=random_title&host=http%3A%2F%2Fwww.mipengine.org%2Findex.html

添加自定义参数

    <mip-pix src="https://www.mipengine.org/a.gif?t=${TIME}&title=${TITLE}&host=${HOST}&area=A"></mip-pix>

自定义参数可拼接在src末尾,最终请求为:

https://www.mipengine.org/a.gif?t=1487307670913&title=random_title&host=http%3A%2F%2Fwww.mipengine.org%2Fmip-pix-test.html&area=A

添加<mip-experiment>实验分组

其中mip-x-button-color建议使用为'mip-x-'+'实验名',也可以自定义任意名称,对应的${xxx}内容会被替换成当前实验分组。

<mip-pix src="https://www.mipengine.org/a.gif?mip-x-button-color=${MIP-X-BUTTON-COLOR}&mip-x-font-color=${MIP-X-FONT-COLOR}"></mip-pix>

最终请求为:

https://www.mipengine.org/tj.gif?t=1487307586286&title=random_title&host=http%3A%2F%2Fwww.mipengine.org%2Findex.html&mip-x-button-color=grey&mip-x-font-color=white&mip-x-font-color2=default

  • 如果本份流量在实验A被分到01组,则最终请求为mip-x-A=01
  • 如果本份流量在实验B被分到默认组,则最终请求为mip-x-B=default
  • 如果本份流量中未配置实验C, 却在mip-pix中存在mip-x-C=${MIP-X-C}取值,则最终请求为mip-x-C=default

添加referrer

在html <head> 标签中增加<meta name="referrer" content="unsafe-url">, 可以在请求头中增加referrer信息

属性

src

说明:资源方服务地址
必选项:是

最终请求-参数说明

参数名意义示例是否默认添加
t当前时间1487307670913
title页面titlerandom_title
host当前页面地址http%3A%2F%2Fwww.mipengine.org%2Fmip-pix-test.html
mip-x-……mip-expriment分组(分组名)