Salesforce Marketing Cloud Journey History API使用问题咨询

1. 确认是否获取全部旅程历史数据 #

Journey History API本身没有MoreDataAvailable字段，但可以通过两种方式判断是否已获取全部数据：

• 添加$count=true参数：修改请求URL，加入$count=true，这样响应会返回@odata.count字段，显示符合条件的总记录数。你可以对比已获取的记录总数和这个值，来确认是否拉取完所有数据。示例请求：

  https://{{TenantId}}.rest.marketingcloudapis.com/interaction/v1/interactions/journeyHistory/search?$page=1&$pageSize=1000&$orderBy=TransactionTime%20desc&$count=true
  

• 检查单页返回记录数：如果某次请求返回的记录数小于你设置的$pageSize（比如设置1000，但只返回800条），说明当前是最后一页，没有更多数据了。

2. 所有记录contactKey显示“Contact Unknown”的排查方向 #

出现这种情况，大概率是以下原因之一，你可以逐一排查：

• 权限不足：确认调用API的应用是否拥有Contact Builder的读取权限，以及Journey Builder的旅程历史读取权限。如果权限缺失，API无法关联到对应的联系人数据，会统一返回“Contact Unknown”。
• 旅程使用匿名触发：如果你的旅程入口是API Event但触发时没有传入有效的contactKey，或者使用了匿名类型的触点（比如匿名登录用户触发的旅程），这类记录本身就没有关联的联系人，所以会显示“Contact Unknown”。
• 数据同步延迟：Journey History的数据和Contact Builder的联系人数据存在同步延迟，刚生成的旅程记录可能还没完成关联，等待一段时间后再重试看看。
• 请求过滤条件异常：检查请求中是否存在错误的$filter参数，意外过滤掉了有有效contactKey的记录，只返回了匿名或无关联的记录。
• 租户/环境错误：确认请求中的{{TenantId}}是否对应正确的业务租户，避免访问到测试环境或其他无关租户的数据。

内容的提问来源于stack exchange，提问作者Chandrashekhar Dautpure