Setup Guide

Use this checklist to install Vendo, connect one destination, and verify both 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 (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 the workspace or agreement presented for your store
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 provisions the Web Pixel as part of setup. Confirm its connection status before testing 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

Delivery time depends on the destination. Use its live or diagnostic view where available, then confirm the final stored event.

4. Verify Server-Side Sync (Optional)

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

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

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, inspect the job status and configured schedule

Historical Data Not Appearing

• Check the Server-Side Connection page in Vendo for progress
• See Historical Backfill for reconciliation guidance

Related

• Configure Mixpanel — Enable session replay and heatmaps
• Set up BigQuery — Stream raw data to your warehouse
• Send Custom Events — Track custom interactions
• Explore the Data Model — Understand all tracked events and properties