HomeData hubOther resources
Guides

Set up web tracking for Loomi AI for Shopify

Suggest Edits

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

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.

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.

Shopify theme editor showing the sidebar with Home page, Header (with Announcement bar and Header subsections), and App embeds (showing "3") highlighted
  1. In the App embeds panel, search for Bloomreach Web SDK in the search box.
  2. Find Bloomreach Web SDK and turn the toggle on.
App embeds panel showing search field and Bloomreach Web SDK with toggle switch, plus "Find apps built for themes on the Shopify App Store" link below

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.

Bloomreach Web SDK configuration panel showing various toggle options and fields
  1. 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
Web Events Tracking configuration panel showing toggles for view_category, view_item, search_submit, checkout, view_quickview, add_to_cart, view_homepage, and view_search_results

❗️

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.

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.

Next steps

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

Additional resources

Updated 3 days ago