Littledata’s Shopify to Segment connection uses a combination of client-side (browser) and server-side tracking to ensure 100% accurate data about your Shopify store in Segment. Littledata automatically integrates with Shopify and Shopify Plus sites to capture every customer touchpoint, including sales, marketing, customer and product performance data.
Client-side (device mode) tracking
During the installation process, Littledata applies a tracking script to all pages (theme.liquid) under your Shopify store, except for the checkout steps:
- Segment’s analytics.js library is loaded on all pages
- Creates a
littledataLayerdata layer for all pages - Minified tracking code, hosted on a content delivery network (CDN)
- Enables sending of client-side events to all Segment destinations which are enabled in ‘device mode’
- Segment’s anonymous ID is passed to our servers to ensure consistent user journey tracking
Server-side (cloud mode) tracking
During the Segment connection setup flow in the app, Littledata also applies a set of webhooks to your Shopify store. This means that each time Shopify pings us back and confirms the user action we know which event has to be sent by our servers, ensuring 100% accuracy. There are many advantages to this approach:
- Smaller script in the browser = faster page load
- No extra scripts on the sensitive and secure checkout pages
- Complete event capture for checkout flow, including sales and refunds/returns
- Accurate marketing attribution (sessions stitched together)
Note: Using a headless Shopify setup? Follow the setup steps for headless Shopify tracking with Littledata.
What can you track
These are the events that Littledata sends from Shopify to Segment. These events will show up as tables in your warehouse, and as regular events in your other Segment destinations.
Client-side events
Client-side events tracked by Littledata, via Segment’s analytics.js library, and passed on to any destination enabled in device mode.
| Event Name | Description |
| Page Viewed | User has viewed a page |
| Product List Viewed | User has viewed a product collection page |
| Product Clicked | User has clicked a product |
| Product Viewed | User has viewed a product |
| Product Image Clicked | User has clicked a product image |
| Product Shared | User has shared a product |
Server-side events
Note: Littledata’s Segment connection v2 is now in private beta. Please reach out to our support team to get access to the events below marked as v2
Server-side events are tracked by Littledata servers from Shopify and passed onto any destination in cloud mode.
| Event Name | Description |
| Product Added | User has added a product to the cart |
| Product Removed | User has removed a product from the cart |
| Checkout Started | User has started checkout |
| Checkout Step Viewed | User has viewed a step in the checkout |
| Checkout Step Completed | User has completed a step in the checkout |
| Customer Created | User added as a customer |
| Customer Updated | Customer information updated |
| Payment Info Entered | User has entered payment info |
| Coupon Entered | User has entered coupon info |
| Coupon Applied | User has applied coupon info |
| Order Completed | Customer has completed an web order (excluding iOS, Android, POS and draft orders) |
| Order Refunded | Web order has been refunded |
| Order Cancelled (v2) | Admin has cancelled an order (including the cancel_reason) |
| POS Order Placed (v2) | User has placed an order via Shopify POS |
| Payment Failure (v2) | User completed checkout step 3 but the payment method failed (i.e. the card details were valid but the charge did not succeed) |
| Customer Enabled (v2) | User has confirmed their email address and created a Shopify customer account with verified_email set as true |
| Fulfilment Update (v2) | Order fulfilment status has changed (including status, tracking_numbers and tracking_urls where the shipping integration allows) |
Identify calls
For every event where there is an identifiable Shopify customer (from both the client and the server) we also send an Identify call to trigger updates in CRM systems connected to Segment. This happens when the customer logs into the storefront, on the last step of the checkout, with the order, and also after purchase with any customer update in Shopify admin.
The following traits are included with an Identify call:
| Property Name | Description | Property Type |
| userId | Shopify Customer ID | Double |
| firstName | Customer’s first name | String |
| lastName | Customer’s email | String |
| phone | Customer’s phone number | String |
| createdAt | Date customer record was created | Date |
| description | Customer notes | String |
| address | Customer’s primary address | String |
| customerLifetimeValue | Total spend of customer on the Shopify store | Double |
| purchaseCount | Number of orders by this customer | Integer |
| marketingOptIn | marketing_opt_in field from Shopify customer | String |
| tags | Custom tags applied to the customer | String |
| state | Whether the customer account is enabled or disabled | String |
| verified_email (v2) | Whether the customer has verified their email | Boolean |
Alias calls
To support seamless customer tracking the Mixpanel , Vero and KISSMetrics destinations, Littledata ensures the pre-checkout anonymousId is added as an alias of the userId (used from checkout step 2 onwards).
Subscription ecommerce events
Additional events available via Littledata’s ReCharge connection, and available in cloud mode destinations.
| Event Name | Description |
| Subscription Created | Customer has created a subscription |
| Subscription Updated | Customer has updated a subscription |
| Subscription Cancelled | Customer has cancelled a subscription |
| Order Processed | Recurring order has been processed |
| Charge Failed | Failed to charge customer |
| Charge Max Tries Reached | Maximum tries to charge customer has been reached |
| Payment Method Updated | Customer has updated the payment method |
| Customer Update | Customer information updated |
Event properties
These are the properties included in the events listed above.
| Trait Name | Description | Property Type |
| userId | Shopify Customer ID | Double |
| order_id | ID of the order | String |
| checkoutId | ID of the checkout session | String |
| shipping | Shipping cost | Float |
| tax | Order tax | Float |
| total | Total value of the order | Float |
| affiliation | Affiliation of the order | String |
| coupon | Discount coupon | String |
| currency | Currency of the order | String |
| discount | Discounted amount | Float |
| products | List of all the product details | Array |
| category | Category of the product | String |
| brand | Brand of the product | String |
| list_id | ID of the product collection | String |
| list_name | Name of the product collection | String |
| list_position | Product position in the collection | Integer |
| name | Product name | String |
| price | Product price | Float |
| product_id | Shopify product ID (also called shopify_product_id on client side) | String |
| sku | Product SKU | String |
| variant | Product variant name | String |
| variants | Property that holds product variant IDs and SKUs | String |
| shopify_variant_id | Shopify variant ID | String |
| quantity | Quantity of the product | Integer |
| step | Checkout step | Integer |
| paymentMethod | Payment method chosen for checkout | String |
| shipping_method | Shipping method chosen for checkout | String |
| context.Google Analytics.clientId | User’s Google Analytics Client ID | String |
| context.Google Analytics.geoid | User’s location | String |
| context.uip | User IP address | String |
| sent_from | Unique property to identify events sent by Littledata | String |
| presentment_currency | User’s local currency | String |
| presentment_total | Order total in local currency | String |
