Django集成Google Analytics：如何将衡量ID设为环境变量

1. G-开头的Measurement ID是否属于需要保密的敏感信息 #

这个ID不属于必须严格保密的敏感凭据：

• 它从设计上就是要直接嵌入前端公开页面的代码片段中，所有访问你站点的用户打开网页源代码就能直接看到这个值，无法做到完全隐藏。
• 唯一需要留意的风险是他人拿到这个ID后可能向你的GA资源发送垃圾统计数据，你可以直接在GA后台配置允许上报数据的域名白名单，拦截这类无效脏数据即可，不需要对ID本身做特殊的保密处理。
• 你出于统一配置管理的习惯把它存在env环境变量里是完全可行的最佳实践，没有规则冲突。

2. Django模板中正确调用环境变量存储的Measurement ID的方法 #

你之前使用{% 'GOOGLE_ID' %}报错的核心原因有两个：一是{% %}是Django模板的逻辑标签语法，用来执行循环、判断、加载标签库这类操作，直接输出变量值需要用{{ 变量名 }}语法；二是Django模板默认没有直接读取系统环境变量的权限，不能直接在模板里调用env里的值。
正确实现步骤如下：

1. 首先在项目settings.py中加载env文件，读取对应的Measurement ID配置：

   # settings.py
   import os
   # 如果你用python-dotenv管理env文件，先执行加载
   from dotenv import load_dotenv
   load_dotenv()
   
   # 读取环境变量中的GA ID
   GOOGLE_ANALYTICS_MEASUREMENT_ID = os.getenv("GOOGLE_ID")
   

2. 将这个配置值传入模板上下文，两种方案选其一即可：
   • 全局生效方案（推荐，不需要每个视图单独传值）：编写一个简单的模板上下文处理器
     ① 在你的任意一个app目录下新建context_processors.py文件，写入以下内容：

     # 示例路径：your_app/context_processors.py
     from django.conf import settings
     
     def ga_id(request):
         return {"GOOGLE_ANALYTICS_ID": settings.GOOGLE_ANALYTICS_MEASUREMENT_ID}
     

     ② 打开settings.py找到TEMPLATES配置项，在OPTIONS.context_processors列表中追加你刚写的处理器路径："your_app.context_processors.ga_id"
   • 轻量方案：如果只有个别页面用到GA代码，直接在对应的视图函数中把值传入模板上下文即可：

     from django.conf import settings
     from django.shortcuts import render
     
     def base_view(request):
         return render(request, "base.html", {
             "GOOGLE_ANALYTICS_ID": settings.GOOGLE_ANALYTICS_MEASUREMENT_ID
         })
     

3. 修改基础模板中的GA代码，用模板变量替换硬编码的Measurement ID即可：

   <!-- Global site tag (gtag.js) - Google Analytics -->        
   <script nonce="{{ CSP_NONCE }}" async src="https://www.googletagmanager.com/gtag/js?id={{ GOOGLE_ANALYTICS_ID }}"></script>
   <script nonce="{{ CSP_NONCE }}">
       window.dataLayer = window.dataLayer || [];
       function gtag(){dataLayer.push(arguments);}
       gtag('js', new Date());
       gtag("config","{{ GOOGLE_ANALYTICS_ID }}");
   </script>
   <!-- end GA -->
   

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