说明:客户端SDK用于采集发生在APP中的终端用户行为。
友盟SDK接入增量行为数据的优势:
1. 接入成本更低:有成熟的埋点事件,SDK有埋点接口和文档指导客户埋点,无需关注上报问题;
2. 容错性高:直接将数据上报,无需通过层层数据传递;在采集和推送链路中完成双重数据校验,保证数据质量;
1. 申请Appkey
登录友盟智能采集后台。若针对已有appkey启用智能推荐服务,则从左侧的全部appkey列表中选择;若针对尚未创建Appkey的应用启用智能推荐服务,则点击右上角新建应用申请appkey。说明:目前推荐SDK仅支持app应用,暂不支持小程序应用。
2. SDK初始化
按智能采集的流程引导,完成推荐SDK的接入和初始化。
3. 推荐事件埋点
推荐SDK是强规范,故进行了事件封装,将所有行为封装为onRecevent函数,以保证推荐场景对数据的高质量要求。针对推荐触发事件(onRecEvent)的各参数规范的详细说明如下:
参数名称 | 参数含义 | 参数规范说明 |
traceId | 效果跟踪ID,为ABtest流量标记,由服务器端分配并下发到设备 | 枚举类型,不能为空,以AIREC_ALIBABA标记使用智能推荐服务的流量 |
traceInfo | 效果跟踪信息,主要用于推荐模型调优和查错,从AIRec的推荐结果获取后下发到设备 | 不能为空,如traceId不等于Alibaba 则traceInfo填:1 |
itemId | 物品ID | 不能为空 |
itemType | 物品类型 | 不能为空, 根据实际需求,从以下类型中选择 image article video shortvideo item recipe audio(如当前类型不满足,请联系技术人员沟通解决方案) |
bhvType | 行为事件类型 | 枚举类型,不能为空,客户端采集按如下规范定义:expose, // 曝光 click, // 点击 cart, // 加入购物车 buy, // 购买 collect, // 收藏 like, // 点赞 unlike, // 点衰 comment, // 写评论 share, // 分享 subscribe, // 订阅 stay // 停留 |
bhvValue | 行为参数 | 当bhvType参数为stay时,需传入数字,单位为ms,表示停留时长 |
bizId | 行为数据的功能场景 | 枚举型,分为:推荐101,//推荐内容列表; 内容详情页103,//单条内容的详细页面,如商品详情页,文章详情页; 搜索102,//搜索框及搜索结果展示页面; 评价104,//; 购物车105,//; 购后页面106,//; 私域流量页107,//店铺or活动页面;其它自定义108,//可根据实际业务场景自定义,所有自定义场景编码统一 |
sceneId | item的投放场景 | 自定义,可以理解是对item可露出页面的标记分类,在客户端数据采集时,为当前行为所对应item的具体投放场景。 |
当推荐不分场景时,sceneId=1;
如推荐场景>=2时,sceneId=行为对应item所在的当前投放场景ID; |
4. 集成测试
AIRec SDK调试Log开关打开时,SDK会输出相关调试信息。过滤TAG字段为”RecAgent”。