Skip to content

Commit d3b369e

Browse files
author
Dustin Larimer
authored
Merge pull request #434 from keen/dustin-latest-release
Automated Event Tracking (browser-only)
2 parents ce1b579 + b4aa0e9 commit d3b369e

File tree

5 files changed

+651
-81
lines changed

5 files changed

+651
-81
lines changed

CHANGELOG.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,13 @@
1212
[{{ release-title }} ({{ version }})](https://github.com/keen/keen-dataviz.js/releases/tag/{{ version }})
1313
1414
-->
15+
<a name="4.2.0"></a>
16+
# 4.2.0 Automated Event Tracking (browser-only)
17+
18+
**Stream: [keen-tracking.js](https://github.com/keen/keen-tracking.js)**
19+
[Release: Automated Event Tracking (browser) (v1.3.0)](https://github.com/keen/keen-tracking.js/releases/tag/v1.3.0)
20+
21+
1522
<a name="4.1.0"></a>
1623
# 4.1.0 Module Updates
1724

README.md

Lines changed: 30 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,8 @@ Or load it synchronously from the CDN:
1818

1919
```html
2020
<meta charset="utf-8">
21-
<link href="https://d26b395fwzu5fz.cloudfront.net/4.1.0/keen.min.css" rel="stylesheet" />
22-
<script src="https://d26b395fwzu5fz.cloudfront.net/4.1.0/keen.min.js"></script>
21+
<link href="https://d26b395fwzu5fz.cloudfront.net/4.2.0/keen.min.css" rel="stylesheet" />
22+
<script src="https://d26b395fwzu5fz.cloudfront.net/4.2.0/keen.min.js"></script>
2323
```
2424

2525
Under the hood, this is simply a bundled release of the following packages:
@@ -50,7 +50,29 @@ This package contains [keen-tracking.js](https://github.com/keen/keen-tracking.j
5050

5151
[Full documentation is available in the keen-tracking.js repo](https://github.com/keen/keen-tracking.js/blob/master/docs/README.md).
5252

53-
### Setup and Pageview Tracking
53+
54+
### Automated Event Tracking (browser-only)
55+
56+
Automatically record `pageviews`, `clicks`, and `form_submissions` events with robust data models:
57+
58+
```html
59+
<link href="https://d26b395fwzu5fz.cloudfront.net/4.2.0/keen.min.css" rel="stylesheet" />
60+
<script src="https://d26b395fwzu5fz.cloudfront.net/4.2.0/keen.min.js"></script>
61+
<script>
62+
Keen.ready(function(){
63+
var client = new Keen({
64+
projectId: 'YOUR_PROJECT_ID',
65+
writeKey: 'YOUR_WRITE_KEY'
66+
});
67+
client.initAutoTracking();
68+
});
69+
</script>
70+
```
71+
72+
[Learn how to configure and customize this functionality here](https://github.com/keen/keen-tracking.js/blob/master/docs/auto-tracking.md)
73+
74+
75+
### Pageview Tracking
5476

5577
First, let's create a new `client` instance with your Project ID and Write Key, and use the `.extendEvents()` method to define a solid baseline data model that will be applied to every single event that is recorded. Consistent data models and property names make life much easier later on, when analyzing and managing several event streams. This setup also includes our [data enrichment add-ons](https://keen.io/docs/streams/data-enrichment-overview/), which will populate additional information when an event is received on our end.
5678

@@ -136,13 +158,16 @@ client.recordEvent('pageview', {});
136158

137159
Every event that is recorded will inherit this baseline data model. Additional properties defined in `client.recordEvent()` will be applied before the event is finally recorded.
138160

161+
Want to get up and running faster? This can also be achieved in the browser with [automated event tracking](https://github.com/keen/keen-tracking.js/blob/master/docs/auto-tracking.md).
162+
139163
**More examples:**
140164

141165
* [Record clicks and form submissions](https://github.com/keen/keen-tracking.js#click-and-form-submit-tracking)
142166
* [Block bots and improve device recognition](https://github.com/keen/keen-tracking.js#block-bots-and-improve-device-recognition)
143167

144168
**What else can this SDK do?**
145169

170+
* [Automated tracking (browser-only)](https://github.com/keen/keen-tracking.js/blob/master/docs/auto-tracking.md)
146171
* [Record multiple events in batches](https://github.com/keen/keen-tracking.js/blob/master/docs/record-events.md)
147172
* [Extend event data models for a single event stream](https://github.com/keen/keen-tracking.js/blob/master/docs/extend-events.md)
148173
* [Queue events to be recorded at a given time interval](https://github.com/keen/keen-tracking.js/blob/master/docs/defer-events.md)
@@ -219,8 +244,8 @@ This package contains [keen-dataviz.js](https://github.com/keen/keen-analysis.js
219244
<html>
220245
<head>
221246
<meta charset="utf-8">
222-
<link href="https://d26b395fwzu5fz.cloudfront.net/4.1.0/keen.min.css" rel="stylesheet" />
223-
<script src="https://d26b395fwzu5fz.cloudfront.net/4.1.0/keen.min.js"></script>
247+
<link href="https://d26b395fwzu5fz.cloudfront.net/4.2.0/keen.min.css" rel="stylesheet" />
248+
<script src="https://d26b395fwzu5fz.cloudfront.net/4.2.0/keen.min.js"></script>
224249
</head>
225250
<body>
226251
<!-- DOM Element -->

0 commit comments

Comments
 (0)