Amplitude Shopify Plugin

Shopify is an all-in-one commerce platform that allows businesses of any size to create, customize, and manage online stores with ease. It offers tools for product listings, payments, shipping, and customer engagement, streamlining the selling process online, across social media, and in person. With built-in marketing features, analytics, and integrations with third-party apps, Shopify helps business owners track performance and drive sales.

The Amplitude Shopify Plugin enables you to instrument your Shopify store with an Amplitude features including Autocapture and Session Replay.

Considerations

Performance: The packages Amplitude provides are roughly 167kb total size, but vary depending on which products you use. In testing, Shopify stores with Amplitude installed registered an average lighthouse score of 96, compared to an average score of 98 without Amplitude.

Plugin details

The Shopify plugin installs a version of the Browser SDK, and adds the script before the </head> tag on each of your site's pages. This script also includes the following Amplitude features:

Shopify and flickering

The method Shopify uses to loads Amplitude's Shopify app causes flickering. To avoid this, add the asynchronous web script with the anti-flicker snippet to your theme.liquid file.

The Shopify plugin captures Amplitude's default events and Shopify's standard events.

Shopify plugin events and event properties

Event	Source	Properties
Page viewed	Amplitude	Page counter, Page domain, Page location, Page path, Page title, Page URL, Session Replay ID (if enabled), Referrer, Attribution, User properties.
Start session	Amplitude	Session Replay ID (if enabled), User properties.
End session	Amplitude	User properties.
Form started	Amplitude	Form destination, Session Replay ID (if enabled), User properties.
Form submitted	Amplitude	Form destination, Session Replay ID (if enabled), User properties.
File downloaded	Amplitude	File extension, File name, Link text, Link URL, Session Replay ID (if enabled),
Element clicked	Amplitude	Element Aria Label, Element Class, Element Hierarchy, Element Href, Element ID, Element Parent Label, Element Position Left, Element Position Top, Element Selector, Element Tag, Element Text, Page Title, Page URL, Session Replay ID, Viewport Height, Viewport Width.
Element changed	Amplitude	Element Class, Element Hierarchy, Element ID, Element Parent Label, Element Position Left, Element Position Top, Element Tag, Page Title, Page URL, Session Replay ID, Viewport Height, Viewport Width.
Collection viewed	Shopify	Collection title
Product viewed	Shopify	Quantity, SKU, Price, Currency Code, Type, Variant Title, Title, Vendor, Products
Product added to cart	Shopify	Quantity, SKU, Price, Currency Code, Type, Variant Title, Title, Vendor, Products
Product removed from cart	Shopify	Quantity, SKU, Price, Currency Code, Type, Variant Title, Title, Vendor, Products
Checkout started	Shopify	Discounted amount, Total price, Currency code, Products
Checkout contact info submitted	Shopify	--
Checkout address info submitted	Shopify	--
Checkout shipping info submitted	Shopify	--
Checkout completed	Shopify	Total tax, Discount amount, Subtotal price, Currency code, Customer id, Products
Order created	Shopify	Customer, Products
Search submitted	Shopify	Search query

Checkout completed vs Order created

In most scenarios, when a customer completes the checkout flow, Shopify fires the Checkout complete event, then the Order created event. If you create an order manually from your store's Admin page, only the Order created event fires. The Checkout complete event is specific to a customer completing the checkout flow.

User ID is set using the email address or phone number the customer enters in the Contact section of the checkout.

Install the plugin

To add the plugin to your Shopify store:

Log in to your Shopify account and find the plugin in the Shopify App Store. Click Install.
Confirm the required plugin permissions and click Install.
Locate your project's API key and add it to the Amplitude Settings page in Shopify.
Select your Amplitude data region. Click Connect.

Ad blocking software
If any ad blocking software is running in your browser, disable it to ensure the plugin setup step can communicate with Amplitude.

A "Connection successful" message indicates the plugin is enabled and connected with Amplitude.

A successful connection enables Amplitude to stream events and properties from your Shopify store to Amplitude, where you can create charts, view session replays, define new events with Visual Labeling, and more.