文档

友盟IOS SDK使用方法

更新时间:

下载SDK

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

1.iOS SDK下载

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

12

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

3

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"];
    //设置场景(此方法在统计SDK7.0以及更新的版本中可省去,已自动实现)
    [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。

  • 本页导读 (0)
文档反馈