Integration with Shopify

The Yespo plugin for Shopify automatically handles the following technical setup:

• Contact transfer — real-time contact creation, update, and deletion, plus historical data import.
• Order transfer — real-time order creation and updates, plus historical data import.
• Web tracking — script installation and event tracking configuration (see the full list of events below).
• Web Push — script installation and Service Worker setup. You do not need to follow the steps from the standard Web Push setup guide — the only remaining step is to activate Web Push in your organization settings.
• Widgets — script installation.
• App Inbox — the plugin automatically reconfigures the script initialization and handles authentication token retrieval when the App Inbox toggle is enabled. No additional steps from the standard App Inbox guide are required.

📘

Note

• Product Recommendations require additional setup on your site, while the technical configuration of the remaining tools is performed automatically by the plugin.
• Technical details about the application can be found in the public repository

How to Set Up the Yespo Shopify App

Follow these simple steps to integrate Yespo with your Shopify store:

❗️

Note

We support integration only for one active Market

Step 1: Connect Your Yespo Account

Use the Full Access to API key from your Yespo account:

• Go to your Yespo account settings → API tab, create a full access to API key, and copy it.

• Log in or sign up for your Shopify account, follow the link to access the Yespo app, and click Install.

• Confirm installing the app.

• Enter your Yespo API key and click Connect.

Step 2: Web Tracking and Site Scripts Integration

Once your Yespo account is connected, install scripts.

• Activate the Yespo theme extension.

• Click Save and Publish.

Step 3: Enable App Inbox (Optional)

To use the App Inbox channel in your Shopify store, enable this option in the App Inbox section.

The plugin will automatically reconfigure the script initialization for App Inbox mode and handle authentication token retrieval — no manual setup is required.

All you need to provide is the CSS selector of the element on your site and the position of the bell icon relative to it: beforebegin, afterbegin, beforeend, or afterend.

<!-- beforebegin -->
<div class="your-selector">
  <!-- afterbegin -->
  element content
  <!-- beforeend -->
</div>
<!-- afterend -->

Step 4: Enable Web Tracking (Optional)

To activate tracking web events in Yespo, click Enable.

The app allows sending the following events to Yespo:

📘

Note

Additionally, you can manually set up sending the AddToWishlist and SearchRequest events.

CategoryPage Event Settings

After enabling web tracking, click Category Settings.

Configure sending the CategoryPage event for collection pages in Shopify.

1. In the Collection Name column, select the collections for which you want to send the CategoryPage event.
2. In the Select entity column, for each collection, select the entity type (Type / Category) that you use in the product feed as the product type.
3. In the Set up Category Value column, specify the product types that are displayed on this collection page (Bags, Accessories, etc.)

After that, when a user opens the page of the customized collection, the application will send the CategoryPage event to Yespo with data about the corresponding category from your feed.

Step 5: Data Synchronization (Optional)

Activating this option allows you to:

• Transfer historical contact data to Yespo;
• Send data on new and historical orders.

Step 6: Configure Yespo Settings

After the script is installed, head over to your Yespo dashboard.

• Customize Web Push settings, recommendations, and other marketing features to align with your store's strategy.

📘

Note

• You can always pause sending contact data to Yespo.
• If the application has been deactivated and reactivated, contacts deleted during its inactivity will not be transferred to Yespo.