Google Analytics
Отслеживайте e-commerce события заказов и корзины
Medusa GA4 Plugin
A Google Analytics 4 plugin for Medusa that automatically tracks ecommerce events on your backend using Measurement Protocol. This plugin implements server-side tracking for key ecommerce events in your Medusa store.
Features
The plugin automatically tracks the following GA4 ecommerce events:
- - When items are added to a cart
- - When items are removed from a cart
- - When shipping information is added to a cart
- - When payment information is added
- - When an order is placed
Prerequisites
- Medusa backend
- Google Analytics 4 property
- GA4 Measurement ID
- GA4 API Secret
Installation
Configuration
Add the plugin to your :
Client-Side Setup
This plugin handles server-side events, but some GA4 ecommerce events need to be implemented on the client side due to their nature:
- - Product views
- - Checkout initiation
- - User registration
- - User login
Additionally, to properly associate events with users, you need to set the GA client ID as metadata when creating a cart. Here's how to do it in the Next.js Starter:
- Get the GA client ID from the cookie:
- Set the client ID as cart metadata during cart creation:
Events Data Format
The plugin automatically formats cart and order data according to GA4's ecommerce event specifications. Each event includes:
- Currency code
- Transaction value
- Item-level details (name, variant, quantity, price)
- Customer information when available
Development
- Clone this repository
- Install dependencies:
- Build the project:
- Test the plugin:
For local development and testing:
npx medusa plugin:developContributing
Contributions are welcome! Please read our contributing guidelines before submitting a pull request.
License
MIT

