Skip to content

Commit faf6361

Browse files
committed
Further fields
1 parent 62d0b8c commit faf6361

File tree

1 file changed

+35
-25
lines changed
  • src/connections/sources/catalog/libraries/website/shopify-littledata

1 file changed

+35
-25
lines changed

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

Lines changed: 35 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,6 @@ Littledata is available as an independent [Shopify App](https://apps.shopify.com
1414

1515
2. The app also sets up server-side webhook forwarding to ensure 100% accuracy of important Customer and Order data.
1616

17-
This source has a full [tracking plan and event schema](https://docs.google.com/spreadsheets/d/1aljowRhMU9_7uGXmcipbP1Y14S4cOSdXGQA2Vx7BHko/copy) in Google Sheets, which is ready to [upload into Protocols](/docs/protocols/apis-and-extensions/#google-sheets-tracking-plan-uploader).
18-
1917
Here's an architecture diagram that shows how the Littledata app mediates data flow between Shopify and Segment.
2018

2119
![](images/littledata_arch.png)
@@ -37,12 +35,14 @@ Here's an architecture diagram that shows how the Littledata app mediates data f
3735
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.
3836
![](images/kvjNx4M.png)
3937

38+
## Event schema
39+
40+
This source has a full [tracking plan and event schema](https://docs.google.com/spreadsheets/d/1aljowRhMU9_7uGXmcipbP1Y14S4cOSdXGQA2Vx7BHko/copy) in Google Sheets, which is ready to [upload into Protocols](/docs/protocols/apis-and-extensions/#google-sheets-tracking-plan-uploader).
41+
4042
## Device-mode events
4143

4244
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.
4345

44-
You can _opt out_ of device-mode pageviews or events by setting `disableClientSideEvents: true` or `disablePageviews: true` in the `LittledataLayer` settings.
45-
4646
| Event Name | Description |
4747
| --------------------- | ------------------------------------------------------------------- |
4848
| Cart Viewed | A user has viewed the /cart page |
@@ -59,6 +59,10 @@ You can _opt out_ of device-mode pageviews or events by setting `disableClientSi
5959
> note ""
6060
> \*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.
6161
62+
You can _opt out_ of device-mode pageviews or events by setting `disableClientSideEvents: true` or `disablePageviews: true` in the `LittledataLayer` settings.
63+
64+
The source also respects [GDPR-compliant cookie](https://blog.littledata.io/2021/06/18/shopify-cookie-banner-gdpr-compliance/) consent via Shopify's cookie banner, or popular consent management platforms such as [OneTrust](https://blog.littledata.io/help/posts/integrating-onetrust-with-shopify/) and [TrustArc](https://blog.littledata.io/help/posts/integrating-trustarc-with-shopify/).
65+
6266
## Cloud-mode events
6367

6468
Below is a table of events that **Shopify by Littledata** sends to Segment from Littledata's servers. These events appear as tables in your warehouse, and as regular events in your other Destinations that support cloud-mode. They include the `anonymousId` that links them to the device-mode events where the event was part of a previous user session, or associated with a `userId` that was previously linked with an `anonymousId`. See Littledata's [troubleshooting guide on attribution](https://blog.littledata.io/help/posts/troubleshooting-marketing-attribution-for-shopify/) for more details.
@@ -134,7 +138,9 @@ To support seamless customer tracking the [Mixpanel](/docs/connections/destinati
134138

135139
## Subscription events
136140

137-
Additional events available through Littledata's [ReCharge connection](https://www.littledata.io/connections/recharge), and available in cloud-mode destinations.
141+
All [recurring orders in the Shopify checkout](https://blog.littledata.io/help/posts/tracking-subscription-orders-in-the-shopify-checkout/), from any subscription app, are tracked as Order Completed events.
142+
143+
Additional subscription lifecycle events via Littledata's [ReCharge connection](https://www.littledata.io/connections/recharge) are available in cloud-mode destinations. See the [Track (custom)](https://docs.google.com/spreadsheets/d/1aljowRhMU9_7uGXmcipbP1Y14S4cOSdXGQA2Vx7BHko/edit#gid=1155311093) tab of the event schema.
138144

139145
| Event Name | Description |
140146
| ------------------------ | ----------------------------------------------------------------------------------------------------------- |
@@ -148,7 +154,7 @@ Additional events available through Littledata's [ReCharge connection](https://w
148154

149155
## Event properties
150156

151-
The list below outlines the properties included in the events listed above.
157+
The list below outlines the properties included in most events. See the 'Track (eCommerce)' tab of the [event schema](https://docs.google.com/spreadsheets/d/1aljowRhMU9_7uGXmcipbP1Y14S4cOSdXGQA2Vx7BHko/copy) for exactly which properties are sent with which events.
152158

153159
| Property | Description | Property Type |
154160
| -------------------------------------- | -------------------------------------------------------------------------------------------------- | ------------- |
@@ -171,7 +177,7 @@ The list below outlines the properties included in the events listed above.
171177
| `sent_from` | A unique property to identify events sent by Littledata | String |
172178
| `shipping_method` | The shipping method chosen for checkout | String |
173179
| `shipping` | The shipping cost | Float |
174-
| `source_name` | The source of the order (e.g. `web`, `android`, `pos`) | String |
180+
| `source_name` | The source of the order or checkout (e.g. `web`, `android`, `pos`) | String |
175181
| `step` | The checkout [step number](https://blog.littledata.io/help/posts/shopify-checkout-funnel-updates/) | Integer |
176182
| `subscription_revenue` | The revenue associated with a [Subscription Event](#subscription-events) | Float |
177183
| `subtotal` | Order total after discounts but before taxes and shipping | Float |
@@ -185,27 +191,31 @@ The list below outlines the properties included in the events listed above.
185191

186192
Each item in the `products` array, or Product Viewed and Product Added events, will have the following properties
187193

188-
| Property | Description | Property Type |
189-
| -------------------- | ------------------------------------------------------------------ | ------------- |
190-
| `brand` | The brand of the product (Shopify `vendor`) | String |
191-
| `category` | The category of the product (defaults to `all`) | String |
192-
| `compare_at_price` | The product price before any discount | String |
193-
| `image_url` | The URL of the first product image | String |
194-
| `list_id` | The ID of the product collection (for List Views and Clicks) | String |
195-
| `list_position` | The product position in the collection (for List Views and Clicks) | Integer |
196-
| `name` | The product name | String |
197-
| `price` | The product price | Float |
198-
| `product_id` | Shopify product ID | String |
199-
| `quantity` | The quantity of products | Integer |
200-
| `shopify_product_id` | Also Shopify product ID | String |
201-
| `shopify_variant_id` | The Shopify variant ID | String |
202-
| `sku` | The product SKU | String |
203-
| `url` | The URL of the product page | String |
204-
| `variant` | The product variant name | String |
194+
| Property | Description | Property Type |
195+
| ---------------------- | ------------------------------------------------------------------ | ------------- |
196+
| `brand` | The brand of the product (Shopify `vendor`) | String |
197+
| `category` | The category of the product (defaults to `all`) | String |
198+
| `compare_at_price` | The product price before any discount | String |
199+
| `coupon` | Coupon code associated with the product | String |
200+
| `currency` | The currency displayed to the user | String |
201+
| `image_url` | The URL of the first product image | String |
202+
| `list_id` | The ID of the product collection (for List Views and Clicks) | String |
203+
| `position` | The product position in the collection (for List Views and Clicks) | Integer |
204+
| `name` | The product name | String |
205+
| `presentment_amount` | The product price as displayed to the user | String |
206+
| `presentment_currency` | The currency displayed to the user | String |
207+
| `price` | The product price at the time of the event, in the store currency | Float |
208+
| `product_id` | The Shopify product ID | String |
209+
| `quantity` | The quantity of products | Integer |
210+
| `shopify_product_id` | Also Shopify product ID | String |
211+
| `shopify_variant_id` | The Shopify variant ID | String |
212+
| `sku` | The product SKU | String |
213+
| `url` | The URL of the product page | String |
214+
| `variant` | The product variant name | String |
205215

206216
## Import all orders
207217

208-
With a [Littledata Plus plan](https://www.littledata.io/app/enterprise) you can import all Shopify orders and refunds from before you started using Segment, to sync with destinations that support timestamped events (for example, a data warehouse). This enables you to build a complete customer history in your chosen destination.
218+
With an [annual Littledata Plus plan](https://www.littledata.io/app/enterprise) you can import all Shopify orders and refunds from before you started using Segment, to sync with destinations that support timestamped events (for example, a data warehouse). This enables you to build a complete customer history in your chosen destination.
209219

210220
## Advanced Device-mode settings
211221

0 commit comments

Comments
 (0)