Skip to content

PoiMetric

POI(Points of Interest)维度的客流数据,返回各 POI 的驻留/服务/贴柜/进店/经过指标。POI 分为三类:

类型 说明
COUNTER 柜台:有驻留、服务、贴柜指标
SECTION 柜台类(如“试妆区”):有驻留、服务指标;一个类聚合多个柜台集,跨柜台集按人去重
ENTRANCE 出入口:有进店人次/人数指标
AISLE 经过通道:有经过人次指标
query {
poiMetrics(storeId: 1, startAt: "2026-08-26T00:00:00+08:00", endAt: "2026-08-27T00:00:00+08:00") {
poi {
id
poiType
name
dwellThresholdSeconds
serviceThresholdSeconds
detectionRange
}
dwellPeople
totalDwellSeconds
servedPeople
serviceDurationSeconds
lingerPeople
totalLingerSeconds
avgLingerSeconds
passByVisits
enteringVisits
enteringPeople
hourly {
dateTime
dwellPeople
totalDwellSeconds
servedPeople
serviceDurationSeconds
lingerPeople
totalLingerSeconds
passByVisits
enteringVisits
enteringPeople
}
}
}
参数 类型 说明
storeId Int! 门店 ID
startAt String 起始时间,ISO8601 含时区偏移,如 2026-08-26T00:00:00+08:00
endAt String 结束时间,排他边界,如查 8 月 26 日传 2026-08-27T00:00:00+08:00
startDate String 已废弃:请使用 startAt(YYYY-MM-DD,闭区间)
endDate String 已废弃:请使用 endAt(YYYY-MM-DD,闭区间)
poiTypes [PoiType!] 可选。按类型过滤,不传返回全部
  • startAt/endAt 需成对提供;也可用 startDate/endDate 回退,两者都未提供时报错;
  • endAt 为排他边界:传「次日 00:00」即表示「当天」;
  • 传入 poiTypes 时只查询对应类型(如 [COUNTER] 只查柜台,也避免无谓的 SQL)。
字段 类型 说明
poi Poi! POI 信息(类型、名称、阈值、检测范围)
dwellPeople Int! 驻留人数(去重)。仅 COUNTER / SECTION,其余为 0
totalDwellSeconds Int! 驻留总时长(秒)。仅 COUNTER / SECTION,其余为 0
servedPeople Int! 服务人数(去重)。仅 COUNTER / SECTION,其余为 0
serviceDurationSeconds Int! 服务总时长(秒)。仅 COUNTER / SECTION,其余为 0
lingerPeople Int! 贴柜人次(各天去重贴柜人数之和)。仅 COUNTER,其余为 0
totalLingerSeconds Int! 贴柜总时长(秒)。仅 COUNTER,其余为 0
avgLingerSeconds Int! 人均贴柜时长(秒)= totalLingerSeconds / lingerPeople,人数为 0 时返回 0
passByVisits Int! 经过通道人次。仅 AISLE,其余为 0
enteringVisits Int! 进店人次。仅 ENTRANCE,其余为 0
enteringPeople Int! 进店人数(范围内去重)。仅 ENTRANCE,其余为 0
hourly [PoiMetricHour!]! 小时明细;仅当请求该字段时才查询
字段 类型 说明
id Int! POI ID(柜台为 counter_set_pkid,柜台类为 counter_set_class_pkid,出入口/通道为 pass_pkid)
poiType PoiType! COUNTER / SECTION / ENTRANCE / AISLE
name String! POI 名称(柜台类为 counter_set_class_name,如“试妆区”)
dwellThresholdSeconds Int! 停留判定阈值(秒):停留达到该值才计为有效驻留;非柜台 POI(含柜台类)无该概念,返回 -1
serviceThresholdSeconds Int! 服务判定阈值(秒):服务达该值才计为一次服务;出入口/通道无该概念,返回 -1
detectionRange Int! 通道检测范围(米);柜台无该概念,返回 -1

小时明细的对象:

字段 类型 说明
dateTime String! 小时起点,ISO8601(+08:00),如 2026-08-26T10:00:00+08:00
dwellPeople Int! 驻留人数(去重)
totalDwellSeconds Int! 驻留总时长(秒)
servedPeople Int! 服务人数(去重)
serviceDurationSeconds Int! 服务总时长(秒)
lingerPeople Int! 贴柜人次
totalLingerSeconds Int! 贴柜总时长(秒)
passByVisits Int! 经过通道人次
enteringVisits Int! 进店人次
enteringPeople Int! 进店人数(去重)

各类型只填充自己的指标(柜台/柜台类填驻留/服务,柜台额外填贴柜,出入口填进店,通道填经过),其余为 0。

  • 驻留 / 服务(COUNTER):来自柜台集每日预计算汇总。柜台未配置阈值时使用缺省值:停留阈值 5 秒、服务阈值 720 秒。
  • 驻留 / 服务(SECTION):来自柜台类每日预计算汇总(counter_set_class_summary_day,小时级为 counter_set_class_summary_hour)。柜台类无停留阈值概念;服务阈值取 counter_set_class_info.service_threshold(缺省 720 秒),且该类下跨柜台集、跨店员的服务人数已按人(顾客 ID)去重,一个顾客在同类多个柜台集被服务只计一次。
  • 进店(ENTRANCE):按首次进店通道归因——人次 = 范围内各天进店记录之和,人数 = 范围内去重顾客数,对应 DailyMetric 的 enteringVisits / enteringPeople 口径。
  • 经过(AISLE):人次 = pass_count_day 按通道的 enters 之和。
  • 排序:柜台与柜台类按 dwellPeople 降序,出入口按 enteringVisits 降序,通道按 passByVisits 降序,依次拼接(柜台 → 柜台类 → 出入口 → 通道)。
  • 平均驻留时长 = totalDwellSeconds / dwellPeople;
  • 平均服务时长 = serviceDurationSeconds / servedPeople;
  • 人均贴柜时长 = avgLingerSeconds(服务端直接返回)。

可按 poi.name 筛选特定区域,例如取「护肤」分类下各 POI 的 dwellPeople 求和即护肤区驻留人数。