Analytics Integrations with Stellar

Last Updated: 2026-02-01

Stellar can integrate with your existing analytics tools to provide a more comprehensive view of your experiment performance. This guide explains how our analytics integrations work and how to set them up.

Google Analytics 4 (GA4) Integration

Overview

Stellar integrates with Google Analytics 4 using the Measurement Protocol. This server-side integration ensures that conversion events sent to GA4 match exactly with the data in your Stellar dashboard. This allows you to:

• View experiment conversion data alongside your other analytics
• Create custom reports and segments based on experiment participation
• Analyze experiment impact on your key metrics
• Track conversions in both Stellar and GA4 with consistent data

Requirements

To use the GA4 integration, you need:

• A Google Analytics 4 property with a web data stream
• Your GA4 Measurement ID (starts with G-)
• A Measurement Protocol API Secret from your GA4 Admin panel

Setting Up GA4 Integration

Step 1: Get Your GA4 Credentials

1. Go to your Google Analytics account
2. Navigate to Admin (gear icon in the bottom left)
3. Under the Property column, click Data Streams
4. Select your web data stream (or create one if needed)
5. Copy your Measurement ID (e.g., G-XXXXXXXXXX)
6. Scroll down to find Measurement Protocol API secrets
7. Click Create to generate a new API secret
8. Give it a nickname (e.g., "Stellar Integration") and copy the secret value

Step 2: Configure GA4 in Stellar

1. Go to your Domains page in Stellar
2. Click View Settings on the domain you want to integrate
3. Find the Google Analytics 4 (GA4) section under Integrations
4. Toggle on the GA4 integration
5. Enter your Measurement ID and API Secret
6. Click Save Credentials

Once configured, Stellar will automatically send conversion events to your GA4 property whenever a user converts in one of your experiments.

Events Sent to GA4

Stellar sends a stellar_experiment_conversion event to GA4 whenever a conversion is tracked. The event includes the following parameters:

{
  "name": "stellar_experiment_conversion",
  "params": {
    "experiment_id": "12345",
    "experiment_name": "Homepage Hero Test",
    "variant_id": "6789",
    "variant_name": "Variant A",
    "conversion_id": "101112",
    "conversion_name": "Add to Cart",
    "is_main_goal": true
  }
}

Setting Up Custom Dimensions in GA4

To use the event parameters in your GA4 reports and explorations, you need to register them as custom dimensions. Here's how:

1. In Google Analytics, go to Admin
2. Under the Property column, click Custom definitions
3. Click Create custom dimension
4. Create the following custom dimensions (one at a time):
   • Dimension name: Experiment ID | Event parameter: experiment_id
   • Dimension name: Experiment Name | Event parameter: experiment_name
   • Dimension name: Variant ID | Event parameter: variant_id
   • Dimension name: Variant Name | Event parameter: variant_name
   • Dimension name: Conversion ID | Event parameter: conversion_id
   • Dimension name: Conversion Name | Event parameter: conversion_name
5. For each dimension, set the Scope to Event

Note: Custom dimensions only apply to data collected after they are created. Historical data will not include these dimensions.

Viewing Conversion Data in GA4

Realtime Report

To verify that events are being received, check the Realtime report:

1. Go to Reports → Realtime
2. Look for stellar_experiment_conversion in the "Event count by Event name" section
3. Click on the event to see parameter breakdowns

Events Report

For historical data:

1. Go to Reports → Engagement → Events
2. Search for stellar_experiment_conversion
3. Click on the event to see details and parameter values

Explorations

For custom analysis with your custom dimensions:

1. Go to Explore → Free form
2. Add your custom dimensions (Experiment Name, Variant Name, etc.) as dimensions
3. Add metrics like Event count
4. Filter by Event name equals stellar_experiment_conversion

Troubleshooting

If you're not seeing experiment data in GA4:

• Verify credentials: Double-check that your Measurement ID and API Secret are entered correctly in Stellar
• Check the integration status: Ensure the GA4 integration toggle is enabled and you see the "GA4 integration is configured and active" message
• Wait for data: GA4 Measurement Protocol events can take up to 24-48 hours to appear in standard reports. Use the Realtime report for immediate verification
• Trigger a conversion: Make sure you have triggered an actual conversion in one of your experiments. The integration only sends conversion events, not experiment views
• Custom dimensions: If you don't see parameter values in reports, make sure you've created the custom dimensions as described above

Data Privacy

The GA4 integration uses your visitor's GA4 client ID (the _ga cookie value) to associate Stellar conversions with their GA4 session. No additional personal data is sent to GA4 beyond what is already being collected by your GA4 implementation.