使用Google Analytics Data API获取日语{eventName}转化遇Bad Request问题咨询

Google Analytics Data API支持获取包含日语等多字节字符的事件名对应的转化数据，你遇到的Bad Request响应并非API不支持多字节字符，而是请求存在格式、编码或配置类问题，以下是常见原因及解决方向：

• 编码错误：确保请求中的日语事件名以UTF-8编码发送。多数HTTP客户端会自动处理编码，但手动构造请求时要避免将日语字符转成乱码，比如不要错误使用GBK等其他编码。
• 参数格式不符：检查请求中引用事件名的逻辑是否符合API规范：
  • 若筛选事件名，需正确使用eventName维度作为过滤字段；
  • 确认日语事件名的拼写完全匹配GA4后台的事件名称（包括全角/半角、假名写法的差异）；
  • 若调用转化指标，需确保该日语事件已在GA4后台被标记为转化事件。
• 不必要的转义：日语平假名、片假名及汉字无需额外转义，直接在请求参数中使用原始字符即可，过度转义反而会导致参数不匹配。
• 权限或资源问题：验证你的API凭证（密钥/OAuth令牌）拥有目标GA4资源的访问权限，且该资源下确实存在该日语命名的事件。

以下是Python客户端库的正确请求示例（直接使用日语事件名）：

from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import RunReportRequest

client = BetaAnalyticsDataClient()
request = RunReportRequest(
    property="properties/你的GA4资源ID",
    dimensions=[{"name": "eventName"}],
    metrics=[{"name": "conversions"}],
    dimension_filter={
        "filter": {
            "field_name": "eventName",
            "string_filter": {"match_type": "EXACT", "value": "購入完了"}
        }
    },
    date_ranges=[{"start_date": "2024-01-01", "end_date": "today"}]
)
response = client.run_report(request)

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