Skip to main content

Super simple Django application for easily tracking events and submitting them asynchronously to KISSmetrics.

Project description

# django-funkymetrics

django-funkymetrics is a super simple Django application for easily tracking events and submit them asynchronously to KISSmetrics using celery tasks.

## Features

  • Track app events easily
  • Submits analytics events asynchronously to KISSmetrics

## Installation

Add the KISSmetrics JS snippet to your project template(s).

Install django-funkymetrics:

pip install django-funkymetrics

Alternatively, download the source code and manually add it to your PYTHONPATH.

Set your KISSmetrics API key:

KISS_API_KEY = ‘<your_api_key>’

Track events and profit.

## Prerequisites

The library assumes that Celery is installed and configured for the Django project. Tasks are automatically created for each record_event.

## Usage

Simply import record_event in your code where you want to track events, and call it as needed:

from import record_event

# Without properties record_event(request, ‘downgraded’)

# With properties record_event(request, ‘upgraded plan’, {‘to_plan’: ‘Standard’})

The request object is used to identify the user the event is associated with.

When the request isn’t available, a user instance can be passed instead. Note that we can’t extract the anonymous KISSmetrics identifier from the user object, so it doesn’t really make sense to pass anonymous users.

## Identifying users

Anonymous users are identified by their KISSmetrics anonymous ID (ie. the value of the km_ai cookie).

Authenticated users are identified by their username.

## Future stuff

  • Overriding user identifiers
  • Queue events locally and submit in batches

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-funkymetrics-0.1.9.tar.gz (4.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page