GA4事件报告为何不展示搜索关键词详情？

问题概述 #

已在网站按钮中接入GA4自定义事件，代码如下：

gtag('event', 'Search KeyWords', {            
    'Keyword': keyword  // 事件参数
 });

• 实时报告中可正常查看Search KeyWords事件的参数详情
• 「互动-事件报告」中无法显示该事件的详情信息

核心原因及解决方法 #

• 未配置自定义维度关联参数：GA4不会自动将自定义事件的参数纳入常规报告的可展示维度，必须手动后台配置：
  1. 登录GA4后台，进入「管理」→「自定义定义」→「创建自定义维度」
  2. 维度名称设为Keyword，事件参数填写Keyword（需与代码中参数名完全一致，包括大小写），范围选择「事件」，完成保存
• 非实时报告数据延迟：GA4的常规报告（如互动事件报告）存在24-48小时的数据处理周期，实时数据正常不代表非实时报告已同步，可等待1-2天后再检查
• 事件命名不符合规范：自定义事件名称包含空格（Search KeyWords），虽然实时报告可识别，但可能影响常规报告的解析，建议改为下划线分隔的格式（如search_keywords），同时同步更新前端代码中的事件名
• 参数匹配错误：若配置自定义维度时，填写的事件参数名与代码中的Keyword大小写、拼写不一致，会导致数据无法关联，需严格保持参数名完全匹配

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