Mixpanel Integration

Vendo’s Mixpanel integration provides comprehensive e-commerce analytics by tracking customer behavior across your entire Shopify store. This integration combines both client-side (browser) and server-side event tracking to give you a complete picture of your customer journey.

Overview

The Mixpanel integration tracks:

Client-Side Events: Real-time browser events captured via Shopify’s Web Pixel (page views, product interactions, cart activity, checkout flow)
Server-Side Events: Backend events synced from Shopify via BigQuery (orders, fulfillments, deliveries, refunds, abandoned checkouts)
User Profiles: Customer properties synced to Mixpanel’s User Profiles for segmentation and analysis

Key Benefits

Complete e-commerce funnel visualization
User journey analysis from first visit to purchase
Attribution tracking with UTM parameters
Fulfillment and delivery speed analytics
Abandoned cart recovery insights

Setup Instructions

Prerequisites

A Mixpanel account with a project created
Admin access to your Shopify store
The Vendo app installed on your Shopify store

Step 1: Get Your Mixpanel Credentials

Log in to your Mixpanel account
Go to Settings > Project Settings
Note down the following:
- Project ID: Found in the URL or project settings
- Token: Under “Access Keys” section
- API Secret: Under “Access Keys” section (may need to create a service account)

Step 2: Create a Service Account (Recommended)

In Mixpanel, go to Settings > Organization Settings > Service Accounts
Click Create Service Account
Name it “Vendo Integration”
Select appropriate permissions (Project Owner recommended for full functionality)
Copy the Username and Secret

Step 3: Configure in Vendo

Open the Vendo app in your Shopify admin
Navigate to Integrations > Mixpanel
Enter your credentials:
- Project ID
- Service Account Username
- Token
- API Secret
- Region: Select US, EU, or IN based on your Mixpanel project’s data residency

Step 4: Select Events to Track

Choose which events to enable:

Client-side events (browser tracking)
Server-side events (backend sync)
Session replay and heatmaps (optional)

Step 5: Historical Data Backfill

Vendo will automatically backfill your historical Shopify data to Mixpanel. This includes:

Past orders
Customer profiles
Abandoned checkouts (last 30 days)

Session Replay & Heatmaps

Mixpanel’s Session Replay and Heatmaps features help you understand exactly how customers interact with your store.

Enabling Session Replay

Session Replay records customer sessions so you can watch exactly what they did on your store — where they clicked, scrolled, and hesitated.

In the Vendo app, go to Integrations > Mixpanel
Scroll to the Session Replay section
Toggle Enable Session Replay on
Set the Record Sessions Percent (1-100%)
- Start with 10-20% to balance insights with Mixpanel costs
- Increase if you need more session data
Click Save

Tips:

Session recordings appear in Mixpanel under Users > Session Replay
Recordings are linked to user profiles and events, so you can watch specific user journeys
PII (passwords, credit cards) is automatically masked

Enabling Heatmaps

Heatmaps visualize where customers click, scroll, and spend time on your pages.

In the Vendo app, go to Integrations > Mixpanel
Toggle Enable Heatmaps on
Click Save

Tips:

View heatmaps in Mixpanel under Analysis > Heatmaps
Heatmaps work on all pages where the Vendo theme block is enabled
Use heatmaps to identify confusing UI elements or missed CTAs

Autotrack

Autotrack automatically captures user interactions without requiring custom event code.

What Autotrack Captures

Interaction	Description
Button clicks	Clicks on `<button>` and `<a>` elements
Form submissions	Form submit events
Input changes	Changes to form fields
Page views	Automatic page view tracking

Enabling Autotrack

In the Vendo app, go to Integrations > Mixpanel
Scroll to the Autotrack section
Configure which interactions to capture:
- Page Views: Track all page loads
- Button Clicks: Track button and link clicks
- Form Submissions: Track form submits
- Input Changes: Track form field changes
Click Save

Tips:

Autotrack events appear with names like Button Click and Form Submit
Event properties include the element’s text, class, and ID
Use Autotrack to discover important interactions, then create custom events for key actions

