Analyzify v4 Setup Upgrade Guide

Analyzify v4 introduces improvements and new features to enhance your tracking capabilities. This guide explains how to upgrade based on your current setup.

Setup Instructions

Your upgrade path depends on whether you're currently using Lightweight or Advanced integration in v3.

Lightweight Integration Path

If you're using Lightweight integration, note that Analyzify v4 includes all integrations directly (GA4, Google Ads Conversion, Google Ads Dynamic Remarketing, etc.). We need to upgrade your current integrations to v4 so you can access the app.

Migration Process

The system will:

• Automatically detect your enabled integrations
• Transfer all necessary data for these integrations, including:
• • Google Analytics 4 Measurement ID
  • Product ID format
  • Google Ads Conversion ID
  • Google Ads Conversion Label
  • Google Ads Dynamic Remarketing ID format

Important Updates Required

1. Custom Pixel Verification
2. • Check if "Add To Cart," "Remove From Cart," and "Begin Checkout" events are enabled via Custom Pixel
   • These events need verification to ensure continued functionality
3. Third-Party Script Changes
4. • Cookiebot script previously included in App Embed (v3) must now be added manually
   • Google Consent Mode arguments must be added to theme.liquid file
   • Add both scripts as close to the tag as possible
   • Shopify Customer Privacy API codes for Cookiebot continue through App Embed

You can complete this process by following the steps in the video recording below.

Lightweight Migration Scenarios

1. Lightweight – Standard (No GDPR Compliance)

Migration Steps:

1) Check Your Custom Pixel : The "Add To Cart," "Remove From Cart," and "Begin Checkout" events may have been activated on your store through the Custom Pixel. Therefore, to ensure these events continue to function properly, you need to check whether they have been enabled via the Custom Pixel. 

2) Disable v3 and Enable v4 App Embed: Navigate to Online Store > Themes > Live Theme > Customize > App Embeds to toggle off v3 and enable v4.

3) Update the Custom Pixel codes : To complete the migration process, you need to update the integration to update the Custom Pixel code for each integration. (Please make sure that you have disconnected or deleted the Pixel code from the old version.)

2. Lightweight – Other CMP (With GDPR Compliance, No Privacy API)

Migration Steps:

1) Check Your Custom Pixel: The "Add To Cart," "Remove From Cart," and "Begin Checkout" events may have been activated on your store through the Custom Pixel. Therefore, to ensure these events continue to function properly, you need to check whether they have been enabled via the Custom Pixel. 

2) Specify Your Consent Management Platform (CMP): We can see you're using a CMP in your previous setup, but we need to know which one. This helps us ensure a smoother migration and proper consent management setup in v4.

3) Disable v3 and Enable v4 App Embed: Go to Online Store > Themes > Live Theme > Customize > App Embeds, and disable v3 while enabling v4.

3. Lightweight – Cookiebot (With GDPR Compliance and Privacy API)

Migration Steps:

1) Check Your Custom Pixel: The "Add To Cart," "Remove From Cart," and "Begin Checkout" events may have been activated on your store through the Custom Pixel. Therefore, to ensure these events continue to function properly, you need to check whether they have been enabled via the Custom Pixel. 

2) Integrate the New Cookiebot Code: We can only automatically identify Cookiebot users, which allows us to customize your migration flow and provide you with the necessary new script for proper integration.

Analyzify v4 does not include 3rd party scripts. For more information, please read here .

We create a new script using your Cookiebot domain group ID (automatically retrieved from your previous setup). Follow the popup instructions to add this script to your theme.

Note : If your domain group ID appears empty for any reason, you'll need to enter it manually. This ensures proper Cookiebot integration in your new setup.

3) Disable v3 and Enable v4 App Embed: Go to Online Store > Themes > Live Theme > Customize > App Embeds, disable v3, and enable v4.

Post-Migration Steps for All Lightweight Scenarios

After completing these steps, you will have access to the v4 interface, where you will notice that all the integrations appear with a "Update Needed" tag in the Integrations section. To complete the integrations, simply follow the steps for each integration:

1. Go To the Integration Page and click Connected
2. Click 3 dots at the right of an Integration and Click Update
3. You will be navigated to the Detailed Integration page
4. Check the values/constants and Click Next to continue
5. You will see a code snippet to upgrade your Custom Pixel
6. Follow the instructions in the App and don’t forget to disconnect the old Analyzify Custom Pixels after connecting the new Custom Pixel code. 
7. Click Completed
8. You see the relevant integration as Processing, please wait 1-2 mins to see the “Active” tag.. 
9. Repeat this process for all the integrations you are currently using and see them as “Update Needed”

