Create an XDM schema

Learn how to create an XDM schema for mobile app events.

Standardization and interoperability are key concepts behind Adobe Experience Platform. Experience Data Model (XDM), driven by Adobe, is an effort to standardize customer experience data and define schemas for customer experience management.

What are XDM schemas?

XDM is a publicly documented specification designed to improve the power of digital experiences. It provides common structures and definitions that allow any application to communicate with Platform services. By adhering to XDM standards, all customer experience data can be incorporated into a common representation that can deliver insights in a faster, more integrated way. You gain valuable insights from customer actions, define customer audiences through segments, and use customer attributes for personalization purposes.

Experience Platform uses schemas to describe the structure of data in a consistent and reusable way. By defining data consistently across systems, it becomes easier to retain meaning and therefore gain value from data.

Before data can be ingested into Platform, a schema must be composed to describe the data’s structure and provide constraints to the type of data that can be contained within each field. Schemas consist of a base class and zero or more schema field groups.

For more information on the schema composition model, including design principles, and best practices, see the basics of schema composition or the playlist Model Your Customer Experience Data with XDM.

TIP
If you’re familiar with Analytics Solution Design Reference (SDRs), you can think of a schema as a more robust SDR. See Create and maintain a Solution Design Reference (SDR) Document for more information.

Prerequisites

To complete the lesson, you must have permission to create an Experience Platform schema.

Learning objectives

In this lesson, you will:

  • Create a schema in the Data Collection interface
  • Add a standard field group to the schema
  • Create and add a custom field group to the schema
  1. Log in to the Adobe Experience Cloud.

  2. Make sure you are in the Experience Platform sandbox you are using for this tutorial.

  3. Open the app switcher App Switcher (at the top right),

  4. Select Data Collection from the menu.

    Login to Experience Cloud

    note note
    NOTE
    Customers of Platform-based applications like Real-Time CDP should use a development sandbox for this tutorial. Other customers use the default production sandbox.
  5. Select Schemas under Data Management in the left rail.

    tags home screen

You are now on the main schemas page and are presented with a list of any existing schemas. You can also see tabs corresponding to the core building blocks of a schema:

  • Field groups are reusable components that define one or more fields to capture specific data, such as personal details, hotel preferences, or address.
  • Classes define the behavioral aspects of the data that the schema contains. For example: XDM ExperienceEvent captures time-series, event data and XDM Individual Profile captures attribute data about an individual.
  • Data types are used as reference field types in classes or field groups in the same way as basic literal fields.

The above descriptions are a high-level overview. For more details, see the Schema building blocks video or read Basics of schema composition in the product documentation.

In this tutorial, you use the Consumer Experience Event field group and create a custom one to demonstrate the process.

NOTE
Adobe continues to add more standard field groups and they should be used whenever possible since these fields are implicitly understood by Experience Platform services and provide greater consistency when used across Platform components. Using standard field groups provides tangible benefits such automatic mapping in Analytics and AI features in Platform.

Luma app schema architecture

In a real-world scenario, the schema design process might look like this:

  • Gather business requirements.
  • Find prebuilt field groups to cover as many requirements as possible.
  • Create custom field groups for any gaps.

For learning purposes, you use prebuilt and custom field groups.

  • Consumer Experience Event: Prebuilt field group that has many common fields.
  • App Information: Custom field group designed to mimic TrackState/TrackAction Analytics concepts.

Create a schema

  1. Select Create Schema.

  2. In the Select a class step of the Create schema wizard, select Experience Event underneath Select a base class for this schema.

  3. Select Next.

    Schema Wizard base class

  4. In the Name and review step of the Create schema wizard, enter a Schema display name, for example Luma Mobile Event Schema and a Description, for example Schema for Luma mobile app experience events.

    note note
    NOTE
    If you are going through this tutorial with multiple persons on a single sandbox or you are using a shared account, consider appending or prepending an identification as part of your naming conventions. For example, instead of Luma Mobile App Event Schema, use Luma Mobile App Event Schema - Joe Smith. See also the note in Overview.
  5. Select Finish to finish the wizard.

    Schema name and review

  6. Select Plus Add next to Field groups.

    Add field group

  7. Search for Consumer Experience Event.

  8. Select Preview to preview the fields and/or read the description for more details before selecting a field group.

  9. Select Consumer Experience Event.

  10. Select Add field groups.

    Selecting field group

    You are brought back to the main schema composition screen where you can see all the available fields.

  11. Select Save.

NOTE
Keep in mind that you do not have to use all the fields in a group. You can also remove fields to help keep the schema concise and understandable. If it’s helpful, you can think of a schema as an empty data layer. In your app, you populate the relevant values at the appropriate time.

The Consumer Experience Event field group has a data type called Web information, which describes events like page view and link clicks. At the time of writing, there isn’t a mobile app parity to this feature, so you are going to create your own.

Create a custom data type

You begin by creating a custom data type describing the two events:

  • Screen view
  • App interaction
  1. Select the Data types tab.

  2. Select Create data type.

    Selecting data type menu

  3. Provide a Display name and Description, for example App Information and Custom data type describing "Screen Views" & "App Actions"

    Providing name & description

    note tip
    TIP
    Always use readable, descriptive display names for your custom fields, as this practice makes them more accessible to marketers when the fields surface in downstream services like the segment builder.
  4. To add a field, select the Plus button.

  5. This field is a container object for app interaction, so provide a camel-case Field name appInteraction, Display name App Interaction, and select Object from the Type list.

  6. Select Apply.

    Adding new app action event

  7. To measure how often an action has occurred, add a field by selecting the Plus button next to the appInteraction object you created.

  8. Give it a camel-case Field name appAction, Display name of App Action and Type Measure.

    This step would be the equivalent of a success event in Adobe Analytics.

  9. Select Apply.

    Adding action name field

  10. Add a field describing the type of interaction by selecting the Plus button next to the appInteraction object.

  11. Give it a Field name name, Display name of Name and Type String.

    This step is the equivalent of a dimension in Adobe Analytics.

    Selecting apply

  12. Scroll to the bottom of the right rail and select Apply.

  13. To create an appStateDetails object containing a Measure field called screenView and two String fields called screenName and screenType, follow the same steps as you did when creating the appInteraction object.

  14. Select Save.

    Final state of data type

Add a custom field group

Now add a custom field group using your custom data type:

  1. Open the schema that you created earlier in this lesson.

  2. Select Plus Add next to Field groups.

    Adding new field group

  3. Select Create new field group.

  4. Provide a Display name and Description, for example, App Interactions and Fields for app interactions.

  5. Select Add field groups.

    Providing name & description

  6. From the main composition screen, select App Interactions.

  7. Add a field to the root of the schema by selecting the Plus button next to the schema name.

  8. In the right rail, provide a Field name of appInformation, a Display name of App Information, and a Type of App Information.

  9. Select App Interactions from the Field Group drop down, to assign the fields to your new field group.

  10. Select Apply.

  11. Select Save.

    Selecting apply

NOTE
Custom field groups are always placed under your Experience Cloud Org identifier.
SUCCESS
You now have a schema to use for the remainder of the tutorial.
Thank you for investing your time in learning about Adobe Experience Platform Mobile SDK. If you have questions, want to share general feedback, or have suggestions on future content, share them on this Experience League Community discussion post.

Next: Create a datastream

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b