README

Fusion Lab - Google Analytics 4 Extension

📌 Overview

Fusion Lab Google Analytics 4 Extension seamlessly integrates Google Analytics 4 (GA4) using Google Tag Manager, enabling advanced tracking for your Magento 2 store.

Includes all core events necessary for comprehensive analytics through GTM from your Magento 2 installation.

Optimized for speed through async code execution to append data to the dataLayer instead of on page load.

The extension is also compatible with Content Security Policy (CSP).

JSON File provided for your GTM container.

Semi PWA backend provided through rest endpoint to fetch product data.

⚡ Features

Magento 2.4.x support.
Includes settings JSON file that you can import to your Google Tag Manager Container.
Compatible with Content Security Policy (CSP).
- dynamic nonce
Events Included
- page_view
- add_to_cart
- remove_from_cart
- view_item_list
- view_item
- view_cart
- begin_checkout
- add_payment_info
- add_shipping_info
- purchase
Multi Website / Storeview Support

🛠️ Installation

Install via Composer 2.x

We recommend to install this module via a compatible version of Composer 2.x for your Magento 2 Installtion.

See your Magento 2 Requirements here.

composer require fusionlab-digital/ga4-tag-manager
php bin/magento module:enable FusionLab_GA4
php bin/magento setup:upgrade
php bin/magento s:d:c
php bin/magento s:s:d {Your Themes}
php bin/magento cache:flush

Manual Installation (not recommended)

This module has a dependency to FusionLab_Core which you must first install. See the github page for installation instructions.
Download the module and extract it into app/code/FusionLab/Ga4
Run the following Magento CLI commands:

php bin/magento module:enable FusionLab_GA4 FusionLab_Core
php bin/magento setup:upgrade
php bin/magento s:d:c
php bin/magento s:s:d {Your Themes}
php bin/magento cache:flush

🚀 Setup

Open the Admin and navigate to Menu -> FusionLab -> Google Analytics 4

Enable the Module
Provide your GTM Container ID
(recommended) Download the JSON file and import it to your GTM Container. Make sure you know what you are doing if other tags are present.
Expand Event Settings and apply the configuration for item id, brand, and concat category
(only for view_item_list) Expand Product Settings to apply the product list selector. Default value .products.wrapper,grid.products-grid is for clean theme.

⚙️ Configuration Documentation

Field	Area	Documentation
Enable Module?	General Settings	Enables or Disables the functionality of the module.
GTM Container Id	General Settings	Your GTM Container Id. Can be found at your Google Tag Manager container
Download JSON File	General Settings	Setup File that you can import into your Google Tag Manager container. See Image in the Admin for Instructions.
Use as Item Id	Event Settings	Is used for for `ecommerce.items[].item_id`. Make sure if you have Google Shopping XML this value is the same as your XML export.
Brand Attribute Code	Event Settings	Is used for `ecommerce.items[].item_brand`.
Concat Category Attributes into 1 field?	Event Settings	If yes then the categories will show in item_category as Women/Shoes/Running Shoes. If no then the item_category up to item_category5 will be filled.
Product List Selector	Product Settings	Is used for the `view_item_list` event. The selector is needed so the code gathers all the products to append to the data layer.

✅ Compatibility

Works with Magento 2.4.x
⚠️ Should also work with any version of Magento 2 that Supports >=php7.4
Tested with Magento Luma Theme
Tested with Magento Custom Theme

📄 License

This module is licensed under the Apache 2.0 License. See LICENSE for details.

📩 Support

For any issues, feature requests, or inquiries, please open an issue on GitHub Issues, contact us at info@fusionlab.gr, or visit our website at fusionlab.gr for more information.

fusionlab-digital / ga4-tag-manager

Maintainers

Details