查询轨迹事件
POST https://qw-openapi-tx.dustess.com/open-integration-api/trail/v2/query?accessToken=
Content-Type: application/json| 字段 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| accessToken | String | accessToken | true |
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| trailId | String | 项目id（传固定ID：56d3c3371f0142859ca05b031c363bdc） | 是 |
| queryDate | String | 查询时间（拉取某一天0点-24点的数据。格式：yyyy-MM-dd，如果customerId和unionId都为空时，查询时间必传） | 否 |
| customerId | String | 客户id（查询customerId和其关联的unionId上报的所有事件） | 否 |
| unionId | String | 微信用户id （customerId和unionId都传的时候，以customerId查询） | 否 |
| page | Int | 页码（默认从第一页开始） | 否 |
| pageSize | Int | 每页显示记录数（单页最大500，默认10） | 否 |
{
"trailId": "56d3c3371f0142859ca05b031c363bdc",
"queryDate": "2022-07-25",
"customerId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"unionId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"page": 1,
"pageSize": 100
}| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 状态码 |
| msg | String | 状态信息 |
| success | Boolean | 是否成功 |
| data | Object | 响应内容 |
| data.page | Int | 页码 |
| data.pageSize | Int | 每页显示记录数 |
| data.total | Int | 总记录数 |
| data.data | Object[] | 总记录数 |
| data.data.id | String | 事件记录id |
| data.data.account | String | 公司id |
| data.data.activityId | String | 旅程记录id |
| data.data.parentActivityId | String | 上级旅程记录id |
| data.data.operatorId | String | 操作人id(员工id) |
| data.data.operatorType | String | 操作人类型,固定为EMPLOYEE(员工) |
| data.data.unionId | String | 微信用户id |
| data.data.customerId | String | 客户id |
| data.data.event | String | 事件(系统已存在行为轨迹事件详见轨迹参数说明) |
| data.data.trailId | String | 项目id |
| data.data.subject | String | 所属对象,固定为:CUSTOMER(客户) |
| data.data.targetId | String | 操作对象id,可能是unionId、customerId，根据targetType判断 |
| data.data.targetType | String | 操作对象类型,WX、CUSTOMER |
| data.data.reportTime | Int | 上报时间戳 |
| data.data.operateTime | Int | 发生时间戳 |
| data.data.createTime | String | 入库时间 |
| data.data.updateTime | String | 更新时间 |
| data.data.stayTime | Int | 停留时间戳 |
| data.data.date | String | 日期 |
| data.data.time | String | 时间 |
| data.data.extraInfo | Object | 额外自定义信息(系统已存在行为轨迹事件自定义字段信息详见轨迹参数说明) |
| data.data.children | Object[] | 下级旅程记录列表 |
| trace_id | String | 链路id |
{
"account": "租户ID，必填",
"customerId": "客户Id，非必填 微信生态联系人id,非微信生态 cookieId ",
"unionId": "用户unionId，非必填 ",
"event": "事件，必填",
"activityId": "记录唯一ID，ID重复会根据配置更新字段，不产生新记录",
"version": 1,
"parentActivityId": "父级记录唯一ID",
"operator": "操作人ID，非必填",
"reportTime": "上报时间，格式为2021-10-12 10:10:10",
"relationId": "关联主体id 非必填",
"attr": {
"deliverType": "来源类型（staffShare员工分享 publicLaunch公域投放 advertising广告投放）",
"sourceId": "来源ID（员工id, 来源ID）(链接带参)",
"deviceId": "设备Id，非必填",
"deviceManufacturer": "设备制造商 非必填",
"deviceModel": "设备型号 非必填",
"browser": "当前访问的浏览器，如'微信浏览'非必填",
"country": "国家 非必填",
"province": "省 非必填",
"city": "市 非必填",
"area": "区 非必填",
"platform": "平台：WPN（公众号）/MINI（小程序）/QW（企微）/OTHER(第三方) 必填",
"contentId": "内容id （可以是表单id、文章Id、商品Id、案例Id..，此字段不做强制校验，因为是全链路需要兼容无素材id情况）",
"reportType": "wx:unionId上报 customer:联系人id上报 cookie:cookie上报 ",
"sceneType": "material(营销资料)，miniMaterial(小程序素材)，commonMaterial(普通素材)，hotMaterial(热门营销资料)，hot-article(热门好文-营销资料类型)，redPacket(红包)，dynamic(企业动态)，tempMaterial，marketingRedPacket(营销红包)，card(名片)，living(直播)，fission(裂变活动)，microSite，phone(手机号)，tel(座机)，address(通讯录)，fissionTemp(营销获客)",
"shareType": "分享人类型 :微信用户（存在unionId）staff:员工 selfVisit：自主访问（存在的场景是用户自己通过搜索名片进行访问）非必填",
"actionType": "电话：phone，微信：wechat，邮箱：email 非必填",
"shareId": "分享人id 例如unionid|staffId,非必填",
"compatibleShareId": "为了兼容老的已经发送出去的链接，此字段用于存储之前的shareId",
"firstScene": "一级场景:2001(文章)，2002(表单)，2003(H5)，2004(案例库)，2005(宣传册)，2006(视频)，2007(文件)，2008(销售名片)，2009(名片小程序),2010(营销视频),2011(企业动态),2012(H5商城),2013(小程序商城),2014(营销红包),2015(商品),9999(其他)",
"secondScene": "二级场景,0(销售分享)，1:(客户转发),2:(自主访问)",
"ruleIds": "5d846128-8d6e-11ed-a9d2-aaa8e229953f,db1afcfb-4ebd-4693-ab37-8ca7dbff956f(规则id，可能存在多个，使用英文逗号分隔)",
"externalUserId": "外部联系人id",
"contentId": "素材ID[查询素材详情](/doc-5158628)",
"uid": "员工id",
"addFriendTime": "添加好友时间，格式yyyy-MM-dd HH:mm:ss",
"submitFormId": "提交表单id",
"carrier": {
"channel": "通道 1v1Message:1v1消息-0, groupMessage:群聊消息-1, qwMoments:企微朋友圈-2, friendCircle:个微朋友圈-3, friend:微信好友-4, microMass:微群发-5,groupMass:群群发-6",
"carrierType": "载体类型 例如：mkPlan:营销计划、massPlan:群发",
"carrierId": "对应载体类型的 任务id",
"extra": "plainId等其他的信息"
},
"stayTime": "停留时长（单位秒）",
"viewRatio": "播放比例 （百分比）10.00"
}
}
{
"code": 0,
"msg": "成功",
"data": {
"page": 1,
"pageSize": 10,
"total": 1,
"data": [{
"id": "2b660bc9-c8a6-4b0f-9dd9-94251f62db5d#1",
"account": "W00000000109",
"activityId": "2b660bc9-c8a6-4b0f-9dd9-94251f62db5d",
"parentActivityId": "",
"operatorId": "2783",
"operatorType": "EMPLOYEE",
"unionId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"customerId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"event": "enterPageActivity",
"trailId": "56d3c3371f0142859ca05b031c363bdc",
"subject": "CUSTOMER",
"eventType": "ACTIVITY",
"targetId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"targetType": "WX",
"effectId": "",
"effectType": "card",
"effectName": "",
"deviceId": "",
"deviceInfo": "",
"bizId": "2b660bc9-c8a6-4b0f-9dd9-94251f62db5d#1",
"reportTime": 1648097916300,
"operateTime": 1648097916300,
"createTime": "2022-03-24 12:58:36",
"updateTime": "2022-03-25 10:27:55",
"stayTime": 0,
"date": "03月24日",
"time": "12:58",
"extraInfo": {
"platform": "MINI"
},
"children": [{
"id": "1ba8b12b-ab2f-11ec-b563-d29bb107c48b#3",
"account": "W00000000109",
"activityId": "1bca1826-ab2f-11ec-a12f-22943c823276",
"parentActivityId": "961d23e0-b0ca-4263-b3c2-9a62640d523c",
"operatorId": "2783",
"operatorType": "EMPLOYEE",
"unionId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"customerId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"event": "stayActivity",
"trailId": "56d3c3371f0142859ca05b031c363bdc",
"subject": "CUSTOMER",
"eventType": "ACTIVITY",
"targetId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"targetType": "WX",
"effectId": "4ece6410-a5d7-11ec-a160-02ab67da82b0",
"effectType": "article",
"effectName": "",
"deviceId": "",
"deviceInfo": "",
"bizId": "1ba8b12b-ab2f-11ec-b563-d29bb107c48b#3",
"reportTime": 1648097935749,
"operateTime": 1648097935749,
"createTime": "2022-03-24 12:58:55",
"updateTime": "2022-03-25 10:27:55",
"stayTime": 0,
"date": "03月24日",
"time": "12:58",
"extraInfo": {
"platform": "MINI"
},
"children": []
},
{
"id": "744ba567-ab2f-11ec-b563-d29bb107c48b#3",
"account": "W00000000109",
"activityId": "74720f2f-ab2f-11ec-a12f-22943c823276",
"parentActivityId": "961d23e0-b0ca-4263-b3c2-9a62640d523c",
"operatorId": "2783",
"operatorType": "EMPLOYEE",
"unionId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"customerId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"event": "leavePageActivity",
"trailId": "56d3c3371f0142859ca05b031c363bdc",
"subject": "CUSTOMER",
"eventType": "ACTIVITY",
"targetId": "owx_AwIYB2E7w73AmzcrEFkUv2Y8",
"targetType": "WX",
"effectId": "4ece6410-a5d7-11ec-a160-02ab67da82b0",
"effectType": "article",
"effectName": "",
"deviceId": "",
"deviceInfo": "",
"bizId": "744ba567-ab2f-11ec-b563-d29bb107c48b#3",
"reportTime": 1648098084456,
"operateTime": 1648098084456,
"createTime": "2022-03-24 13:01:24",
"updateTime": "2022-03-25 10:27:55",
"stayTime": 0,
"date": "03月24日",
"time": "13:01",
"extraInfo": {
"platform": "MINI"
},
"children": []
}
]
}]
},
"trace_id": "51ca6690e2f94eb1980bad01a465e78b",
"success": true
} {
"success": false,
"code": 10001,
"msg": "system unknown error",
"data": null
}
``