Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Woopra Analytics Tracking API

Project description

Track customers directly in Python using Woopra's Python SDK

The purpose of this SDK is to allow our customers who have servers running Python to track their users by writing only Python code. Tracking directly in Python will allow you to track your users through the back-end without having to handle http requests manually.

## Installation
```python
pip install woopra
```

## Usage
The first step is to setup the tracker SDK. To do so, configure the tracker instance as follows (replace mybusiness.com with your website as registered on Woopra):

```python
#import the SDK
from woopra import WoopraTracker

woopra = WoopraTracker("mybusiness.com")
```

You can also configure the timeout (in milliseconds, defaults to 30000 - equivalent to 30 seconds) after which the event will expire and the visit will be marked as offline:

```python
# set the timeout to 15seconds:
woopra.set_timeout(15000)
```
To identify a user, you should use the <code>identify()</code> function. You can choose to identify the visitor with his EMAIL, or with a UNIQUE_ID of your choice (in this case, make sure to re-use the same ID for a given visitor accross different visits).

```
woopra.identify(WoopraTracker.EMAIL ,
"johndoe@mybusiness.com",
{
'name' : 'Test Name2',
'admin' : False
},
IP_ADDRESS, # the IP address of the user
USER_AGENT # the user agent
)
```

And you're ready to start tracking events:
```python
woopra.track("play", {
"artist" : "Dave Brubeck",
"song" : "Take Five",
"genre" : "Jazz"
})
```

Or just push the user information (without event tracking) by doing:
```python
woopra.push()
```

Project details


Download files

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

Files for woopra, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size woopra-0.2.1.tar.gz (3.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page