Set up a schema and dataset
To ingest data into Adobe Experience Platform, you first must define which data you want to collect. All data ingested into Adobe Experience Platform must conform to a standard, denormalized structure for it be recognized and acted upon by downstream capabilities and features. Experience Data Model (XDM) is the standard framework that provides this structure in the form of schemas.
Once you have defined a schema, you use one or more datasets to store and manage the collection of data. A dataset is a storage and management construct for a collection of data (typically a table) that contains a schema (columns) and fields (rows).
All data that is ingested into Adobe Experience Platform must conform to a pre-defined schema before it can be persisted as a dataset.
Set up a schema
For this quick start, you want to collect some loyalty data, for example loyalty id, loyalty points, and loyalty status.
You first must define a schema that models this data.
To set up your schema:
-
In the Adobe Experience Platform UI, in the left rail, select Schemas within DATA MANAGEMENT.
-
Select Create schema.
. -
In the Select a class step of the Create schema wizard:
-
Select Individual Profile.
INFO
An Experience Event schema is used to model the behavior of a profile (like scene name, push button to add to cart). An Individual Profile schema is used to model the profile attributes (like name, email, gender). -
Select Next.
-
-
In the Name and review step of the Create schema wizard:
-
Enter a Schema display name for your schema and (optional) a Description.
-
Select Finish.
-
-
In the Structure tab of Example Schema:
-
Select + Add in Field groups.
Field groups are reusable collection of objects and attributes that allow you to easily extend your schemas.
-
In the Add fields groups dialog, select the Loyalty Details field group from the list.
You can select the preview button, to see a preview of the fields that are part of this field group.
Select Back to close the preview.
-
Select Add field groups.
-
-
Select + next to your schema name in the Structure panel.
-
In the Field Properties panel, enter
Identification
as the name, Identification as the Display name, select Object as the Type and select Profile Core v2 as the Field Group.This identification object adds identification capabilities to your schema. In your case, you want to identify loyalty information using the email address in your batch data.
Select Apply to add this object to your schema.
-
Select the email field in the identification object you just added, and select Identity and Email from the Identity namespace in the Field Properties panel.
You are specifying the email address as the identity the Adobe Experience Platform Identity service can use to combine (stitch) the behavior of profiles.
Select Apply. You see that a fingerprint icon appears in the email attribute.
-
Select the root level of your schema (with the schema name), then select the Profile switch.
You are prompted to enable the schema for profile. Once enabled, when data is ingested into datasets based on this schema, that data is merged into the Real-Time Customer Profile.
See Enable the schema for use in Real-Time Customer Profile for more information.
IMPORTANT
Once you save a schema enabled for profile, it can no longer be disabled for profile. -
Select Save to save your schema.
You have created a minimal schema that models the loyalty data you can ingest into Adobe Experience Platform . The schema allows profiles to be identified using the email address. By enabling the schema for profile, you ensure that data from your streaming source is added to the Real-Time Customer Profile.
See Create and edit schemas in the UI for more information on adding and removing field groups and individual fields to a schema.