You can complete this process by following the steps in the video recording below.

Advanced Integration Path

If your Analyzify v3 integration method is Advanced, please follow this section.

Analyzify v4 includes all integrations directly, such as GA4, Google Ads Conversion, Google Ads Dynamic Remarketing, etc. and one of these integrations is the dataLayer a.k.a Advanced setup.

To access the new version of Analyzify, you need to complete certain steps based on your existing Analyzify setup.

DataLayer Integration Changes

To utilize the dataLayer integration, we provide the required Google Tag Manager container. However, unlike our previous versions:

• This container is not provided as a ready-made option
• You should update your constants which are used to send relevant data to the destinations whenever a new version JSON file is imported into your container

You can learn how to update your tags by reading our guide .

⚠️ Important Note : Due to the ease of setup and management, we do not recommend the dataLayer integration and Google Tag Manager setup if it is not necessary for you. Instead:

• We suggest stopping the tags within Google Tag Manager
• Activate Analyzify's Google Analytics 4 or Google Ads Conversion integrations instead
• Warning: Do not activate these integrations without stopping the Google Tag Manager tags, as this could cause double-counting issues

If you're unsure whether you need Google Tag Manager, you can let us know, and we can review your setup for you.

We will determine whether you need Google Tag Manager based on the following points

1) Users who don't need Google Tag Manager (GTM) :

• If you're only using Analyzify default tags within GTM without customization, you can activate your existing integrations, such as Google Analytics 4, Google Ads Conversion, and Google Ads Dynamic Remarketing, directly through Analyzify without needing GTM.

2) Users who need GTM but can manage integrations via Analyzify :

• If you're using non-Analyzify tags in GTM, you can stop Analyzify-related tags in GTM and activate Analyzify v4 integrations as a new user. If the non-Analyzify tags rely on the Analyzify dataLayer, you can keep your Analyzify dataLayer integration active in parallel to ensure the continued functionality of these tags.

3) Users who need GTM and can't manage Analyzify integrations via GA4 :

• If you have customized Analyzify GTM container, continue using GTM to avoid disrupting your customizations.
• Analyzify v4 does not include customization features within its standard setup.

Before making this decision, we can prioritize upgrading your current dataLayer version to v4 so that you can review the app.

Updating the Version 3.3 dataLayer Integration

⚠️ Important : Ensure you have sufficient time to complete the setup without interruption to avoid data corruption, double counting, and consent-related issues.

Changes in Third-Party Script Handling

Analyzify no longer includes third-party scripts. This affects two key components:

1. GTM Script Changes

• The GTM script was previously injected into your theme file through App Embed in v3
• Since it is third-party, they are no longer included in the v4 app embed codes
• Therefore, we should inject your GTM script into:
• • The theme.liquid file
  • Other layouts
  • Position: as close to the tag as possible

⚠️ Important : If you are using any version control system, please update your repository with the changes

2. Cookiebot Banner Script Changes

• The other third-party script Analyzify no longer includes is the Cookiebot banner script
• In version 3, this integration was managed within GTM
• Analyzify v4 does not include the Cookiebot banner template within Google Tag Manager containers
• Therefore, to complete the consent setup, you must add:
• • The Google Consent Mode arguments
  • The Cookiebot banner script
  • Location: theme.liquid file and other layouts
  • Position: as close to the tag as possible

⚠️ Important : The Shopify Customer Privacy API codes for Cookiebot integration continue to be managed through the Analyzify App Embed

Simplified Implementation

To simplify this process, we automatically generate scripts containing:

• The Google Tag Manager
• The necessary Google Consent Mode arguments
• Cookiebot banner code for Consent setup
• Your current IDs

You can complete this process by following the steps in the video recording below.

Advanced Migration Scenarios

1. Advanced v3.3 – Standard (No GDPR Compliance)

Migration Steps:

1. Disable v3 and Enable v4 App Embed: Navigate to Online Store > Themes > Live Theme > Customize > App Embeds, turn off v3, and enable v4.
2. Add the New GTM Script: Analyzify v4 does not contain 3rd party scripts. For more information, please read here .
3. When adding the GTM script to your theme, please ensure you're not adding it twice. Check your theme files for any existing GTM scripts first - having multiple GTM scripts will cause double tracking issues.

Analyzify will automatically retrieve your GTM ID from the previous setup. After completing the setup, please ensure that the GTM container is properly loaded on your store.

2. Advanced v3.3 – Other CMP (With GDPR Compliance, No Privacy API)

Migration Steps

