**[ This description is mirrored from README.md at [github.com/justinribeiro/ga-dnt-analytics](https://github.com//justinribeiro/ga-dnt-analytics/blob/2.0.1/README.md) on 2019-05-22 ]** # \ Basic Google Analytics web component with Do Not Track support. [](https://www.webcomponents.org/element/justinribeiro/ga-dnt-analytics) ```html ga-dnt-analytics - Open DevTools and check console. ```  ## Installation Install the component using Bower: ```shell bower i justinribeiro/ga-dnt-analytics --save ``` ## Usage 1. Import Web Components' polyfill, if needed: ```html ``` 2. Import ga-dnt-analytics: ```html ``` 3. Start using it! ```html ``` ## 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. ```javascript // 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](https://developers.google.com/analytics/devguides/collection/analyticsjs/sending-hits). ## Contributing 1. Fork it! 2. Create your feature branch: `git checkout -b my-new-feature` 3. Commit your changes: `git commit -am 'Add some feature'` 4. Push to the branch: `git push origin my-new-feature` 5. Submit a pull request :D ## Credits [Justin Ribeiro](https://github.com/justinribeiro) [Schalk Neethling](https://github.com/schalkneethling) [Google Analytics](https://developers.google.com/analytics/) ## License MIT License (MIT)