GA4 Measurement Protocol地理信息无法自动填充问题求助

问题背景 #

通过Python手动向GA4的mp/collect端点上报page_view事件时，将地理信息（城市、国家、经纬度等）放在事件的params字段中，结果这些信息被识别为自定义事件参数，而非GA4系统自带的地理维度。

核心原因 #

GA4的系统地理维度（如城市、国家、大洲）默认通过IP地址自动解析生成，且地理属性属于用户级别的数据，而非事件级参数。直接将地理字段放在事件params中，会被当作自定义参数处理，无法映射到系统维度。

解决方法 #

方法1：依赖IP自动解析地理信息 #

GA4会根据请求中的IP地址自动生成地理维度，无需手动传入地理参数。如果请求从后端服务器发起，需确保在事件params中携带用户的真实IP地址，避免GA4使用服务器IP解析地理数据。

修改后的上报数据示例：

{
    "client_id": "6909975079.1681323722",
    "events": [
        {
            "name": "page_view",
            "params": {
                "page_title": "Wedding: QR Code",
                "hostname": "scan.example.com",
                "landing_page": "/eRCU",
                "page_location": "https://scan.example.com/eRCU",
                "page_referrer": "https://scan.example.com/eRCU",
                "session_id": 1681313623,
                "engagement_time_msec": 264,
                "ip_address": "XX.36.XXX.14"
            }
        }
    ]
}

方法2：手动指定用户地理属性 #

若需强制指定地理信息（不依赖IP解析），需将地理字段放在user_properties字段中，而非事件params。user_properties是GA4存储用户级属性的字段，放入此处的地理数据会被映射到系统自带的地理维度。

修改后的上报数据示例：

{
    "client_id": "6909975079.1681323722",
    "user_properties": {
        "city": {"value": "Mumbai"},
        "continent_code": {"value": "AS"},
        "country_code": {"value": "IN"},
        "country": {"value": "India"},
        "latitude": {"value": "19.0748"},
        "longitude": {"value": "72.8856"}
    },
    "events": [
        {
            "name": "page_view",
            "params": {
                "page_title": "Wedding: QR Code",
                "hostname": "scan.example.com",
                "landing_page": "/eRCU",
                "page_location": "https://scan.example.com/eRCU",
                "page_referrer": "https://scan.example.com/eRCU",
                "session_id": 1681313623,
                "engagement_time_msec": 264
            }
        }
    ]
}

注意事项 #

• 不要同时使用两种方法，避免地理数据冲突。
• 若使用IP解析，需确保ip_address参数为用户的真实IP，否则地理维度数据会不准确。
• GA4系统维度仅识别符合命名规范的用户属性，地理相关字段名需与GA4默认维度匹配（如city、country等）。

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