1.21.5 • Published 7 months ago
@elastic/search-ui-analytics-plugin v1.21.5
Search UI Analytics Plugin
Use the Analytics Plugin to send analytics events to the Behavioral Analytics Product. Follow the instructions to set up the plugin.
Installation
yarn add @elastic/search-ui-analytics-plugin
## OR
npm install @elastic/search-ui-analytics-plugin
Basic Usage
Add the Analytics Plugin to your Search UI configuration like so:
import AnalyticsPlugin from "@elastic/search-ui-analytics-plugin";
// search ui configuration
const config = {
apiConnector: connector,
searchQuery: { ... },
plugins: [ AnalyticsPlugin() ]
}
By default, the Analytics Plugin will use the Behavioral Analytics client provided when using script tag integration.
Passing in a custom analytics client
If you integrated Behavioral Analytics using the @elastic/behavioral-analytics-javascript-tracker
NPM package, you can pass in a custom analytics client to the Analytics Plugin.
import AnalyticsPlugin from "@elastic/search-ui-analytics-plugin";
import { createTracker, getTracker } from "@elastic/behavioral-analytics-javascript-tracker";
createTracker({
// the DSN can be found in the Behavioral Analytics Collections view page
dsn: "https://my-analytics-dsn.elastic.co"
})
// search ui configuration
const config = {
apiConnector: connector,
searchQuery: { ... },
plugins: [
AnalyticsPlugin({
client: getTracker()
})
]
}
Options
The Analytics Plugin accepts the following options:
Option | Type | Description | Default |
---|---|---|---|
client | AnalyticsTracker | The Behavioral Analytics client to use. Read more on Behavioral Analytics Tracker repo | window.elasticAnalytics |