Skip to Content
SourcesShopifySetup Guide

Setup Guide

Get Vendo tracking your Shopify store in under 10 minutes.

Prerequisites

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

Installation

Step 1: Install the Vendo App

  1. Visit the Vendo app on the Shopify App Store 
  2. Click Add app
  3. Review permissions and click Install

Step 2: Complete Onboarding

  1. Follow the onboarding wizard to create your Vendo account
  2. Select a plan (all plans include a 21-day free trial)
  3. Choose whether to enable historical backfill

Step 3: Connect Your First Destination

  1. Go to Integrations in the Vendo app
  2. Select a destination (e.g., Mixpanel, BigQuery)
  3. Enter your credentials
  4. Choose which events to track
  5. Save the configuration

Vendo will automatically create the Web Pixel and start tracking client-side events.

Step 4: Enable the Theme Extension

  1. Go to Online Store > Themes in Shopify admin
  2. Click Customize on your active theme
  3. Click App embeds in the left sidebar
  4. Toggle Vendo on
  5. Save your theme

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

Verify Your Setup

After completing setup, verify everything is working:

1. Check Status Cards

In the Vendo app, confirm:

  • Customer Events Pixel shows as connected
  • Theme Extension shows as enabled
  • Each destination shows 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 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

Events should appear within seconds for client-side tracking.

4. Verify Server-Side Sync (Optional)

Server-side events (orders, fulfillments) sync every 10–15 minutes. To test:

  1. Place a test order on your store
  2. Wait 15 minutes
  3. Check your destination for “Order Received” event

Troubleshooting

Web Pixel Not Tracking

  • Ensure at least one destination is connected and enabled
  • Check that client-side events are enabled in the destination’s Events tab
  • Clear your browser cache and try again

Theme Extension Not Loading

  • Verify the Vendo app embed is enabled in your theme
  • Check that you saved your theme after enabling
  • Try a different browser to rule out extensions blocking scripts

Events Missing in Destination

  • Confirm credentials are correct in Vendo
  • Check that the specific event type is enabled
  • For server-side events, allow 15 minutes for the sync cycle

Historical Data Not Appearing

  • Backfill can take several hours for large stores
  • Check the Server-Side Connection page in Vendo for progress
  • See Historical Backfill for timing estimates

Next Steps

Last updated on
OverviewData Model