GA4界面与Data API关键事件计数差异技术问询

问题背景 #

我正在使用Google Analytics Data API v1beta从GA4媒体资源中按广告系列拉取关键事件，具体追踪通过Google Tag Manager配置的自定义事件Phone_Number_Click，但发现GA4界面与API返回的数据存在差异。

数据对比 #

使用代码 #

from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import RunReportRequest, DateRange, Dimension, Metric
import pandas as pd
import os

os.environ['GOOGLE_APPLICATION_CREDENTIALS'] = 'path_to_key.json'
client = BetaAnalyticsDataClient()

request = RunReportRequest(
    property="properties/2812",
    dimensions=[
        Dimension(name="campaignId"),
        Dimension(name="campaignName")
    ],
    metrics=[Metric(name="keyEvents")],
    date_ranges=[DateRange(start_date="yesterday", end_date="yesterday")],
)

response = client.run_report(request)
rows = [
    { "Campaign ID": row.dimension_values[0].value,
      "Campaign": row.dimension_values[1].value,
      "keyEvents": row.metric_values[0].value }
    for row in response.rows
]
df = pd.DataFrame(rows)
print(df)

问题解答 #

1. Data API是否采用与GA4界面相同的归因模型？ #

默认情况下，Data API使用GA4媒体资源的默认归因模型，和界面默认报表的模型一致。但如果在GA4界面手动切换了归因模型（比如从默认的「数据驱动」改为「首次互动」），而API请求未同步对应设置，就会出现数据差异。

2. 是否可以在API请求中指定或对齐归因设置？ #

可以。在RunReportRequest中添加attribution_settings参数，指定目标归因模型和归因窗口，即可与GA4界面的设置对齐。

示例修改后的请求：

request = RunReportRequest(
    property="properties/2812",
    dimensions=[
        Dimension(name="campaignId"),
        Dimension(name="campaignName")
    ],
    metrics=[Metric(name="keyEvents")],
    date_ranges=[DateRange(start_date="yesterday", end_date="yesterday")],
    # 指定归因模型为首次互动，匹配界面设置
    attribution_settings={
        "model": "FIRST_INTERACTION",
        "lookback_window_days": 90
    }
)

支持的归因模型包括FIRST_INTERACTION、LAST_INTERACTION、DATA_DRIVEN等，与GA4界面提供的选项一致。

3. 哪些原因会导致API返回的关键事件数量低于GA4界面？ #

• 归因规则不匹配：API使用默认归因设置，而界面切换了不同的归因模型或调整了归因窗口，统计规则不一致导致数据差异。
• 数据延迟：GA4界面报表可能包含延迟处理的事件数据，而API拉取的是当前已完成处理的数据，存在时间差。
• 指标范围差异：API中的keyEvents指标包含所有标记为关键事件的类型，若界面仅筛选了Phone_Number_Click这单一事件，会导致数据量不同。
• 采样策略不同：数据量较大时，GA4界面可能采用了宽松的采样策略，而API默认采样更严格，导致结果偏差。可尝试在API请求中添加sampling_level="LARGE"参数优化。
• 过滤器缺失：GA4界面报表可能应用了额外过滤器（如排除内部流量、特定设备），而API请求未添加对应过滤条件，统计范围不一致。

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