SuperAPI AI 工具集

ga4-events

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:这是一个 GA4 事件实现参考技能,帮助用户正确实现、审计和验证 Google Analytics 4 事件,提供可直接复制使用的代码示例。若环境中可用 GA4 MCP 工具,可检查用户实际媒体资源的自定义维度、数据流和转化事件,给出结合上下文的建议。

主要能力:覆盖 GA4 事件模型总览(事件名+参数、会话由 session_start 派生、page_view 事件等);自动收集事件(Web 的 first_visit、session_start、page_view、user_engagement,移动端 Firebase 的 first_open、screen_view、app_update 等)及自动附加参数;增强衡量事件(scroll、click、view_search_results、video_start/progress/complete、file_download、form_start/submit);推荐事件(login、sign_up、share、search、select_content);电商漏斗事件(view_item_list、select_item、view_item、add_to_cart、remove_from_cart、view_cart、begin_checkout、add_shipping_info、add_payment_info、purchase、refund);线索与游戏类事件;items 数组参数参考;自定义事件命名规则与配额;自定义维度与指标;GTM dataLayer 实现;服务端 Measurement Protocol 及校验端点;DebugView 与 BigQuery 校验查询。

使用方式:以斜杠命令调用,如 /ga4-events 查看事件模型总览,/ga4-events purchase 查看购买事件参数与代码,/ga4-events ecommerce 查看电商事件漏斗,/ga4-events enhanced measurement、/ga4-events custom events、/ga4-events validation、/ga4-events gtm、/ga4-events measurement protocol 分别查看对应主题。

限制:purchase 必须包含 transaction_id、value、currency,GA4 在 72 小时内按 transaction_id 去重;自定义事件名最长 40 字符、须以字母开头、区分大小写,不能使用 firebase_、google_、ga_ 前缀及保留事件名;每个媒体资源最多 500 个唯一事件名、每事件 25 个参数;items 数组每事件最多 200 项;Measurement Protocol 无响应校验(需用 debug 端点)、client_id 须匹配现有 GA4 cookie、事件不会出现在 Realtime(约 30 分钟延迟)、无法触发 first_visit/session_start;标准报告处理需 24-48 小时。视频跟踪仅支持带 enablejsapi=1 的 YouTube 嵌入。具体收费与价格信息暂未提供。