You need to enable JavaScript to run this app.
导航
实时分群圈选
最近更新时间:2025.10.22 10:57:25首次发布时间:2024.03.28 11:23:43
复制全文
我的收藏
有用
有用
无用
无用

实时分群圈选,是指支持基于上游实时数据源,实现人群的实时更新。本文为您介绍如何创建和管理实时分群。

能力介绍

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

使用限制
  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查询用户是否属于某分群)

    支持

    支持

    高级操作

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

    支持

    支持

    拆包

    支持

    不支持

    更新(手动触发)

    支持

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

    修改更新频次

    按天/按需 修改

    启动实时/中断实时(任务运行切换)

操作说明

创建实时分群

  1. 在客户数据平台,选择「用户分群 」,点击「+创建私域分群 」,创建方式选择「规则创建分群 」-「实时分群 」。

Image

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

Image

说明

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

  • 仅支持实时行为数据源,不支持离线数据源;
  • 行为不支持选择未做过、全局未做过、依次做过;
  • 标签、行为属性、用户属性的「文本类型」不支持全局不包含、like、正则匹配;
  • 标签、行为属性、用户属性的「时间日期类型」不支持全局不包含;
  • 标签、行为属性、用户属性的「数值型」不支持topN;

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

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

查询最新分群包数量

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

管理实时分群

在分群管理页面,支持对分群进行下载明细数据、授权、复制等操作,类似于离线分群。

下载实时分群文件

点击「…」-「下载分群」,支持将下载当前实时分群的明细文件。
Image

在线服务查询

实时分群的服务配置支持在线服务查询,可以通过API查询某用户是否属于实时分群

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

Image

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

Image

接口调用方式

基本信息

生效版本

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
}