Skip to main content

​
Prerequisites

Before setting up the Google Analytics integration, ensure you have:

​
Getting Your Google Analytics Credentials

​
1. Measurement ID

1

Access Google Analytics

Log in to your Google Analytics account and select your GA4 property
2

Navigate to Admin

Click on the Admin icon (gear) in the bottom left corner
3

Find Measurement ID

Go to Data Streams and select your data stream. The Measurement ID (format: G-XXXXXXXXXX) is displayed at the top
4

Copy Measurement ID

Copy this value for the integration configuration

​
2. API Secret

1

Access Data Streams

In Google Analytics Admin, go to Data Streams and select your stream
2

Measurement Protocol API

Scroll down to “Measurement Protocol API secrets” section
3

Create API Secret

Click “Create” to generate a new API secret. Give it a descriptive name (e.g., “Masivo CDP Integration”)
4

Copy API Secret

Copy the API secret value immediately - it won’t be shown again
The API secret is only shown once when created. Make sure to copy it immediately and store it securely.

​
Configuration Steps

​
Step 1: Access Integration Settings

1

Navigate to CDP

Go to your Masivo dashboard and select the CDP section
2

Open Integrations

Click on “Integrations” in the CDP menu
3

Add New Integration

Click “Add Integration” and select “Google Analytics” from the catalog

​
Step 2: Configure Basic Settings

Required Fields

Enter your Google Analytics 4 Measurement ID (format: G-XXXXXXXXXX). This identifies your GA4 property.
Enter your Measurement Protocol API Secret from Google Analytics. This authenticates API requests to GA4.

​
Step 3: Configure Data Sync Options

Audiences

Enable this option to sync Masivo audience calculations to Google Analytics. When an audience is calculated in Masivo, it will be synced as a custom dimension in GA4.
Enable this option to handle audience deletion in Google Analytics when audiences are deleted in Masivo.

Customers

Enable this option to sync customer tags to Google Analytics as custom user properties for advanced segmentation.

Events & Purchases

Enable this option to send customer behavior events to Google Analytics for analytics and insights. Events will be mapped to GA4 standard and custom events.
Enable this option to send purchase events with transaction data to Google Analytics for e-commerce tracking and revenue analysis.

​
Google Analytics Configuration Details

​
Measurement Protocol API

API Requirements

The Measurement Protocol API must be enabled for your GA4 property. This is typically enabled by default.
Each API secret can be used to send events to your GA4 property. You can create multiple secrets for different integrations.
Google Analytics has rate limits for the Measurement Protocol API. Masivo automatically handles rate limiting and batching.

​
Event Tracking Process

1

Event Collection

Customer events and purchases are collected in Masivo through various touchpoints
2

Event Mapping

Events are mapped to Google Analytics 4 standard events (purchase, sign_up, login) or sent as custom events
3

Data Processing

Customer data is processed and formatted for Google Analytics Measurement Protocol
4

Analytics Tracking

Events are sent to Google Analytics 4 via Measurement Protocol API for analysis

​
Event Mapping

Standard Event Mapping

  • CUSTOMER/USER/IDENTIFY → sign_up or login events - Customer registration and profile creation events
  • PURCHASE/TRANSACTION → purchase event - Transaction data with product details, amounts, and currencies
  • PAGE/PAGEVIEW → page_view event - Page view tracking and navigation events
  • EVENT/TRACK → Custom events - Customer behavior and engagement events - Custom loyalty program activities

​
User Properties and Custom Dimensions

Data Enrichment

Masivo automatically sends user properties to GA4 including: - User ID - External customer ID - Customer tags (if enabled) - Audience membership (if enabled)
Custom dimensions can be configured in GA4 to track loyalty program specific data like tier levels, reward balances, etc.
Purchase events include full e-commerce data: - Product IDs and names - Product categories - Order values and currencies - Transaction IDs

​
Monitoring and Troubleshooting

​
Health Monitoring

1

Event Delivery

Monitor event delivery in Google Analytics Realtime reports
2

Data Quality

Check for data validation errors in Google Analytics DebugView
3

API Errors

Review error logs and failed API requests in Masivo integration logs
4

Event Counts

Verify event counts match between Masivo and Google Analytics

​
Common Issues

1

Verify Secret

Ensure the API secret is correct and matches the one in Google Analytics
2

Check Secret Status

Verify the API secret is active and not deleted in Google Analytics
3

Create New Secret

If the secret is lost, create a new one in Google Analytics and update the integration
1

Verify Format

Ensure the Measurement ID follows the format G-XXXXXXXXXX
2

Check Property

Verify the Measurement ID matches your GA4 property
3

Data Stream

Ensure you’re using the correct data stream’s Measurement ID
1

Check DebugView

Use Google Analytics DebugView to verify events are being received
2

Verify Event Format

Ensure events are formatted correctly according to GA4 Measurement Protocol requirements
3

Review Rate Limits

Check if you’re hitting rate limits and adjust event batching if needed
1

Verify Event Names

Check that event names match GA4 standard events or custom event naming conventions
2

Check Parameters

Verify event parameters are correctly formatted and within GA4 limits
3

User Properties

Ensure user properties are set correctly and within GA4 limits