Upgrade Lightweight Setup to Analyzify 4.0

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.