程序接口

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

1、init
2、login

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

3、logout

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

玩家登录

  1. // 开始登陆 (参数:渠道)
  2. [CAAccount loginStart:@"channel_name"];
  4. // 登陆成功 (参数:用户ID)
  5. [CAAccount loginSuccess:@"usedid_xxx" age:0 sex:0 channel:@"channel_name"];
  6. // channel 获客渠道，指获取该客户的广告渠道信息   
  7. // 登陆失败 (参数:失败原因)
  8. [CAAccount loginFailed:@"密码错误"];
  10. // 退出登陆  （我们已经考虑和完善处理玩家异常登出操作）
  11. [CAAccount logout];

付费行为分析

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

  1. // 开始支付
  2. [CAPayment payBegin:@"1000"             // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
  3.             orderID:@"1943946387"       // 订单ID，唯一标识一次交易。
  4.             payType:@"wechat"           // 支付方式。如：支付宝、苹果iap、银联支付、爱贝支付聚合等。
  5.           subjectID:@"600金币包"         // 商品ID。玩家购买的充值包类型。例如：人民币15元600虚拟币包
  6.        currencyType:@"CNY"              // 请使用ISO 4217中规范的3位字母代码标记货币类型。充值货币类型 
  7. virtualCurrencyAmount:@"1000"           // 充值获得的虚拟币额度。
  8.           accountID:@"wechat_userid"    // 消费的账号  苹果是appleid 安卓是？？
  9.             partner:@"支付渠道"          // 支付渠道。
  10.          gameServer:@"server-100"       // 玩家充值的区服。
  11.               level:@"1"                // 玩家充值时的等级。
  12.             mission:@"开启钻石会员"       // 玩家充值时所在的关卡或任务。亦可传入一个玩家打到的最高关卡。
  13. ];
  15. // 支付成功
  16. [CAPayment paySuccess:@"1000"           // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
  17.               orderID:@"1943946387"
  18.               payType:@"wechat"
  19.             subjectID:@"600金币包"
  20.          currencyType:@"CNY"
  21. virtualCurrencyAmount:@"1000"
  22.             accountID:@"wechat_userid"
  23.               partner:@"支付渠道"
  24.            gameServer:@"server-100"
  25.                 level:@"1"
  26.               mission:@"开启钻石会员"
  27. ];
  29. // 支付失败
  30. [CAPayment payFailed:@"1000"            // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
  31.               orderID:@"1943946387"
  32.               payType:@"wechat"
  33.             subjectID:@"600金币包"
  34.          currencyType:@"CNY"
  35. virtualCurrencyAmount:@"1000"
  36.             accountID:@"wechat_userid"
  37.               partner:@"支付渠道"
  38.            gameServer:@"server-100"
  39.                 level:@"1"
  40.               mission:@"开启钻石会员"
  41.                reason:@""               // 充值失败的原因
  42. ];
  44. // 取消支付
  45. [CAPayment payCanceled:@"1000"          // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
  46.               orderID:@"1943946387"
  47.               payType:@"wechat"
  48.             subjectID:@"600金币包"
  49.          currencyType:@"CNY"
  50. virtualCurrencyAmount:@"1000"
  51.             accountID:@"wechat_userid"
  52.               partner:@"支付渠道"
  53.            gameServer:@"server-100"
  54.                 level:@"1"
  55.               mission:@"开启钻石会员"
  56. ];

自定义事件统计

事件 ID 可以任意填写，事件内容及标签灵活自定义。后台根据事件内定义的标签进行相关统计和漏斗分析。例如：

  1. "evetID":"barrier",
  2. "eventValue":{
  3.         "关卡数" : "魔法瓶",
  4.         "玩家级别" : "100",
  5.         "玩家战力" : 100,
  6.         "复活次数" : 100,
  7.         }

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

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

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

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

  1. // 开始事件
  2. [CACustomEvent onStarted:@"战斗"
  3.                eventData: @{
  4.                            @"life": @"1000",
  5.                            }
  6. ];
  8. // 事件完成
  9. [CACustomEvent onSuccess:@"战斗"
  10.                eventData: @{
  11.                            @"life": @"1000",
  12.                            }
  13. ];
  15. // 事件取消
  16. [CACustomEvent onCancelled:@"战斗"
  17.                  eventData: @{
  18.                              @"life":@"1000",
  19.                              }
  20. ];
  22. // 事件失败
  23. [CACustomEvent onFailed:@"战斗"
  24.               eventData: @{
  25.                           @"life": @"1000",
  26.                           }
  27.                  reason:@"战斗取消"
  28. ];