Analytics for Personalization users

Table of contents

• Introduction
• Step 1: Select content types to extend with Contentful Analytics dashboards
• Step 2: Install the Insights Plugin
• Step 3: Wrap additional components in <EntryAnalytics />
• Step 4: Validate your integration
• Step 5: Enable Built-in AI Features for the Analytics Agent

Introduction

This guide explains how Contentful Personalization customers can use their existing integration to quickly implement Contentful Analytics.

This guide assumes that your application implements Contentful Personalization in a React-based frontend. It covers the following steps:

1. Select the content types to extend with Contentful Analytics dashboards.
2. Install the Insights Plugin. Use version 7.17.6 or later.
3. Optional: Wrap additional components in <EntryAnalytics />.
4. Validate your integration.
5. Enable Built-in AI Features.

Step 1: Select content types to extend with Contentful Analytics dashboards

You decide what content types display Content Analytics dashboards by enabling them:

1. Log in to the Contentful web app.
2. Navigate to the “Content model” tab.
3. Select the content type you want to enable entry-level analytics for (e.g., Page).
4. In the left sidebar, click Entry editors.
5. Under “Available items”, add the installed Contentful Personalization app.
6. Click Save. The “Analytics” tab is displayed in the entry editor for any entry of that content type.

Step 2: Install the Insights Plugin

Identify the Experience SDK version that you're using and install the Insights Plugin.

Step 3: Wrap additional components in <EntryAnalytics />

The Experience SDK provides the following components that can be used to wrap your React components: <EntryAnalytics /> and <Experience />. A wrapped component will automatically send a component event to the Experience API if a user views it. Contentful Analytics will then use these events to calculate actionable insights.

• Wrap content in an <Experience /> component if you want to enable both Contentful Personalization and Contentful Analytics for it.
• Wrap content in an <EntryAnalytics /> component if you exclusively want to enable Contentful Analytics for it.

Step 4: Validate your integration

We recommend using our Live Events view to validate your integration of Contentful Analytics.

To access the Live Events view:

1. Log in to the Contentful web app.
2. Navigate to the “Optimization” tab.
3. In the left sidebar, click Live Events.
4. Enable the Live event streaming toggle.

The Events dashboard displays the type of events that Contentful Analytics receives over time, and the Event streaming log lists invidivual events.

Step 5: Enable Built-in AI Features for the Analytics agent

The Analytics Agent is the AI assistant that allows you to ask contextual questions about your content and instantly receive AI-powered content answers, both as text and visual elements. The Analytics Agent relies on Contentful's AI features, so you must first enable them at the organization level.

To enable AI features at the organization level:

1. Log in to the Contentful web app.
2. Navigate to the “Optimization” tab.
3. In the left sidebar, click Analytics Agent.
4. Click Go to Organization Settings.
5. Click Continue to organization settings.
6. Enable the Built-in AI Features option.
7. Review the pricing and number of approved output words modal, then click Enable.
8. Review Contentful’s AI Terms of Service. If you agree, click Accept terms to enable Built-in AI features.