👍

The Events management application is currently in BETA. We welcome and encourage your feedback as we work together to refine capabilities for future iterations of this application. Kindly share your feedback using the dedicated feedback option provided in the application UI.

What is Events Management

---

Events management is an application that streamlines the pixel integration process with real-time insights and provides you greater control over the event tracking on your site. It lets you instantly gauge whether your pixel implementation works as expected.

As you integrate and optimize your site’s pixel, Events Management is your go-to tool to ensure that the data driving your AI-powered recommendations, search results, and analytics is correct and complete.

How is Events Management valuable

---

• Seamless Pixel Implementation: Events management supports your pixel implementation by providing detailed event data in an instant. Such transparency ensures that the implementation is fast, accurate, and friction-free.
  
  
• Control and debug events in real-time: Events management is a power-packed utility tool that allows you to investigate the details of individual events, load and test events, control events from local, staging, and production environments, and debug live site events in real-time.

How to view events

---

Prerequisites

Ensure the IAM Admin grants you the 'Events Management User - Read Only' role. This role provides you access to open and utilize the Events Management application.

Once the role has been assigned, the Events Management application should become available under the Setup menu category:

1. Navigation

Go to Setup > Events management in the Bloomreach dashboard.

2. Select the Mode and Period

2.1) Mode

The Events Management app features two unique working modes - Integration and Live. These cater to the different stages of your pixel integration lifecycle. With these, you can flexibly test and monitor your event tracking before and after going Live. We retain data up to the last 30 days in both modes.

Integration mode

• Purpose: This mode serves as your testing ground to debug and validate events instantly. It allows you to view the specific events with the debug flag set to “true.” These events are available to view in seconds but will be discarded and will not impact any production features.

  

• When to use this mode: During the initial setup, when implementing new pixel types or making changes to your tracking.

  📘

  Follow this guide to learn how you can send and track debug events in Integration mode.

Live mode

• Purpose: This mode allows you to monitor and troubleshoot Live events in your production environment. Due to the large volume of events being processed every hour, it generally takes up to 2 hours to view these events.
• When to use this mode: Ready to go live or already running live.

2.2) Period

This sets the timeframe to view events and issues.

Please note that the Mode and the Period specified in this step will impact the data displayed in the tabs discussed below.

3. View data under the Status and Events stream tabs

On the Events Management homepage, you’ll see two tabs — Status and Events Stream. Each serves a distinct purpose, tailored to streamline your workflow and enhance your data management capabilities.

Receiving and Viewing New Events
On receiving new events, the UI displays a notification.

Click on Refresh to start viewing the received events under the Status and Events Stream tabs. In this example, a newly received Search event is displayed.

Status (for preliminary pixel verification)

This serves as your event health dashboard. It provides you with an overview of the quality of pixel events sent for a given period.

Events are grouped by type, and each category is assessed for correctness. Here, you can observe which pixel types are received correctly and which have issues. Events categories that contain any amount of pixel events with issues are indicated in orange, while those that have no issues detected will be marked in green.

Page view pixels

This gives a quick snapshot of your Page view pixels implementation. The pixel types displayed are:

• Product Page View
• Category Page View
• Search Result Page View
• Content page view
• Conversion Page View Pixel

Event pixels

This gives a quick snapshot of your Event pixel implementation. The event pixels displayed are:

• Add to Cart
• Search
• Suggest
• Quick View

View specific pixel issues and tracking code snippet
To get an overview of the issues pertaining to a specific event type, click the individual pixel type button. This opens the event type modal on the right with two tabs — Overview and Snippet.

Overview tab shows the pixel count (sum of individual pixels received on the API) and the specific issues detected. Click on the “🔍Inspect events” option to inspect all details of this event type under the Events stream. In the below example, we inspect the Category page view pixels.

Snippet tab shows the event tracking code snippet that you can copy and use for pixel implementation. The snippet dynamically sets the account ID and debug parameter (for Integration mode). The code snippet also contains relevant comments that offer additional context regarding the parameters.

👍

To monitor your pixel’s health closely, use Pixel Monitor. It provides detailed trendlines and allows you to set alerts for pixel errors. This ensures that your data is flowing as expected.

Events stream (for data-backed debugging)

This serves as a live feed of events as they are tracked on your site. Here you can

• Observe individual events received.
• Check the event validation status.
• Drill down into specifics like event type, timestamp, and much more.

Live feed

Here, you can view and inspect the detailed feed of all the tracked events. The details include

• Date: Date when the event was tracked by our system.

• Type: Type of pixel event tracked - page view or user interaction event.

• Domain key: The Bloomreach-provided ID of the domain receiving the request. This parameter identifies the specific site language version when one account ID hosts multiple site versions with different languages.

• View ID: The specific site catalog view displayed when one Bloomreach account ID hosts multiple site versions with unique product catalog characteristics, such as product price, availability, or title.

• Device: Device where the event was fired.

• Status: This specifies the status of the pixel type and helps identify any issues with the implementation.

  

Filters

Here, you can filter the data based on Issue type, Type of pixel event, Cookie ID, and User ID.

📘

Privacy and Data Integrity

In line with our commitment to privacy and data protection, the Events Stream and the Event Details Side Panel are designed to respect user privacy. Any personally identifiable information (PII) is handled according to strict privacy standards, ensuring that sensitive data of your customers remains hidden or masked while you analyze event properties.

Coming Up

---

• Ready-to-copy tailored snippets: In upcoming feature iterations, we will dynamically populate domain_key, view_id, and various other variables to make the snippets even more tailored to your needs.
• All the pixel types: We will add other pixel types onto the Status page for easy at-glance validation. These will include not only the Homepage and Widget pixels.