Install the Tealium app in Shopify

Before you install and configure the Tealium Shopify app, configure the following in Tealium:

• Tealium HTTP API data source
• Event specifications
• A data layer restock variable

For information about these configuration tasks, see Tealium configuration.

Install the Tealium app

The following sections provide instructions for installing the Tealium App in Shopify, enabling the Shopify theme, and configuring the Checkout Pixel.

Install the Tealium app

1. In Shopify, under Apps, search and select the Tealium app.
2. On the Config tab, enter your Account, Profile, and Environment information.
   Environment would typically be prod, dev, or qa.
3. Select a Checkout Tracking option:
   • Client Side Only: Select this option if you only have Tealium iQ Tag Management.
   • Client and Server Side: Select this option if you will be using Shopify Webhooks to send data to EventStream.
4. If you selected Client and Server Side, do the following:
   1. In Tealium, go to Server-Side > Data Sources, and select the data source you created for Shopify.
   2. Copy the Data Source Key for the selected data source.
   3. In Shopify, paste the data source key into the Server Side Data Source ID field.
5. If you are using First-Party Domains, enter your domain name.
6. Click Submit when you have finished the configuration. Webhooks are immediately created.

Enable the Shopify theme

Use the following steps to enable the Shopify theme:

1. In Shopify, on the Theme Extension tab, click Enable.
   This loads the Tealium library, utag.js, as well as the standard data layer for Shopify events, and opens the Theme Manager.
2. In the Theme Manager, toggle Tealium Settings on.
3. To enable debugging, click the down arrow next for Tealium Settings, then do the following:
   1. Click Enabled.
   2. Enter the Environment (prod, dev, or qa).

Configure the checkout pixel

The Tealium app uses a custom checkout pixel to send checkout event data to EventStream. If you do not have EventStream enabled, you do not need to configure the checkout pixel.

Use the following steps to configure the Checkout Pixel:

1. On the Checkout Install tab, copy the example code shown.
2. In Shopify Admin, go to Settings > Customer Events.
   You will see the Tealium pixel that the Tealium app has installed. The checkout pixel must be added manually
3. Click Add Custom Pixel and enter Tealium Checkout for the Pixel Name.
4. Click Add pixel.
5. Under Customer Privacy, the recommended options are as follows:
   • Permission: select Analytics.
   • Data sale: select Data collected does not qualify as data sale.
     This may change depending on the data your store is collecting in Tealium.
6. Delete the example code shown in the Code box.
7. Paste the code copied from the Checkout Install tab into the Code box.
8. Click Save.
9. Click Connect.

Privacy and consent

The Tealium app uses a custom template for consent integrations that makes use of the Shopify Customer Privacy API. This section shows how to configure the recommended approach to consent management and privacy with Shopify.

For more information, see About consent integrations.

The Tealium Shopify app can use the built-in Shopify cookie banner and the Shopify Privacy platform. Use client-side consent integrations to configure third-party banners or other consent management platforms.

Configure client-side consent integrations

Configuration of client-side consent integrations consists of the following:

• Create a purpose group and purposes
• Map tags to purposes
• Add a consent integration for Shopify

Create a purpose group and purposes

To add a consent integration for Shopify, create a purpose group and one or more purposes. Each purpose you create requires a name and a key. The name must correspond to one of the Shopify consent categories. The following table shows the keys and names for Shopify consent purposes:

Assign the appropriate Tealium iQ purpose before mapping tags to the different purposes. For each Tag, select the Map drop-down menu and assign the most appropriate purpose for the tag.

For more information about creating a purpose group and purposes, see Add a purpose group.

Add a custom consent integration

Use the following settings when configuring a custom integration for Shopify:

For more information about adding a custom consent integration, see Add an integration.

Validate your installation

Shopify Custom Pixels run in an iFrame sandbox that makes most tag monitoring plugins incompatible, including the Tealium Universal Tag Debugger. This section provides information on manually implementing debug mode.

To enable this debug mode, follow these steps:

1. Add a cookie named tealium_debug to the page that you are testing.
2. Set the cookie value to dev.
   This automatically sets utagdb=true, which enables verbose output and loads the Tealium dev environment version.
3. To see the additional output, open the browser console.

This debug mode applies only to the client-side. It cannot be used to validate server-side data collection.

Debugging of webhooks and events sent to EventStream can be done using the Live Events page in EventStream. The page being tested will need to be reloaded to see the events. This works on the whole site, including checkout. For more information, see About Live Events.

Uninstall the Tealium Shopify app App

To remove the Tealium app from Shopify, use the following steps:

1. In Shopify, go to Visit Settings > Custom data,
2. In the list, click Tealium, which will be near the bottom of the list.
   The Tealium meta fields will be listed.
3. Scroll down in the list of fields and click Delete.