Set up web tracking for Loomi AI for Shopify

This guide walks you through setting up web tracking on your Shopify store to enable behavioral data collection and personalization features.

📘

Running Loomi AI for Shopify alongside another Bloomreach product? Your web integration depends on your setup. See Choose your web integration before you start.

Overview

After setting up your Shopify integration inside Data hub, you need to set up web tracking on your Shopify theme. This enables Bloomreach to track customer behavior and power personalization features.

This guide covers the standard implementation using Bloomreach Web SDK for all Bloomreach users. For custom implementation methods, see Shopify Customization.

Choose your web integration

Your web tracking method depends on which Bloomreach products you use with Shopify.

❗️

If you're using the legacy Engagement Shopify connector (not Loomi AI for Shopify), keep the Engagement web integration and don't set up Data hub Event Streams. The two paths are separate and can't be mixed.

Discovery-only customers

If you use Loomi AI for Shopify with Discovery but not Engagement:

• Install the Discovery connector alongside Loomi AI for Shopify.
• Configure your event streams with Discovery as the only destination. Don't enable Engagement destinations.
• For Discovery Recommendations, confirm that the Recommendations module is enabled in your Discovery dashboard and that your item collection is mapped to Discovery.

Prerequisites

Before you begin, ensure you have:

• Completed Data hub integration: You must complete how to integrate Loomi AI for Shopify before setting up web tracking.
• Shopify theme editor access: Access to edit your Shopify theme through Online Store > Themes > Edit theme.
• Marketing and Analytics consent: A "Marketing and Analytics" consent category configured in your cookie acceptance banner. For detailed prerequisites, see Shopify Web Pixel prerequisites.

Set up web tracking

Bloomreach Web SDK is part of the official Bloomreach: Loomi AI app in the Shopify App Store.

❗️

Important

A single store can only have one Bloomreach Web SDK pixel integration (1 project = 1 integration = 1 SDK).

Enable Bloomreach Web SDK

1. In your Shopify admin, go to Online Store > Themes > Edit Theme.

2. Click App Embeds in the left sidebar.

3. In the App embeds panel, search for Bloomreach Web SDK in the search box.
4. Find Bloomreach Web SDK and turn the toggle on.

Configure Bloomreach Web SDK (optional)

After enabling the Bloomreach Web SDK, you can configure additional settings:

Available configuration options:

• Track Real-time Segments: Enable real-time segment tracking for personalization
• Track Page Visits: Enable page visit event tracking
• Custom Configuration (JSON): Add custom configuration to extend or override default settings.
  Example:

{
  "track": {
    "google_analytics": false
  },
  "cookies": {
    "cross_subdomain": ".example.com",
    "expires": {
      "tracking": 15768000,
      "ab_test": 2592000
    }
  },
  "ping": {
    "enabled": true,
    "interval": 60
  },
  "webOptimization": {
    "experiments": false,
    "tagManager": true,
    "webLayers": true
  }
}

Discovery-specific options:

• Discovery - test_data: Enable this to flag event data as test data, which won't affect your analytics. Use this in test environments to validate tracking without impacting production data. Turn this off on your live site.

• Discovery - debug: Enable this to view individual events from your test environment in real time. Events appear in the Integration mode of Events diagnostics within seconds. When disabled, events appear in Live mode with up to 2 hours delay.

5. After configuring your settings, click Save to save your changes.

Configure event tracking in Data hub

The Bloomreach Web SDK tracks the following customer behavior events. You can configure which specific event to track in your Data hub integration settings:

• view_category: Category page views
• view_item: Product detail page views
• search_submit: Search queries submitted
• checkout: Checkout process events
• view_quickview: Quick view interactions
• add_to_cart: Add to cart actions
• view_homepage: Homepage views
• view_search_results: Search results page views
• conversion: Purchase completion events

❗️

Important

When switching from Engagement SDK to Bloomreach Web SDK, the search event is now split into search_submit and view_search_results. Update any dependencies on search events to use search_submit.

Validate event tracking

To validate that your event tracking is working correctly:

For Discovery

1. Install the Bloomreach Tracking Console for Google Chrome.
2. Use the Events Management view to test Pixel Tracking with Debug Events.

For detailed validation steps and troubleshooting, see Pixel Validator documentation.

Existing server-side Discovery pixel

If your store already has a server-side Discovery pixel, don't add Discovery as a destination in the Loomi AI for Shopify event stream. Adding it would cause duplicate tracking events.

If Discovery was automatically added as a destination during setup, remove it from the event stream configuration in Data hub.

📘

How Loomi AI for Shopify tracks events

The Loomi AI for Shopify Web SDK uses Data hub Event Streams to send events. It doesn't use the legacy pix.gif pixel calls. To verify tracking, use the Bloomreach Tracking Console Extension instead of the browser Network tab.

For Engagement

1. Install the Bloomreach Tracking Console for Google Chrome.
2. Or open a customer profile in your Engagement project to verify incoming web events.

Open a customer profile in your Engagement project to verify incoming web events.

Limitations

Custom tracking domain (CTD) limitation

Custom Tracking Domains (CTD) are not fully supported in Loomi AI for Shopify. If you specify a CTD value in the custom configuration section of the Shopify app settings, it only changes the tracking target for page visit and session events — it doesn't affect Shopify web pixel events such as view_item, search_submit, or purchase events.

Next steps

Your web tracking setup is complete. Your Shopify store now sends behavioral data to Bloomreach to power personalization features.

Additional resources

• Loomi AI for Shopify overview: Return to the feature overview.
• Loomi AI for Shopify FAQ: Common questions about the integration.