用途:对某个受众分群做分析快照,回答“这个分群里的人长什么样”,展示字段值分布、覆盖率、数值统计和值得注意的模式。属于只读操作。
主要能力:按分群查看各字段的取值计数(terms_counts)、是否存在更多取值(more_terms)、字段有值/缺失的档案数(ents_present/ents_absent)、近似基数(approx_cardinality);数值字段还提供均值、标准差、最小/最大值和样本数(stats),以及分桶直方图(histograms)。支持一次查询多个分群并做对比。
使用方式:需已认证的 API 访问,凭据解析见 ../references/auth.md。输入为分群名称或 ID(必填),可选指定字段、表(默认 user)。注意 fieldinfo 接口必须使用分群的 id 哈希而非 slug 名称,否则返回 HTTP 500,因此先用 GET /v2/segment 解析出 id。示例: curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/segment?table=user&sizes=true" -H "Authorization: ${LYTICS_API_TOKEN}" curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/segment/${SEGMENT_ID}/fieldinfo?limit=20&table=user" -H "Authorization: ${LYTICS_API_TOKEN}" 多分群:curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/segment/fieldinfo?ids=${ID1},${ID2}&limit=20&table=user" -H "Authorization: ${LYTICS_API_TOKEN}" 查询参数:fields(默认全部)、limit(默认 20,最大 1000)、table(默认 user)、cached(默认 true,设 false 取新数据)。响应数据位于 data.segments,可用 jq '.data.segments[].fields[]' 遍历。
适用场景:了解分群人口构成、检查字段覆盖率、查看数值分布与异常值、对比多个分群差异,并据此提出下钻、对比或收窄受众的后续动作。
限制:只读,不创建或修改分群;需认证;分群过新或为空可能无字段信息;last_updated 过旧时可用 cached=false 重取。相关技能:segment-manager 用于查找分群,audience-builder 用于创建分群。