全部产品
云市场

友盟SDK使用

更新时间:2020-02-10 14:08:29

友盟SDK接入增量行为数据的优势:

1. 接入成本更低:有成熟的埋点事件,SDK有埋点接口和文档指导客户埋点,无需关注上报问题;
2. 容错性高:直接将数据上报,无需通过层层数据传递;在采集和推送链路中完成双重数据校验,保证数据质量;

流程

1. 申请Appkey

登录友盟智能采集后台。若针对已有appkey启用智能推荐服务,则从左侧的全部appkey列表中选择;若针对尚未创建Appkey的应用启用智能推荐服务,则点击右上角新建应用申请appkey。说明:目前推荐SDK仅支持app应用,暂不支持小程序应用。流程2

2. SDK初始化

按智能采集的流程引导,完成推荐SDK的接入和初始化。

3. 推荐事件埋点

推荐SDK是强规范,故进行了事件封装,将所有行为封装为onRecevent函数,以保证推荐场景对数据的高质量要求。针对推荐触发事件(onRecEvent)的各参数规范的详细说明如下:

参数名称 参数含义 参数规范说明
traceId 效果跟踪ID,为ABtest流量标记,由服务器端分配并下发到设备 枚举类型,不能为空,以AIREC_ALIBABA标记使用智能推荐服务的流量
traceInfo 效果跟踪信息,主要用于推荐模型调优和查错,从AIRec的推荐结果获取后下发到设备 不能为空
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的具体投放场景。
  1. 当推荐不分场景时,sceneId=1;
  2. 如推荐场景>=2时,scenId=行为对应item所在的当前投放场景ID; |

曝光、点击、sceneId的具体埋点规范

4. 集成测试

AIRec SDK调试Log开关打开时,SDK会输出相关调试信息。过滤TAG字段为”RecAgent”。