1.文档说明

1.1.功能描述

此文档是统计日志sdk接入说明。 在游戏及应用开发商需要接入掌趣SDK时，根据该日志向掌趣统计后台发送游戏内统计日志。

1.2.阅读对象

接入掌趣的游戏及应用开发者，包括客户端及服务器端工程师。

1.3.名词解释

玩家：玩家指下载安装和运行游戏及应用的用户，在统计时，玩家这个词本身又包含三层意义，即设备、账户、角色；

设备：指玩家用于安装运行游戏和应用的手机，平板，电脑等硬件设施；

账户：指玩家为了登录游戏和应用而注册的通行证，账户等信息；

角色：指玩家为了进入游戏创建的游戏内角色信息。

用户行为：玩家在游戏和应用内每一个值得被记录的动作都可以称为一次用户行为或者事件或者动作，我们在统计sdk中将玩家用户行为分为基础事件和游戏内事件两大类；

基础事件：包括启动和初始化应用，注册和登录账户，注册和登录角色，客户端心跳等；

游戏内事件：包括玩家的充值，虚拟物品获得与使用，任务、关卡、副本、交互等等。

日志：当玩家在游戏中发生了一次应该被记录的事件，而且这次事件通过统计sdk成功记录，则产生了一条记录对应事件的日志，每个日志都包含多个不同的字段，用于描述事件的不同角度的信息。掌趣统计后台通过对日志的搜集、分析和计算，算出各种事件的统计数据，并将其在掌趣BI后台中展示出来。

维度：在一条日志里，会对一个事件的不同角度的信息进行记录，例如新闻六要素，who,when,where,what,why和how，六要素其实就是同一事件在六个维度上坐标值。在掌趣统计sdk中，会有时间、产品、联运、推广渠道、游戏逻辑服等维度信息来标识一个事件。一些维度信息在掌趣sdk跟应用打包时就已经固化在客户端的配置文件中了，另外一些维度信息则需要客户端开发人员在事件发生时实时获取和记录日志。因此日志接口的每一个参数都是必要和有意义的，请接入时务必确保维度信息的完整性和正确性。

2.开发环境搭建

2.1. lib库的引入

直接从<资源，lib库和配置文件>中复制所有lib库到游戏工程的相应目录，包含libs及assets。
注意：由MIS平台获取的ourpalm.cfg请放到APK的assets文件夹的根目录。

2.2. AndroidManifest.xml的配置

请游戏直接从<资源，lib库和配置文件>中AndroidManifest.xml中复制当前渠道所需配置的内容，内有详细的注释说明。如不清楚请咨询掌趣SDK技术人员。

掌趣统计SDK所需要的权限：

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <!-- 如游戏本身有Application类，则需要在代码中继承 ourpalm.android.statistics.info.Ourpalm_Statistics_Application；如游戏本身没有 Application类，则需要在此添加配置，将AndroidManifest.xml中application的名字 命名为“ourpalm.android.statistics.info.Ourpalm_Statistics_Application” --> <application android:name="ourpalm.android.statistics.info.Ourpalm_Statistics_Application" android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <!-- 新增 上传崩溃日志的服务 --> <service android:name="ourpalm.android.c.Ourpalm_CrashService" android:process=":ourpalmCrash" > <intent-filter> <action android:name="ourpalm.UpCrashLog"/> </intent-filter> </service>

2.3. 备注说明

1.导入过程中可能因为重复引用LIB库导致编译报错，在项目工程中移除重复的LIB库即可。
2.某些渠道关于横竖屏展示问题，需游戏自行在AndroidManifest.xml中设置。

3.日志接入流程

3.1 流程说明

日志接入流程大致分为三个步骤：
1.客户端日志接入开发负责人根据日志接入流程文档，调用日志接口，完成几个基础日志的记录；
2.掌趣科技数据中心对客户端接入的日志进行格式和字段内容检查；
3.客户端日志接入开发负责人与掌趣技术人员通过日志接入测试用例后，日志接入工作正式完成。

3.2 接口介绍

