Shopify Theme Installation

Core Components and App Pixel

Retail Cloud Connect uses two Shopify components to capture storefront user events correctly: an App Embed and an App Pixel. Enable both to collect model training data, segment visitors into Shopify markets, and capture conversions.

• When Enable App Embed is clicked, Shopify opens the Theme Editor for the current theme
• Confirm that the Core Components App Embed is activated, then click Save to exit the Theme Editor

• Shopify uses App Pixels to create strict, isolated environments on the online store. Retail Cloud Connect uses Shopify-controlled APIs to support performance, security, and privacy for merchants and shoppers.
• All pixels, including the Retail Cloud Connect App Pixel, are visible in the Customer events page of Shopify settings.

Training on Existing Traffic

The Core Components App Embed also supports optional training on existing Shopify storefront traffic before the store fully switches to Nimstrata search and browse results. It also runs configured search redirects early in the page lifecycle.

Current options include:

• Track Shopify Search Results
• Track Shopify Collection Pages

This can be helpful when merchants want to:

• Prepare for an A/B test
• Let AI Commerce Search learn from existing shopper behavior
• Gather training data before launching a new search experience

Cookies

Enabling the Core Components App Embed and App Pixel places cookies on the Shopify storefront:

• rcc-identity - The prefix of the myshopify.com domain, used to identify the Shopify store
• rcc-market-id - The ID of the market shoppers are shopping from, used to provide location-specific search results
• rcc-place-id - The active Shopify location ID, used to provide results based on local inventory availability
• rcc-visitor-id - An anonymized UUID for each Shopify store visitor, used to provide personalized search results
• rcc-track-search - Whether Shopify-native search traffic should be captured for model training before launch
• rcc-track-collection - Whether Shopify-native collection traffic should be captured for model training before launch

These cookies support personalized product discovery on the first-party Shopify storefront, so merchants typically classify them as functional cookies. Without rcc-visitor-id, personalized results do not work.

AI Commerce Search personalization is limited to the Shopify storefront. It is not used for external ad targeting. For more details, review the Google Cloud terms also referenced in Nimstrata's Privacy Policy and Terms & Conditions:

Online Store 1.0 Theme Assets

Nimstrata hosts static assets on Cloudflare's CDN for Shopify merchants using Online Store 1.0 or other manual theme installs where Shopify App Blocks are not available.

Additional Guidance

For best performance, only include assets when they are required to render App Blocks, for example:

{% # Your theme.liquid file %}

{%- if request.page_type == 'search' or request.page_type == 'collection' %}
    <link rel="stylesheet" href="https://assets.retailconnect.app/shopify/latest/search-react.css">
    <script defer src="https://assets.retailconnect.app/shopify/latest/search-react.js"></script>
{%- endif %}

{%- if request.page_type == 'product'
  or request.page_type == 'collection'
  or request.page_type == 'cart'
  or request.page_type == 'index'
  or request.page_type == 'page'
  or request.page_type == 'blog'
  or request.page_type == 'article'
%}
    <link rel="stylesheet" href="https://assets.retailconnect.app/shopify/latest/recommendation-react.css">
    <script defer src="https://assets.retailconnect.app/shopify/latest/recommendation-react.js"></script>
{%- endif %}

{%- if request.page_type == 'page' %}
    <link rel="stylesheet" href="https://assets.retailconnect.app/shopify/latest/document.css">
    <script defer src="https://assets.retailconnect.app/shopify/latest/document.js"></script>
{%- endif %}

Manual installs may also need to define window.Nimstrata before the script loads. Online Store 2.0 App Blocks generate these values automatically. See Window Nimstrata Properties and nimstrata.liquid Setup before adding custom storefront JavaScript.

Product Card Builder and Styles

Use the following pages to customize how App Blocks look and behave:

• Product Card Builder to design the storefront product card
• Styling App Blocks to apply custom CSS
• Custom Components for advanced product card behavior
• Content Inside Search and Collection Grids for promotions, ads, or editorial content between search and collection product cards
• Custom No Results Page for branded search and collection empty states
• App Block Events for analytics, cart UI, rendered-grid events, reactive search state, and runtime filter or collection changes