Skip to Content
SourcesShopifySetup Guide

Setup Guide

Install and configure Vendo for your Shopify store.

Last reviewed September 15, 2026

Use this checklist to install Vendo and connect one destination. Then verify the Shopify pixel and the real downstream result.

Prerequisites

  • A Shopify store (any plan)
  • Admin access to your Shopify store
  • Credentials for at least one destination (for example, Mixpanel, BigQuery or Segment)

Installation

Step 1: Install the Vendo App

  1. Go to the Vendo app on the Shopify App Store .
  2. Click Add app.
  3. Review the permissions.
  4. Click Install.

Step 2: Complete Onboarding

  1. Click Get Started.
  2. On Choose Your Plan, if you have a promo code, enter it under Have a promo code?.
  3. Click Apply.
  4. Select a plan.
  5. On Set up notifications, add recipients or click Continue.

All plans include a 21-day free trial. You are not charged until your trial ends.

Step 3: Connect Your First Destination

  1. Go to Destinations in the Vendo app.
  2. Select a destination (for example, Mixpanel or BigQuery).
  3. Enter your credentials.
  4. Choose which events to track.
  5. If you enabled server-side events, choose whether to enable historical backfill.
  6. Click Complete Setup.

Vendo provisions the Web Pixel as part of setup. Confirm its connection status before you test events.

Step 4: Enable the Theme Extension

  1. In Shopify admin, go to Online Store > Themes.
  2. On your active theme, click Customize.
  3. In the left sidebar, click App embeds.
  4. Turn Vendo on.
  5. Save your theme.

The theme extension enables features such as session replay (Mixpanel), push prompts (OneSignal) and the GTM data layer.

Verify Your Setup

After you complete setup, verify that everything works.

1. Check Status Cards

On the Shopify status page of the Vendo app, confirm that:

  • Customer events web pixel shows Active
  • Theme extension shows Enabled

To repair a status:

  1. If Customer events web pixel shows Not connected, click Connect.
  2. If Theme extension shows Out of sync, click the Out of sync badge.
  3. Click Re-sync now.

Out of sync means that the copy of your settings on your storefront is out of date. Your storefront runs older settings than the settings saved in Vendo. Orders and other server-side data are not affected.

On the Destinations page, confirm that each destination shows the Active status.

2. Trigger a Test Event

  1. Open your storefront in a new browser tab.
  2. View a product page.
  3. Add a product to the cart.

3. Confirm Events in Your Destination

  • Mixpanel: Go to Events > Live View
  • BigQuery: Query your dataset for recent events
  • Segment: Check the Debugger
  • OneSignal: Check the Activity Feed
  • Customer.io: Check Activity Logs

Delivery time depends on the destination. If the destination has a live or diagnostic view, use it. Then confirm the final stored event.

4. Verify Server-Side Sync (Optional)

Server-side events run through scheduled pipeline jobs. To test them:

  1. Place a test order on your store.
  2. Wait for the related job to complete in Vendo.
  3. Check the destination for the expected order event and a stable order identifier.

Manage Destinations

Destinations Page

The Destinations page lists each destination that you added. The Last run column shows when the destination last ran. The Next run column shows the next scheduled run. If Vendo has no next run time, it shows Not reported.

Each row has a menu with these actions:

  • Edit: opens the destination.
  • Pause or Resume: stops or starts event delivery to the destination. Vendo asks you to confirm.
  • Delete: removes the destination. It shows only for destinations that you can delete.

Warning: Deleting a destination stops Shopify delivery and removes its configuration. Connections that you use in other parts of your Vendo workspace stay.

Turn Delivery On or Off

  1. Open the destination.
  2. On the Overview tab, set the Enable name delivery toggle (for example, Enable Mixpanel delivery).
  3. In the Shopify save bar, click Save.

Resync Historical Data

Sync now opens the Resync Historical Data window. Sync now is not available for Google Tag Manager.

  1. On the Overview tab of the destination, click Sync now.
  2. Select the date range. The default range is the last 7 days.
  3. If recent or missing Shopify records may not be in Vendo yet, select Refresh source data from Shopify first.
  4. Caution: The resync sends events for the period again. The destination can receive duplicate events.
  5. Click Fetch & Resync or Start Resync.

The button is Fetch & Resync when Vendo must first import data from Shopify. This occurs when you select Refresh source data from Shopify first, or a start date before your earliest data in Vendo.

Troubleshooting

Web Pixel Not Tracking

  • Make sure that at least one destination is connected and enabled
  • Make sure that client-side events are enabled on the Events tab of the destination
  • Clear your browser cache and try again

Theme Extension Not Loading

  • Make sure that the Vendo app embed is enabled in your theme
  • Make sure that you saved your theme after you enabled the app embed
  • Try a different browser to rule out extensions that block scripts

Events Missing in Destination

  • Confirm that the credentials in Vendo are correct
  • Make sure that the specific event type is enabled
  • For server-side events, inspect the job status and the configured schedule

Historical Data Not Appearing

  • Open Shop data sync in Vendo to check the progress
  • See Historical Backfill for reconciliation guidance
Need help?

When you contact support, give your workspace, the source or destination name, the job ID and the first error message.

support@vendodata.com
Last updated on
OverviewData Model