用途
Segment Performance Comparator 用于在 Customer Journey Analytics（CJA）中，将 2–5 个受众细分（segment）在一组关键指标上进行并排比较。输出不仅展示每个细分单独的表现，还指出每个指标上哪个细分胜出或落后，以及哪些差异大到值得采取行动。该技能以数据回答“我们应该聚焦哪个受众？”这一问题，服务于产品决策、个性化策略与预算分配。
主要能力
- 通过名称或关键词搜索细分（findSegments），并用 describeSegment 核验细分逻辑。
- 当没有现成细分时，可基于纯英文描述在报告内联创建临时 ad hoc 细分（adhocSegments），无需保存。
- 解析基础指标（findMetrics）与自定义 KPI（findCalculatedMetrics）。
- 未指定指标时，通过 listComponentUsage 按使用量取前 6–8 个指标作为默认比较集，并优先使用计算指标。
- 对每个细分运行一次 runReport，收集指标值并构建矩阵（行=指标，列=细分）。
- 按行标记胜出/落后细分，计算差异幅度（(max−min)/max×100），当幅度大于 10% 时标记为显著差异。
- 生成 HTML 对比报告并写入 /tmp/cja_segment_performance_comparator_report_<YYYY-MM-DD_HHMMSS>.html，随后用 open 命令打开。
- 生成 3–5 条叙述性洞察，涵盖整体胜出者、最大差异、意外持平、可行动信号与异常。
使用方式
工作流分为多个阶段：
- 设置：调用 findDataViews 列出可用数据视图；若用户未指定，则展示列表并询问；调用 setDefaultSessionDataViewId 设置所选 ID；确认要比较的细分与指标。
- 识别细分：从用户描述解析细分并核验；若不存在匹配细分，可提议创建临时 ad hoc 细分；单次比较最多 5 个细分，超出时提示按使用量或列表顺序优先排序。
- 识别指标：解析用户指定指标，或按使用量取前 6–8 个；优先计算指标；移除对某细分会恒为零的指标。
- 运行比较：对每个细分运行 runReport，metricIds 为逗号分隔字符串，使用 startDate/endDate（非 dateRange），并需提供 dimensionIds（即使仅汇总报告，也使用低基数维度如 variables/daterangeday 或 variables/web.webPageDetails.name）；汇总值位于 summaryData.filteredTotals。
- 构建矩阵：按指标×细分填充值，标记胜出/落后，计算差异幅度并标记显著差异。
- 生成 HTML 报告：读取 template.html 并原样使用，仅填充占位符（如 {ORG_NAME}、{DATE_RANGE}、{DATA_VIEW}、{GENERATED_DATE}、{SEGMENT_NAMES_SUMMARY}、{SEGMENT_NAME}、{COLOR}、{VISITOR_COUNT}、{NUM_SEGMENTS}、{NUM_METRICS}、{NUM_SIGNIFICANT}、{OVERALL_WINNER}、{METRIC_NAME}、{VALUE}、{WINNER_SEGMENT}、{SPREAD}、{INSIGHT_TEXT}），并按数据项重复细分标签、矩阵行与洞察框；按胜出/落后规则使用 cell-winner / cell-loser 类。
- 叙述洞察：生成 3–5 条纯英文洞察，点名具体细分与指标值。
- 交付：内联摘要说明整体胜出细分、最大差距指标与一条可行动建议。
适用场景
- 比较移动端与桌面端等受众表现。
- 比较新访客与回访访客、不同获客渠道等群体。
- 为产品决策、个性化策略与预算分配提供数据依据。
限制与注意事项
- 只读分析，绝不删除或修改细分或计算指标。
- 运行前必须确认细分；名称有歧义时展示匹配的细分 ID 与定义。
- 所有细分必须使用相同日期范围，跨时间窗口比较会产生误导。
- 需注意细分之间的受众重叠，重叠较大时“差异”可能被夸大。
- 单次比较细分数量上限为 5 个，超过 5–6 个会使报告难以阅读。
- 需区分统计显著性与实际显著性，除非用户另有说明，聚焦 5% 以上的差异。
- 具体收费、价格、平台支持范围等事实资料未提供。