Events Tracked

Client-Side Events

These events are captured in real-time as customers browse your store.

Event Name	Description	When Triggered
Page Viewed	Customer visits any page	Every page load
Product Viewed	Customer views a product detail page	Product page load
Collection Viewed	Customer views a collection/category page	Collection page load
Search Submitted	Customer performs a search	Search form submission
Product Added To Cart	Customer adds item to cart	Add to cart action
Product Removed From Cart	Customer removes item from cart	Remove from cart action
Cart Viewed	Customer views their cart	Cart page load
Checkout Started	Customer begins checkout	Checkout initiation
Checkout Contact Info Submitted	Customer enters email/phone	Contact step completion
Checkout Address Info Submitted	Customer enters shipping address	Address step completion
Checkout Shipping Info Submitted	Customer selects shipping method	Shipping step completion
Payment Info Submitted	Customer enters payment details	Payment step completion
Checkout Completed	Customer completes purchase	Order confirmation page

Custom Events

Vendo also supports tracking custom events sent from your theme or app. Any event sent via the Shopify Web Pixel analytics.publish() method will be forwarded to Mixpanel:

Event Type	Description
all_custom_events	Custom events with arbitrary names and properties

Custom event payload example:


{
  "event": "Your Custom Event Name",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "custom_property_1": "value1",
    "custom_property_2": 123,
    "$user_id": "6359703453860"
  }
}

Server-Side Events

These events are synced from your Shopify backend for accurate, server-verified data.

Event Name	Description	When Triggered
Order Received	New order is placed	Order creation in Shopify
Products Purchased	Individual line item tracking	Per product in an order
Cart Abandoned	Checkout not completed	1+ hours after cart abandonment
Order Fulfilled	Order is shipped	Fulfillment creation
Order Delivered	Order reaches customer	Delivery status update
Order Refunded	Full order refund	Complete refund processed
Order Partially Refunded	Partial refund	Partial refund processed

User Properties

User profiles are automatically created and updated with the following properties:

Property	Type	Description	Example
`$email`	String	Customer’s email address	”customer@email.com”
`$first_name`	String	First name	”John”
`$last_name`	String	Last name	”Smith”
`$phone`	String	Phone number	”+1234567890”
`$created`	DateTime	Account creation date	”2024-01-15T10:30:00Z”
`shopify_customer_id`	String	Shopify’s customer ID	”6359703453860”
`total_spent`	Number	Lifetime spend amount	1523.50
`order_count`	Number	Total orders placed	12
`verified_email`	Boolean	Email verification status	true
`customer_tags`	Array	Shopify customer tags	[“VIP”, “repeat-buyer”]
`first_order_date`	DateTime	Date of first purchase	”2023-06-15T14:20:00Z”
`last_order_date`	DateTime	Date of most recent purchase	”2024-01-10T09:15:00Z”
`email_marketing_consent_state`	String	Marketing consent status	”subscribed”
`email_marketing_consent_opt_in_level`	String	Opt-in level	”single_opt_in”
`marketing_state`	String	Marketing state	”enabled”
`tax_exempt`	Boolean	Tax exemption status	false
`shopify_customer_notes`	String	Admin notes about customer	”VIP customer”

UTM Properties (Client-Side)

When customers arrive via marketing campaigns, UTM parameters are captured:

Property	Description	Example
`utm_source`	Traffic source	”google”
`utm_medium`	Marketing medium	”cpc”
`utm_campaign`	Campaign name	”summer-sale-2024”
`utm_content`	Ad content identifier	”banner-a”
`utm_term`	Paid search keyword	”running shoes”
`initial_utm_source`	First-ever UTM source	”facebook”
`initial_utm_medium`	First-ever UTM medium	”social”
`initial_utm_campaign`	First-ever campaign	”brand-awareness”

User Identification

How Users Are Identified

Vendo uses a consistent user identification strategy across all touchpoints:

Anonymous Users: Assigned a Shopify-generated device ID until identified
Identified Users: Linked to their Shopify Customer ID once they:
- Log in to their account
- Complete a checkout
- Subscribe to marketing

