API Reference

Plugins

Native.js


statistic

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

方法:

模块:

permissions


{
// ...
"permissions":{
	// ...
	"Statistic": {
		"description": "统计"
	}
}
}
			

eventTrig

触发事件


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

说明:

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

参数:

返回值:

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。

参数:

返回值:

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.eventDuration("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。

参数:

返回值:

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。

参数:

返回值:

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>