Skip to content

Commit 3eb4829

Browse files
rvadera12kdaswanimarkzegarelli
authored
Google Analytics 4 Docs (#4325)
* update ga4 cloud mode & add ga4 web docs * fix typos * remove cloud & web * Update index.md * Update index.md * Update index.md * add beta note * Update strat nav --------- Co-authored-by: kdaswani <[email protected]> Co-authored-by: markzegarelli <[email protected]>
1 parent 37489a8 commit 3eb4829

File tree

3 files changed

+77
-25
lines changed
  • src
    • _data/sidenav
    • connections/destinations/catalog

3 files changed

+77
-25
lines changed

src/_data/sidenav/strat.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,8 @@ sections:
5555
title: Google Universal Analytics destination
5656
- path: /connections/destinations/catalog/actions-google-analytics-4
5757
title: Google Analytics 4 destination
58+
- path: /connections/destinations/catalog/actions-google-analytics-4-web
59+
title: Google Analytics 4 Web destination
5860
- path: /connections/destinations/catalog/google-tag-manager
5961
title: Google Tag Manager destination
6062
- path: /connections/destinations/catalog/actions-google-enhanced-conversions
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: Google Analytics 4 Web Destination
3+
strat: google
4+
hide-boilerplate: true
5+
hide-dossier: false
6+
id: 63ed446fe60a1b56c5e6f130
7+
versions:
8+
- name: "Google Analytics 4 Cloud"
9+
link: '/docs/connections/destinations/catalog/actions-google-analytics-4/'
10+
---
11+
12+
{% include content/plan-grid.md name="actions" %}
13+
14+
[Google Analytics 4](https://support.google.com/analytics/answer/10089681){:target="_blank"} is Google's new Analytics property, which you can use for both websites and applications. Google Analytics 4 has machine learning at its core to help surface insights and give you a more complete understanding of your customers across devices and platforms.
15+
16+
When you have Segment installed, you can use your existing tracking implementation to fulfill your data collection needs with Google Analytics 4. When you use the Google Analytics 4 Web destination, Segment loads the [gtag.js library](https://support.google.com/analytics/answer/9310895?hl=en#zippy=%2Cin-this-article){:target="_blank"} for you.
17+
18+
> info ""
19+
> The Google Analytics 4 Web destination is in beta and is in active development. Some functionality may change before it becomes generally available.
20+
21+
## Getting started
22+
23+
Before you connect Segment to Google Analytics 4, configure a Google Analytics 4 property in your Analytics account. For more information, see Google's article [Set up Analytics for a website and/or app](https://support.google.com/analytics/answer/9304153){:target='_blank'}.
24+
25+
To connect the Google Analytics 4 Web destination:
26+
27+
1. From the Segment web app, click **Catalog**, then click **Destinations**.
28+
2. Search for “Google Analytics 4 Web” in the Destinations Catalog, and select the destination.
29+
3. Click **Configure Google Analytics 4 Web**.
30+
4. Select the web source that will send data to Google Analytics 4 and follow the steps to name your destination. The web source chosen must use [Analytics.js 2.0](/docs/connections/sources/catalog/libraries/website/javascript/){:target='_blank'}.
31+
5. On the **Settings** tab, under **Basic Settings**, enter in the [Measurement ID](https://support.google.com/analytics/answer/9539598){:target='_blank'} associated with your GA4 web stream.
32+
6. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
33+
34+
{% include components/actions-fields.html settings="true"%}
35+
36+
## FAQ & Troubleshooting
37+
38+
### Custom Event Naming
39+
40+
Google Analytics 4 does not accept custom event names that include spaces. Segment replaces spaces in the Event Name in the Custom Event action with an underscore. As a result, you will see custom events snake cased in Google Analytics 4.
41+
42+
Google Analytics 4 is also case sensitive. If you would like all event names to be lowercase, use the `Lowercase Event Name` setting in the Custom Event action. If this setting is disabled, Google will treat event names with different casing as distinct events. For more information, see [Google Analytics 4 Event name rules](https://support.google.com/analytics/answer/10085872?hl=en&ref_topic=9756175#event-name-rules&zippy=%2Cin-this-article.%2Cin-this-article){:target="_blank"}.
43+
44+
### Custom Dimensions & Metrics
45+
46+
With Google Analytics 4, you must create custom dimensions and metrics within the Google Analytics 4 interface and link event parameters to the corresponding dimension or metric. When creating the dimension or metric, you can either select a parameter from the list of already collected fields or enter the name of the parameter you plan to collect in the future. For more information, see [Google Analytics 4 Custom dimensions and metrics](https://support.google.com/analytics/answer/10075209?hl=en){:target="_blank"}.
47+
48+
### Debug Mode
49+
50+
The Google Analytics 4 [debug mode](https://support.google.com/analytics/answer/7201382?hl=en){:target="_blank"} is supported with the Google Analytics 4 Web destination. DebugView displays the events and user properties that Analytics collects from a user in real-time. This can be helpful in troubleshooting your implementation.

0 commit comments

Comments
 (0)