You need to enable JavaScript to run this app.
导航
实时分群圈选
最近更新时间:2024.08.29 17:13:47首次发布时间:2023.10.31 11:43:31

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

请求参数

  • 路径

名称

数据类型

是否必选

描述

user

Int

用于查询所在分群的用户id

  • Header

名称

数据类型

是否必选

描述

X-BDPP-Id

String

App id

Authorization

String

Token,以 “Bearer ”开头(注意:Bearer后有空格)

X-Tenant

String

项目id

  • Query参数

名称

数据类型

是否必选

描述

segIds

String

逗号分隔的分群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' \

响应参数

名称

数据类型

描述

data

Array[String]

用户所在的分群ID

code

int

错误码

响应样例

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

2.5 在线服务查询

实时分群的服务配置中,在线服务查询支持:

  • 查询全量:检索实时分群的所有数据。
  • 查询最新分区:仅检索最新分区的数据,适用于需要最新结果的场景,如“当日新注册用户”。