You need to enable JavaScript to run this app.
导航
增长营销平台
  • 文档首页
    • /
  • 增长营销平台

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

最近更新时间：2023.07.13 14:01:17

首次发布时间：2022.12.30 16:58:56

我的收藏
1. 资源位能力介绍

1.1 什么是算法资源位

场景示例资源位样式说明

banner轮播

  • 通常出现在屏幕的中上段，常见于电商、内容资讯、游戏、金融等行业

频道

  • 通常在banner轮播的下方，在资讯、金融、电商行业较为常见，也被称为金刚位、运营位。

feed流

  • 是最为常见的营销方式，在小程序、APP、h5、网页等终端都可展示。也被称为推荐列表，可推物料包括：商品、内容、视频、图片、音频等。

1.2 如何创建资源位

步骤示意图
流程概览

物料同步

  • 通过接口的方式，将已有物料同步至GMP

创建资源位

  • 创建资源位后，根据生成的资源位id进行集成。集成后，在GMP侧配置的素材信息可同步至客户侧

选择推荐物品

  • 配置该资源位可推荐的候选物料

  • 可设置兜底物料，以应对算法报错等极端情况

设置建模指标

  • 基于业务场景设置建模指标

数据分析

支持查看推荐位的点击、曝光、渗透数据
支持通过算法对物料进行深层分析


2. 数据流转

标红部分：客户重点关注
alt

3. 资源位接入说明

3.1 接入前重点信息确认

序号信息确认事项具体说明
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

模型构建

3.2 接入前置条件

集成并初始化Finder SDK

详见3.3 开始接入

CDP IdMapping 配置

目标接入文档操作人
uuid 和CDP基准id建立映射关系客户数据平台-火山引擎-ID Mapping火山

3.3 开始接入

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

3.4 常见Q&A

如何判断是否初始化成功？

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

发起资源位请求后无资源

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

id、id_type 具体指什么

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

id 怎么获取

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

资源位 id 怎么获取

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