SDK日志接口，用于采集客户端的诸如玩家注册，玩家登录，玩家充值，玩家虚拟物品变更，玩家属性变更等用户行为，为产品运营，推广营销等工作提供数据支持。
在调用日志接口时，客户端需要为日志接口提供日志ID，日志关键字，日志内容三个参数，其中，日志内容(val)是一个json格式的字符串，里面详细描述了该次事件的具体信息。例如，一个玩家充值日志，他的几个参数大概是这样的：

{ "val": "{ \"orderNo\":\"0162014101420092117000\", \"payChannelId\":\"支付宝\", \"currencyType\":\"1\", \"currencyAmount\":\"10000\", \"virtualCurrencyId\":\"diamond\", \"virtualCurrencyAmount\":\"1000\" }", "id": "8", "key": "role-credit" }

从示例中可见，
日志的id为8，
本次充值的订单号为0162014101420092117000（由开发者自行决定订单号作为订单唯一标识）
本次充值的支付渠道为支付宝
本次充值的货币类型为1 (人民币，见附2.1货币规范)
本次充值的实际支付金额为100元（单位为分，所以接口中的参数值是10000）
本次充值的虚拟币类型为钻石
本次充值的虚拟币发放金额为1000

除了货币类型是附2.1货币规范指定之外，其余信息皆为该游戏的产品人员和开发人员自行设定，其余一些虚拟币类型和商品ID的代码由游戏开发和运营人员自行指定。

需要注意的地方：

当传入中文字符串时，务必确保该中文字符串使用的是utf8编码。例如，商品名称，任务名称，副本场景名称等。
由的产品人员和开发人员自行设定的字段信息，也必须由相应的负责人确保内容的一致性。 例如同一个逻辑服下，如果在用户登录注册时调用日志接口传递的逻辑服标识是1001，那么在调用计费中心的充值计费接口时逻辑服标识也应该是同样的1001，而不应该是其他的值。同样的，如果A用户在购买一个极品武器时记录的物品id是001weapon，那么另外一个用户在拍卖同样一个极品武器时物品id也应该是001weapon

3.2.1 统计SDK初始化（客户端调用，必须）

功能说明
1.为SDK中各个功能的使用提供必要的准备工作。
2.获取初始化数据。

接口定义

/** * 统计SDK初始化 * * @param activity Activity * @param gameVer 游戏版本号 * @param gameResVer 游戏资源版本号,无资源版本号可传"" * @return null */ public void initStatisticsLog(Activity activity, String gameVer, String gameResVer)

参数说明

参数名称	重要性	类型	说明
activity	必选	Activity	Activity上下文
gameVer	可选	String	SDK优先读取AndroidManifest.xml里面的版本号，如未获取到则使用此参数。
gameResVer	可选	String	游戏资源版本号，如游戏无此概念则可以传“”

接口实例

// 初始化SDK Ourpalm_Statistics_Entry.getInstance().initStatisticsLog(this, "1.0.0", "");

3.2.2设置用户信息（客户端调用，必须）

功能说明1、登录成功后调用，传入用户登陆类型（用户注册和用户登陆）、用户ID、用户名;
2、这个接口会根据传入的用户登陆类型 自动发送账户注册及账户登录日志。

接口定义

/** * 设置用户信息 * @param type 1：用户注册，2：用户登陆 * @param userId 用户ID * @param userName 用户名 */ public void setUserInfo(int type, String userId, String userName)

参数说明：

参数名称	重要性	类型	说明
type	必选	int	1表示用户注册，2表示用户登陆
userId	必选	String	用户ID，登录或注册的成功后，返回的用户ID
userName	必选	String	用户名

接口示例

Ourpalm_Statistics_Entry.getInstance(). setUserInfo(1, "测试用户ID", "测试用户名");

3.2.3设置游戏信息（客户端调用，必须）

功能说明成功登陆游戏并进入游戏后，游戏客户端必须调用此接口设置用户的角色信息，角色信息在其他统计功能接口中需要用到。
注意：此接口在每次进入游戏客户端时，
如有新角色注册并登陆，则需要调用一次注册设置(type=1)和一次登陆设置(type=2)；
如本次进入游戏用户使用老角色登陆，则只需要调用一次登陆设置(type=2)。

