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 the client-side events enabled in the Shopify integration, including supported standard and custom events
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)

Vendo provisions the Web Pixel as part of the Shopify destination workflow. Confirm that the pixel is connected and enabled rather than assuming a saved destination guarantees storefront delivery.

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 Behavior

The initial historical window is selected during setup. After that import, scheduled incremental jobs process new or updated server-side records with the integration’s configured lookback. Use the destination status and job history for the actual cadence; do not rely on a fixed interval in this guide.

Historical Backfill

When you first connect the server-side integration, Vendo can import the historical window selected during setup, up to the maximum shown in the app. This backfill applies to:

• Orders, fulfillments, refunds, and deliveries
• Customer profiles with lifetime metrics
• Supported abandoned-checkout records available from Shopify for the selected workflow

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.