A Django app to integrate Fathom Analytics into your project
Project description
django-usefathom
Fathom Analytics integration with Django projects. Provides ability to integrate page view tracking and goal reporting.
If you want to track goals instead of events, please use the 1.x.x version of the library.
Installation
Install the package:
pip install django-usefathom
Add usefathom
to your settings.py
file:
INSTALLED_APPS = [
# ...
"usefathom",
# ...
]
Add template processor to your settings.py
file:
TEMPLATES = [
{
# ....
"OPTIONS": {
"context_processors": [
# ...
"usefathom.context_processors.usefathom",
# ...
],
},
},
]
Add your fathom site id to your settings.py
file:
FATHOM_SITE_ID = "XXXX1234"
Include tracking snippet in your templates:
{% include "usefathom/usefathom.html" %}
From this point your site visits will be tracked.
Event Tracking
Python
Now if you want to report a event from your backend service to Fathom analytics:
import usefathom
def some_view(request, *args, **kwargs):
# anywhere you have request object, most likely views are a good place for this
usefathom.track(request, "add_to_card", 100) # Third parameter is optional integer, attaches the monetary value to the event in cents
And the goal will be reported to Fathom analytics on the next page load.
HTML+JS
You can use template tags to track the goals from the html. It's useful when tracking external link clicks, etc.
{% load fathom }
......with link
<a href="https://go-somewhere.com/link" {% click_event "somewhere_link_clicked" 100 %}>Go somewhere?</a>
......with form
<form method="POST" {% submit_event "registration_submit" %}>
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_usefathom-2.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 01357777861bd543a3c1659776c44c99a47a8fdb02fcc90df776ca6e2c2f796d |
|
MD5 | 10c6785a6aae5affc46cfed5c2b1b049 |
|
BLAKE2b-256 | 5e93a4facca7f5a6e9fb46bdd18b8818f6d831a7c7d5284e63b8530ec2a1c5ba |