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.

The Amplitude Shopify Plugin enables you to bring data from your Shopify store into Amplitude, unlocking valuable insights from funnel analytics, user behavior trends and charts, ROI analysis, Session Replay and more.

Overview

The Shopify plugin installs a version of the Amplitude Browser SDK and adds the script before the </head> tag of your site's pages. The script includes Session Replay and Web Experiment.

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, including marketing attribution 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

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.

Shopify checkout page

Shopify prevents third-party packages from loading on your store's checkout page. As a result, Amplitude doesn't receive events from the checkout page, and you can't run experiments on it.

Performance impact

The packages that Amplitude adds to your Shopify pages weigh ~167kb. Internal testing showed Lighthouse performance reports averaging 98 without the plugin, and 96 with the plugin.

Install the plugin

The method you use to install the Shopify plugin depends on if you have an existing Amplitude organization.

Install without an existing Amplitude organization

Find the Amplitude Shopify plugin in the Shopify App Store.
Click Install and confirm access to add it to your Shopify store.
Navigate to the Amplitude Get Started page and click to create your Amplitude account. Complete the form, agree to terms, and click Continue.

Data Storage Locaiton
Amplitude provides data storage in the US and EU. Choose the appropriate option based on your location.
After you create your account, from the Amplitude setup page, click Shopify in the Other ways to install section.
In the resulting modal, copy your Amplitude project's API key.
Return to the Amplitude Settings screen in Shopify, enter the API key, and click Connect.

Install into an existing Amplitude organization

Log in to Amplitude, and navigate to your organization's settings.
Select the project within your organization that you want to connect to Shopify.
Find the Project's API key and copy it.
Return to the Amplitude Settings screen in Shopify, enter the API key, and click Connect.