Integrating with Shopify

The Shopify data source can be connected during the sign up wizard or later by creating a new data source and following the setup steps. It unlocks powerful solutions for Shopify stores to grow faster and make more money.

How the Shopify data source works

The Shopify data source is a read only integration and does not modify your existing Shopify customer data. On connect we will (by default) add Capture.js (tracking code) to your Shopify theme.liquid when you first connect.

The only write permission requested is to add Capture.js to your Shopify theme in order to:

  • Track store browsers

  • Track products added to cart

  • Track browser abandonment

  • Show out of stock notifications

Data source history

Depending on your plan either 30 or 90 days of your Shopify customer activity will be imported and any activities thereafter.

Installing Capture.js for Shopify

When you first connect the data source we will automatically install the Capture.js tracking code into your theme.liquid file. This has no impact on your stores performance and enables you to:

  • Track store browsers;

  • Track which products your customers add to their carts;

  • Track browser abandonment;

  • Allow visitors to request to be notified of new stock when an item is out of stock; and

  • Enables the display of other widgets on your store.

You can choose not to install Capture.js by disabling it under advanced settings when adding the Shopify data source. You can then manually add Capture.js by using the Website Session Tracking data source later or to specific areas of your store - although for best performance this is not advised.

Shopify data model

When you install Shopify, the Shopify data model is added to your Customer Data Platform. This gives you access to all of the same fields in Shopify and sets up a new layout on each person so you can easily see information from Shopify.

Shopify activities and attributes

Abandoned cart

The abandoned cart activity is generated by Autopilot based on a customer starting a checkout and not completing an order after 90 minutes. They may still complete an order after 90 minutes so it’s important to use this activity in conjunction with the Place order activity to determine if a recent cart is still in an abandoned state.

Attribute Field type Description

Abandoned checkout URL

URL

This is the URL to resume the abandoned checkout.

Line item names

List (array of items)

This is a list of items in the cart by name.

Shipping price

Currency

This is the cost of shipping.

Total weight

Number

This is the total weight of all items combined.

Subtotal price

Currency

The price of the order in the shop currency after discounts but before shipping, taxes, and tips.

Total line item price

Currency

The price of all of the line item prices added together.

Item count

Number

The total number of items.

Discount codes

List (array of items)

A list of discount codes applied to the cart.

Total discount

Currency

The total discount applied.

Currency

Text

The currency used.

Source

Text

The source of the order e.g. Web, POS, iPhone, and Android.

Referring site

URL

This is the URL of the referrer that brought the customer to your store. e.g. https://www.google.com/search?q=great+products

Collections

List (array of items)

This is a list of the collections relevant to items in the cart.

Tags

List (array of items)

This is a list of all the tags related to items in your cart.

Total price

Currency

This is the total price of the abandoned order.

Added product to cart

The Shopify abandoned cart activity is generated by Autopilot based on a customer starting a checkout and not completing an order after 90 minutes.

Attribute Field type Description

Title

Text

The title of the product.

Variant title

Text

The variant title.

SKU

Text

The product SKU.

Device

Text

The device used by the customer. e.g. Desktop.

Vendor

Text

The vendor of the product.

Collections

List (array of items)

Collections that the product belongs to.

Tags

List (array of items)

Tags related to the item.

Price

Currency

The price of the item added to cart.

Back in stock

The back in stock activity is generated by Autopilot when a customer has requested to be notified when a certain item is back in stock.

Attribute Field type Description

Title

Text

The title of the product that is back in stock.

Inventory quantity

Number

The inventory quantity of the product back in stock.

Variant title

Text

The title of the variant if applicable.

SKU

Text

The SKU of the product.

Vendor

Text

The vendor of the product.

Collections

List (array of items)

Collections that the product belongs to.

Tags

List (array of items)

Tags related to the item.

Price

Currency

The price of the item back in stock.

Checkout started

This activity occurs when the checkout process begins and the user is identified.

Attribute Field type Description

