ga-dnt-analytics
Basic Google Analytics web component with Do Not Track support.
[ This description is mirrored from README.md at github.com/justinribeiro/ga-dnt-analytics on 2019-05-22 ]
<ga-dnt-analytics>
Basic Google Analytics web component with Do Not Track support.
<ga-dnt-analytics debug="true"></ga-dnt-analytics>
ga-dnt-analytics - Open DevTools and check console.
Installation
Install the component using Bower:
bower i justinribeiro/ga-dnt-analytics --save
Usage
Import Web Components' polyfill, if needed:
<script src="bower_components/webcomponentsjs/webcomponents-loader.js"></script>
Import ga-dnt-analytics:
<link rel="import" href="bower_components/ga-dnt-analytics/ga-dnt-analytics.html"/>
Start using it!
<ga-dnt-analytics key="UA-XXXXXX-X"></ga-dnt-analytics>
Attributes/Properties
Attribute | Options | Default | Description |
---|---|---|---|
key |
String | "" | (optional) Sets UA for Google Analytics tracking |
debug |
Boolean | false |
(optional) Enables Google Analytics debugging mode |
trace |
Boolean | false |
(optional) Use with debug; enables full tracing for GA |
donottrack |
Boolean | true |
(optional) Check and use Do Not Track browser flag |
pageview |
Boolean | false |
(optional) Send ga('send', 'pageview') ping on element stamp |
Methods
If not using the pageview
property to send a ping to GA, you can use the send()
method to send a payload to GA.
// via Polymer 2.x
this.shadowRoot.querySelector('ga-dnt-analytics').send({
hitType: 'pageview',
page: window.location.pathname,
location: window.location.href,
title: 'My Title'
});
// via Polymer 1.x
this.$$('ga-dnt-analytics').send({
hitType: 'pageview',
page: window.location.pathname,
location: window.location.href,
title: 'My Title'
});
// via JavaScript
document.querySelector('ga-dnt-analytics').send({
hitType: 'pageview',
page: window.location.pathname,
location: window.location.href,
title: 'My Title'
});
For list of payloads and string/objects to send, see See https://developers.google.com/analytics/devguides/collection/analyticsjs/sending-hits.
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request :D
Credits
Justin Ribeiro Schalk Neethling Google Analytics
License
MIT License (MIT)
Links
Compatibility
Was this helpful? Need more help?
Leave a comment or a question below. You can also join
the chat on Discord or
ask questions on StackOverflow.
Version
Dependencies
Polymer/polymer#^1.4.0
- Released
- 2017-01-16
- Maturity
- IMPORTED
- License
- Other
Compatibility
- Framework
- Polymer 1.0+
- Polymer 2.0+ in 2.0.0
- Browser
- Browser Independent