Skip to content

PeoplePath(进店链路)

按人返回其店内游逛链路:所有角色(顾客、员工及其他)各有多少条,就有多少条 PeoplePath。每条链路把「柜台集停留时段」与「出入口过口事件」合并为按时间排序的步骤序列,为按人做轨迹分析提供原始数据。在 peoplePaths 查询中使用。

query {
peoplePaths(storeId: 1, startDate: "2026-07-01", endDate: "2026-07-31", roles: [CUSTOMER]) {
peopleId
role
steps {
poi {
id
poiType
name
}
dwellSeconds
enterTime
leaveTime
}
}
}
字段 类型 说明
peopleId String! 已废弃:请使用 profile.peopleId
role PeopleRole! 已废弃:请使用 profile.role
profile PeopleProfile! 行人画像:身份、性别、身高、年龄(见下)
entranceId Int! 已废弃:请勿使用,未来将移除;可在 steps 中筛选 poiType == ENTRANCE 的步骤
steps [PathStep!]! 到访步骤(柜台停留 + 出入口过口),按时间升序
字段 类型 说明
peopleId String! 行人身份 ID(uuid)
role PeopleRole! 行人身份:CUSTOMER(顾客)/ STAFF(员工)/ OTHER(其他)
rawRole Int! 原始身份值:0 成人顾客、1 店员、2 儿童、101 提袋顾客、10000~10002 外卖员、20000~20002 快递员
gender Gender! 性别:MALE / FEMALE / UNKNOWN
height Int! 身高(厘米);-1 表示未识别到
age Int! 年龄。注意:当前 GPU 输出的暂时是年龄段而非实际岁数(见下)
received Boolean! 是否被接待

age 取值说明:0 未知、18 未成年、28 青年、45 中年、60 老年。

字段 类型 说明
poi Poi! 到访的 POI 对象
dwellSeconds Int! 停留时长(秒);出入口过口步骤恒为 0
enterTime String! 进入时间(ISO8601,+08:00);出入口步骤为过口事件发生时间
leaveTime String! 离开时间(ISO8601,+08:00);出入口步骤与 enterTime 相同

Poi 结构见 PoiMetric。steps 中的 poiType 与 poiMetrics 一致:柜台步骤为 COUNTER(带停留/服务阈值),出入口过口步骤为 ENTRANCE。

参数 类型 说明
storeId Int! 门店 ID
startDate String! 起始日期,YYYY-MM-DD
endDate String! 结束日期,YYYY-MM-DD
roles [PeopleRole!] 可选。传 CUSTOMER / STAFF / OTHER 仅返回对应身份;不传返回全部角色(不做进店过滤)
  • 进店首访 POI = 首个 COUNTER 步骤的 poi.name(开头可能有一个或多个 ENTRANCE 过口步骤);
  • 进店入口 = 首个 poiType == ENTRANCE 步骤的 poi.id(等价于已废弃的 entranceId);
  • 「先去护肤还是先去彩妆」,可对每条链路首个 COUNTER 步骤的 poi.name 归组统计人数比例。

注意:出入口步骤只记录过口事件时间,不区分进出方向;需要区分进入/离开事件时请用 FlowEvent 查询。