statistic
Statistic模块管理统计功能,用于提供应用内统计的能力,支持统计和分析用户属性和用户行为数据。通过plus.statistic可获取统计管理对象。
方法:
- eventTrig: 触发事件
- eventDuration: 精确持续事件
- eventStart: 开始持续事件(过期API,不推荐使用)
- eventEnd: 结束持续事件(过期API,不推荐使用)
模块:
permissions
{
// ...
"permissions":{
// ...
"Statistic": {
"description": "统计"
}
}
}
eventTrig
触发事件
void plus.statistic.eventTrig(id, value);
说明:
触发指定的统计事件,触发的事件必须要先在统计网站上注册事件ID。
参数:
- id:
(
String
)
必选 要触发的事件ID
事件ID不能使用特殊字符,不建议使用中文,且长度不能超过128个字节。 - value:
(
JSON
|
String
)
可选 要触发事件的数据
推荐使用键值对类型(JSON)数据,key和value都不能使用特殊字符,key不能超过128个字节,value不能超过256个字节,每个id的key不能超过10个,每个key的取值不能超过1000个; 不推荐使用字符串类型(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">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕,现在可以正常调用扩展API
plus.statistic.eventTrig( "purchase", {"type":"book","quantity":"3"} );
}, false );
</script>
</head>
<body>
</body>
</html>
eventDuration
精确持续事件
void plus.statistic.eventDuration(id, duration, value);
说明:
精确时长的持续事件统计,触发的事件必须要先在统计网站上注册事件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 : 无示例:
<!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">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕,现在可以正常调用扩展API
}, false );
function feedback(){
var d = 12000;
plus.statistic.duration("music", d, {"type":"popular","artist":"JJLin"});
}
</script>
</head>
<body>
<button onclick="feedback()">feedback</button>
</body>
</html>
eventStart
开始持续事件(过期API,不推荐使用)
void plus.statistic.eventStart( id, label );
说明:
开始指定的持续事件统计,当事件结束时调用eventEnd方法,,触发的事件必须要先在统计网站上注册事件ID。
参数:
- id:
(
String
)
必选 要触发的事件ID
事件ID不能使用特殊字符,不建议使用中文,且长度不能超过128个字节。 - value:
(
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>
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>