@livechat/store-metrics

Reads and stores various marketing parameters in Accounts Client Store. Super Important Thing for Marketing Team™. Only 3.1kB gzipped.

Installation

npm install --save @livechat/store-metrics

Usage

Apps

Library exposes only one function that saves source attribution and Partner Program affiliation params based on document.location and document.referrer. Make sure to fire it as early as possible, before redirects etc.

import storeMetrics from "@livechat/store-metrics";
storeMetrics();

Websites

For websites without module bundler/resolver you can use self-executing version of store-metrics. You can load it directly from our CDN:

<script src="https://cdn.livechat-static.com/metrics/store-metrics.min.js" async></script>

And that's it.

Development

npm install
npm run test:watch

Build

npm run build

Changelog

1.0.0 — 2021-05-25

Changed

• Storage mechanism changed from cookies to cross-domain localStorage, to support multi-product Global Accounts
• Because there is no 'session' concpet in localStorage, default TTL is set to 2 weeks

Removed

• IE no longer supported
• URL API polyfill

0.4.0 [YANKED]

0.3.0 — 2020-06-17

Added

• All cookies are now set with SameSite='none' and Secure attributes (see: https://www.chromestatus.com/feature/5633521622188032)

0.2.1 - 2018-10-19

Added

• ShareASale click ID first-party cookie (see: http://shareasale.com/itp/lead.htm#_Toc522268050)

0.2.0 - 2018-02-13

Added

• Return params which were saved while executing

0.1.4 - 2017-12-12

Fixed

• Referrer for internal redirects is no longer stored

0.1.3 - 2017-12-08

Added

• Self-executing version for browsers
• CDN deployment and website usage docs

Fixed

• URL is not a constructor error

0.1.2 - 2017-12-05

Fixed

• Cookie domain for origins not starting with www.

0.1.1 [YANKED]

0.1.0 - 2017-11-28

Initial release