程序接口

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

1、init
2、login

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

3、logout

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

玩家登录

// 开始登陆 (参数:渠道)
[CAAccount loginStart:@"channel_name"];

// 登陆成功 (参数:用户ID)
[CAAccount loginSuccess:@"usedid_xxx" age:0 sex:0 channel:@"channel_name"];
// channel 获客渠道，指获取该客户的广告渠道信息   
// 登陆失败 (参数:失败原因)
[CAAccount loginFailed:@"密码错误"];

// 退出登陆  （我们已经考虑和完善处理玩家异常登出操作）
[CAAccount logout];

付费行为分析

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

// 开始支付
[CAPayment payBegin:@"1000"             // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
            orderID:@"1943946387"       // 订单ID，唯一标识一次交易。
            payType:@"wechat"           // 支付方式。如：支付宝、苹果iap、银联支付、爱贝支付聚合等。
          subjectID:@"600金币包"         // 商品ID。玩家购买的充值包类型。例如：人民币15元600虚拟币包
       currencyType:@"CNY"              // 请使用ISO 4217中规范的3位字母代码标记货币类型。充值货币类型 
virtualCurrencyAmount:@"1000"           // 充值获得的虚拟币额度。
          accountID:@"wechat_userid"    // 消费的账号  苹果是appleid 安卓是？？
            partner:@"支付渠道"          // 支付渠道。
         gameServer:@"server-100"       // 玩家充值的区服。
              level:@"1"                // 玩家充值时的等级。
            mission:@"开启钻石会员"       // 玩家充值时所在的关卡或任务。亦可传入一个玩家打到的最高关卡。
];

// 支付成功
[CAPayment paySuccess:@"1000"           // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
              orderID:@"1943946387"
              payType:@"wechat"
            subjectID:@"600金币包"
         currencyType:@"CNY"
virtualCurrencyAmount:@"1000"
            accountID:@"wechat_userid"
              partner:@"支付渠道"
           gameServer:@"server-100"
                level:@"1"
              mission:@"开启钻石会员"
];

// 支付失败
[CAPayment payFailed:@"1000"            // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
              orderID:@"1943946387"
              payType:@"wechat"
            subjectID:@"600金币包"
         currencyType:@"CNY"
virtualCurrencyAmount:@"1000"
            accountID:@"wechat_userid"
              partner:@"支付渠道"
           gameServer:@"server-100"
                level:@"1"
              mission:@"开启钻石会员"
               reason:@""               // 充值失败的原因
];

// 取消支付
[CAPayment payCanceled:@"1000"          // 现金金额或现金等价物的额度。例如1元传入100，100元则传入10000
              orderID:@"1943946387"
              payType:@"wechat"
            subjectID:@"600金币包"
         currencyType:@"CNY"
virtualCurrencyAmount:@"1000"
            accountID:@"wechat_userid"
              partner:@"支付渠道"
           gameServer:@"server-100"
                level:@"1"
              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:@"战斗"
               eventData: @{
                           @"life": @"1000",
                           }
];

// 事件完成
[CACustomEvent onSuccess:@"战斗"
               eventData: @{
                           @"life": @"1000",
                           }
];

// 事件取消
[CACustomEvent onCancelled:@"战斗"
                 eventData: @{
                             @"life":@"1000",
                             }
];

// 事件失败
[CACustomEvent onFailed:@"战斗"
              eventData: @{
                          @"life": @"1000",
                          }
                 reason:@"战斗取消"
];