1. Disable v3 and Enable v4 App Embed: Navigate to Online Store > Themes > Live Theme > Customize > App Embeds, turn off v3, and enable v4.
2. Add the New GTM Script: Analyzify v4 does not contain 3rd party scripts. For more information, please read here .
3. When adding the GTM script to your theme, please ensure you're not adding it twice. Check your theme files for any existing GTM scripts first - having multiple GTM scripts will cause double tracking issues.
4. Specify Your CMP: We can see you're using a CMP in your previous setup, but we need to know which one. This helps us ensure a smoother migration and proper consent management setup in v4.

3. Advanced v3.3 – Cookiebot (With GDPR Compliance and Privacy API)

Migration Steps:

1. Disable v3 and Enable v4 App Embed Go to Online Store > Themes > Live Theme > Customize > App Embeds, turn off v3, and enable v4.
2. Integrate the New Cookiebot Code Analyzify v4 does not contain 3rd party scripts. For more information, please follow this link. Therefore, please complete the steps to ensure that the GTM script is fully and correctly added to your theme. Analyzify will automatically retrieve your GTM ID from the previous setup. After completing the setup, please ensure that the GTM container is properly loaded on your store.
3. Add the New GTM Script Analyzify v4 does not contain 3rd party scripts. For more information, please read here . Therefore, please complete the steps to ensure that the GTM script is fully and correctly added to your theme.

Analyzify will automatically retrieve your GTM ID from the previous setup. After completing the setup, please ensure that the GTM container is properly loaded on your store.

Completing DataLayer Integration

After completing these steps, you will have access to the v4 interface, where you will notice that the dataLayer integration appears with a "Update Needed" tag in the Integrations section. To complete the dataLayer integration, simply follow the steps in this document:

1. Learn how to activate the dataLayer codes with V4
2. GTM Custom Pixel Code

Once done, mark it as "Completed." You can complete this process by following the steps in the video recording below.

DataLayer Status and Compatibility

With the section you've completed so far, you have successfully activated your Analyzify dataLayer codes for both the storefront and checkout steps. Before moving on to the Google Tag Manager step:

The Analyzify v4.0 dataLayer integration is compatible with the Google Tag Manager tags you are currently using(v3.3) If you are not experienced with the Google Tag Manager container, we do not recommend updating to the new Google Tag Manager container.

Important Changes in v4.0

Analyzify continues to offer dataLayer integration and provides the necessary GTM tags for using this integration. However, version 4.0 does not support GTM setups. Moreover, when creating a GTM container downloaded from the UI, it does not automatically fill in the required IDs, other variables, and configuration variables within the Custom Pixel codes for the tags to function.

Therefore, each time you download a container from the UI, you need to manually configure:

• The GTM container
• The variables within the Pixel codes whenever the Custom Pixel codes are updated

We have detailed documentation available on these topics:

• Analyzify v4 Data Layer Activation
• Adjust Analyzify v4 GTM Container

Next Steps

You can now review the Analyzify app and decide whether to stop managing the tags within the Google Tag Manager container and instead manage these integrations via Analyzify. As we mentioned before, if you do not have a technical background, feel free to reach out to us. We can conduct the necessary checks for you.

For more information about this update and other new features in Analyzify v4, read our guide .

Transition to Standard Setups from GTM

Once you've identified your scenario as “ Users who don't need Google Tag Manager (GTM) ”, or “ Users who need GTM but can manage standart integrations via Analyzify ” begin by accessing the Analyzify app and following these steps:

Setup Steps

1) Activate Analyzify Destinations :

• • Complete steps within the app for each destination (Google Analytics 4, Google Ads Conversions, Google Ads Remarketing).
  • Fill in the Measurement ID, Conversion ID, or other tracking IDs you currently use, You can utilize the IDs you are currently using to perform this process.
  • Activate these destinations with necessary and simple configurations.

2) Pause Old Tags in GTM :

• • Open Google Tag Manager and go to the Tags section.
  • Filter tags by typing "GA4", "Google Ads Conversion", or "Google Ads Remarketing".
  • Select all filtered tags, ensuring you've selected only Analyzify-related tags.
  • Click on the three dots in the top right corner and mark it as "Pause".
  • Repeat this process for each integration you're migrating to v4.

3) Publish Changes in GTM :

• • After selecting and pausing all necessary tags, click the Submit button in the top right corner.
  • Change the version name to "Analyzify v3.3 → v4: Paused All the Necessary Tags".
  • Click the Publish button.

4) Remove old Analyzify codes :

• Additional step for “Users who don't need Google Tag Manager (GTM)”: If there are no active tags left in Google Tag Manager, you can disable the Analyzify dataLayer integration.

For a visual walkthrough of the setup process, you can watch our step-by-step video guide below: