Map the GA4 schema

Updated Nov 8, 2026 Based on Google Analytics Help docs reviewed 2026-11-08

GA4 exports events as nested, key-value fields rather than flat columns. Once your GA4 data source is connected (see Connect the data source), map its fields to Data 360 data model objects (DMOs) so Personalization can read them like any other source.

Map GA4 fields to DMOs

  1. Open the GA4 data lake object (DLO) that your connection created.
  2. Map event_name, event_timestamp and event_date to the matching fields on your engagement DMO.
  3. Map the user_pseudo_id (and user_id, if you collect it) to the identifier field your identity resolution rules key on.
  4. Map any event_params or user_properties entries you need to custom fields on the DMO — see the note below.
  5. For e-commerce data, map the ecommerce and items fields to your transaction and product DMOs.
  6. Save the mapping and confirm new GA4 events populate the DMOs.

GA4 field groups you’ll map

Field groupExample fieldsMaps to
Event identificationevent_name, event_date, event_timestampEngagement DMO
User identificationuser_id, user_pseudo_idIdentity/profile DMO
Custom parametersevent_params, user_properties (key-value)Custom fields on the matching DMO
Device and geodevice, geoEngagement or context DMO
Traffic sourcetraffic_source, collected_traffic_sourceEngagement or attribution DMO
E-commerceecommerce, itemsTransaction/product DMO
GA4 data lake object fields mapped to Data 360 data model object fields on the mapping canvas
Screenshot: GA4 schema mapping

Discussion

Comments are not configured for local development. They appear once the site owner connects GitHub Discussions (Giscus).

Support SF Guide

SF Guide is a free, independent guide to Salesforce Personalization, built and maintained in the open. If it saved you time on an implementation, a small contribution helps keep it current and ad-light.