GA4 Implementation 是 ga4-implementation-expert 智能体背后的知识库，覆盖在真实网站上通过 Google Tag Manager 部署 Google Analytics 4 所需的全部内容：欧盟强制性的法律/合规层、跨框架的技术安装、事件与转化分类体系、再营销受众，以及用于判断网站为何不转化的诊断模式。
用途 该技能面向 GA4 部署与诊断任务。它既可用于从零搭建 GA4 + GTM 的完整实施，也可用于仅做诊断的场景（例如“我的网站为什么不转化”），此时可直接跳到诊断步骤。
合规是前置阻塞条件 在意大利或欧盟，GA4 无法在缺少以下全部条件时合法部署：
- 技术型同意管理平台（CMP），在用户同意前阻止 GA4 Cookie，而不仅仅是一份书面的 Cookie 政策；
- 符合意大利 Garante 要求的 Cookie 横幅（接受/拒绝等权重、细粒度偏好、不以滚动作为同意、6 个月后重新抑制）；
- Google Consent Mode v2，四项信号（analytics_storage、ad_storage、ad_user_data、ad_personalization）默认全部设为 denied；
- 在 GA4 账户设置中接受数据处理条款（GDPR 第 28 条）；
- 针对 EEA 流量禁用 Google Signals。 仅有一个描述网站使用哪些 Cookie 的 Cookie 政策页面并不满足法律要求。网站必须具备技术机制，从一开始就阻止 Cookie 被设置。这是意大利和欧盟网站上最常见的合规失败点。 对于非欧盟流量，法律门槛较低，但根据 Google 政策，自 2024 年 3 月 6 日起，任何服务 EEA 用户的媒体资源都必须使用 Consent Mode v2。缺少它，Google 会禁用再营销和受众构建。
使用方式 大多数 GA4 实施任务遵循以下顺序：
- 先审计合规——阅读 references/gdpr-compliance-eu.md。如果 CMP 和 Consent Mode v2 层未就位，先修复它，再动标签。
- 安装 GTM 和 GA4 标签——阅读 references/gtm-setup.md，了解安装规则、代码片段放置顺序和 EEA 账户级锁定。
- 将业务目标映射到事件——阅读 references/events-and-conversions.md，了解标准事件分类、自定义维度、Key Events 标记和受众模式。
- 应用框架特定集成——阅读 references/framework-integration.md，了解原生 HTML、Next.js（App + Pages Router）、React 和 WordPress 模式。
- 验证与诊断——阅读 references/diagnostics-troubleshooting.md，了解验证工具、流量与转化的诊断区分、行业基准和常见错误清单。 对于仅做诊断的任务（“我的网站为什么不转化”），直接跳到第 5 步。
参考索引
- gdpr-compliance-eu.md：法律层。意大利 Garante 决定时间线（2022 Caffeina、2023 DPF 充分性、2025 T-553/23、待决的 Schrems III 上诉）、Cookie 横幅强制要求、GA4 账户级强制配置、Consent Mode v2 四项信号及其默认值、Basic 与 Advanced 模式权衡、CMP 选择（推荐非技术用户使用 iubenda，免费开源替代为 Orestbida CookieConsent v3），以及可直接粘贴的代码片段。
- gtm-setup.md：安装理由与关键规则。为何优先使用 GTM 而非直接使用 gtag.js、容器上线前要应用的 EEA 账户级锁定（保留期、Google Signals、归因、DPA、注册国家）、两个 GTM 代码片段、按正确顺序安装代码片段（Consent Mode v2 默认块 → CMP 加载器 → GTM head 片段 → GTM noscript body 片段）、使用 Initialization - All Pages 触发器的 GA4 Google Tag 配置、安装陷阱、容器备份、环境以及标准报告时间线。媒体资源和容器的创建步骤委托给它链接的 Google 官方文档。
- events-and-conversions.md：衡量层。增强衡量自动事件、通过 GTM 的自定义事件模式（预订按钮点击、tel/mailto/wa.me 链接点击、表单提交、外部 OTA 点击）、何时使用 GA4 推荐事件名称用于电商，以及每次推送前必须执行的 ecommerce: null 清空（推荐事件列表和 items[] 结构委托给它链接的 Google 官方文档）、自定义维度注册演练、Key Events 标记（原 Conversions）、标准受众模式集、Google Ads 关联流程、增强型转化、内部流量排除、EEA 报告身份和归因设置。
- framework-integration.md：各框架实现模式。原生 HTML 和静态站点生成器（Jekyll、Hugo、Eleventy）、Next.js（App Router 使用 @next/third-parties/google，Pages Router 使用 _document.tsx 和 next/script，路由变化跟踪）、CRA/Vite React 配合路由监听器、WordPress（主题 functions.php 动作钩子 vs Site Kit 和 GTM4WP 等插件），以及常见陷阱（水合不匹配、Strict Mode 下重复触发、缓存插件剥离代码片段）。
- diagnostics-troubleshooting.md：诊断与排查层。流量与转化的区分（场景 A：无人访问 / 场景 B：有人访问但不转化）及各自要检查的 GA4 报告、Acquisition 报告解读、Funnel Exploration 设置、酒店与旅游基准、低流量站点的数据阈值变通方法、Microsoft Clarity 集成、Google Search Console 集成，以及常见错误清单（代码片段只放在一个页面、重复跟踪、放置错误、Measurement ID 拼写错误、内部 IP 排除）。
适用场景 适用于在真实网站上部署 GA4 + GTM、需要满足欧盟/意大利合规要求、需要设计事件与转化分类、需要按框架集成、或需要诊断流量与转化问题的场景。
限制 该技能不覆盖以下内容：
- 服务端 GTM（sGTM）：超出范围。如用户需要服务端打标，指向 Google 官方文档。
- Universal Analytics → GA4 迁移：UA 自 2023 年 7 月起已停用。历史 UA 数据为只读且无法迁移；GA4 必须全新设置。
- BigQuery 导出：高级主题，用户询问时链接到 GA4 BigQuery 关联文档。
- Looker Studio 仪表板模板：GA4 内置报告对大多数情况已足够；Looker Studio 是后续层。
- 非 Google 分析工具：Matomo、Plausible、Fathom 等。gdpr-compliance-eu.md 中的 DPF 后备应急说明简要提到 Matomo 作为 DPF 被推翻时的欧盟托管替代方案，但该技能专用于 GA4。
来源说明 法律与合规内容反映意大利 Garante 指南（Provvedimenti 9677876 和 9782874）、欧盟-美国数据隐私框架充分性决定（2023 年 7 月 10 日）、欧盟普通法院关于 Case T-553/23 的裁决（2025 年 9 月 3 日），以及截至 2025-2026 年的 Google Consent Mode v2 规范。为生产网站实施时，请对照当前 Garante 和 Google 出版物核实，尤其是在 2026 年底或 2027 年初法院作出“Schrems III”裁决的情况下。