Distinct ID Mapping

The distinct_id in Mixpanel is set based on your configuration:

Mapping Option	Value Used	Best For
`shopify_customer_id`	Shopify’s numeric customer ID	Stores with customer accounts
`email`	Customer’s email address	Email-centric marketing
`shopify_customer_id` (default)	Falls back to device ID for anonymous	General use

Identity Resolution

When a user transitions from anonymous to identified:

Vendo creates an alias linking the anonymous ID to the customer ID
All historical events are associated with the customer profile
Future events use the consistent customer ID

Example Payloads

Order Received Event


{
  "event": "Order Received",
  "properties": {
    "$source": "Vendo - Shopify App",
    "distinct_id": "6359703453860",
    "$insert_id": "5363269534010",
    "time": 1705312800000,
    "shopify_order_id": "5363269534010",
    "order_id": "1001",
    "email": "customer@email.com",
    "currency": "USD",
    "cart_subtotal_amount": 149.99,
    "cart_total_amount": 162.49,
    "total_discounts": 15.00,
    "tax_amount": 12.50,
    "shipping_amount": 10.00,
    "billing_address": {
      "first_name": "John",
      "last_name": "Smith",
      "address1": "123 Main St",
      "city": "New York",
      "province": "NY",
      "country": "US",
      "zip": "10001",
      "country_code": "US",
      "province_code": "NY"
    },
    "shipping_address": {
      "first_name": "John",
      "last_name": "Smith",
      "address1": "123 Main St",
      "city": "New York",
      "province": "NY",
      "country": "US",
      "zip": "10001"
    },
    "payment_gateway": ["shopify_payments"],
    "financial_status": "paid",
    "confirmed": true,
    "order_tags": ["online", "first-order"],
    "products": [
      {
        "product_id": 7894561230,
        "title": "Classic T-Shirt",
        "sku": "TSHIRT-BLK-M",
        "price": 29.99,
        "quantity": 2,
        "variant_title": "Black / Medium"
      },
      {
        "product_id": 7894561231,
        "title": "Running Shorts",
        "sku": "SHORTS-BLU-L",
        "price": 45.00,
        "quantity": 1,
        "variant_title": "Blue / Large"
      }
    ],
    "discount": [{"code": "SUMMER20"}],
    "source_name": "web",
    "app_name": "Online Store",
    "landing_page": "/products/classic-tshirt?utm_source=google&utm_medium=cpc",
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "summer-sale",
    "note": "Please gift wrap",
    "vendo_tracking_version": "2.1.0"
  }
}

Page Viewed Event (Client-Side)


{
  "event": "Page Viewed",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "49b71cd2-295b-476a-a345-0eb50bd13b57",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$device": "Desktop",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/collections/summer",
    "page_title": "Summer Collection – My Store",
    "path_name": "/collections/summer",
    "$screen_height": 900,
    "$screen_width": 1440,
    "language": "en-US",
    "event_type": "page_viewed",
    "$referrer": "https://google.com",
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "summer-sale"
  }
}

Product Viewed Event (Client-Side)


{
  "event": "Product Viewed",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "49b71cd2-295b-476a-a345-0eb50bd13b57",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$device": "Desktop",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/products/classic-tshirt",
    "page_title": "Classic T-Shirt – My Store",
    "path_name": "/products/classic-tshirt",
    "$screen_height": 900,
    "$screen_width": 1440,
    "language": "en-US",
    "event_type": "product_viewed",
    "$referrer": "https://mystore.com/collections/all",
    "products": [
      {
        "id": "gid://shopify/Product/7894561230",
        "title": "Classic T-Shirt",
        "untranslated_title": "Classic T-Shirt",
        "type": "Apparel",
        "vendor": "My Brand",
        "variant_id": "gid://shopify/ProductVariant/42345678901",
        "variant_price": "29.99",
        "variant_currency_code": "USD",
        "variant_sku": "TSHIRT-BLK-M",
        "variant_title": "Black / Medium",
        "variant_untranslated_title": "Black / Medium"
      }
    ],
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "summer-sale"
  }
}

