为Django项目提供简单Google Analytics集成
项目描述
django-ga-tracking是一个简单的Django插件式应用程序,它提供上下文处理器和模板,可以将Google Analytics跟踪代码添加到您的页面。
替代方案和区别
有像django-google-analytics和Django Analytics Middleware这样的替代方案,但这个项目始于这两种解决方案似乎都引入了不必要的复杂性,并且/或者缺少通过Django设置模块配置分析的能力。后者对于该项目尤其重要,因为我们绝对想避免硬编码配置或将配置存储在数据库列中。
安装
使用pip安装
pip install django-ga-tracking
基本用法
将ga_tracking添加到INSTALLED_APPS。
接下来,将ga_tracking_id上下文处理器添加到TEMPLATE_CONTEXT_PROCESSORS
TEMPLATE_CONTEXT_PROCESSORS = ( .... 'ga_tracking.context_processors.ga_tracking_id', )
定义一个GA_TRACKING_ID设置,并将您的跟踪ID分配给它。例如
GA_TRACKING_ID = 'UA-12345678-9'
最后,将跟踪代码模板添加到您的模板中的某个位置
{% include "ga_tracking/ga.html" %}
跟踪超级用户
默认情况下,django-ga-analytics将跟踪超级用户。您可以通过使用GA_TRACK_SUPERUSER设置来禁用此功能。将其设置为False将导致跟踪代码不会为任何将is_superuser属性设置为True的用户进行渲染。
新跟踪代码
Google Analytics 提供了另一种跟踪代码(analytics.js)。此代码在 django-ga-tracking 中也可用。由于跟踪代码同时使用属性 ID 和顶级域名,您需要指定两者。因此,请将以下内容添加到您的设置中
GA_TRACKING_ID = 'UA-12345678-9' GA_DOMAIN = 'example.com'
接下来,包含替代模板
{% include "ga_tracking/ga_new.html" %}
自定义
由于 django-ga-tracking 使用简单的模板来添加代码,您可以通过用自己的模板覆盖它来简单地自定义它。`ga.html` 模板包含由 Google 提供的默认 `