SuperAPI AI 工具集

data360-segment

数据与分析

查看项目

更新于 10-15 21:43

技能介绍

用途:处理 Data Cloud 的受众与洞察工作,包括分群(segment)、计算洞察(calculated insight)、发布流程、成员计数及分群 SQL 排查。涉及 sf data360 segment *、sf data360 calculated-insight * 时使用本技能;若在构建 DMO、映射或身份解析应转 data360-harmonize,下游激活转 data360-activate,只读 SQL 查询转 data360-query。

使用前需收集:目标 org 别名、统一 DMO 或基础实体名、意图(创建/发布/检查/排查)、资产类型(分群或计算洞察)、成功指标(成员数、聚合值或发布状态)。

核心规则:Data Cloud 分群 SQL 与 CRM SOQL 不同;变更前先运行就绪分类脚本 node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase segment --json;优先使用可复用的 JSON 定义;创建行为不稳定时加 --api-version 64.0;发布或运行后须用计数或 SQL 验证,而非假定成功;需要可读成员详情时用 SQL join 而非 segment members。

工作流:1) 分类就绪状态;2) 查看现状 sf data360 segment list -o <org> 与 sf data360 calculated-insight list -o <org>;3) 用 JSON 创建 sf data360 segment create -o <org> -f segment.json --api-version 64.0 与 sf data360 calculated-insight create -o <org> -f ci.json;4) 显式发布或运行 sf data360 segment publish -o <org> --name My_Segment 与 sf data360 calculated-insight run -o <org> --name Lifetime_Value;5) 验证 sf data360 segment count -o <org> --name My_Segment 或 sf data360 query sql -o <org> --sql '...'。

注意:分群创建可能需 --api-version 64.0;segment members 返回不透明 ID;分群 SQL 非 SOQL;计算洞察与分群 SQL 限制不同;发布/运行可能触发异步作业;空列表通常表示模块可达但未配置。

输出格式:分段任务、动作、目标 org、产物、验证、下一步。参考资料包括 ../data360-orchestrate 下的计算洞察与分群模板及 feature-readiness.md。