程序接口

程序接口

特别注意：只有调用退出登录方法，才会有游戏时长和活跃用户等指标。一次完整会话链路核心设计有三步：

1、init
2、login

（中间任意消费和自定义事件）

3、logout

程序接口包括 玩家登录、付费行为分析、自定义事件统计 三种：

玩家登录

// 开始登录
CAAccount.loginStart(
    String channel // 获客渠道，指获取该客户的广告渠道信息    
);
// 登录成功
CAAccount.loginSuccess(
    String uid,    // 用户ID
    int age,        // 年龄 
    int sex,        // 性别
    String channel // 获客渠道，指获取该客户的广告渠道信息    
);
// 登录失败
CAAccount.loginFailed(
    String reason // 登录失败原因     
);
// 退出登录  （我们已经考虑和完善处理玩家异常登出操作）
CAAccount.logout();

付费行为分析

非实际付费渠道，只是收集付费行为

// 开始支付
CAPayment.payBegin(
    int amount,                     // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
    String orderID,                 // 订单ID，唯一标识一次交易。
    String payType,                 // 支付方式。如：支付宝、苹果iap、银联支付、爱贝支付聚合等。
    String iapID,                   // 商品ID。玩家购买的充值包类型。例如：人民币15元600虚拟币包
    String currencyType,            // 请使用ISO 4217中规范的3位字母代码标记货币类型。充值货币类型
    String virtualCurrencyAmount,   // 充值获得的虚拟币额度。
    String accountID,               // 消费的账号  苹果是appleid 安卓是？？
    String partner,                 // 支付渠道
    String gameServer,              // 玩家充值的区服。
    String level,                   // 玩家充值时的等级。
    String mission                  // 玩家充值时所在的关卡或任务。亦可传入一个玩家打到的最高关卡
)
// 支付成功
CAPayment.paySuccess(
    int amount,                     // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
    String orderID,
    String payType,
    String iapID,
    String currencyType,
    String virtualCurrencyAmount,
    String accountID,
    String partner,
    String gameServer,
    String level,
    String mission
);
// 支付失败
CAPayment.payFailed(
    int amount,                     // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
    String orderID,
    String payType,
    String iapID,
    String currencyType,
    String virtualCurrencyAmount,
    String accountID,
    String partner,
    String gameServer,
    String level,
    String mission,
    String reason           // 充值失败的原因
);
// 支付取消
CAPayment.payCanceled(
    int amount,                     // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
    String orderID,
    String payType,
    String iapID,
    String currencyType,
    String virtualCurrencyAmount,
    String accountID,
    String partner,
    String gameServer,
    String level,
    String mission
);

自定义事件统计

事件 ID 可以任意填写，事件内容及标签灵活自定义。例如：

"evetID":"barrier",
"eventValue":{
        "关卡数" : "魔法瓶",
        "玩家级别" : "100",
        "玩家战力" : 100,
        "复活次数" : 100,
        }

长度限制： eventid（事件ID） 200；tagkey（标签id） 200 ；tagvalue（标签值） 200。

例子中：”barrier” 为 eventID ; “关卡数” 为 tagkey;”魔法瓶” 为 tagvalue。

自定义事件内置了一些默认模板，包括玩家信息、关卡统计、任务统计、道具统计等，具体可查看 默认模版 部分的文档内容。注意：事件 ID 不可使用关键字：init、pay、task、barrier、item、advertising、role、virtual，以免和默认模板的数据产生混淆。

后台根据事件内定义的标签进行相关统计和漏斗分析。

接口中eventdata不能传空值，空值将无法进行后续的统计分析工作。

//  开始事件
CACustomEvent.onStarted(
    final String eventID,   // 事件ID
    JSONObject eventData    // 自定义数据(JSONObject)不要传空值
);
// 事件完成
CACustomEvent.onSuccess(
    final String eventID,
    JSONObject eventData  // 自定义数据(JSONObject)不要传空值
);
// 事件取消
CACustomEvent.onCancelled(
    final String eventID,
    JSONObject eventData // 自定义数据(JSONObject)不要传空值
);
// 事件失败
CACustomEvent.onFailed(
    final String eventID,
    JSONObject eventData, 
    String reason           // 失败原因
);

3.3.2. 程序接口

程序接口

玩家登录

付费行为分析

自定义事件统计