Next.js 如何实现仅在用户同意Cookie后加载Google Analytics
实现合规GA加载的可落地方案
卡壳的核心原因
你现在的实现从根上有两个问题:
- 自定义
_document组件的渲染逻辑是服务端执行的,天生没有访问localStorage的权限,哪怕把代码塞到生命周期里,_document本身的服务端执行特性也决定了它没法拿到客户端的存储值 - 现在把GA脚本硬写在
_document的Head标签里的写法,会在服务端返回HTML的时候就触发GA资源加载——哪怕用户还没打开弹窗、根本没同意统计类Cookie,GA的请求已经发出去了,这本身就不符合合规要求,根本不是能不能在render里读存储值的问题。
具体实现步骤
1. 移除_document里的所有GA硬编码逻辑
把之前塞在_document Head里的两个GA相关脚本全部删掉,这个位置不适合放任何需要读取客户端状态的第三方脚本。
2. 封装带条件控制的GA加载工具
改造原来的utils/gtag.js,实现动态加载、初始化、卸载GA的全套方法:
// utils/gtag.js export const GA_TRACKING_ID = "你的实际GA追踪ID" // 动态加载GA官方脚本,避免硬编码提前加载 export const loadGAScript = () => { // 做重复加载判断,防止用户多次切换选项导致脚本叠加 if (document.querySelector(`script[src*="googletagmanager.com/gtag/js?id=${GA_TRACKING_ID}"]`)) return const gaScript = document.createElement('script') gaScript.async = true gaScript.src = `https://www.googletagmanager.com/gtag/js?id=${GA_TRACKING_ID}` gaScript.onload = () => { // 脚本加载完成后再做初始化 window.dataLayer = window.dataLayer || []; function gtag(){window.dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', GA_TRACKING_ID, { page_path: window.location.pathname, }); window.gtag = gtag // 挂载到全局方便页面路由切换时上报 } document.head.appendChild(gaScript) } // 用户取消授权时,彻底卸载GA、清除残留Cookie export const unloadGA = () => { // 移除已加载的GA脚本 document.querySelector(`script[src*="googletagmanager.com/gtag/js"]`)?.remove() // 清除GA写入的所有用户识别Cookie document.cookie.split(";").forEach(cookie => { const cookieName = cookie.split("=")[0].trim() if (cookieName.startsWith("_ga") || cookieName.startsWith("_gid")) { document.cookie = `${cookieName}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;` } }) // 清空上报队列 delete window.gtag window.dataLayer = [] }
3. 在客户端全局挂载授权判断逻辑
把读取存储授权状态、判断是否加载GA的逻辑,放到全局App组件(pages/_app.js)的客户端挂载阶段,这个阶段可以正常访问localStorage:
// pages/_app.js import { useEffect } from 'react' import { loadGAScript, unloadGA } from '../utils/gtag' export default function MyApp({ Component, pageProps }) { useEffect(() => { // 客户端环境下正常读取本地存储的Cookie授权配置 const savedConsent = localStorage.getItem('acceptCookies') // 没有存过授权记录的话直接跳过,不加载GA if (!savedConsent) return const consentConfig = JSON.parse(savedConsent) // 只有statistics字段为true时才加载GA if (consentConfig.statistics) { loadGAScript() } else { // 针对历史加载过GA、但用户后续取消授权的场景,主动卸载清理 unloadGA() } }, []) return <Component {...pageProps} /> }
4. 同步打通Cookie弹窗的交互逻辑
在你现有的Cookie授权弹窗的提交逻辑里,加实时联动判断:
- 当用户将
statistics选项从false切换为true并保存时,直接调用loadGAScript()完成GA加载 - 当用户将
statistics选项从true切换为false并保存时,直接调用unloadGA()清理所有GA的残留痕迹
注意避坑点
- 不要尝试在
_document的getInitialProps里写读取localStorage的逻辑,这个方法是服务端执行的,根本接触不到浏览器存储,硬写只会报localStorage is not defined的错误 - 动态加载GA脚本时一定要做重复判断,不要用户每点一次保存就往页面里加一个新的GA脚本,容易造成数据重复上报
- 用户取消授权时一定要主动清除GA种下的所有识别Cookie,不能只是停止新的上报,不然依然存在合规风险
之前绕不出圈子的核心原因,是从一开始就把需要客户端判断的脚本,放到了服务端执行的组件里,不管怎么加生命周期钩子都解决不了核心的运行环境不匹配的问题。
内容的提问来源于stack exchange,提问作者ro ko
相关产品推荐
相关产品推荐

