Google Analytics 4
An introduction to the GA4 Destination
Overview
Destination Type:
- Includes support for Server-side GTM
- Includes support for Consent Mode V2
Installation Instructions
-
Navigate to your GA4 Property and choose
Admin> Data collection and modification > Data streams. -
If you do not have a data stream yet, you should click Add stream > Web. If you do have a data stream already, you should click on the datastream.
-
Copy the Measurement ID from the top right corner. You will need it later.
-
Click on Measurement Protocol API secrets on the same page.
If you do not see the Measurement Protocol API secrets option, this means that you do not haveEdit
permissions for this GA4 Property. -
Click on Create to generate a new secret, and give it the name Converge. After creating, copy the Secret value.
-
In the Converge sidebar, click on
Event streamsand then click Create new Destination. -
Select the Google Analytics 4 destination and click Next.
-
Give your destination a name (e.g. GA4 Destination) and click Next.
-
Fill in the Measurement ID and Measurement Protocol API Secret you copied from GA4 and click Next.
-
Keep the defaults on the Configuration page and click Next.
-
Select Use default mapping and click Next.
-
Select the sources you want to forward events from, then click Next.
-
Review any issues and click Submit.
Configuration Options
The following options can be configured in the Destination Configuration.
Modify your Content ID
The Converge GA4 Destination will use the Default content mode to define the Content ID forwarded by default. However, you can configure the destination to use explicity the Product ID, the Variant ID or SKU instead.
- Navigate to your GA4 Destination, click on Configuration.
- Click on the Configuration-subtab
- Open the Advanced configuration (optional) section
- Pick your desired Content ID, and click on Save
List of Content ID Modes
Content ID Mode | Behavior |
---|---|
Default | Use the variant_id if available, otherwise use the product_id |
Product Id | Always use the product_id |
Variant Id | Always use the variant_id |
SKU | Always use the sku |
Connection Type
How Converge forwards events to Google Analytics 4. Options include:
- Client-side: loads the
gtag
and sends every Converge event client-side. - Server-side: loads the
gtag
and sends every Converge event (except for$page_load
) server-side through the Measurement Protocol. - Server-side GTM (Recommended): loads the
gtag
in a server-side GTM container, and sends server-side conversions through the Measurement Protocol.
Custom Events
The GA4 destination supports setting up custom events, see here for a deep-dive.
When the (recommended) sGTM mode is selected, there are two additional configuration options for each custom event:
- Client or Server. Configure where the custom event is sent from. By default, custom events are triggered from the browser. In some cases, you may want to trigger the event from the server instead. This is useful for events that are exclusively sent server-side to Converge.
- Event or Conversion. Choose whether the custom event should be marked as a conversion in GA4.
Custom Event Properties
Converge allows you to map properties that were tracked on a source from Converge into a custom property in Google Analytics 4.
Custom Ecommerce Properties
You might want to add a custom property on the items
array for ecommerce events as per the GA4 documentation here.
For example, you could include a custom in_stock
parameter on all of the item
arrays in your GA4 Ecommerce events.
The steps for setting up these custom properties are functionally similar to the steps described above in the Custom Event Properties-paragraph.
The only distinction is that you should choose an item-scoped custom dimension
in the GA4
Custom User Properties
You might want to forward a profile property as a custom user property.
The steps for setting up these custom properties are functionally similar to the steps described above in the Custom Event Properties-paragraph.
The only distinction is that you should choose a user-scoped custom dimension
in the GA4
Deploy a separate data layer for Converge
When enabled, Converge creates a new dataLayer
object, even if there is already an existing dataLayer
object. This makes sure that any existing implementation does not accidentally push events on the dataLayer
object that Converge uses to forward events to its destinations.
When you use the sGTM
connection type, Converge will always use a separate data layer.
Pass consent parameters on server-side events
When enabled, Converge makes sure to inject the Google Consent Parameters on server-side captured events as per the corresponding browser session.
Cross-Domain tracking
If you need to track users across multiple domains you will need to set up cross-domain tracking in GA4.
- Go to your GA4 property.
- Go to Admin.
- Go to Data streams.
- Select your active data stream(s).
- Click Configure tag settings.
- Under Settings click Configure your domains.
- Add the different domains the user will interact with.
- Click Save.
GA4 will automatically add cross-domain tracking parameters to every link going from domain A to domain B.
Converge functionality
This integration supports the following Converge destination functionality.
Converge Feature | Supported |
---|---|
Custom Events | |
Filters | |
Server-side Conversions |
FAQ
Event Mapping
Converge automatically maps the following events from the Converge Event Spec to the Google Analytics 4 spec.
Converge Event Name | GA4 Event Name |
---|---|
$page_load | page_view |
Viewed Product | view_item |
Viewed Collection | view_item_list |
Added To Cart | add_to_cart |
Added To Wishlist | add_to_wishlist |
Removed To Cart | remove_from_cart |
Removed To Wishlist | remove_from_wishlist |
Viewed Cart | view_cart |
Started Checkout | begin_checkout |
Added Payment Info | add_payment_info |
Added Contact Info | add_contact_info |
Added Shipping Info | add_shipping_info |
Placed Order | purchase |
Started Subscription | start_subscription |
Placed Recurring Subscription Order | renew_subscription |
Received Refund | refund |
Logged In | login |
Signed Up | sign_up |
Select Product | select_item |
Choose Option | select_item |
Searched | search |