Skip to content

Add info about /debug endpoint #6590

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
May 22, 2024
Merged

Add info about /debug endpoint #6590

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7d8c759
Update index.md
spencerattick May 22, 2024
96e1e43
Update src/connections/destinations/catalog/actions-google-analytics-…
spencerattick May 22, 2024
9f21753
Update index.md
spencerattick May 22, 2024
ba50f0f
fix typo
spencerattick May 22, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions src/connections/destinations/catalog/actions-google-analytics-4/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -188,6 +188,15 @@ Google doesn't currently support passing certain reserved fields to the Google A

The Google Analytics 4 [debug mode](https://support.google.com/analytics/answer/7201382?hl=en){:target="_blank"} only works with a client-side implementation through gtag.js, Google Tag Manager, or Firebase. Because Segment's Google Analytics 4 Cloud integration is server-side and uses the Measurement Protocol API, debug mode is not supported.

However, you can use Google's `/debug` endpoint to test your events against Google's Measurement Protocol Validation Server. For more information, see Google's [Validate events](https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events?client_type=gtag#:~:text=Protocol%20Validation%20Server-,/debug/mp/collect,-All%20other%20request){:target="_blank”} documentation.

To validate your events:

1. Run a test through Segment's [Event Tester](/docs/connections/test-connections/) with the event you're concerned about.
2. Copy the `Request from Segment` value you see. This is the payload that Segment attempts to send to Google.
3. Use an API testing tool, like Postman, to send that payload to Google's `/debug` endpoint.
4. Google's `/debug` endpoint returns a [validation code](https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events?client_type=gtag#validation_code){:target="_blank”} and a description of the error.

### Mobile data

To achieve complete reporting, Google recommends use of their Firebase SDKs to send mobile data to Google Analytics 4. To assist in your implementation, Segment has a [Firebase destination](/docs/connections/destinations/catalog/firebase) available for mobile analytics. For more information on linking Google Analytics 4 properties to Firebase, see [Google Analytics 4 Firebase integration](https://support.google.com/analytics/answer/9289234?hl=en){:target="_blank"}.
Expand Down
Loading