接口定义 /** * 设置游戏角色信息 * @param type  1：角色注册，2：角色登陆 * @param callback 获取游戏信息的回调 * @return null */ public void setGameInfo(int type, Ourpalm_GameInfoCallBack callback)

参数说明

参数名称	重要性	类型	说明
type	必选	int	1表示角色注册，2表示角色登陆
callback	必选	Ourpalm_GameInfoCallBack	游戏客户端必须实现这个游戏信息回调类，最好返回动态的游戏信息值（变量），便于统计实时的游戏信息。

接口示例

Ourpalm_Statistics_Entry.getInstance().setGameInfo(1,new Ourpalm_GameInfoCallBack() { @Override public String getGameServerId() { // TODO Auto-generated method stub //实时返回游戏服务器ID 变量返回，如没有，返回”” return "1"; } @Override public String getGameRoleVipLevel() { // TODO Auto-generated method stub //实时返回游戏角色VIP等级 变量返回，如没有，返回”” return "2"; } @Override public String getGameRoleName() { // TODO Auto-generated method stub //实时返回游戏角色名称 变量返回，如没有，返回”” return "测试角色"; } @Override public String getGameRoleLevel() { // TODO Auto-generated method stub //实时返回游戏角色等级 变量返回，如没有，返回”” return "100"; } @Override public String getGameRoleId() { // TODO Auto-generated method stub //实时返回游戏角色ID 变量返回，如没有，返回”” return "987654321"; } });

3.2.4停止发送统计日志（客户端调用，必选）

功能说明
游戏退出时调用，停止发送统计日志。

接口定义

/**     * 游戏退出时调用，停止发送统计日志     *     * @param null     * @return null     */    public void stopStatistics()接口示例

Ourpalm_Statistics_Entry.getInstance().stopStatistics();

3.2.5开启SDK日志输出（客户端调用，可选）

功能说明
打开后能在logcat看到SDK的日志输出，TAG为“info”和”ourpalm_http”, 用于游戏接入SDK的调试阶段，出正式游戏包时请务必关闭日志输出。

接口定义
/**     * 是否打开日志     * * @param log     */ publicvoid SetLogs(boolean log)

参数说明

参数名称	重要性	类型	说明
log	必须	Boolean	是否打开日志输出

接口示例

// 设置打开日志输出，出正式包时务必注释掉，或者传false Ourpalm_Statistics_Entry.getInstance().setLogs(true);

3.2.6.发送游戏内日志（客户端调用, 必须）

功能说明
用于统计游戏的各项信息。

接口定义
/** * 游戏端需发送的统计日志 * @param logID 日志ID * @param logKey 日志KEY * @parammap 日志属性MAP */ public void Ourpalm_SendGameInfoLog(String logID, String logKey, HashMap<String,Object> map)

参数说明

参数名称	重要性	类型	说明
logID	必须	String	日志ID（详见logId和LogKey对应表）
logKey	必须	String	日志KEY（详见logId和LogKey对应表）
map	必须	HashMap	日志属性，具体属性字段见下面日志的说明表格

接口示例 HashMap<String,Object> map = new HashMap<String,Object>(); map.put("key1", "value1"); map.put("key2", "value2"); map.put("key3", "value3"); Ourpalm_Statistics_Entry.getInstance(). sendGameInfoLog ("logID", "logKey", map);

LogId和LogKey对应表

logId	Logkey	描述
8	role-credit	玩家充值日志
9	role-item-update	玩家虚拟物品变更
10	role-prop-update	玩家属性变更
1001	role-task	任务
1002	role-stage	副本，场景
1003	role-act	自定义事件
2001	role-interact	自定义交互事件

日志logVal字段对照表

跟踪玩家充值（客户端调用，必须）

当用户已经启动游戏客户端，且通过发货通知接口收到发货通知并给用户成功发货时，需要记录一条对应的发货成功日志来跟踪玩家充值。
支付方式ID：如支付宝，神州付，财付通，微信支付等，由开发者自行指定，需要在同一个产品的所有订单中保持支付方式id的一致性
订单号：由开发者自行指定该笔充值的唯一标识
订单金额：即发货通知接口的订单金额
货币类型：玩家支付的是人民币还是美元或者欧元，见附2.1货币规范
商品ID：用于记录本次充值给用户发放了哪一个商品，商品id建议由英文字母或数字组成，以避免乱码等问题。
商品名称：商品名称建议为中文信息。
日志时间字段，sdk会根据调用日志接口时间自行填充。
用户id，角色名称，角色id等字段，sdk会根据角色登录时保存的信息自行填充。

8 玩家充值日志 role-credit

LogId	日志名称	LogKey	字段名	字段类型	字段说明	备注
8	玩家充值日志	role-credit	roleLevel	Integer	角色等级	必需
			roleVipLevel	Integer	角色vip等级	必需
			payChannelId	String	支付方式	例如，91支付，UC支付等，非必需
			orderNo	String	订单号	必需
			currencyType	String	货币类型	（参照附2.1货币规范）必需
			currencyAmount	Integer	订单金额	单位:分，必需
			itemId	String	商品ID	游戏中商品或者道具ID，必需
			itemName	String	商品名称	便于运营人员识别商品，一般传入中文，必需
			itemCount	Integer	商品个数	必需

日志格式示例:

HashMap<String,Object> map = new HashMap<String,Object>(); // map.put("time", "2014-04-18 17:11:30"); map.put("roleLevel", "1"); map.put("roleVipLevel", "0"); map.put("payChannelId", "3100052033100012"); map.put("orderNo", "0012014090110143611500"); map.put("currencyType", "1"); map.put("currencyAmount", "100"); map.put("itemId", "diamond"); map.put("itemName", "钻石"); map.put("itemCount", "100"); Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SendGameInfoLog("8", "role-credit", map);

该记录表示当前登录的角色马克.吐温充值100分人民币购买游戏内100钻石

跟踪玩家虚拟物品（虚拟币、道具）变更（客户端调用，必须）

当用户在游戏内，因为种种原因产生虚拟物品（含虚拟货币）的增加和消耗时，需要记录一条对应的虚拟物品变更日志。
变更类型：用于标识本次变更是新增了虚拟物品还是消耗了虚拟物品，新增记录1，消耗记录0。
自定义变更描述：用于标识用户因为什么原因变更虚拟物品（虚拟货币），如任务获得，怪物掉落，系统赠送，副本奖励，世界喊话，家族奉献，婚姻喜宴等等。
商品ID：用于记录用户本次是因为哪一个游戏内的商品引发的虚拟物品变更，例如购买游戏内的装备、经验、头衔、坐骑等。商品名称由游戏策划人员自行定义，比如 0001对应装备图纸，0002对应黄金翅膀，0003对应经验丹，0004对应体力等等。传入0001,0002,0003……这些ID即可
商品名称：用于记录用户本次是因为哪一个游戏内的商品引发的虚拟物品变更，例如购买游戏内的装备、经验、头衔、坐骑等。商品名称由游戏策划人员自行定义，比如 0001_装备图纸，0002_黄金翅膀，0003_经验丹，0004_体力等等。统计结果也会直接将日志中的商品名称展示出来，如果用户本次变更行为与具体商品道具无关，则该字段置空即可。
商品个数：用于记录用户本次消费行为涉及多少个商品，如果用户本次消费行为与具体商品无关，则该字段置空即可。
需要注意的是，如果玩家的一次事件导致多种虚拟物品变更，比如完成一次史诗副本同时获得1000珍珠20000石币，则需要记录相应的两条虚拟物品变更日志。

LogId	日志名称	LogKey	字段名	字段类型	字段说明	备注
9	玩家虚拟物品变更日志	role-item-update	roleLevel	Integer	角色等级	必需
			roleVipLevel	Integer	角色vip等级	必需
			updateType	String	变更类型	1：新增      0：消耗      必需
			itemId	String	商品ID	必需
			itemName	String	商品名称	便于运营人员识别商品，一般传入中文，必需
			itemCount	Integer	商品个数	必需
			custom	String	自定义	本次虚拟物品变更的其他相关信息，非必需

日志格式示例:

HashMap<String,Object> map = new HashMap<String,Object>(); // map.put("time", "2014-04-18 17:11:30"); map.put("roleLevel", "1"); map.put("roleVipLevel", "0"); map.put("updateType", "0"); map.put("itemId", "diamond"); map.put("itemName", "钻石"); map.put("itemCount", "100"); map.put("custom", "购买"); Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SendGameInfoLog("9", "role-item-update", map); HashMap<String,Object> map = new HashMap<String,Object>(); // map.put("time", "2014-04-18 17:11:30"); map.put("roleLevel", "1"); map.put("roleVipLevel", "0"); map.put("updateType", "1"); map.put("itemId", "MGH_Weapon_001"); map.put("itemName", "玛格汉铁锤"); map.put("itemCount", "1"); map.put("custom", "购买"); Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SendGameInfoLog("9", "role-item-update", map);

上面两条日志表示当前登录的角色马克.吐温为了购买id为玛格汉铁锤 的武器花了100钻石。

跟踪玩家属性变更（客户端调用，必须）

当用户的角色，发生一些属性上的变化时，记录相应的角色属性变更日志。例如等级提升，军衔提升，VIP等级提升，属性点重配，种族天赋变更等等。
属性标识：角色变更了哪种属性，其中等级标识为level，VIP等级标识为viplevel，其余属性标识由游戏产品和开发人员自行设定。
新属性值：角色完成属性变更之后，该属性的值变成了什么。
变更值：如果该属性值是一个数字，比如等级level，那么本次用户的等级变更了多少，例如购买大礼包level连升三级，则变更值为3。

10 玩家属性变更日志 role-prop-update

LogId	日志名称	LogKey	字段名	字段类型	字段说明	备注
10	玩家属性变更日志	role-prop-update	roleLevel	Integer	角色等级	必需
			roleVipLevel	Integer	角色vip等级	必需
			propKey	String	属性标识	必需
			propValue	String	新属性值	必需
			rangeability	String	变更值	必需

日志格式示例：

HashMap<String,Object> map = new HashMap<String,Object>(); // map.put("time", "2014-04-18 17:11:30"); map.put("roleLevel", "3"); map.put("roleVipLevel", "0"); map.put("propKey", "level"); map.put("propValue", "3"); map.put("rangeability", "2"); Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SendGameInfoLog("10", "role-prop-update", map); HashMap<String,Object> map = new HashMap<String,Object>(); // map.put("time", "2014-04-18 17:11:30"); map.put("roleLevel", "2"); map.put("roleVipLevel", "1"); map.put("propKey", "vipLevel"); map.put("propValue", "1"); map.put("rangeability", "1"); Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SendGameInfoLog("10", "role-prop-update", map);

该记录表示当前角色马克.吐温连升了两级，目前等级为3。他的vip等级升了一级，目前vip等级为1

自定义事件

当运营人员需要对游戏内的任务完成情况，关卡完成情况进行记录时，即可记录一条游戏自定义事件。在记录日志之前，游戏运营人员有必要向掌趣科技统计后台提供一份任务，关卡，以及其他自定义事件的id和名称对照表，并在掌趣科技统计后台描述任务，关卡，道具之间的关系。
任务，副本关卡日志的格式均为stageId,stageName,detail三个字段，三个字段的值完全由游戏研发人员和运营人员自行指定，例如新手引导任务可以用 newbieguide标识stageId，也可以用task001或其他字符串标识来表示stageId，任务完成，既可以用 SUCC表示，也可以用complete表示，还可以根据任务的中断，放弃，失败等多种状况，为同一个任务记录多条日志。对于同一种事件结果，建议使用同样的detail内容来描述。尽量做到同一个detail的含义一致，同一个事件结果的detail一致。

需要注意的地方：
无论是任务，关卡还是其他自定义事件日志，taskId/stageId/actId字段都必须是相对于该日志的logId唯一，不能够与其他任务，关卡或道具的id字段重复。
尽管任务，副本/场景，以及游戏自定义事件三个日志的字段数量和格式相同，但是我们希望研发人员能够按照预设的不同logid和logkey分别记录这三类日志，这样一来，便于将相对重要的日志同其它日志区分出来，也便于我们对任务和场景副本日志采用预设的特定算法来进行统计运算。
我们要求用以下的默认字段来记录事件日志的detail，以便统计后台可以用默认的配置来对游戏自定义事件进行计算成功率，通过率等进一步指标。 如果列表中的detail无法满足游戏的日志记录要求，也允许各个游戏使用自己定义的detail来记录日志，实际上在下面的日志范例中也有一些detail字段灵活发挥的情况。

事件类型	detail	含义
role-task	accept	接任务
	fail	任务失败
	cancel	放弃任务
	succ	达成任务条件
	complete	任务完成
role-stage	begin	场景开始
	fail	场景失败
	cancel	场景取消
	end	场景结束
role-act	begin	事件开始
	fail	事件失败
	cancel	事件取消
	end	事件结束

LogId	日志名称	key	字段名	字段类型	字段说明
1001	任务	role-task	roleLevel	Integer	角色等级，必需
			roleVipLevel	Integer	角色vip等级，必需
			taskId	String	任务编码，英文或数字，必需
			taskName	String	任务名称，最好传中文，必需
			detail	String	相关信息，全为英文，参考上面detail定义，必需

HashMap<String,Object> map = new HashMap<String,Object>(); // map.put("time", "2014-04-18 17:11:30"); map.put("roleLevel", "10"); map.put("roleVipLevel", "2"); map.put("taskId", "newbieguide1"); map.put("taskName", "新手引导流程1"); map.put("detail", "accept"); Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SendGameInfoLog("1001", "role-task", map); HashMap<String,Object> map = new HashMap<String,Object>(); // map.put("time", "2014-04-18 17:12:30"); map.put("roleLevel", "10"); map.put("roleVipLevel", "2"); map.put("taskId", "newbieguide1"); map.put("taskName", "新手引导流程1"); map.put("detail", "complete"); Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SendGameInfoLog("1001", "role-task", map);

这两条日志表示，当前角色马克.吐温在17:11:30接受了新手流程任务1，在17:12:30完成了新手流程任务1.

LogId	日志名称	key	字段名	字段类型	字段说明
1002	副本场景日志	role-stage	roleLevel	Integer	角色等级，必需
			roleVipLevel	Integer	角色vip等级，必需
			stageId	String	副本场景标识，英文或数字，必需
			stageName	String	副本场景名称，最好传中文，必需
			detail	String	相关信息，全为英文，参考上面detail定义，必需

LogId	日志名称	key	字段名	字段类型	字段说明
1003	游戏自定义事件	role-act	roleLevel	Integer	角色等级，必需
			roleVipLevel	Integer	角色vip等级，必需
			actId	String	事件标识，英文或数字，必需
			actName	String	事件名称，最好传中文，必需
			detail	String	相关信息，全为英文，参考上面detail定义，必需

HashMap<String,Object> map = new HashMap<String,Object>(); // map.put("time", "2014-04-18 17:11:30"); map.put("roleLevel", "10"); map.put("roleVipLevel", "2"); map.put("stageId", "DeadminesIstanc"); map.put("stageName", "死亡矿井"); map.put("detail", "begin"); Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SendGameInfoLog("1002", "role-stage", map); HashMap<String,Object> map = new HashMap<String,Object>(); // map.put("time", "2014-04-18 17:11:30"); map.put("roleLevel", "10"); map.put("roleVipLevel", "2"); map.put("actId", "fight.mineer"); map.put("actName", "战斗.狗头人矿工"); map.put("detail", "begin"); Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SendGameInfoLog("1003", "role-act", map);

以上日志表示，当前角色马克吐温于2014-04-18 17:11:30 进入死亡矿井。

下面我们用一系列日志，来记录一个复杂的副本过程，以此作为游戏内自定义事件的开发样例

logkey	事件	日志
role-task	接受任务：迪菲亚兄弟会	time:2014-04-18 20:00:00      taskId:taskdifeiya003      taskName:迪菲亚兄弟会      detail:accept
role-stage	进入死亡矿井	time:2014-04-18 21:00:00      stageId:enterstage      stageName:死亡矿井      detail:deadmine
role-act	boos战格鲁巴托克开始	time:2014-04-18 21:05:00      actId:fightdeadmineboos1      actName:boos战格鲁巴托克      detail:begin
role-act	boss战格鲁巴托克完成	time:2014-04-18 21:07:00      actId:fightdeadmineboos1      actName:boss战格鲁巴托克      detail:end
role-act	boos战格范克里夫开始	time:2014-04-18 21:20:00      actId:fightdeadmineboos4      actName:boos战格范克里夫      detail:begin
role-act	boss战格范克里夫失败	time:2014-04-18 21:21:00      actId:fightdeadmineboos4      actName:boos战格范克里夫      detail:fail
role-act	死亡	time:2014-04-18 21:21:00      actId:dead      actName:角色死亡      detail:end
role-stage	出死亡矿井	time:2014-04-18 21:21:20      stageId:quitstage      stageName:死亡矿井      detail:deadmine
role-stage	进入死亡矿井	time:2014-04-18 21:23:20      stageId:enterstage      stageName:死亡矿井      detail:deadmine
role-act	复活	time:2014-04-18 21:23:21      actId:bufferuse      actName:复活      detail:relive
role-act	boos战格范克里夫开始	time:2014-04-18 21:25:00      actId:fightdeadmineboos4      actName:boos战格范克里夫      detail:begin
role-act	boos战格范克里夫完成	time:2014-04-18 21:30:00      actId:fightdeadmineboos4      actName:boos战格范克里夫      detail:end
role-task	任务迪菲亚兄弟会达到完成条件	time:2014-04-18 21:30:00      taskId:taskdifeiya003      taskName:迪菲亚兄弟会      detail:succ
role-stage	出死亡矿井	time:2014-04-18 21:40:20      stageId:quitstage      stageName:死亡矿井      detail:deadmine
role-task	交任务：迪菲亚兄弟会	time:2014-04-18 21:45:00      taskId:taskdifeiya003      taskName:迪菲亚兄弟会      detail:complete

从中，运营人员可以发现，当前角色马克.吐温进入死亡矿井后，顺利击败第一个boss，但是在挑战最终boss范克里夫时不幸阵亡，玩家没有气馁，复活之后重整旗鼓，终于击败范克里夫，打通了死亡矿井，完成了任务迪菲亚兄弟会。
自定义交互事件游戏中除了角色与系统间发生的事件之外，还会有玩家之间的交互事件，这类事件使用交互事件日志来记录。
与游戏自定义事件相比，交互事件多了一个交互对象的概念，targetType字段用于描述本次交互的对象是哪一类对象，0、系统交互，1、玩家之间互动，2、游戏自定义交互。系统交互事件应该尽量使用游戏自定义事件来记录，除非交互对象较为重要需要额外记录。
targetCode用于描述当前玩家与具体哪一个对象进行了交互，当targetType为2时，targetCode必须为对方角色id，targetInfo必须为对方逻辑服标识。

LogId	日志名称	key	字段名	字段类型	字段说明
2001	交互行为	role-interact	roleLevel	Integer	角色等级，必需
			roleVipLevel	Integer	角色vip等级，必需
			interactId	String	自定义事件编码，数字或字母，必需
			interactName	String	自定义事件名称，建议写中文，必需
			targetType	String	目标类型，0:系统，1:玩家，2:自定义类型，必需
			targetCode	String	目标，若目标类型为玩家则为对方角色ID，必需
			targetInfo	String	目标详细信息，若目标类型为玩家，则为对方逻辑服ID，非必需
			detail	String	相关信息，全为英文，参考上面detail定义，必需

交互日志举例HashMap<String,Object> map = new HashMap<String,Object>(); // map.put("time", "2014-04-18 17:11:30"); map.put("roleLevel", "10"); map.put("roleVipLevel", "2"); map.put("interactId", "addfriend"); map.put("interactName", "添加好友"); map.put("targetType", "1"); map.put("targetCode", "0010000067543"); map.put("targetInfo", "珍妮佛"); map.put("detail", "ENTER"); Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SendGameInfoLog("2001", "role-interact", map);

这条日志表示当前玩家马克吐温添加了玩家珍妮佛为好友

logKey	事件	日志
role-interact	加入公会：圣光兄弟会	time:2014-04-18 22:00:00      interactId:jioncrop      interactName:加入公会      targetType:0      targetCode:crop100991      targetInfo:crop      detail:end
role-act	获得一次公会等级提升	time:2014-04-18 22:01:00      actId:croppromote      actName:公会等级提升      detail:end
role-interact	对敌对公会：战神传说发起公会战争	time:2014-04-18 22:10:00      interactId:declarewar      interactName:参战      targetType:0      targetCode:crop1000022      targetInfo:crop      detail:begin
role-stage	进入战场：长城	time:2014-04-18 22:11:00      stageId:enterbattlefield      stageName:进入战场      detail:greatwall
role-interact	攻击敌对玩家	time:2014-04-18 22:11:21      interactId:attack      interactName:PVP攻击      targetType:1      targetCode:1002000100021      targetInfo:1002      detail:-3000
role-interact	被敌对玩家杀死	time:2014-04-18 22:11:39      interactId:killed      interactName:pvp战败死亡      targetType:1      targetCode:1002000100021      targetInfo:1002      detail:-5000
role-interact	被敌对玩家嘲弄	time:2014-04-18 22:11:42      interactId:laughed      interactName:遭到嘲弄      targetType:1      targetCode:1002000100021      targetInfo:1002      detail:end
role-debit	使用收费道具：复仇之镰	time:2014-04-18 22:11:50      roleLevel:50      roleVipLevel:3      updateType:0      itemId:killer1001      itemName:复仇之镰      itemCount:1      customer:use
role-interact	攻击敌对玩家	time:2014-04-18 22:11:21      interactId:attack      interactName:pvp攻击      targetType:1      targetCode:1002000100021      targetInfo:1002      detail:-99999
role-interact	击杀敌对玩家	time:2014-04-18 22:11:39      interactId:kill      interactName:pvp战斗击杀对方      targetType:1      targetCode:1002000100021      targetInfo:1002      detail:-99999
role-stage	退出战场：长城	time:2014-04-18 22:11:00      stageId:quitbattlefield      stageName:退出战场      detail:greatwall

从上面一系列日志，我们可以发现，玩家马克吐温在加入公会圣光兄弟会后，被卷入了一场公会战争，他在战场上被敌人杀死，随后使用收费道具复仇杀死对方。

4. 日志接入功能开发建议

以下是我们对日志接入功能的一些开发建议，由于网游服务端和客户端技术复杂多变，我们无法面面俱到的为所有游戏提供一套统一的接入规范，因此分享一些接入过程中我们认为对日志发送功能较为有利的开发经验和建议。

4.1.日志发送协议

详细观察我们的日志发送接口，会发现它仅仅由三个参数组成，分别是logId，logKey和logJson，其中logJson是key-val形式的一个映射表。因此我们希望游戏接入日志时，能够预先在客户端和服务器端之间架设这样一个协议：
消息头——日志发送协议ID
消息体——由三个参数组成，分别为logId,logKey和logJson(一个将key-val映射转换为json格式的字符串)
只要服务器端通过该协议向客户端推送了这样一个消息，那么客户端就把消息体的三个参数转换为样例代码中的logId,logKey和logJson对象，然后调用掌趣sdk提供的日志发送接口发送即可。
将来如果有日志格式的改变或者有新的日志需要发送，我们不需要更新已经上线的客户端，只要在服务端增加相应的代码即可完成新日志发送。这样可以避免由于统计数据需求导致强制更新客户端。

附录1：客户端状态码（错误码）

状态码	说明
101	连接超时
102	网络异常，请检查网络
103	数据异常
104	SDK初始化参数错误
105	SDK语言配置文件错误
106	Ourpalm.cfg配置文件错误
107	SDK未初始化成功
108	SDK未设置登录回调
109	未设置服务器id
110	未设置价格
111	未设置货币类型
112	未设置商品名称
113	未设置商品id

附录2：通用局数据

附2.1货币规范

在MIS中的货币有总共九种，货币ID是没有限定位数的纯自增值。

货币ID	货币名称	货币单位
1	人民币	分
2	美元	美分
3	日元	円
4	港币	分
5	英镑	便士
6	新加坡币	分
7	越南盾	分
8	台币	元
9	韩币	分
10	泰铢	萨当
11	卢布	戈比