SuperAPI AI 工具集

bootstrap-google-analytics

数据与分析

查看项目

更新于 10-16 04:59

技能介绍

用途:为 Phoenix 1.8 应用引导配置 Google Analytics 4(gtag.js),实现开发/测试环境禁用、生产环境通过环境变量启用。

主要能力:修改 config/config.exs 加入默认 enabled: false、measurement_id: nil 的 :google_analytics 配置;在 config/runtime.exs 的 if config_env() == :prod do 块内启用并读取 GOOGLE_ANALYTICS_MEASUREMENT_ID;在 root.html.heex 的 </head> 前条件注入 gtag.js 脚本;在 .env.sample 添加 GOOGLE_ANALYTICS_MEASUREMENT_ID 条目。会从 mix.exs 检测应用模块前缀、OTP 应用名与 Web 模块前缀,并查找根布局、已有 GA 配置与脚本、CSP 设置。

使用方式:先执行 Phase 0 发现审计,确认根布局存在、是否已有 GA 脚本与配置;再按顺序执行配置、运行时配置、布局注入与环境文件步骤,跳过已存在项;最后运行 mix compile --warnings-as-errors 与 mix test 验证,并确认开发环境不加载脚本。

适用场景:Phoenix 1.8 项目需要以最小改动接入 GA4,且希望生产环境才启用、避免开发/测试向 Google 发请求。

限制:根布局缺失时须停止并通知用户;measurement_id 缺失时虽 enabled 为 true 但脚本不会加载;若配置 CSP,需在 script-src 与 connect-src 允许 https://www.googletagmanager.com 与 https://www.google-analytics.com;GDPR 合规需自行考虑 Cookie 同意横幅,因为 gtag.js 默认设置 Cookie。测量 ID 形如 G-XXXXXXXXXX,可在 Google Analytics 的 Admin > Data Streams > Web > Measurement ID 获取。本地测试可临时在 config/dev.exs 设 enabled: true。