New file |
| | |
| | | // |
| | | // MobClickGameAnalytics.h |
| | | // Analytics |
| | | // |
| | | // Copyright (C) 2010-2014 Umeng.com . All rights reserved. |
| | | |
| | | @interface MobClickGameAnalytics : NSObject |
| | | |
| | | #pragma mark - account function |
| | | /** active user sign-in. |
| | | 使用sign-In函数后,如果结束该PUID的统计,需要调用sign-Off函数 |
| | | @param puid : user's ID |
| | | @param provider : 不能以下划线"_"开头,使用大写字母和数字标识; 如果是上市公司,建议使用股票代码。 |
| | | @return void. |
| | | */ |
| | | + (void)profileSignInWithPUID:(NSString *)puid; |
| | | + (void)profileSignInWithPUID:(NSString *)puid provider:(NSString *)provider; |
| | | |
| | | /** active user sign-off. |
| | | 停止sign-in PUID的统计 |
| | | @return void. |
| | | */ |
| | | + (void)profileSignOff; |
| | | |
| | | #pragma mark GameLevel methods |
| | | ///--------------------------------------------------------------------------------------- |
| | | /// @name set game level |
| | | ///--------------------------------------------------------------------------------------- |
| | | |
| | | /** 设置玩家的等级. |
| | | */ |
| | | |
| | | /** 设置玩家等级属性. |
| | | @param level 玩家等级 |
| | | @return void |
| | | */ |
| | | + (void)setUserLevelId:(int)level; |
| | | |
| | | ///--------------------------------------------------------------------------------------- |
| | | /// @name 关卡统计 |
| | | ///--------------------------------------------------------------------------------------- |
| | | |
| | | /** 记录玩家进入关卡,通过关卡及失败的情况. |
| | | */ |
| | | |
| | | |
| | | /** 进入关卡. |
| | | @param level 关卡 |
| | | @return void |
| | | */ |
| | | + (void)startLevel:(NSString *)level; |
| | | |
| | | /** 通过关卡. |
| | | @param level 关卡,如果level == nil 则为当前关卡 |
| | | @return void |
| | | */ |
| | | + (void)finishLevel:(NSString *)level; |
| | | |
| | | /** 未通过关卡. |
| | | @param level 关卡,如果level == nil 则为当前关卡 |
| | | @return void |
| | | */ |
| | | |
| | | + (void)failLevel:(NSString *)level; |
| | | |
| | | |
| | | #pragma mark - |
| | | #pragma mark Pay methods |
| | | |
| | | ///--------------------------------------------------------------------------------------- |
| | | /// @name 支付统计 |
| | | ///--------------------------------------------------------------------------------------- |
| | | |
| | | /** 记录玩家交易兑换货币的情况 |
| | | @param currencyAmount 现金或等价物总额 |
| | | @param currencyType 为ISO4217定义的3位字母代码,如CNY,USD等(如使用其它自定义等价物作为现金,可使用ISO4217中未定义的3位字母组合传入货币类型) |
| | | @param virtualAmount 虚拟币数量 |
| | | @param channel 支付渠道 |
| | | @param orderId 交易订单ID |
| | | @return void |
| | | */ |
| | | + (void)exchange:(NSString *)orderId currencyAmount:(double)currencyAmount currencyType:(NSString *)currencyType virtualCurrencyAmount:(double)virtualAmount paychannel:(int)channel; |
| | | |
| | | /** 玩家支付货币兑换虚拟币. |
| | | @param cash 真实货币数量 |
| | | @param source 支付渠道 |
| | | @param coin 虚拟币数量 |
| | | @return void |
| | | */ |
| | | |
| | | + (void)pay:(double)cash source:(int)source coin:(double)coin; |
| | | |
| | | /** 玩家支付货币购买道具. |
| | | @param cash 真实货币数量 |
| | | @param source 支付渠道 |
| | | @param item 道具名称 |
| | | @param amount 道具数量 |
| | | @param price 道具单价 |
| | | @return void |
| | | */ |
| | | + (void)pay:(double)cash source:(int)source item:(NSString *)item amount:(int)amount price:(double)price; |
| | | |
| | | |
| | | #pragma mark - |
| | | #pragma mark Buy methods |
| | | |
| | | ///--------------------------------------------------------------------------------------- |
| | | /// @name 虚拟币购买统计 |
| | | ///--------------------------------------------------------------------------------------- |
| | | |
| | | /** 记录玩家使用虚拟币的消费情况 |
| | | */ |
| | | |
| | | |
| | | /** 玩家使用虚拟币购买道具 |
| | | @param item 道具名称 |
| | | @param amount 道具数量 |
| | | @param price 道具单价 |
| | | @return void |
| | | */ |
| | | + (void)buy:(NSString *)item amount:(int)amount price:(double)price; |
| | | |
| | | |
| | | #pragma mark - |
| | | #pragma mark Use methods |
| | | |
| | | |
| | | ///--------------------------------------------------------------------------------------- |
| | | /// @name 道具消耗统计 |
| | | ///--------------------------------------------------------------------------------------- |
| | | |
| | | /** 记录玩家道具消费情况 |
| | | */ |
| | | |
| | | |
| | | /** 玩家使用虚拟币购买道具 |
| | | @param item 道具名称 |
| | | @param amount 道具数量 |
| | | @param price 道具单价 |
| | | @return void |
| | | */ |
| | | |
| | | + (void)use:(NSString *)item amount:(int)amount price:(double)price; |
| | | |
| | | |
| | | #pragma mark - |
| | | #pragma mark Bonus methods |
| | | |
| | | |
| | | ///--------------------------------------------------------------------------------------- |
| | | /// @name 虚拟币及道具奖励统计 |
| | | ///--------------------------------------------------------------------------------------- |
| | | |
| | | /** 记录玩家获赠虚拟币及道具的情况 |
| | | */ |
| | | |
| | | |
| | | /** 玩家获虚拟币奖励 |
| | | @param coin 虚拟币数量 |
| | | @param source 奖励方式 |
| | | @return void |
| | | */ |
| | | |
| | | + (void)bonus:(double)coin source:(int)source; |
| | | |
| | | /** 玩家获道具奖励 |
| | | @param item 道具名称 |
| | | @param amount 道具数量 |
| | | @param price 道具单价 |
| | | @param source 奖励方式 |
| | | @return void |
| | | */ |
| | | |
| | | + (void)bonus:(NSString *)item amount:(int)amount price:(double)price source:(int)source; |
| | | |
| | | #pragma mark DEPRECATED |
| | | |
| | | //已经被新的setUserLevelId:方法替代,请使用新的API。 |
| | | + (void)setUserLevel:(NSString *)level; |
| | | |
| | | //已经被新的active user方法替代,请使用新的API。 |
| | | + (void)setUserID:(NSString *)userId sex:(int)sex age:(int)age platform:(NSString *)platform; |
| | | |
| | | @end |