Add field groups to XDM schema

Last update: 2023-11-13
  • Created for:
  • Admin

One of the onboarding steps for using the Data Connection extension is to access the datastream workspace and create a datastream that is specific to Adobe Commerce. When you create that datastream, you must also select an XDM schema that represents the data you plan to ingest. This topic provides you with the field groups your XDM schema must include to successfully collect the data provided by the Adobe Commerce events.

  1. If you do not already have an XDM schema, create one. Otherwise, edit your existing XDM schema in the Adobe Experience Platform UI.

  2. Add the following Commerce-specific field groups:

    • Site Search
    • Visit Web Page
    • User Login Process
    • Reference Keys
    • Personal Contact Details
    • Commerce Details
    • Adobe Analytics ExperienceEvent Commerce (if you want to send data to Adobe Analytics)
    • Identity Map

    Do not set any Commerce-specific field groups as Primary identity. Doing so identifies the field as required and Experience Platform expects that field in every event. If that field is absent, data ingestion fails.

    Your XDM schema now contains Commerce-specific field groups so that the data collected from the Commerce events is represented in the XDM.

  3. Create a dataset based off the schema you created or updated.

    A dataset is a storage and management construct for a collection of data, typically a table, that contains a schema (columns) and fields (rows). Datasets also contain metadata that describes various aspects of the data they store.

  4. Create a datastream and select the XDM schema that contains the Commerce-specific field groups and the corresponding dataset.

    The datastream forwards the collected data to the dataset. The data is represented in the dataset based on the selected schema.

On this page