statistic

统计模块可使得Web开发人员能快速调用运行环境提供的统计API进行用户行为分析，而不需要安装额外的浏览器插件。

  • : 触发事件
  • eventDuration: 精确持续事件
  • : 开始持续事件（过期API，不推荐使用）
  • eventEnd: 结束持续事件（过期API，不推荐使用）

权限：

permissions

eventTrig

触发事件

  2.

说明：

触发指定的统计事件，触发的事件必须要先在统计网站上注册事件ID。

参数：

  • id: (String)必选 要触发的事件ID事件ID不能使用特殊字符，不建议使用中文，且长度不能超过128个字节。
  • value: (JSON|String)可选 要触发事件的数据推荐使用键值对类型（JSON）数据，key和value都不能使用特殊字符，key不能超过128个字节，value不能超过256个字节，每个id的key不能超过10个，每个key的取值不能超过1000个；不推荐使用字符串类型（String）数据。

返回值：

void: 无

示例：

  2. <!DOCTYPE html>
  3. <html>
  4.     <head>
  5.     <meta charset="utf-8"/>
  6.     <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
  7.     <title>Statistic Example</title>
  8.     <script type="text/javascript">
  9. // 监听plusready事件  
  10. document.addEventListener( "plusready", function(){
  11.     // 扩展API加载完毕，现在可以正常调用扩展API
  12.     plus.statistic.eventTrig( "purchase", {"type":"book","quantity":"3"} );
  13. }, false );
  15.     </head>
  16.     <body>
  17.     </body>
  18. </html>
  19.

eventDuration

精确持续事件

精确时长的持续事件统计，触发的事件必须要先在统计网站上注册事件ID。

参数：

  • id: (String)必选 要触发的事件ID
  • duration: (Number)必选 要触发事件数值取值范围是-2,147,483,648到+2,147,483,647之间的有符号整数，如果数据超出了该范围，会造成数据丢包，影响数据统计的准确性。
  • value: (JSON|String)可选 要触发事件的数据推荐使用键值对类型（JSON）数据，key和value都不能使用特殊字符，key不能超过128个字节，value不能超过256个字节，每个id的key不能超过10个，每个key的取值不能超过1000个；不推荐使用字符串类型（String）数据。

返回值：

void: 无

示例：

  2. <!DOCTYPE html>
  3.     <head>
  4.     <meta charset="utf-8"/>
  5.     <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
  6.     <title>Statistic Example</title>
  7.     <script type="text/javascript">
  8. // 监听plusready事件  
  9. document.addEventListener( "plusready", function(){
  11. }, false );
  12. function feedback(){
  13.     var d = 12000;
  14.     plus.statistic.eventDuration("music", d, {"type":"popular","artist":"JJLin"});
  15. }
  16.     </script>
  17.     </head>
  18.     <body>
  19.         <button onclick="feedback()">feedback</button>
  20.     </body>
  21. </html>
  22.

eventStart

开始持续事件（过期API，不推荐使用）

  2. void plus.statistic.eventStart( id, label );
  3.

说明：

参数：

  • id: (String)必选 要触发的事件ID事件ID不能使用特殊字符，不建议使用中文，且长度不能超过128个字节。
  • value: (String)可选 要触发事件的标签

void: 无

示例：

uni-app使用plus注意事项

eventEnd

结束持续事件（过期API，不推荐使用）





说明：
结束指定的持续事件统计，需先调用eventStart方法开始持续事件统计，触发的事件必须要先在统计网站上注册事件ID。


参数：
    

  • id: (String)必选 要触发的事件ID
  • label: (String)可选 要触发事件的标签


返回值：
void: 无


示例：

<!DOCTYPE html>
<html>
    <head>
    <meta charset="utf-8"/>
    <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
    <title>Statistic Example</title>
    <script type="text/javascript">
var winsetting = null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
    // 扩展API加载完毕，现在可以正常调用扩展API
    winsetting = plus.webview.create( "setting.html" );
    winsetting.addEventListener( "loaded", function(){
        plus.statistic.eventStart( "setting" );
    }, false );
    winsetting.addEventListener( "close", function(){
        plus.statistic.eventEnd( "setting" );
    }, false );
    winsetting.show();
}, false );
    </script>
    </head>
    <body>
    </body>
</html>