Google Analytics 4
Send events to Google Analytics 4 via the Measurement Protocol. Use SignalSmith to push server-side events from your warehouse to GA4.
Prerequisites
- A Google Analytics 4 property
- Your GA4 Measurement ID (starts with
G-) - A Measurement Protocol API secret
Authentication
GA4 uses Measurement Protocol credentials.
- In GA4, go to Admin > Data Streams > [Your Stream] > Measurement Protocol API secrets
- Create a new API secret
- Copy the Measurement ID (starts with
G-) and the API Secret - Enter both values in SignalSmith
Configuration
GA4 does not require additional configuration fields beyond authentication.
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Event Name | Text | Yes | The GA4 event name to send (e.g., purchase, sign_up, page_view, custom_event) |
| User ID Field | Text | No | Row field to use as the GA4 user_id parameter (optional) |
Supported Operations
Sync Modes: Insert
Audience Sync Modes: Add
Features
- Field Mapping: No — Events are sent using the Measurement Protocol format
- Schema Introspection: No
How It Works
Each row from your model is sent as a single event to the GA4 Measurement Protocol endpoint. All columns in the row (except the user ID field) are included as event parameters.
Troubleshooting
Events not appearing in GA4
Measurement Protocol events can take up to 24-48 hours to appear in GA4 reports. Use the GA4 DebugView (Admin > DebugView) for real-time validation.
Invalid Measurement ID
The Measurement ID must start with G- (e.g., G-XXXXXXXXXX). Find it in GA4 Admin > Data Streams.
API secret invalid
API secrets are specific to each data stream. Verify the secret in GA4 Admin > Data Streams > Measurement Protocol API secrets.
Event parameter limits
GA4 has limits on event parameters: 25 custom parameters per event, parameter names up to 40 characters, and parameter values up to 100 characters.