Integration with Shopify

Read this article in Ukrainian ⮕

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 — domain registration, 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

• This app's name is Yespo, but it perfectly works with eSputnik CDP.
• 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

Supported Languages

The app is available in English, Polish, Portuguese, Spanish, Italian, German, and French. Its interface follows the Shopify Admin language and falls back to English when the selected language is not supported.

How to Set Up the Yespo Shopify App

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

❗️

Note

We support integration only for one active Market

Step 1: Connect Your eSputnik Account

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

• Go to your eSputnik 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 eSputnik API key and click Connect.

Step 2: Web Tracking and Site Scripts Integration

Once your eSputnik 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 to [email protected] 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 eSputnik, click Enable.

The app allows sending the following events to eSputnik:

📘

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 eSputnik 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 eSputnik;
• Send data on new and historical orders.

📘

Note

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

Step 6: Configure eSputnik Settings

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

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

Auto-Applying Promo Codes from a Widget at Checkout

If your store is connected via the Yespo app, the General tab of the promo code component will display an Apply promo code automatically toggle. It is enabled by default.

When the toggle is on, a visitor who receives a promo code in the widget will see it already applied at checkout — no manual entry required.

If the toggle is off, the promo code is shown in the widget but will not be automatically applied at checkout.