Shopify GraphQL查询订单UTM参数返回customerJourney为空如何排查

结论 #

你的GraphQL查询语法完全符合规范，不存在语法错误。返回全量customerJourney为null和查询语句本身无关，是权限、数据本身或API版本的问题。

可能的原因 #

• 权限不足：你使用的API密钥没有开通客户旅程相关的读权限，多数电商平台的GraphQL接口对于敏感行为数据会做权限校验，无权限时直接返回null而非报错
• 数据本身不存在：你查询的10笔订单对应没有可采集的客户旅程数据，常见场景包括订单为手动后台创建、用户关闭了Cookie追踪、订单生成时间早于平台开启客户旅程统计的节点、客户下单前清空了浏览痕迹
• API版本不匹配：你调用的API版本已调整customerJourney字段的返回规则，或是该字段有额外的前置依赖条件未满足

排查方案 #

• 先校验API密钥的权限配置，确认已开启客户旅程、订单关联用户行为的读权限
• 调整订单查询范围，筛选最近一周的新增订单测试，排除历史订单无旅程数据的情况
• 可先用简化版查询语句验证字段可用性，示例如下：

query {
  orders(first:10, query:"created_at:>='2024-01-01'") {
    edges {
      node {
        id
        customerJourney {
          moments {
            ... on CustomerVisit {
              utmParameters {
                source
              }
            }
          }
        }
      }
    }
  }
}

• 确认当前调用的API版本，核对对应版本的字段说明，确认customerJourney是否存在额外调用限制

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