Tooling

Insights plugin

The Insights plugin sends data to an Insights API endpoint via the Beacon API when an <Experience> component remains in the viewport for a specified amount of time. This view data powers Component Insights and Experience Insights.

Entries without a personalization or experiment can also be tracked this way if they are wrapped with the <Experience> component. This data can be analyzed on the Content insights page.

Installation

The Insights Plugin requires that you are using major version 6.x or above of one of the SDKs. Ensure that all of your other @ninetailed dependencies are also using the same version.

Add the dependency:

$npm install @ninetailed/experience.js-plugin-insights

Then, add the plugin to the instance:

1import { NinetailedInsightsPlugin } from '@ninetailed/experience.js-plugin-insights'
1<NinetailedProvider
2  // ...
3  plugins={[
4    new NinetailedInsightsPlugin()
5  ]}
6  componentViewTrackingThreshold={2000} // (Optional prop) Number, default = 2000
7>
8  // ...
9</NinetailedProvider>;

Timing configuration

The Insights Plugin logs that a component has been seen only after the component has remained within the user’s viewport for a specified amount of time (in milliseconds), determined by the value of the componentViewTrackingThreshold property on the instance (see code samples above). If the option is unspecified, the value defaults to 2000.