Product Added To Cart Event (Client-Side)


{
  "event": "Product Added To Cart",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "add-cart-event-id-123",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$device": "Desktop",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/products/classic-tshirt",
    "page_title": "Classic T-Shirt – My Store",
    "path_name": "/products/classic-tshirt",
    "$screen_height": 900,
    "$screen_width": 1440,
    "language": "en-US",
    "event_type": "product_added_to_cart",
    "currency": "USD",
    "amount": "59.98",
    "quantity": 2,
    "products": [
      {
        "id": "gid://shopify/Product/7894561230",
        "title": "Classic T-Shirt",
        "untranslated_title": "Classic T-Shirt",
        "type": "Apparel",
        "vendor": "My Brand",
        "variant_id": "gid://shopify/ProductVariant/42345678901",
        "variant_price": "29.99",
        "variant_currency_code": "USD",
        "variant_sku": "TSHIRT-BLK-M",
        "variant_title": "Black / Medium",
        "variant_untranslated_title": "Black / Medium"
      }
    ],
    "utm_source": "google",
    "utm_medium": "cpc"
  }
}

Cart Viewed Event (Client-Side)


{
  "event": "Cart Viewed",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "cart-view-event-id-456",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/cart",
    "page_title": "Your Cart – My Store",
    "path_name": "/cart",
    "event_type": "cart_viewed",
    "amount": "149.97",
    "quantity": 3,
    "currency": "USD",
    "products": [
      {
        "id": "gid://shopify/Product/7894561230",
        "title": "Classic T-Shirt",
        "quantity": 2,
        "type": "Apparel",
        "vendor": "My Brand",
        "variant_id": "gid://shopify/ProductVariant/42345678901",
        "variant_price": "29.99",
        "variant_currency_code": "USD",
        "variant_sku": "TSHIRT-BLK-M",
        "variant_title": "Black / Medium"
      },
      {
        "id": "gid://shopify/Product/7894561231",
        "title": "Running Shorts",
        "quantity": 1,
        "type": "Apparel",
        "vendor": "My Brand",
        "variant_id": "gid://shopify/ProductVariant/42345678902",
        "variant_price": "45.00",
        "variant_currency_code": "USD",
        "variant_sku": "SHORTS-BLU-L",
        "variant_title": "Blue / Large"
      }
    ]
  }
}

Checkout Started Event (Client-Side)


{
  "event": "Checkout Started",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "checkout-started-id-789",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/checkouts/abc123",
    "page_title": "Checkout – My Store",
    "event_type": "checkout_started",
    "currency": "USD",
    "cart_total_amount": "162.49",
    "cart_subtotal_amount": "149.97",
    "tax_amount": "12.52",
    "shipping_amount": "0.00",
    "checkout_token": "abc123def456",
    "order_id": "gid://shopify/Order/5363269534010",
    "checkout_attributes": [
      {"key": "landing_page", "value": "/products/classic-tshirt"},
      {"key": "utm_source", "value": "google"}
    ],
    "shipping_address": {
      "city": "New York",
      "country": "US",
      "countryCode": "US",
      "province": "NY",
      "provinceCode": "NY"
    },
    "products": [
      {
        "id": "gid://shopify/Product/7894561230",
        "title": "Classic T-Shirt",
        "quantity": 2,
        "variant_id": "gid://shopify/ProductVariant/42345678901",
        "variant_price": "29.99",
        "variant_currency_code": "USD",
        "variant_sku": "TSHIRT-BLK-M",
        "variant_title": "Black / Medium"
      }
    ],
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "summer-sale"
  }
}

Checkout Contact Info Submitted Event (Client-Side)

Fired when the customer enters their contact information (email/phone):


