You need to enable JavaScript to run this app.
导航

实时分群圈选

最近更新时间2024.03.28 11:23:43

首次发布时间2024.03.28 11:23:43

1. 概述

实时分群圈选,是指支持基于上游实时数据源,实现人群的实时更新。

当前支持的能力包括:创建实时分群、查询最新分群包数量、下载最新分群文件,以及通过OpenApi的形式查询用户是否属于某实时分群包。

2. 操作说明

注意:

  1. 实时分群资源上限默认50个,最高500个。

  2. 实时分群不、支持将分群包结果存为其他ID类型。

  3. 实时&离线分群能力存在差异,如下:

离线&实时分群 能力差异

功能分类具体功能离线实时

创建&更新

创建规则分群时可用的数据

  1. 离线标签+实时标签

  2. 离线属性

  3. 离线人群~~+~~实时人群

  4. 离线行为+实时行为

  5. 离线明细数据

  1. 离线标签+实时标签

  2. 离线属性

  3. 离线人群~~+~~实时人群

  4. 实时行为(时间范围仅支持当天)

  5. 实时明细数据(时间范围仅支持当天,1.19版本支持)

*需要至少一个实时数据源

圈选的操作符有所限制,不支持高级/聚合类的判断,如:

  • 标签、行为属性、用户属性的「文本类型」不支持全局不包含、like、正则匹配;

  • 标签、行为属性、用户属性的「时间日期类型」不支持全局不包含

  • 标签、行为属性、用户属性的「数值型」不支持topN

首次创建的数据按最新的历史数据按最新的数据
数据更新频次按需/按天t+1实时

保存为其他ID类型
(非baseid)

支持

支持

分群主体转换支持暂不支持
下载下载分群包支持支持
下载分群包明显支持支持
隐私脱敏策略生效支持支持

应用

群体洞察

支持

支持

分群用户明细-个体画像支持支持
推送GMP触达任务支持支持

服务配置
(导入在线服务,用于api查询用户是否属于某分群)

支持

支持

高级操作

复制/删改查/授权/分组

支持

支持

拆包支持不支持

更新(手动触发)

支持

支持(手工触发对离线部分,本身实时流持续更新)

修改更新频次按天/按需 修改启动实时/中断实时(任务运行切换)

2.1 创建建实时分群

  1. 点击 用户分群-创建私域分群 ,选择 规则创建(实时分群包)

  1. 配置分群包创建规则,可使用实时标签、实时人群、实时行为与离线数据相结合,创建实时更新的分群包。

说明

实时规则圈选相对于离线,有部分能力限制:

  1. 仅支持实时行为数据源,不支持离线数据源

  2. 行为不支持选择未做过、全局未做过、依次做过

  3. 标签、行为属性、用户属性的「文本类型」不支持全局不包含、like、正则匹配;

  4. 标签、行为属性、用户属性的「时间日期类型」不支持全局不包含

  5. 标签、行为属性、用户属性的「数值型」不支持topN

如使用以上逻辑会引起创建失败

  1. 完成规则配置后,点击右上角 保存 即可。

2.2 查询最新分群包数量

对于创建完成的实时分群包,点击分群数量位置的 同步最新数据,即可查询最新的分群包数量。

2.3 下载实时分群文件

点击 “…”-下载分群包,支持将下载当前实时分群的明细文件。

2.4 通过API查询某用户是否属于实时分群

  1. 点击 “…”-服务配置,支持开启分群在线服务。

  1. 点击 查看已经导入在线服务的分群列表 ,将跳转到分群在线服务配置的列表页。


接口调用方式如下:
基本信息

生效版本1.9+
功能描述给定一个 用户id, 一系列分群id, 返回用户所在的分群id
请求路径**/openapi/online/v1/**user/{user}/segs
请求类型GET

请求参数

  • 路径
名称数据类型是否必选描述
userInt用于查询所在分群的用户id
  • Header
名称数据类型是否必选描述
X-BDPP-IdStringApp id
AuthorizationStringToken,以 “Bearer ”开头(注意:Bearer后有空格)
X-TenantString项目id
  • Query参数
名称数据类型是否必选描述
segIdsString逗号分隔的分群ID,例如 1,2,3

请求样例

curl --location --request GET 'http://10.248.134.123:30530/openapi/online/v1/user/17/segs?segIds=1,2,3' \
--header 'X-BDPP-Id: xxx' \
--header 'Authorization: xxx' \

响应参数

名称数据类型描述
dataArray[String]用户所在的分群ID
codeint错误码

响应样例

{
    "data": [
        "1",
        "11"
    ]
    "code": 0
}