PeoplePath(进店链路)
PeoplePath(进店链路)
Section titled “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 } }}Fields for PeoplePath
Section titled “Fields for PeoplePath”| 字段 | 类型 | 说明 |
|---|---|---|
peopleId |
String! |
已废弃:请使用 profile.peopleId |
role |
PeopleRole! |
已废弃:请使用 profile.role |
profile |
PeopleProfile! |
行人画像:身份、性别、身高、年龄(见下) |
entranceId |
Int! |
已废弃:请勿使用,未来将移除;可在 steps 中筛选 poiType == ENTRANCE 的步骤 |
steps |
[PathStep!]! |
到访步骤(柜台停留 + 出入口过口),按时间升序 |
Fields for PeopleProfile
Section titled “Fields for PeopleProfile”| 字段 | 类型 | 说明 |
|---|---|---|
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老年。
Fields for PathStep
Section titled “Fields for PathStep”| 字段 | 类型 | 说明 |
|---|---|---|
poi |
Poi! |
到访的 POI 对象 |
dwellSeconds |
Int! |
停留时长(秒);出入口过口步骤恒为 0 |
enterTime |
String! |
进入时间(ISO8601,+08:00);出入口步骤为过口事件发生时间 |
leaveTime |
String! |
离开时间(ISO8601,+08:00);出入口步骤与 enterTime 相同 |
Poi 结构见 PoiMetric。steps 中的 poiType 与 poiMetrics 一致:柜台步骤为 COUNTER(带停留/服务阈值),出入口过口步骤为 ENTRANCE。
Arguments
Section titled “Arguments”| 参数 | 类型 | 说明 |
|---|---|---|
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 查询。