Google Analytics 4

Nimriz integrates with Google Analytics 4 through the server-side Measurement Protocol. You connect a GA4 property once, then add one or more actions to control which Nimriz events should be forwarded.

Requirements

You must have a Growth plan or higher to use the GA4 integration.

Configuration

To connect Nimriz to GA4, you need two credentials from your Google Analytics property:

1. Measurement ID (e.g., G-XXXXXXXXXX)
2. API Secret

1. Find Your Measurement ID

1. In Google Analytics, click Admin.
2. Under the relevant property, select Data Streams.
3. Choose your Web data stream.
4. Copy the Measurement ID from the upper right corner.

2. Generate an API Secret

1. Still in the Web stream details, scroll down to Measurement Protocol API secrets.
2. Click Create to generate a new secret.
3. Give it a descriptive name (e.g., "Nimriz Server-side").
4. Copy the Secret value.

3. Set up GA4 in Nimriz

1. In Nimriz, open Integrations.
2. Go to Catalog and choose Google Analytics 4.
3. Paste your Measurement ID and API Secret.
4. Save the destination and add an action such as Send event.
5. Choose the event triggers and any mapping overrides you want.
6. Review the preview, send a test event, then enable the connection.

Event Payload

By default, Nimriz sends a custom event named nimriz_link_click. The payload includes variables such as short_url, domain_name, country, device_category, and your existing utm_* fields.

Nimriz uses an obfuscated daily-salted hash of the visitor's IP address (ip_hash) as the client_id for GA4 tracking. If you enforce Strict Privacy Mode on your workspace, the payload falls back to a synthetic per-click ID instead.

Troubleshooting

If you are not seeing data in GA4:

1. Open the GA4 destination in Nimriz.
2. Select the action you want to verify.
3. Review the payload preview and trigger filters.
4. Use Send test to this action. Nimriz routes the test payload to GA4's /debug/mp/collect endpoint so you can verify the event format.