GA Measurement Protocol

After installing the app, go to the website settings and, in the Enhanced Website Tracking section, enable the Activate Tracking option. To test your website tracking and view tracked events in the browser console, also temporarily activate the Debug Logging feature:

If you use Odoo's built-in Google Analytics feature, disable it and transfer the identifier to a new tracking service.

The module is compatible with the Odoo Google Consent Mode solution, which allows managing cookie consent and updating consent states by sending them to Google.

The module allows you to track e-commerce events on your website and send them to Google along with product information and user-provided data. You can send this data via Google Tag and via API. These features are implemented at the tracking service level. Add and configure a tracking service for your Odoo website.

Adding a Tracking Service

Go to the Website - Configuration - Tracking - Services menu and click New to add a new tracking service.

Firstly, fill in the following fields in the new tracking service:

• Specify a Website (if using multiple websites)
• Select Google Analytics 4 as the service Type
• Paste your GA4 Measurement ID into the Key field

Then, specify the type of product identifier and product category sent to Google.

If products have attributes and variants, choose Product Variant ID in the Item Type field; otherwise, select Product Template ID.

Select the desired Category Type: an eCommerce Public Category or an internal Product Category.

The next option is the Lead Value on the Options tab.

This field represents the monetary value of a lead generation, based on estimated evaluations.

Measurement Protocol Activation

Enable the Internal Logs option.

Internal logging is required for API integration.

After that, switch on the API mode by enabling the Activate option in the API section.

Next, log in to your Google Analytics account and create an Access Token under Web stream details, Events section, and Measurement Protocol API secrets.

Copy the Secret value and paste it into the Access Token field in Odoo.

Internal logs record visitor actions on your Odoo website to assist with further analysis and monitoring. Click the Logs button at the top of the form.

Enable the State and API Sent Date columns to display a status and the date of event sending through the Measurement Protocol:

Scheduled Actions

The module uses a scheduled action to send tracking events periodically. By default, this action runs every 30 minutes, but you can adjust this interval to meet your requirements.

To send tracking data manually, select tracking logs from the list or open a log and click on Send Event.

Sensitive Data Cleanup

Because tracking logs may contain sensitive data, configure a cleanup schedule. Go to the website settings and set the cleaning period. The default period is 30 days.

Enable the Unlink Logs After Period option to completely remove tracking logs older than the specified period.

Enhanced conversions help optimize your advertisements by providing Google with additional user data. Open the Advanced Matching tab and click Allow Enhanced Conversions, which enables all available options for this tracking service.

Review the options and leave enabled the user-provided data that should be sent to Google.

The module sends user data securely as it is hashed in accordance with Google's requirements.

Use the Sale Order Partner value as the Customer Data Source because it provides more user information when guest checkouts are allowed without registration.

The module includes additional settings available in Developer Mode.

Product Identifier

The module uses the Product ID field as a unique product identifier. To use a different value, specify another product field containing the desired identifier on the Technical tab:

The specified product field should provide non-empty values and remain unique for each product. Otherwise, the tracking data for this product becomes unusable.

Purchase on Portal

To track portal purchases, enable the Track Purchase on Portal option:

Exclude Delivery

The next available setting for tracking services is Exclude Delivery. When enabled, the service excludes delivery lines from sales orders in tracking data transmissions:

Exclude Rewards

To exclude reward order lines from tracking data, enable the Exclude Reward option:

Add to Cart

By default, the module tracks the actual addition of a product to the cart. To track the event upon clicking the button without waiting for the actual addition to the cart, perform the following steps:

• Navigate to Website — Configuration — Websites
• Open the website on the Enhanced Tracking tab
• Enable the Add to Cart on Click option

Tracking the actual addition might fail if third-party modules modify the logic. In this case, this option allows for event tracking by binding it to button selectors used in native Odoo website templates.

Purchase

To track purchases only after a successful payment transaction, enable the Track Confirmed Purchases only option:

This option only affects the event transmission through the tracking service; the internal log records the event regardless.

If business logic considers an order with a Pending payment status as a purchase, enable the Track Pending Purchases too option as well.

Test the Google Analytics Measurement Protocol integration to ensure accurate event tracking.

Two verification methods are available:

• Realtime Overview — monitor live events directly within the Google Analytics user interface
• Debug Mode — validate payloads using the Measurement Protocol validation server

Realtime Overview

The first way to test the Google Analytics Measurement Protocol integration is to use the Realtime Overview. Enable the Remove JS Script option to prevent events from being sent to Google Analytics via script before the API.

For testing, log out of Odoo or use a different browser, as website tracking does not work for internal Odoo users.

Once the state of internal logs sending has changed to Sent, go to Google Analytics, then open the Reports menu and the Realtime Overview page.

Review the Event count by Event name and Key events by Event name sections, which should contain the events you sent.

Measurement Protocol Validation Server

To verify the integration with the Measurement Protocol validation server, enable the Debug Mode option in your Google Analytics tracking service settings.

Open one of the events and send it manually. If the log status has changed to Debug and on the Technical tab, the API Response field has the OK value, which means that no errors were found.

If the status changed to Warning or Error, check the API Response field for details on why.

After completing testing, disable Debug Mode and send the event again. The Sent status means that the event was successfully sent via API to Google Analytics.