text: //
  //  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
  