Create schemas and datasets

The Postman collection is referenced throughout the article using the associated calls by number. More details on installing and using the Postman collection are available on the Github README page. There are also sample datasets of loyalty and profile data.

Schemas

A schema is a set of rules that represent and validate the structure and format of data. At a high level, schemas provide an abstract definition of a real-world object (such as a person) and outline what data should be included in each instance of that object (such as first name, last name, birthday, and so on). Schemas can be created in the UI or using the Experience Platform APIs.

See this documentation for more details.

Create a schema

Partners can build a schema using the UI by following this tutorial. This example uses the loyalty program profile schema. While the example is a profile schema, event-based schemas can be used using a similar process.

To use the APIs, partners must have an existing Adobe I/O integration with Experience Platform permissions enabled. See this guide to create an I/O integration.

Then visit this link to learn how to build schemas using the API.

To create a schema via Postman, use the calls contained in folders 1: Create Schema, 1a: Create Schema for PROFILE data OR 1b: Create Schema for EVENT data.

Datasets

All data that is brought into Adobe Experience Platform is contained in datasets. 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.

Catalog Service is the system of record for data location and lineage within Experience Platform, and is used to create and manage datasets. Catalog tracks the metadata for each dataset, which includes a reference to the Experience Data Model (XDM) schema the dataset conforms to (explained in the next section) and the number of records ingested into that dataset.

Go here for a detailed dataset overview.

Create a dataset

Create a dataset via the UI:

Go here for a dataset user guide.

Create a dataset using the APIs.

To create a dataset via Postman, use folders 2: Create Dataset, 2a: Create dataset for PROFILE data OR 2b: Create dataset for EVENT data.

Schema and dataset best practices for partners