Skip to content

Commit ce2fa66

Browse files
author
markzegarelli
authored
Merge pull request #1397 from segmentio/littledata-docs-update
Littledata docs update
2 parents 5ba7df8 + f937fe3 commit ce2fa66

File tree

2 files changed

+14
-11
lines changed
  • src/connections/sources/catalog

2 files changed

+14
-11
lines changed
-20 KB
Loading

src/connections/sources/catalog/libraries/website/shopify-littledata/index.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ redirect_from:
66

77
<!-- 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 -->
88

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.
1010

1111
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:
1212

@@ -19,7 +19,7 @@ Here's an architecture diagram that shows how the Littledata app mediates data f
1919
![](images/littledata_arch.png)
2020

2121
> 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.
2323
2424
## Getting Started
2525

@@ -32,12 +32,12 @@ Here's an architecture diagram that shows how the Littledata app mediates data f
3232
![](images/eLUh6GF.png)
3333
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/)._
3434
![](images/iYM76VI.png)
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.
3636
![](images/kvjNx4M.png)
3737

3838
## Device-mode Events
3939

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.
4141

4242
| Event Name | Description |
4343
| --------------------- | --------------------------------------------------------------------- |
@@ -47,10 +47,9 @@ Below is a table of events that **Shopify by Littledata** sends to Segment throu
4747
| Product List Viewed | The user has viewed a product as they scroll down the collection page |
4848
| Product Shared | User has shared a product through social links |
4949
| 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 \* |
5151

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.
5453
5554
In addition to the events tracked as standard, the following hits can be tracked based on page path:
5655

@@ -91,7 +90,7 @@ In the Littledata application, you can choose which of the following fields you
9190
- Shopify Customer ID (default)
9291
- Email
9392
- MD5 email hash
94-
- None 
93+
- None
9594

9695
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.
9796

@@ -112,12 +111,16 @@ The following traits are included with an Identify call:
112111
| `lastName` | The customer's email | String |
113112
| `marketingOptIn` | The `marketing_opt_in` field from [Shopify customer](https://shopify.dev/docs/admin-api/rest/reference/customers/customer?api[version]=2020-04) | String |
114113
| `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 |
116115
| `state` | Whether the customer account is enabled or disabled | String |
117116
| `tags` | The custom tags [applied to the customer](https://shopify.dev/docs/admin-api/rest/reference/customers/customer?api[version]=2020-04) | String |
118117
| `userId` | Chosen user identifier, defaulting to Shopify Customer ID | Double |
119118
| `verified_email` (v2) | Whether the customer has verified their email | Boolean |
120119

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+
121124
## Support for email marketing destinations
122125

123126
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
126129

127130
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).
128131

129-
## Subscription Ecommerce Events
132+
## Subscription e-commerce Events
130133

131134
Additional events available through Littledata's [ReCharge connection](https://www.littledata.io/connections/recharge), and available in cloud-mode destinations.
132135

@@ -197,7 +200,7 @@ You can edit the LittledataLayer object in your Shopify theme to manually change
197200

198201
### cookiesToTrack
199202

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).
201204

202205
### CDNForAnalyticsJS
203206

0 commit comments

Comments
 (0)