Skip to documentation content
Advertising and analytics

Connect GA4 Measurement Protocol

Send server-side analytics events to a GA4 web stream.

All connectors · Checked against AXO’s implementation in October 2026.

Prepare access

Use an owner or admin account in AXO and confirm the selected site. Have permission to authorize the external account or create its server credentials. Keep secrets in the connector’s protected configuration.

SettingValue to prepare
measurement_idWeb-stream ID beginning G-.
api_secretMeasurement Protocol API secret from that stream.

Connect

Open Integrations, find GA4 Measurement Protocol, and open its setup. Enter the fields above and save with Connect (or Save changes for an existing connection).

  1. In GA4 Admin → Data streams, choose the web stream and create a Measurement Protocol API secret.
  2. Save both values in AXO. This configuration is used by the Privacy Shield forwarding path; ordinary event subscriptions do not invoke a native GA4 sender. Review the Privacy Shield setup before relying on delivery.

Verify the result

AXO currently has no dedicated connection-test handler for this tile. Google’s validation server checks event structure but does not validate the API secret, and validation events do not appear in reports. Confirm reporting separately.

Record the AXO integration or trigger result and the receiving system’s result. A saved configuration, credential check, and completed delivery establish different things. Use a controlled destination for a test that writes data or sends a message.

Fix a failed connection

Do not treat an HTTP success as proof that GA4 accepted a valid event. Check the stream, secret, and event parameters against Google’s validator.

For a saved catalog connector, open Health to read the latest error, then repair the settings through the setup method on this page. Pause delivery while correcting an unintended destination. Reconnect OAuth when its grant is revoked; for key-based connections, save the replacement key, verify it, then revoke the old key at the provider.

Provider reference: Validate GA4 Measurement Protocol events. Reviewed October 2026.

Next: create an event-triggered action, or implement a webhook receiver.