算法个性化资源位接入流程--增长营销平台-火山引擎

文档中心

导航

算法个性化资源位接入流程

最近更新时间：2024.06.05 17:50:04首次发布时间：2022.12.30 16:58:56

1. 资源位能力介绍

1.1 什么是算法资源位

场景	示例	资源位样式说明
banner轮播		通常出现在屏幕的中上段，常见于电商、内容资讯、游戏、金融等行业
频道		通常在banner轮播的下方，在资讯、金融、电商行业较为常见，也被称为金刚位、运营位。
feed流		是最为常见的营销方式，在小程序、APP、h5、网页等终端都可展示。也被称为推荐列表，可推物料包括：商品、内容、视频、图片、音频等。

步骤	示意图
流程概览
物料同步	通过接口的方式，将已有物料同步至GMP
创建资源位	创建资源位后，根据生成的资源位id进行集成。集成后，在GMP侧配置的素材信息可同步至客户侧
选择推荐物品	配置该资源位可推荐的候选物料可设置兜底物料，以应对算法报错等极端情况
设置建模指标	基于业务场景设置建模指标
数据分析	支持查看推荐位的点击、曝光、渗透数据支持通过算法对物料进行深层分析

2. 数据流转

标红部分：客户重点关注

3. 资源位接入说明

序号	信息确认事项	具体说明
0	物料同步	物料已通过api同步至系统
1	确认埋点采集方案	已部署Finder ：客户端可使用Finder SDK上报埋点数据，GMP可订阅Finder的kafka获取埋点数据未部署Finder部署连接器：可以通过数据连接器的方式接入，详情可咨询火山工程师未部署Finder未部署连接器：只能通过 OpenAPI 方式接入；不支持数据分析，无法实现模型调优
2	确认接入端	APP：支持 SDK（IOS&Android）；支持 OpenAPI H5：支持 SDK ；支持 OpenAPI PC：仅支持 OpenAPI 小程序：仅支持 OpenAPI
3	确认渲染方式	OpenAPI：需客户侧客户端进行渲染，客户侧监听数据，上报给finder / 客户侧服务端客户SDK 渲染：需客户侧客户端进行渲染，客户侧客户端调用 SDK API，GMP资源位SDK上报给finder
4	数据回传客户具有自己的数据平台数据在GMP平台展示	接入客户侧渲染方式：客户侧客户端调用 SDK API，GMP资源位SDK上报给finder 通过Open API 接入，需要根据上报规范进行上报依赖finder；
5	模型构建	输入资源位的用户属性数据、行为数据、物料数据GMP算法数据需求_资源位算法完成建模工作

详见3.3 开始接入

目标	接入文档	操作人
uuid 和CDP基准id建立映射关系	VeCDP-ID图谱构建	火山

接入方式	接入文档
OpenAPI	通过OpenAPI接入算法资源位增长营销平台-火山引擎
Android	Android SDK集成增长营销平台-火山引擎
IOS	iOS SDK集成增长营销平台-火山引擎
H5	H5 SDK集成增长营销平台-火山引擎

日志过滤"GMPResource"查看是否有资源位初始化完成日志

检查初始化配置是否正确，可在日志中过滤"GMPResource"查看错误日志，或者抓包查看请求是否成功响应

id_type 是指在 cdp 上定义了的 id 类型，id 是其对应的值。如下，基准（baseid）、uid、device_id、phoneid、web_id 都是 id_type，1581486 是其中一个用户的基准id（baseid）

如果接入了 finder sdk，客户端可以通过 fidner sdk 获取到 device_id，web端/小程序可以通过 finder sdk 获取到 web_id，如果有自己定义的 id 类型，也有自己的途径可以获取到，并且能够同步到 cdp 中的话，使用自己定义的 id 类型也是可以的。

在 gmp 上配置好资源位后即可看到资源位的 id 了。