Google Analytics 4 Device Mode

Send events to Google Analytics 4 using RudderStack web device mode.

RudderStack lets you send your event data to Google Analytics 4 destination via device mode using the native web SDK, using the gtag tagging method.

info
You need to select gtag.js as the Client Type and enable Use device-mode to send events in the RudderStack dashboard to send events via device mode. For more information on device mode settings in the RudderStack dashboard, see Setting up Google Analytics 4 guide.

Find the open source JavaScript SDK code for this destination in the GitHub repository.

Identify

The identify call lets you identify a visiting user and associate them to their actions. It also lets you record the traits about them like their name, email address, etc.

User-ID is an advanced feature that lets GA4 present a cross-device, cross-platform view of your customers’ behavior. Google Analytics 4 uses userId and deviceId (GA’s cid value from Universal Analytics terminology) to identify users.

A sample identify call is as shown:

rudderanalytics.identify("1hKOmRA4el9Zt1WSfVJIVo4GRlm", {
  name: "Alex Keener",
  email: "alex@example.com",
})

In the above snippet, the userId is set to 1hKOmRA4el9Zt1WSfVJIVo4GRlm and the name and email is set as user_properties.

Page

The page call lets you record your website’s page views with any additional relevant information about the viewed page.

Google Analytics 4 gtag sends a page_view event to Google Analytics by default every-time it is loaded. You can also send page_view event to Google Analytics whenever you make an explicit page() call to RudderStack SDK.

RudderStack sends the following properties by default:

  • url mapped to page_location
  • title mapped to page_title
  • referrer mapped to page_referrer

You can also make page() call with any custom and standard properties as shown below:

rudderanalytics.page({
  path: "/test_browser.html",
  url: "http://example.com/test_browser.html?param1=true",
  title: "Page Load",
  search: "?param1=true",
  referrer: "referrer",
})

Track

warning
This destination does not strictly adhere to the RudderStack Ecommerce Event Spec.

The track call lets you capture user events along with the properties associated with them.

A sample track call is as shown:

rudderanalytics.track("Track me")

RudderStack SDK sends the track event name and any properties as custom properties to Google Analytics 4.

info
RudderStack SDK flattens the properties that are nested and not standard Google Analytics 4 properties before sending them to Google Analytics.
info
There are limits on the number of custom properties per event that can be sent to Google Analytics 4. The RudderStack SDK does not drop the payload based on these limits. If the events are don’t show up in the debug view or in the Google Analytics dashboard reports, refer to the Google support page to learn more about the collection limits.

Group

The group call lets you link an identified user with a group such as a company, organization, or an account, and record any traits associated with that group, for example, company name, number of employees, etc.

RudderStack maps the group call to the join_group event by default.

A sample group call is shown below:

rudderanalytics.group("1hKOmRA4", {
    "custom1": 1234,
    "custom2": "custom2"
});

Ecommerce events tracking

RudderStack supports ecommerce tracking for Google Analytics 4. Use the Ecommerce Events Specification for sending events while instrumenting your site with the RudderStack SDK.

Below are some examples of the track event names that are passed to Google Analytics 4-specific ecommerce event name:

RudderStack event nameGoogle Analytics 4 event name
Products Searchedsearch
Product List Viewedview_item_list
Promotion Viewedview_promotion
Product Clickedselect_item
Product Added To Wishlistadd_to_wishlist
Product Addedadd_to_cart
Cart Sharedshare
Checkout Startedbegin_checkout
Order Completedpurchase
info
For each product in the order, there must be an id and name associated with it. Refer to the GA4 documentation for more information on ecommerce events and corresponding properties.

Debug mode

RudderStack sends all the device mode events with a debug_mode parameter so that you can view them in the DebugView.

FAQ

How can I disable sending userId to GA4?

You can disable sending userId to GA4 by passing an integrations object in your JavaScript SDK load options and setting sendUserId to false.

rudderanalytics.load(
  "WRITE_KEY",
  "DATA_PLANE_URL", {
    integrations: {
      All: true,
      "Google Analytics 4": {
        sendUserId: false
      },
    }
  }
)
warning
If you set sendUserId to false, RudderStack will not send userId to GA4 in any of the events.

How can I enable Google Signals in GA4?

Google Signals helps you understand the interaction of users with your website across multiple devices and sessions. To enable Google Signals and capture user data, the following conditions must be met:

  • A user must be signed in to their Google Account on the website or app.
  • Ad Personalization must be enabled for their account.
info
The Google Signals feature is available in the web device mode only.

To enable Google Signals in GA4 and reflect the collected user data in your reports, follow the steps below:

  1. Log into your Google Analytics dashboard.

  2. Open the Admin panel by clicking on the gear icon at the bottom left.

    Google Signals

  3. Select the property for which you want to enable Google Signals. Then, go to Data Settings > Data Collection.

  4. Click Get Started in the Google signals data collection section:

    Google Signals

  5. Click Continue.

    Google Signals

  6. Read the additional information and click Activate.

    Google Signals

Google Signals is now enabled. You will be able to see the Age, Gender, and other relevant data in the GA4 Demographics reports after 24 hours.


Questions? Contact us by email or on Slack