跳转到主要内容

为Django项目提供简单Google Analytics集成

项目描述

django-ga-tracking是一个简单的Django插件式应用程序,它提供上下文处理器和模板,可以将Google Analytics跟踪代码添加到您的页面。

替代方案和区别

有像django-google-analyticsDjango 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 提供的默认 `