185 lines
5.0 KiB
Objective-C
185 lines
5.0 KiB
Objective-C
//
|
||
// 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
|