Plugin for the analytics npm package. Built using microbundle.
Install analytics and analytics-plugin-conscia packages
npm install analytics
npm install analytics-plugin-consciaTo use, install the package and initialize the plugin with analytics.
import Analytics from 'analytics'
import analyticsPluginConscia from 'analytics-plugin-conscia'
const analytics = Analytics({
app: 'awesome-app',
plugins: [
analyticsPluginConscia({
trackerUrl: 'https://tracker-staging.conscia.ai',
customerCode: 'xyz',
apiKey: '12345678',
})
]
})
/* Track a page view */
analytics.page()
/* Track a custom event */
analytics.track('cartCheckout', {
item: 'pink socks',
price: 20
})
/* Identify a visitor */
analytics.identify('user-id-xyz', {
firstName: 'bill',
lastName: 'murray'
})After initializing analytics with the consciaAnalyticsPlugin plugin, data will be sent into Conscia's Tracker service whenever analytics.identify, analytics.page, or analytics.track are called.
The analytics-plugin-conscia package works in the browser as well as in nodeJS environments.
The UMD distribution (imported via the unpkg CDN) can be used to send events to the Conscia Tracker service in client-side environments where a bundler is not being used.
<html>
<head>
<script src="https://unpkg.com/analytics/dist/analytics.min.js"></script>
<script src="https://unpkg.com/analytics-plugin-conscia/dist/analytics-plugin-conscia.umd.js"></script>
<script>
const Analytics = _analytics.init({
app: 'awesome-app',
plugins: [
analyticsPluginConscia({
trackerUrl: 'https://tracker-staging.conscia.ai',
customerCode: 'xyz',
apiKey: '12345678',
})
]
});
</script>
<script>
Analytics.identify('user123', {
name: 'John Smith',
company: 'Conscia',
});
Analytics.page();
</script>
</head>
<body>
<h1>Hello World</h1>
<button onclick="Analytics.track('Button Clicked')">Event 1</button>
</body>
</html>| Option | description |
|---|---|
trackerUrl required - string |
The Conscia Tracker Service URL |
customerCode required - string |
The Conscia Customer Code which the tracker events belong to |
apiKey required - string |
The Conscia API Key which has sufficient permissions to submit tracker events |
This package distributes the plugin in the following formats:
./dist/analytics-plugin-conscia.d.ts- Typescript definitions./dist/analytics-plugin-conscia.require.cjs- used for require() in Node 12+./dist/analytics-plugin-conscia.modern.js- bundle for modern browsers./dist/analytics-plugin-conscia.cjs- CommonJS bundle./dist/analytics-plugin-conscia.module.js- ESM bundle./dist/analytics-plugin-conscia.umd.js- UMD bundle