{
  "event": "Checkout Contact Info Submitted",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "contact-info-id-111",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/checkouts/abc123",
    "page_title": "Checkout – My Store",
    "event_type": "checkout_contact_info_submitted",
    "currency": "USD",
    "cart_total_amount": "162.49",
    "cart_subtotal_amount": "149.97",
    "tax_amount": "12.52",
    "shipping_amount": "0.00",
    "checkout_token": "abc123def456",
    "order_id": "gid://shopify/Order/5363269534010",
    "email": "customer@email.com",
    "phone": "+14155551234",
    "products": [
      {
        "id": "gid://shopify/Product/7894561230",
        "title": "Classic T-Shirt",
        "quantity": 2,
        "variant_id": "gid://shopify/ProductVariant/42345678901",
        "variant_price": "29.99"
      }
    ]
  }
}

Checkout Address Info Submitted Event (Client-Side)

Fired when the customer enters their shipping address:


{
  "event": "Checkout Address Info Submitted",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "address-info-id-222",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/checkouts/abc123",
    "page_title": "Checkout – My Store",
    "event_type": "checkout_address_info_submitted",
    "currency": "USD",
    "cart_total_amount": "162.49",
    "cart_subtotal_amount": "149.97",
    "tax_amount": "12.52",
    "shipping_amount": "0.00",
    "checkout_token": "abc123def456",
    "order_id": "gid://shopify/Order/5363269534010",
    "email": "customer@email.com",
    "phone": "+14155551234",
    "shipping_address": {
      "firstName": "John",
      "lastName": "Smith",
      "address1": "123 Main St",
      "city": "New York",
      "country": "US",
      "countryCode": "US",
      "province": "NY",
      "provinceCode": "NY",
      "zip": "10001"
    },
    "products": [...]
  }
}

Checkout Shipping Info Submitted Event (Client-Side)

Fired when the customer selects a shipping method:


{
  "event": "Checkout Shipping Info Submitted",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "shipping-info-id-333",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/checkouts/abc123",
    "page_title": "Checkout – My Store",
    "event_type": "checkout_shipping_info_submitted",
    "currency": "USD",
    "cart_total_amount": "172.49",
    "cart_subtotal_amount": "149.97",
    "tax_amount": "12.52",
    "shipping_amount": "10.00",
    "checkout_token": "abc123def456",
    "order_id": "gid://shopify/Order/5363269534010",
    "email": "customer@email.com",
    "phone": "+14155551234",
    "shipping_address": {...},
    "products": [...]
  }
}

Payment Info Submitted Event (Client-Side)

Fired when the customer enters their payment information:


{
  "event": "Payment Info Submitted",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "payment-info-id-444",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/checkouts/abc123",
    "page_title": "Checkout – My Store",
    "event_type": "payment_info_submitted",
    "currency": "USD",
    "cart_total_amount": "172.49",
    "cart_subtotal_amount": "149.97",
    "tax_amount": "12.52",
    "shipping_amount": "10.00",
    "checkout_token": "abc123def456",
    "order_id": "gid://shopify/Order/5363269534010",
    "email": "customer@email.com",
    "phone": "+14155551234",
    "shipping_address": {...},
    "checkout_attributes": {...},
    "products": [...]
  }
}

Product Removed From Cart Event (Client-Side)


{
  "event": "Product Removed From Cart",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "remove-cart-event-id-555",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/cart",
    "page_title": "Your Cart – My Store",
    "event_type": "product_removed_from_cart",
    "currency": "USD",
    "amount": "29.99",
    "quantity": 1,
    "products": [
      {
        "id": "gid://shopify/Product/7894561230",
        "title": "Classic T-Shirt",
        "untranslated_title": "Classic T-Shirt",
        "type": "Apparel",
        "vendor": "My Brand",
        "variant_id": "gid://shopify/ProductVariant/42345678901",
        "variant_price": "29.99",
        "variant_currency_code": "USD",
        "variant_sku": "TSHIRT-BLK-M",
        "variant_title": "Black / Medium"
      }
    ]
  }
}

Checkout Completed Event (Client-Side)


