RudderStack lets you send your event data to Google Analytics 4 via the cloud mode by leveraging the Google Analytics 4 Measurement Protocol.

Identify

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

A sample identify call using gtag is shown below:

Copy
rudderanalytics.identify("1hKOmRA4GRlm", {
    firstLogin: true,
    method: "Google",
    value: 10,
    currency: "USD"
});

A sample identify call using firebase is shown below:

Copy
rudderanalytics.identify("1hKOmRA4GRlm", {
    firstLogin: true,
    method: "Google",
    value: 10,
    currency: "USD"
}, {
    externalId: [{
        type: "ga4AppInstanceId",
        id: "f0dd99b6f979fb551ce583373900f937"
    }],
});

Track

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

RudderStack supports both the gtag and firebase ways for tagging in websites in the cloud mode. However, note that:

• If you use gtag, passing the client_id parameter is mandatory.
• If you use firebase, passing the app_instance_id parameter is mandatory.

The mappings for the above-mentioned mandatory parameters are listed in the following table:

The mappings for the optional parameters (common for gtag and firebase both) are listed in the following table:

A sample track call using gtag is shown below:

Copy
rudderanalytics.track('Product List Viewed', {
  list_id: "related_products",
  category: "Related_products",
  products: [{
    product_id: "507f1f77bcf86cd799439011",
    name: "Monopoly: 3rd Edition",
    coupon: "SUMMER_FUN",
    category: "Apparel",
    brand: "Google",
    variant: "green",
    price: "19",
    quantity: "2",
    position: "1",
    affiliation: "Google Merchandise Store",
    currency: "USD",
    discount: 2.22,
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    item_list_id: "related_products",
    item_list_name: "Related Products",
    location_id: "L_12345"
  }]
}, {
    externalId: [{
        type: "ga4ClientId",
        id: "client_id"
    }],
});

A sample track call using firebase is shown below:

Copy
rudderanalytics.track('Product List Viewed', {
  list_id: "related_products",
  category: "Related_products",
  products: [{
    product_id: "507f1f77bcf86cd799439011",
    name: "Monopoly: 3rd Edition",
    coupon: "SUMMER_FUN",
    category: "Apparel",
    brand: "Google",
    variant: "green",
    price: "19",
    quantity: "2",
    position: "1",
    affiliation: "Google Merchandise Store",
    currency: "USD",
    discount: 2.22,
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    item_list_id: "related_products",
    item_list_name: "Related Products",
    location_id: "L_12345"
  }]
}, {
  externalId: [{
    type: "ga4AppInstanceId",
    id: "f0dd99b6f979fb551ce583373900f937"
  }],
});

Page

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

RudderStack maps the page call to a page_view event by default, and passes it to Google Analytics 4 as a custom event.

As mentioned in the track section above, the RudderStack cloud mode supports both the gtag and firebase methods for tagging in websites.

A sample page call using gtag is shown below:

Copy
rudderanalytics.page();

A sample page call using firebase is shown below:

Copy
rudderanalytics.page({}, {
  externalId: [{
    type: "ga4AppInstanceId",
    id: "f0dd99b6f979fb551ce583373900f937"
  }],
});

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 using gtag is shown below:

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

A sample group call using firebase is shown below:

Copy
rudderanalytics.group("1hKOmRA4", {
    "custom1": 1234,
    "custom2": "custom2"
}, {
    externalId: [{
        type: "ga4AppInstanceId",
        id: "f0dd99b6f979fb551ce583373900f937"
    }],
});

E-commerce event tracking

RudderStack supports e-commerce tracking for Google Analytics 4. You can refer to the E-commerce Events Specification guide for sending events while instrumenting your site with the RudderStack SDK.

The following table lists the mappings between the RudderStack and Google Analytics 4 events:

The following table lists the RudderStack and Google Analytics 4 properties mappings based on the specific RudderStack events:

Most of the above mentioned events include items parameter which accepts an Item array. The below table details out the common mappings for Items array:

The below mentioned e-commerce events include items parameter which accepts an Item array.

The following table details the parameter mappings present in the Items array, for the above events:

The below mentioned e-commerce events include items parameter which accepts an Item array.

The following table details the parameter mappings present in the Items array, for the above events:

Non e-commerce events tracking

The below table lists the mappings of the non e-commerce track events and properties that are passed to Google Analytics 4 events and properties:

Rules for naming custom events

You must follow the below rules while choosing a name for the custom events:

• Event names are case sensitive. For example, my_event and My_Event are two distinct events.
• Event names must start with a letter. Only letters, numbers, and underscores are permitted. DO NOT use spaces.
• Do not use reserved prefixes and event names. Refer to the FAQ section to know more about the reserved event names and prefixes.

FAQ

I’ve set up GA4 as a destination in RudderStack but I’m not seeing the expected data flow through in the GA4 dashboard. What should I do?

To view the events sent to GA4, go to your Google Analytics dashboard and navigate to Reports > Realtime.

While the events typically show up within a few seconds, note that it can take GA4 up to 24 hours to process their data and appear on other reports. Also, not all types of data flow through to its realtime dashboard. It may be best to consult GA4’s FAQs for the most up-to-date information on its latest capabilities and limitations.

What are the reserved prefixes in Google Analytics 4?

The reserved prefixes in Google Analytics 4 cannot be used for custom events. The list of such prefixes is mentioned below:

• _ (underscore)
• firebase_
• ga_
• google_
• gtag.

Refer to the GA4 documentation for more information.

What are the reserved event, parameter, and user property names in Google Analytics 4?

Google Analytics 4 has some reserved event, parameter, and user property names that cannot be used. Refer to the Measurement Protocol (Google Analytics 4) guide for a complete list of reserved names.

How do I obtain the app_instance_id?

You can retrieve the app_instance_id through the Firebase SDK depending on the platform where the SDK is installed:

• Android: getAppInstanceId()
• Kotlin: getAppInstanceId()
• Swift: appInstanceID()
• Objective-C: appInstanceID
• C++: GetAnalyticsInstanceId()
• Unity: GetAnalyticsInstanceIdAsync()

Contact us

For queries on any of the sections covered in this guide, you can contact us or start a conversation in our Slack community.