You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Feb 21, 2024. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+8-32Lines changed: 8 additions & 32 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,29 +2,8 @@
2
2
3
3
This library provides a Python interface to Google Analytics, supporting the Universal Analytics Measurement Protocol, with an interface modeled (loosely) after Google's `analytics.js`.
4
4
5
-
**NOTE** this project is reasonably feature-complete for most use-cases, covering all relevant features of the Measurement Protocol, however we still consider it _beta_. Please feel free to file issues for feature requests.
6
-
7
-
# Contact
8
-
Email: `opensource@analyticspros.com`
9
-
10
-
# Installation
11
-
12
-
The easiest way to install universal-analytics is directly from PyPi using `pip` by running the following command:
Otherwise you can download source code and install it directly:
21
-
22
-
python setup.py install
23
-
24
5
# Usage
25
6
26
-
For the most accurate data in your reports, Analytics Pros recommends establishing a distinct ID for each of your users, and integrating that ID on your front-end web tracking, as well as back-end tracking calls. This provides for a consistent, correct representation of user engagement, without skewing overall visit metrics (and others).
27
-
28
7
A simple example:
29
8
30
9
```python
@@ -39,15 +18,15 @@ Please see the [test/test_everything.py](./test/test_everything.py) script for a
39
18
This library support the following tracking types, with corresponding (optional) arguments:
40
19
41
20
* pageview: [ page path ]
42
-
* event: category, action, [ label [, value ]]
43
-
* social: network, action [, target ]
21
+
* event: category, action, [ label [, value ]]
22
+
* social: network, action [, target ]
44
23
* timing: category, variable, time [, label ]
45
24
46
25
Additional tracking types supported with property dictionaries:
47
26
48
27
* transaction
49
28
* item
50
-
* screenview
29
+
* screenview
51
30
* exception
52
31
53
32
Property dictionaries permit the same naming conventions given in the [analytics.js Field Reference](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference), with the addition of common spelling variations, abbreviations, and hyphenated names (rather than camel-case). These are also demonstrated in the [tests/main.py](./tests/main.py) file.
We're particularly interested in the scope of throttling for back-end tracking for users who have a defined use-case for it. Please [contact us](mailto:opensource@analyticspros.com) if you have such a use-case.
49
+
# Attribution
75
50
51
+
This package is a fork of a package by the same name by [Analytics Pros](https://github.com/analytics-pros/universal-analytics-python).
0 commit comments