Merge branch 'master' of http://git.letsgame.mobi/document/tracesdk

赵康
2 parents a820d907c5 6e6ed75a77
Showing 1 changed file Side-by-side Diff
doc/integerate guide.md
-
 Mobithink App Tracking SDK  
 2014-11
  
 开发者接入指南 1.0.0  
-最后修订：2014-11-20  
+最后修订：2014-12-02  
  
 # 一、 综述
 1.  适用范围  
 Mobithink App Tracking SDK(以下简称SDK)为移动应用提供数据统计分析服务，通过在应用中加入数
 据SDK，来在Mobithink提供的网站中查阅应用的相关数据。
-该SDK适用于 Android 1.6（API Level 4）及以上的设备。
+该SDK适用于 Android 2.2（API Level 4）及以上的设备。
 2.  统计标准  
 数据系统中的基本数据单元依据以下标准定义：  
 Ø  新增用户  
@@ -85,7 +84,20 @@ WRITE_EXTERNAL_STORAGE  用于保存设备信息，以及记录日志。
   注意3：对于会内嵌其他Activity的ActivityGroup(比如TabActivity)，建议不要在ActivityGroup里添加调用，而是在所有内嵌的Activity里添加。  
   注意4：如果应用只支持API Level 14以上的设备，可只在应用的入口Activity添加调用.  
  
-6.  使用自定义事件  
+6.  使用事件追踪  
+    Ø   追踪用户升级,需要用户等级作为参数
+
+        TraceAgent.onUpgrade(Context ctx,String level);
+
+    Ø   追踪用户注册
+        
+        TraceAgent.onRegister(Context ctx);
+        
+    Ø   追踪支付事件,需要货币和金额作为参数
+    
+        TraceAgent.onPurchase(Context ctx,String currency,float amount);
+    
+7.  使用自定义事件  
 用法说明  
 自定义事件用于统计任何您期望去跟踪的数据，如：点击某功能按钮、填写某个输
 入框、触发了某个广告等；同时，自定义事件还支持添加一些描述性的属性参数，
@@ -97,9 +109,9 @@ WRITE_EXTERNAL_STORAGE  用于保存设备信息，以及记录日志。
 如果您要跟踪更多的事件，我们提供了Label参数的用法，可 以 给 多 个 要 跟 踪
 的同类型或类似的事件使用相同的Event ID，通过给他们分配不同Label来
 达到区分跟踪多个事件的目的。这可理解为Event ID成为了多个事件的目录，
-EventID+Label形成了一个具体事件。请对事件做好分类，这也对您管理和
-
-查阅事件数据有利。  
+EventID+Label形成了一个具体事件。请对事件做好分类，这也对您管理和查阅事件数据有利。  
+Ø  属性参数中Key不可以使用保留关键字,保留关键字如下:  
+def,purchase,register,upgrade  
 调用方法  
 Ø  在应用程序要跟踪的事件处加入下面格式的代码，也就成功的添加了一个简单
 事件到您的应用程序中了：  
@@ -146,5 +158,4 @@ ID来作为统一名称，Label来确定不同位置。这样查阅Event ID数
         kv.put("关卡号", “第5关”); //关卡具体编号
         kv.put("失败原因", “主动退出”); //失败原因
         kv.put("该局分数", “10000～12000”); //玩家该局所打分数
-        TCAgent.onEvent(DemoActivity.this, "战斗失败", kv);
-
+        TCAgent.onEvent(DemoActivity.this, "战斗失败", kv);
 \ No newline at end of file
1		-
2	1	Mobithink App Tracking SDK
3	2	2014-11
4	3
5	4	开发者接入指南 1.0.0
6		-最后修订：2014-11-20
	5	+最后修订：2014-12-02
7	6
8	7	# 一、综述
9	8	1. 适用范围
10	9	Mobithink App Tracking SDK(以下简称SDK)为移动应用提供数据统计分析服务，通过在应用中加入数
11	10	据SDK，来在Mobithink提供的网站中查阅应用的相关数据。
12		-该SDK适用于 Android 1.6（API Level 4）及以上的设备。
	11	+该SDK适用于 Android 2.2（API Level 4）及以上的设备。
13	12	2. 统计标准
14	13	数据系统中的基本数据单元依据以下标准定义：
15	14	Ø 新增用户
...	...	@@ -85,7 +84,20 @@ WRITE_EXTERNAL_STORAGE 用于保存设备信息，以及记录日志。
85	84	注意3：对于会内嵌其他Activity的ActivityGroup(比如TabActivity)，建议不要在ActivityGroup里添加调用，而是在所有内嵌的Activity里添加。
86	85	注意4：如果应用只支持API Level 14以上的设备，可只在应用的入口Activity添加调用.
87	86
88		-6. 使用自定义事件
	87	+6. 使用事件追踪
	88	+ Ø 追踪用户升级,需要用户等级作为参数
	89	+
	90	+ TraceAgent.onUpgrade(Context ctx,String level);
	91	+
	92	+ Ø 追踪用户注册
	93	+
	94	+ TraceAgent.onRegister(Context ctx);
	95	+
	96	+ Ø 追踪支付事件,需要货币和金额作为参数
	97	+
	98	+ TraceAgent.onPurchase(Context ctx,String currency,float amount);
	99	+
	100	+7. 使用自定义事件
89	101	用法说明
90	102	自定义事件用于统计任何您期望去跟踪的数据，如：点击某功能按钮、填写某个输
91	103	入框、触发了某个广告等；同时，自定义事件还支持添加一些描述性的属性参数，
...	...	@@ -97,9 +109,9 @@ WRITE_EXTERNAL_STORAGE 用于保存设备信息，以及记录日志。
97	109	如果您要跟踪更多的事件，我们提供了Label参数的用法，可以给多个要跟踪
98	110	的同类型或类似的事件使用相同的Event ID，通过给他们分配不同Label来
99	111	达到区分跟踪多个事件的目的。这可理解为Event ID成为了多个事件的目录，
100		-EventID+Label形成了一个具体事件。请对事件做好分类，这也对您管理和
101		-
102		-查阅事件数据有利。
	112	+EventID+Label形成了一个具体事件。请对事件做好分类，这也对您管理和查阅事件数据有利。
	113	+Ø 属性参数中Key不可以使用保留关键字,保留关键字如下:
	114	+def,purchase,register,upgrade
103	115	调用方法
104	116	Ø 在应用程序要跟踪的事件处加入下面格式的代码，也就成功的添加了一个简单
105	117	事件到您的应用程序中了：
...	...	@@ -146,5 +158,4 @@ ID来作为统一名称，Label来确定不同位置。这样查阅Event ID数
146	158	kv.put("关卡号", “第5关”); //关卡具体编号
147	159	kv.put("失败原因", “主动退出”); //失败原因
148	160	kv.put("该局分数", “10000～12000”); //玩家该局所打分数
149		- TCAgent.onEvent(DemoActivity.this, "战斗失败", kv);
150		-
	161	+ TCAgent.onEvent(DemoActivity.this, "战斗失败", kv);
151	162	\ No newline at end of file