Google Analytics 4(GA4)与v3版本自定义事件追踪差异及实现问询

原始问题背景 #

在Google Analytics v3中，可直接从应用前端发送自定义事件，示例如下：

gtag('event', 'my_custom_search', {
  'event_category': 'custom_text',
  'event_label': 'custom_label',
  'value': 'custom_value',
});

而在GA4中，发送预定义事件依然可行，例如search事件的写法为：

gtag('event', 'search', {
  search_term: '1234'
});

尝试发送自定义事件时使用了如下写法：

gtag('event', 'my_custom_search', {
  search_term: '1234'
});

但该自定义事件并未在实时视图中显示，因此有以下两个疑问：

• GA4是否依然支持直接即时发送自定义事件？
• 是否必须提前在Google Tag Manager中完成所有事件的创建配置？
  如果第二个问题答案为是，会带来大量额外工作量，需要同时在Google Tag Manager和前端代码中定义对应事件。

问题解答 #

1. GA4是否支持直接即时发送自定义事件？ #

GA4完全支持直接从前端代码即时发送自定义事件，无需提前在GA4后台预定义事件。
你遇到的事件未在实时视图展示的问题，可优先排查以下常见原因：

• 事件名不符合GA4命名规则：不能使用ga_、firebase_、google_等官方预留前缀，仅支持字母、数字、下划线，且必须以字母开头
• 本地测试IP被GA4后台的过滤器排除，默认配置下内部IP访问数据不会被统计
• gtag实例未正确绑定你的GA4媒体资源ID，事件被发送到了其他错误的资源
• 浏览器启用了广告拦截、反跟踪类插件，拦截了GA4的事件上报请求
  你当前使用的my_custom_search事件写法本身符合GA4规范，排查上述问题后即可正常上报。

2. 是否必须提前在Google Tag Manager中完成所有事件的创建配置？ #

不需要。Google Tag Manager只是埋点管理工具，不是GA4事件上报的必需依赖：

• 如果你直接在前端代码中调用gtag()上报事件，完全不需要在GTM中做任何配置，事件可以正常被GA4接收统计
• 只有当你选择通过GTM统一管理所有事件的触发逻辑时，才需要在GTM中配置对应的事件触发器和发送规则，这种场景才需要两边同步定义
  如果你的业务场景是直接在前端写死gtag()调用上报自定义事件，不会产生额外的两端配置工作量。

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