GA4交易/购买事件UI与API数据不一致问题排查

问题背景 #

目标是按Google Ads Campaign ID拉取购买交易次数和收入，但API返回数据与GA4仪表盘同日期范围的购买转化报告存在明显差异：API返回的交易次数（331）比仪表盘（239.47）高25%以上，收入也有小幅偏差，且所有Campaign均存在此现象。

当前API查询 #

{
    "propertyId": "*********",
    "query": {
        "dateRanges": [
            {
                "startDate": "2022-09-30",
                "endDate": "2022-10-06"
            }
        ],
        "dimensions": [
            {
                "name": "googleAdsCampaignId"
            },
            {
                "name": "googleAdsCampaignName"
            }
        ],
        "metrics": [
            {
                "name": "advertiserAdClicks"
            },
            {
                "name": "advertiserAdCost"
            },
            {
                "name": "transactions"
            },
            {
                "name": "purchaseRevenue"
            }
        ],
        "dimensionFilter": {
            "andGroup": {
                "expressions": [
                    {
                        "filter": {
                            "fieldName": "googleAdsCustomerId",
                            "stringFilter": {
                                "matchType": "EXACT",
                                "value": "*********",
                                "caseSensitive": false
                            }
                        }
                    }
                ]
            }
        }
    }
}

数据差异表现 #

• API返回示例（Example Campaign）：交易次数331，收入31374.21
• GA4仪表盘数据：交易次数239.47，收入31981.63

已尝试的排查动作 #

添加eventName=purchase的过滤条件，但transactions指标仍返回331（过滤条件存在拼写错误：caseSesnsitive应为caseSensitive）：

{
  "filter": {
    "fieldName": "eventName",
      "stringFilter": {
        "matchType": "EXACT",
        "value": "purchase",
        "caseSensitive": false
    }
  }
}

可能原因及解决方法 #

1. 指标定义不匹配 #

GA4仪表盘的「购买转化报告」大概率统计的是标记为转化的purchase事件（即conversions指标），而API查询的transactions指标包含所有符合定义的交易事件（含未标记为转化的purchase、in_app_purchase等）。

• 解决：将API中的transactions替换为conversions，并配合eventName=purchase的过滤，匹配仪表盘的转化统计逻辑。

2. 过滤条件未生效 #

原过滤条件存在拼写错误（caseSesnsitive→caseSensitive），且未将eventName过滤正确合并到andGroup中，导致过滤不生效。修正后的完整过滤逻辑：

"dimensionFilter": {
  "andGroup": {
    "expressions": [
      {
        "filter": {
          "fieldName": "googleAdsCustomerId",
          "stringFilter": {
            "matchType": "EXACT",
            "value": "*********",
            "caseSensitive": false
          }
        }
      },
      {
        "filter": {
          "fieldName": "eventName",
          "stringFilter": {
            "matchType": "EXACT",
            "value": "purchase",
            "caseSensitive": false
          }
        }
      }
    ]
  }
}

3. 数据采样差异 #

GA4仪表盘可能对大流量数据启用采样，而API默认采样逻辑不同。在API查询中添加"samplingLevel": "LARGE"参数，强制使用大采样量减少差异：

"query": {
    // 原有参数...
    "samplingLevel": "LARGE"
}

4. 事件计数逻辑差异 #

部分场景下，仪表盘的「交易次数」可能按用户去重统计（如"购买转化用户数"），而API的transactions是按事件触发次数统计。可尝试在API中添加userPseudoId维度，统计去重后的用户交易数，对比仪表盘数据。

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