HK2 Marketing Analytics

Overview

HK2 Marketing Analytics integrates Google Analytics 4 (GA4), Facebook (Meta) Pixel, and Google Product Feed generation into your Magento 2 store. It provides a centralized configuration panel for managing analytics and tracking settings without modifying theme templates.

Problem Statement

Magento store owners need to integrate multiple analytics and marketing tracking services to measure store performance, understand customer behavior, and optimize marketing campaigns. Manually editing templates for each service is error-prone, requires theme maintenance, and does not scale across multiple services.

Solution Approach

This module provides a unified configuration-driven integration for Google Analytics 4 and Facebook Pixel tracking. Tracking scripts are injected automatically on all frontend pages via a layout handle, with no template overrides required. A scheduled cron job generates the Google Product Feed for Merchant Center submissions.

Who is this for?

• Magento store owners who need Google Analytics 4 tracking
• Merchants running Facebook advertising campaigns
• Stores submitting product data to Google Merchant Center
• Developers who want a clean, configurable tracking solution without template modifications

Use Cases

• Track store traffic and user behavior with Google Analytics 4
• Measure Facebook ad performance with Meta Pixel PageView tracking
• Submit product catalog to Google Shopping via automated feed generation
• Manage all tracking configurations from a single admin panel

Key Features

• Google Analytics 4 Integration — Inject GA4 gtag.js with your Measurement ID on all pages
• Facebook (Meta) Pixel — Inject Facebook Pixel with automatic PageView event tracking
• Google Product Feed — Scheduled daily XML product feed generation for Google Merchant Center
• Centralized Configuration — Manage all tracking settings from a single admin panel
• Automatic Injection — Tracking scripts load automatically with no template edits
• ACL Protected — Granular admin permissions for configuration access
• Cron-Based Feed — Automated daily feed generation at 2:00 AM

System Requirements

• Magento 2.4.x (Open Source or Adobe Commerce)
• PHP 8.1, 8.2, 8.3, or 8.4
• Composer
• hk2/core module (^1.0)

Installation

See Installation Guide for detailed instructions.

composer require hk2/module-marketing-analytics
bin/magento module:enable HK2_MarketingAnalytics
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Configuration

Navigate to Stores > Configuration > HK2 > Marketing Analytics in the Magento Admin Panel.

Available settings:

Content Security Policy (CSP)

If you have Content Security Policy enabled in your Magento store, ensure the following external domains are whitelisted:

• https://www.googletagmanager.com — Google Analytics
• https://connect.facebook.net — Facebook Pixel
• https://www.google-analytics.com — Google Analytics

Privacy & GDPR

When using Google Analytics and Facebook Pixel, ensure compliance with applicable privacy regulations:

• Configure your cookie consent mechanism before loading tracking scripts
• Update your privacy policy to disclose third-party tracking services
• Configure Google Analytics IP anonymization if required in your jurisdiction
• Provide opt-out mechanisms where required by law

For detailed usage instructions, refer to the Usage Guide.

Documentation

• Installation Guide
• Usage Guide
• Compatibility

Known Limitations

• The Google Product Feed generation is scheduled for daily execution and cannot be triggered manually from the admin panel
• Product feed is generated as XML for Google Shopping; other feed formats are not supported
• The module requires the hk2/core dependency for the HK2 admin tab and shared components

Contributing

Contributions are welcome. Please open an issue or pull request on the repository.

Report security vulnerabilities to [email protected] — see SECURITY.md for details.

License

This module is licensed under the Open Software License 3.0 (OSL-3.0). See LICENSE.txt.

Disclaimer

This module is provided "as is" without warranty of any kind. The authors are not responsible for any damages arising from its use. Ensure compliance with applicable laws and regulations when using tracking technologies.

1.0.0 (2026-05-11)

✨ Features

• add bug report and pull request templates for improved issue tracking (d492ef6)
• implement HK2 Marketing Analytics module with Google Analytics and Facebook Pixel integration (7e8971e)

📝 Documentation

• update README with detailed module overview, features, installation, and configuration instructions (2123f42)