Shopify App Configuration Guide

Install the Shopify App

To begin, download the app from this page (opens in a new tab) or search for Addingwell directly in the Shopify App Store (opens in a new tab).

Then click on Install.

Configure the DataLayer

Enable the DataLayer

Enabling the DataLayer automatically generates user event tracking in GA4 format. These events cover most interactions on your site.

Here is the list of supported events: view_item_list, view_item, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_payment_info, add_shipping_info, purchase.

Add a Suffix to the DataLayer

If necessary, you can add a suffix to the names of DataLayer events to avoid conflicts with other GA4 events already present.

For example, by adding the suffix aw, the view_item event becomes view_item_aw.

Configure Google Tag Manager (GTM)

Enable GTM

To integrate Google Tag Manager into your store, start by enabling the gtm.js script on all pages of your site. Then enter your GTM container ID (e.g., GTM-DSD8IZD).

Use an Alternative Path

You have the option to configure a custom (proxied) URL to load gtm.js and bypass ad blockers. By default, the URL used is: https://www.googletagmanager.com/gtm.js.

With Addingwell's server-side tracking, you can generate a proxied URL from your Container by clicking "How to setup" in the CDN section.

Then enable the "Addingwell CDN" option, which modifies the GTM-XXXX ID to aw=XXXX.

Checkout Tracking with Customer Events

To track interactions during the checkout process, you need to set up a custom pixel.

Here's how to do it:

1. Go to Settings > Customer events in your Shopify admin.
2. Click on Add a new custom pixel.
3. Name your pixel (e.g., addingwell-pixel).
4. Add the appropriate permissions.
5. Replace the pixel code with the one provided in the app.
6. Click Save and then Connect.

🎉 Installation Complete

Congratulations 👏! You have successfully configured your Shopify site.

Add the shopify_y Parameter

Add the shopify_y parameter to your GA4 event tags in your GTM container for the checkout steps (begin_checkout, add_payment_info, add_shipping_info, and purchase if you use Checkout Extensibility). Create a DataLayer variable to retrieve the visitor ID, named master_id. This will allow you to track the visitor throughout the checkout process.

Enable the Cookie Restore Feature

On the Cookie Monitoring page, click on Cookie Restore and fill out the form with the following information:

• Tracking domain.
• Leave the second line unchanged.
• Cookie name: _shopify_y.
• Click Verify.

Wait a few seconds, then click on Enable Cookie Restore.