Line item names

List (array of items)

This is a list of items in the cart by name.

Shipping price

Currency

This is the cost of shipping.

Total weight

Number

This is the total weight of all items combined.

Subtotal price

Currency

The price of the order in the shop currency after discounts but before shipping, taxes, and tips.

Total line item price

Currency

The price of all of the line item prices added together.

Item count

Number

The total number of items.

Discount codes

List (array of items)

A list of discount codes applied to the cart.

Total discount

Currency

The total discount applied.

Currency

Text

The currency used.

Source

Text

The source of the order e.g. Web, POS, iPhone, and Android.

Referring site

URL

This is the URL of the referrer that brought the customer to your store. e.g. https://www.google.com/search?q=great+products

Collections

List (array of items)

This is a list of the collections relevant to items in the cart.

Tags

List (array of items)

This is a list of all the tags related to items in your cart.

Total price

Currency

This is the total price of the abandoned order.

Placed order, Order cancelled, Order fulfilled, Order refunded

These activities are generated as the order status progresses between statuses. The order status URL gives the customer updates about the order and is generated by Shopify.

Attribute Field type Description

Order status URL

URL

This is the URL the customer can visit to check the status of their order.

Line item names

List (array of items)

This is a list of items in the cart by name.

Shipping price

Currency

This is the cost of shipping.

Total weight

Number

This is the total weight of all items combined.

Subtotal price

Currency

The price of the order in the shop currency after discounts but before shipping, taxes, and tips.

Total line item price

Currency

The price of all of the line item prices added together.

Item count

Number

The total number of items.

Discount codes

List (array of items)

A list of discount codes applied to the cart.

Total discount

Currency

The total discount applied.

Currency

Text

The currency used. E.g. USD

Source

Text

The source of the order e.g. Web, POS, iPhone, and Android.

Collections

List (array of items)

This is a list of the collections relevant to items in the cart.

Tags

List (array of items)

This is a list of all the tags related to items in your cart.

Total price

Currency

This is the total price of the abandoned order.

Ordered product

Each product in an order generates an Ordered product activity. This allows you to visualize and filter based on individual products purchased.

Attribute Field type Description

Quantity

Number

The amount of the product ordered.

Total weight

Number

The weight of the total quantity of the order.

Title

Text

The title of the product.

Variant title

Text

The title of the variant selected if applicable.

SKU

Text

The product SKU.

Vendor

Text

The product vendor.

Price

Currency

The price of an individual product ordered. Does not take into account quantity.

Collections

List (array of items)

A list of the collections the product belongs to.

Tags

List (array of items)

The tags related to the product.

Viewed product

The viewed product activity is generated by Autopilot when a known user views a product in your Shopify store. This activity is reliant on Capture.js being installed correctly.

Attribute Field type Description

Title

Text

The title of the product.

Inventory quantity

Number

The inventory quantity of the product back in stock.

Variant title

Text

The title of the variant selected if applicable.

SKU

Text

The product SKU.

Device

Text

The device used by the customer. e.g. Desktop.

Vendor

Text

The product vendor.

Collections

List (array of items)

A list of the collections the product belongs to.

Tags

List (array of items)

The tags related to the product.

Price

Currency

The price of an individual product ordered. Does not take into account quantity.

Waiting on stock

The waiting on stock activity is generated by Autopilot when a user requests to be notified when an item is back in stock. This activity requires Capture.js to be installed (be default it happens automatically) on your Shopify store and you to have switched on the "Waiting on stock" widget.

Attribute Field type Description

Title

Text

The title of the product.

Variant title

Text

The title of the variant selected if applicable.

SKU

Text

The product SKU.

Device

Text

The device used by the customer. e.g. Desktop, Mobile.

Vendor

Text

The product vendor.

Price

Currency

The price of an individual product ordered. Does not take into account quantity.

Collections

List (array of items)

A list of the collections the product belongs to.

Tags

List (array of items)

The tags related to the product.