statistic

Statistic模块管理统计功能，用于提供应用内统计的能力，支持统计和分析用户属性和用户行为数据。通过plus.statistic可获取统计管理对象。

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

方法：

权限：

permissions

  2. {
  3. // ...
  4. "permissions":{
  5.     // ...
  6.     "Statistic": {
  7.         "description": "统计"
  8.     }
  9. }
  10. }
  11.

eventTrig

触发事件

  2. void plus.statistic.eventTrig(id, value);
  3.

说明：

触发指定的统计事件，触发的事件必须要先在统计网站上注册事件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 );
  14.     </script>
  15.     </head>
  16.     <body>
  17.     </body>
  18. </html>
  19.

uni-app使用plus注意事项

eventDuration

精确持续事件

  2. void plus.statistic.eventDuration(id, duration, value);
  3.

说明：

精确时长的持续事件统计，触发的事件必须要先在统计网站上注册事件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. <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. }, false );
  13. function feedback(){
  14.     var d = 12000;
  15.     plus.statistic.eventDuration("music", d, {"type":"popular","artist":"JJLin"});
  16. }
  17.     </script>
  18.     </head>
  19.     <body>
  20.         <button onclick="feedback()">feedback</button>
  21.     </body>
  22. </html>
  23.

uni-app使用plus注意事项

eventStart

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

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

说明：

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

参数：

  • id: (String)必选 要触发的事件ID事件ID不能使用特殊字符，不建议使用中文，且长度不能超过128个字节。
  • value: (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. var winsetting = null;
  10. // 监听plusready事件  
  11. document.addEventListener( "plusready", function(){
  12.     // 扩展API加载完毕，现在可以正常调用扩展API
  13.     winsetting = plus.webview.create( "setting.html" );
  14.     winsetting.addEventListener( "loaded", function(){
  15.         plus.statistic.eventStart( "setting" );
  16.     }, false );
  17.     winsetting.addEventListener( "close", function(){
  18.         plus.statistic.eventEnd( "setting" );
  19.     }, false );
  20.     winsetting.show();
  21. }, false );
  22.     </script>
  23.     </head>
  24.     <body>
  25.     </body>
  26. </html>
  27.

uni-app使用plus注意事项

eventEnd

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


void plus.statistic.eventEnd( id, label );

说明：

结束指定的持续事件统计，需先调用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>

uni-app使用plus注意事项