You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/sources/catalog/libraries/website/shopify-littledata/index.md
+14-11Lines changed: 14 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ redirect_from:
6
6
7
7
<!-- LR Note: the working copy of the source catalog YML we built on showed this in the `website` source though as of Nov 18 it's labeled cloud-source -->
8
8
9
-
Littledata is a smart analytics app that automates ecommerce tracking. Littledata's [Shopify-to-Segment connection](https://blog.littledata.io/help/posts/segment-overview/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners) automatically tracks key ecommerce events on a Shopify or Shopify Plus store, so you can use Shopify as a source in your Segment workspace.
9
+
Littledata is a smart analytics app that automates e-commerce tracking. Littledata's [Shopify-to-Segment connection](https://blog.littledata.io/help/posts/segment-overview/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners) automatically tracks key e-commerce events on a Shopify or Shopify Plus store, so you can use Shopify as a source in your Segment workspace.
10
10
11
11
Littledata is available as an independent [Shopify App](https://apps.shopify.com/segment-com-by-littledata). When you install the Littledata app on your store, Littledata does two things:
12
12
@@ -19,7 +19,7 @@ Here's an architecture diagram that shows how the Littledata app mediates data f
19
19

20
20
21
21
> warning "Note"
22
-
> This integration is maintained by Littledata _and is not supported by Segment directly_. The Littledata app has been reviewed by the Segment team for conformance with the[E-Commerce Spec](/docs/connections/spec/ecommerce/v2/), and is the recommended way of using Segment with Shopify. However, it does require a paid subscription with Littledata, who mediates the connection between Shopify and Segment. [Contact the Littledata Support team](mailto:[email protected]) with any questions.
22
+
> This integration is maintained by Littledata _and is not supported by Segment directly_. The Littledata app has been reviewed by the Segment team for conformance with Segment's[E-Commerce Spec](/docs/connections/spec/e-commerce/v2/), and is the recommended way of using Segment with Shopify. However, it does require a paid subscription with Littledata, who mediates the connection between Shopify and Segment. [Contact the Littledata Support team](mailto:[email protected]) with any questions.
23
23
24
24
## Getting Started
25
25
@@ -32,12 +32,12 @@ Here's an architecture diagram that shows how the Littledata app mediates data f
32
32

33
33
6. Choose either an **Automatic** or a **Manual** install. _Automatic installs work in most instances, but if you choose to do a manual install, just follow [this guide](https://blog.littledata.io/help/posts/segment-installation-guide/)._
34
34

35
-
7. Segment's **analytics.js** library, Littledata **tracking script** and **webhooks** will be automatically applied to the store and the installation proccess will then be complete.
35
+
7. Segment's **analytics.js** library, Littledata **tracking script** and **webhooks** will be automatically applied to the store and the installation process will then be complete.
36
36

37
37
38
38
## Device-mode Events
39
39
40
-
Below is a table of events that **Shopify by Littledata** sends to Segment through the analytics.js libary. These events will show up as tables in your warehouse, and as regular events in your other Destinations supporting device-mode.
40
+
Below is a table of events that **Shopify by Littledata** sends to Segment through the analytics.js library. These events will show up as tables in your warehouse, and as regular events in your other Destinations supporting device-mode.
@@ -47,10 +47,9 @@ Below is a table of events that **Shopify by Littledata** sends to Segment throu
47
47
| Product List Viewed | The user has viewed a product as they scroll down the collection page |
48
48
| Product Shared | User has shared a product through social links |
49
49
| Product Viewed | The user has viewed a product page |
50
-
|Thankyou Page Viewed| User has viewed the thank you page after completing an order \*|
50
+
|Thank you Page Viewed | User has viewed the thank you page after completing an order \*|
51
51
52
-
> note ""
53
-
> \* This is less reliable than the de-duplicated `Order Completed` event sent from the Littledata servers, but you can use it in device-mode destinations to trigger a conversion. The `payment_method` and `shipping_method` properties are not available with this event.
52
+
> note "" \* This is less reliable than the de-duplicated `Order Completed` event sent from the Littledata servers, but you can use it in device-mode destinations to trigger a conversion. The `payment_method` and `shipping_method` properties are not available with this event.
54
53
55
54
In addition to the events tracked as standard, the following hits can be tracked based on page path:
56
55
@@ -91,7 +90,7 @@ In the Littledata application, you can choose which of the following fields you
91
90
- Shopify Customer ID (default)
92
91
- Email
93
92
- MD5 email hash
94
-
- None
93
+
- None
95
94
96
95
For example, using 'email' allows you to match users across platforms that do not have access to the Shopify Customer ID. For [Segment Personas](/docs/personas/) we also send `shopify_customer_id` as an [externalID](/docs/personas/identity-resolution/externalids/) for advanced matching.
97
96
@@ -112,12 +111,16 @@ The following traits are included with an Identify call:
112
111
|`lastName`| The customer's email | String |
113
112
|`marketingOptIn`| The `marketing_opt_in` field from [Shopify customer](https://shopify.dev/docs/admin-api/rest/reference/customers/customer?api[version]=2020-04)| String |
114
113
|`phone`| The customer's phone number | String |
115
-
|`purchaseCount`| The bumber of orders by this customer | Integer |
114
+
|`purchaseCount`| The number of orders by this customer | Integer |
116
115
|`state`| Whether the customer account is enabled or disabled | String |
117
116
|`tags`| The custom tags [applied to the customer](https://shopify.dev/docs/admin-api/rest/reference/customers/customer?api[version]=2020-04)| String |
118
117
|`userId`| Chosen user identifier, defaulting to Shopify Customer ID | Double |
119
118
|`verified_email` (v2) | Whether the customer has verified their email | Boolean |
120
119
120
+
## Support for Google Analytics destination
121
+
122
+
All events (device-mode and cloud-mode) contain the Google Analytics `clientId` field where known. This allows the [Google Analytics destination](/docs/connections/destinations/catalog/google-analytics/#supported-sources-and-connection-modes) to be configured in cloud-mode only, so all client side events are relayed via Segment's servers - reducing the scripts needed on your website.
123
+
121
124
## Support for email marketing destinations
122
125
123
126
Email marketing platforms such as [Klaviyo](/docs/connections/destinations/catalog/klaviyo/#server-side-track), [Iterable](/docs/connections/destinations/catalog/iterable/#track) and [Hubspot](/docs/connections/destinations/catalog/hubspot/#server) require an email property with any server-side event in order to associate events with a customer (they cannot use an `anonymousId`). Littledata adds that `email` property whenever an email address is set in the user `traits()` object (in device-mode) or from the Shopify customer record (in cloud-mode).
@@ -126,7 +129,7 @@ Email marketing platforms such as [Klaviyo](/docs/connections/destinations/catal
126
129
127
130
To support seamless customer tracking the [Mixpanel](/docs/connections/destinations/catalog/mixpanel/#alias), [Vero](/docs/connections/destinations/catalog/vero/#alias) and [KISSMetrics](docs/connections/destinations/catalog/kissmetrics/#alias) destinations, Littledata ensures the pre-checkout `anonymousId` is added as an alias of the `userId` (used from checkout step 2 onwards).
128
131
129
-
## Subscription Ecommerce Events
132
+
## Subscription e-commerce Events
130
133
131
134
Additional events available through Littledata's [ReCharge connection](https://www.littledata.io/connections/recharge), and available in cloud-mode destinations.
132
135
@@ -197,7 +200,7 @@ You can edit the LittledataLayer object in your Shopify theme to manually change
197
200
198
201
### cookiesToTrack
199
202
200
-
You can send any cookie set on a landing page (for example, a session identifier or marketing campaign name) to Segment with an Identify call.
203
+
You can send any cookie set on a landing page (for example, a session identifier or marketing campaign name) to Segment with an Identify call. A common use is to pass Iterable `campaignId` and `templateId` through to the [Order Completed event](https://support.iterable.com/hc/en-us/articles/204795719-Sending-Data-from-Segment-to-Iterable-#order-completed).
0 commit comments