# Shopify Theme Installation

# User Events

Retail Cloud Connect™ uses two Shopify components to correctly capture visitor data from your online store, an App Embed and an App Pixel.

For best results, you must enable both components to collect Vertex AI model training data, segment visitors into the appropriate Shopify markets, capture conversion events, and suggest relevant products to end users.

Click both Enable buttons in the Shopify App to activate the components:

User Event Enable Buttons on the Theme Installation Page
User Event Enable Buttons on the Theme Installation Page

  • When you click Enable App Embed you will be taken to the Theme Editor for your current theme
  • Confirm that the User Events App Embed is activated, then click Save to exit the Theme Editor

  • Shopify uses App Pixels to create strict, isolated environments on your online store. Retail Cloud Connect™ uses Shopify-controlled APIs to ensure performance, security, and privacy for you and your customers.
  • You can see all pixels, including the Retail Cloud Connect™ App Pixel, in the Customer events page of your Shopify settings:


# Cookies

Enabling the Retail Cloud Connect™ App Embed and App Pixel places up to three cookies on your Shopify storefront:

  • rcc-identity - The prefix of your myshopify.com domain, used to identify your Shopify store
  • rcc-market-id - The ID of the market users are shopping from, used to provide location-specific search results
  • rcc-visitor-id - An anonymized UUID for each Shopify store visitor, used to provide personalized search results

These three cookies work in tandem to provide personalized search results on your first-party Shopify storefront, so merchants typically classify them as functional cookies, as personalizing product discovery results directly enhances the user's experience and makes finding products more effective for specific users on your store. Without the rcc-visitor-id cookie, personalized aspects of Vertex AI Search for Commerce do not work.

Google Cloud's Vertex AI Search for Commerce personalizes search results only within your Shopify store to improve user experience. It doesn't use this data for external ad targeting or share it with third parties. For more details, please review the Google Cloud Retail API terms of service, also referenced in our Privacy Policy and Terms & Conditions:

Vertex AI Search for Industry terms for data use
https://cloud.google.com/retail/data-use-terms


# App Blocks

Each App Block requires a Serving Configuration ID which can be found in Google Cloud.

# Product Card Builder

Our Product Card Builder provides merchants using Online Store 2.0 themes with a drag-and-drop interface to design product listing pages. You can start with a predefined template or design your own product card from the available components.

You can also create Custom Components that retrieve additional data from Shopify's Storefront API.


# Online Store 1.0 Theme Assets

Nimstrata hosts static assets on Cloudflare's CDN for Shopify merchants using Online Store 1.0 themes that leverage our Shopify App Blocks.


# Additional Guidance

For best performance, we recommend only including 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' %}
    <script defer src="https://assets.retailconnect.app/shopify/latest/search-react.js"></script>
{%- endif %}