友盟IOS SDK使用方法

下载Sdk

重要说明：AIRec需要配合友盟基础组件库 2.1.2+版本和统计SDK 6.0.6+版本一起使用。

1.iOS SDK下载

2. 解压下载后的zip文件，将得到common目录下的基础组件库UMCommon.framework及analytics目录下的UMAnalytics.framework导入工程，并将其加入工程依赖。

3. 将最新版本智能推荐SDK包AIRec.framework导入工程中。

4. Targets->BuildSettings设置，Targets->BuildSettings 中 ， Other Linker Flags增加-Objc，一定要添加此项，注意是大写C，不是小写c

基础SDK初始化

1. 在友盟官网注册账号，并申请Appkey。友盟基础组件库的初始化函数需要传入此Appkey。
2. 在目标工程- (BOOL)application:(UIApplication)application didFinishLaunchingWithOptions:(NSDictionary)launchOptions 中执行友盟基础组件库初始化函数，设置统计场景。下面的示例代码摘自AIRec SDK集成Demo工程。

   (BOOL)APPLICATION:(UIAPPLICATION *)APPLICATION DIDFINISHLAUNCHINGWITHOPTIONS:(NSDICTIONARY *)LAUNCHOPTIONS {
   // OVERRIDE POINT FOR CUSTOMIZATION AFTER APPLICATION LAUNCH.
   //初始化
   [UMCONFIGURE INITWITHAPPKEY:@"59C5EF6EB27B0A393E00002B" CHANNEL:@"APP STORE"];
   //设置场景
   [MOBCLICK SETSCENARIOTYPE:E_UM_NORMAL];
   //设置USERID
   [AIREC SETRECUSERID:@"SET USERID"];
   //设置是否登录
   [AIREC SETRECLOGIN:YES];
   RETURN YES;
   }

   如果需要使用友盟统计SDK高级功能，请参考如下链接：如果需要使用友盟统计SDK高级功能，请参考如下链接：

   友盟SDK集成文档

   智能推荐SDK集成

   SDK API说明

   请在完成友盟基础组件库初始化函数调用之后调用AIRec SDK初始化函数。 请在调用AIRec SDK初始化函数之后再调用其它功能接口函数。

设置UserId函数

 /** 设置userId
@param  userId 用户ID
@return void.
*/
+ (void)setRecUserId:(NSString *)userId;

例子：

     [AIRec setRecUserId:@"set userId"];

设置是否登录函数

 /** 设置是否登录
@param  isLogin 是否登录，如传nil为未登录
@return void.
*/

例子：

 [AIRec setRecLogin:YES];

推荐事件触发函数：

/**
 * 行为事件类型
 */
typedef NS_ENUM (NSUInteger, bhvType)
{
 AI_REC_EXPOSE = 0, // 曝光
 AI_REC_STAY, // 停留
 AI_REC_CLICK,  // 点击
 AI_REC_CART, // 加入购物车
 AI_REC_BUY,  // 购买
 AI_REC_COLLECT,  // 收藏
 AI_REC_LIKE, // 点赞
 AI_REC_UNLIKE, // 点衰
 AI_REC_COMMENT,  // 写评论
 AI_REC_SHARE,  // 分享
 AI_REC_SUBSCRIBE // 订阅
 AI_REC_EVALUATE // 评价
};
/**
 * 效果测试跟踪ID
 */
static NSString * const AIREC_ALIBABA;
static NSString * const AIREC_SELFHOLD;
/** 发送时间方法
     bizId 
     sceneId 默认值为1
     traceId NSString类型 ，（AIREC_ALIBABA值为Alibaba ， AIREC_SELFHOLD值为Selfhold）
     traceInfo
     itemId
     itemType
     bhvType 枚举traceIdType 
     bhvValue
     (注：1. 当bhvType=AI_REC_STAY时，bhvValue值能传数字，代表停留时间，单位为秒s，如传字符串默认值为0；
                 2. 当bhvType=AI_REC_CLICK时，bhvValue传1；
                 3. 当AI_REC_EVALUATE时，bhvValue传数字，代表评价等级）
     parameters 自定义参数
  */
  + (void)onRecEvent:(NSString *)bizId sceneId:(NSString *)sceneId traceId:(NSString *)traceId traceInfo:(NSString *)traceInfo itemId:(NSString *)itemId itemType:(NSString *)itemType bhvType:(bhvType)bhvType bhvValue:(NSString *)bhvValue parameters:(NSDictionary *)parameters;

例子：

     [AIRec onRecEvent:@"bizID" sceneId:@"sceneID" traceId:AIREC_ALIBABA traceInfo:@"traceInfo111" itemId:@"itemID222" itemType:@"itemType33" bhvType:AI_REC_STAY bhvValue:@"bhvValue44" parameters:@{@"aa":@"bb"}];

SDK集成调试

AIRec SDK会输出相关调试信息。过滤TAG字段为”RecAgent”,如需查看发送数据log，需集成UMCommonLog.framework 和 UMCommonLog.bundle，具体集成参考文档：https://developer.umeng.com/docs/66632/detail/66891

• 注意：App正式上线前请关闭SDK调试Log。