Integration Features

Vendo combines three tracking methods to capture a complete picture of your customers’ journey — from first page view to order delivery.

Client-Side Tracking (Web Pixel)

Vendo monitors user-generated events on your storefront in real-time using Shopify’s Web Pixel API. The Vendo Web Pixel is a Shopify Custom Pixel that:

1. Captures all standard Shopify storefront events (14 event types) plus custom events from any app
2. Enriches each event with device info, UTM parameters, click IDs, and user identity
3. Routes events to your enabled destinations (Mixpanel, Segment, BigQuery, OneSignal, Customer.io, GTM)

The Web Pixel is installed automatically when you connect your first destination. No manual code changes are required.

Automatic Enrichment

Every client-side event is automatically enriched with:

• Device info — Browser, OS, screen size, language
• Page context — URL, title, referrer
• UTM parameters — Source, medium, campaign, content, term
• Click IDs — gclid, fbclid, msclkid, ttclid, and others
• Identity — Device ID, Customer ID (when known)

For the complete list of client-side events and their properties, see Events & Data Model.

For custom event tracking, see Sending Custom Events.

Theme Extension

The Vendo theme extension is a single app embed block that loads destination SDKs on your storefront. It enables features that require JavaScript on the page:

Enabling the Theme Extension

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

The theme extension reads its configuration from a shop metafield (vendo.config) that Vendo manages automatically whenever you save destination settings.

Server-Side Integration

Vendo’s server-side integration imports order lifecycle data from Shopify’s backend APIs and exports it to your connected destinations. This covers events that cannot be captured in the browser — fulfillment, delivery, refunds, and historical orders.

How It Works

Shopify GraphQL API
  → Vendo Pipeline (import + normalize)
  → BigQuery (staging dataset)
  → Destination plugins (Mixpanel, Segment, OneSignal, Customer.io, BigQuery)

1. Shopify GraphQL API — Vendo reads orders, customers, fulfillments, and refunds from Shopify’s Admin API
2. BigQuery staging — Data is normalized and stored in a per-shop BigQuery dataset managed by Vendo
3. Destination export — Transformed events and customer profiles are sent to each enabled destination

For the complete list of server-side events and their properties, see Events & Data Model.

Sync Frequency

Historical Backfill

When you first connect the server-side integration, Vendo can import up to 2 years of historical order data. This backfill applies to:

• Orders, fulfillments, refunds, and deliveries
• Customer profiles with lifetime metrics
• Abandoned checkouts (last 30 days)

Note: Client-side events (browsing, cart, checkout) are captured in real-time and cannot be backfilled.

See Historical Backfill for configuration options and timing estimates.

Destination Export

Pausing & Resuming

You can pause and resume the server-side connection per destination:

• Pause — Stops creating new export jobs. Data continues to be imported to BigQuery.
• Resume — Triggers a catch-up export, then resumes incremental exports.

Identity Resolution

Vendo links anonymous browsing sessions to known customers using:

You can change the identity key in the app’s User ID settings (e.g., use email instead of Shopify Customer ID).

For headless Shopify stores, see Headless Shopify Tracking for identity bridging between your custom frontend and Shopify checkout.