{
  "event": "Checkout Completed",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "checkout-completed-id-999",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/checkouts/abc123/thank_you",
    "page_title": "Thank you – My Store",
    "event_type": "checkout_completed",
    "$user_id": "6359703453860",
    "currency": "USD",
    "cart_total_amount": "162.49",
    "cart_subtotal_amount": "149.97",
    "tax_amount": "12.52",
    "shipping_amount": "10.00",
    "checkout_token": "abc123def456",
    "order_id": "gid://shopify/Order/5363269534010",
    "email": "customer@email.com",
    "phone": "+14155551234",
    "checkout_attributes": [
      {"key": "landing_page", "value": "/products/classic-tshirt"},
      {"key": "utm_source", "value": "google"}
    ],
    "shipping_address": {
      "firstName": "John",
      "lastName": "Smith",
      "address1": "123 Main St",
      "city": "New York",
      "country": "US",
      "countryCode": "US",
      "province": "NY",
      "provinceCode": "NY",
      "zip": "10001"
    },
    "products": [
      {
        "id": "gid://shopify/Product/7894561230",
        "title": "Classic T-Shirt",
        "quantity": 2,
        "variant_id": "gid://shopify/ProductVariant/42345678901",
        "variant_price": "29.99",
        "variant_currency_code": "USD",
        "variant_sku": "TSHIRT-BLK-M",
        "variant_title": "Black / Medium"
      }
    ],
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "summer-sale",
    "gclid": "CjwKCAjw..."
  }
}

Collection Viewed Event (Client-Side)


{
  "event": "Collection Viewed",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "collection-viewed-id-111",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/collections/summer",
    "page_title": "Summer Collection – My Store",
    "path_name": "/collections/summer",
    "event_type": "collection_viewed",
    "collection_id": "gid://shopify/Collection/123456789",
    "collection_title": "Summer Collection",
    "products": [
      {
        "result_rank": 1,
        "id": "gid://shopify/Product/7894561230",
        "title": "Classic T-Shirt",
        "type": "Apparel",
        "vendor": "My Brand",
        "variant_id": "gid://shopify/ProductVariant/42345678901",
        "variant_price": "29.99",
        "variant_currency_code": "USD",
        "variant_sku": "TSHIRT-BLK-M",
        "variant_title": "Black / Medium"
      },
      {
        "result_rank": 2,
        "id": "gid://shopify/Product/7894561231",
        "title": "Running Shorts",
        "type": "Apparel",
        "vendor": "My Brand",
        "variant_id": "gid://shopify/ProductVariant/42345678902",
        "variant_price": "45.00",
        "variant_currency_code": "USD",
        "variant_sku": "SHORTS-BLU-L",
        "variant_title": "Blue / Large"
      }
    ]
  }
}

Search Submitted Event (Client-Side)


{
  "event": "Search Submitted",
  "properties": {
    "$source": "Vendo - Shopify App",
    "vendo_tracking_version": "1.1.4",
    "distinct_id": "shop_client_abc123",
    "$insert_id": "search-submitted-id-222",
    "$device_id": "shop_client_abc123",
    "$browser": "Chrome",
    "$os": "Mac OS X",
    "$current_url": "https://mystore.com/search?q=t-shirt",
    "page_title": "Search Results – My Store",
    "path_name": "/search",
    "event_type": "search_submitted",
    "search_query": "t-shirt",
    "products": [
      {
        "result_rank": 1,
        "id": "gid://shopify/Product/7894561230",
        "title": "Classic T-Shirt",
        "type": "Apparel",
        "vendor": "My Brand",
        "variant_id": "gid://shopify/ProductVariant/42345678901",
        "variant_price": "29.99",
        "variant_currency_code": "USD",
        "variant_sku": "TSHIRT-BLK-M",
        "variant_title": "Black / Medium"
      }
    ]
  }
}

Cart Abandoned Event


{
  "event": "Cart Abandoned",
  "properties": {
    "$source": "Vendo - Shopify App",
    "distinct_id": "6359703453860",
    "$insert_id": "29563359395886",
    "time": 1705312800000,
    "checkout_id": "29563359395886",
    "email": "customer@email.com",
    "currency": "USD",
    "cart_subtotal_amount": 89.99,
    "cart_total_amount": 97.49,
    "total_discounts": 0,
    "tax_amount": 7.50,
    "billing_address": {
      "city": "New York",
      "country": "US"
    },
    "shipping_address": {
      "city": "New York",
      "country": "US"
    },
    "abandoned_checkout_url": "https://mystore.com/checkouts/abc123/recover",
    "products": [
      {
        "product_id": 7894561230,
        "title": "Classic T-Shirt",
        "sku": "TSHIRT-BLK-M",
        "price": 29.99,
        "quantity": 3
      }
    ],
    "custom_order_attributes": [
      {"key": "utm_source", "value": "facebook"},
      {"key": "utm_campaign", "value": "retargeting"}
    ],
    "vendo_tracking_version": "2.1.0"
  }
}

User Profile Update


{
  "$source": "Vendo - Shopify App",
  "$distinct_id": "6359703453860",
  "$ignore_time": true,
  "$ip": "203.0.113.50",
  "$set": {
    "$created": "2023-06-15T10:30:00Z",
    "shopify_customer_id": "6359703453860",
    "$email": "customer@email.com",
    "$first_name": "John",
    "$last_name": "Smith",
    "$phone": "+14155551234",
    "total_spent": 1523.50,
    "order_count": 12,
    "verified_email": true,
    "customer_tags": ["VIP", "repeat-buyer", "newsletter"],
    "first_order_date": "2023-06-20T14:20:00Z",
    "last_order_date": "2024-01-10T09:15:00Z",
    "email_marketing_consent_state": "subscribed",
    "email_marketing_consent_opt_in_level": "single_opt_in",
    "marketing_state": "enabled",
    "tax_exempt": false,
    "shopify_customer_notes": "VIP customer - priority support"
  }
}

Order Fulfilled Event


{
  "event": "Order Fulfilled",
  "properties": {
    "$source": "Vendo - Shopify App",
    "distinct_id": "6359703453860",
    "$insert_id": "4751610282298",
    "time": 1705399200000,
    "fulfillment_id": "4751610282298",
    "shopify_order_id": "5363269534010",
    "order_id": "1001",
    "email": "customer@email.com",
    "fulfillment_name": "GP2534115-F1",
    "fulfillment_service": "manual",
    "fulfillment_status": "success",
    "tracking_number": "1Z999AA10123456784",
    "fulfillment_speed": 2,
    "fulfillment_speed_weekdays": 2,
    "products": [
      {
        "product_id": 7894561230,
        "title": "Classic T-Shirt",
        "quantity": 2
      }
    ],
    "vendo_tracking_version": "2.1.0"
  }
}

What to Expect in Mixpanel

After Setup

Real-time Client Events: Within minutes, you’ll see page views, product views, and cart interactions
Historical Backfill: Server-side events from the past will appear within 1-24 hours
User Profiles: Customer profiles will be created with all historical data

Recommended Reports

Once data is flowing, create these reports in Mixpanel:

E-commerce Funnel
- Page Viewed → Product Viewed → Product Added to Cart → Checkout Started → Checkout Completed
Revenue Analysis
- Order Received events with cart_total_amount breakdown
Cart Abandonment
- Checkout Started but NOT Checkout Completed within 24 hours
Fulfillment Performance
- Average fulfillment_speed across orders
Customer Cohorts
- Segment by order_count, total_spent, or customer_tags

Lexicon (Data Dictionary)

Vendo automatically updates your Mixpanel Lexicon with:

Event descriptions
Property descriptions
Display names
Data types

This makes it easy for your team to understand the data without documentation.

Troubleshooting

Events Not Appearing

Check browser console for any JavaScript errors
Verify credentials are correctly entered in Vendo
Check event filters in Mixpanel (ensure you’re viewing the correct date range)

User Profiles Missing Data

Allow time for sync - profiles update every few hours
Check customer has orders - profiles are created when customers have activity

UTM Parameters Not Tracking

Ensure UTM parameters are in the landing page URL
Check checkout attributes are enabled in your Shopify theme

Support

For assistance with your Mixpanel integration:

Email: support@vendodata.com
Documentation: https://docs.vendodata.com
Mixpanel Help: https://help.mixpanel.com