xConnect - APIS to capture data across every screen, device & source
 
 
Let's start by defining xConnect: xConnect is that layer that you're going to use to interact with the experience data in xDB. This will make things much easier for you than executing queries directly against the data store.
 

Creating and Retrieving Contacts

One of the first things you’ll need to do with the API is learn how to create a new Contact and retrieve existing contacts. If you are gathering personal information about a customer, this will usually be tied to the xDB profile on the Contact. You may need custom facets to store your custom information.

In the following video, we walk through the basics of creating a new Contact and then retrieving that data using xConnect.

[View:https://www.youtube.com/watch?v=ab0FJq-b-yA:305:183]

Registering and Searching Interactions

Once you have Contacts created, you’ll want to be able to track the events your customers are triggering. For example, if a customer makes a purchase in the store, you will want to send this information to their xDB profile as an Interaction.

In the following video, we walk through the basics of registering a new interaction. We also take a look at how you can search through xConnect to find existing interactions.

[View:https://www.youtube.com/watch?v=wvhLoPgocrU:305:183]

Try it yourself

Work your way through the 5 series - xConnect tutorials. Use these step-by-step guides to help you learn the basics:

  1. xConnect tutorial #1: Create a contact and an interaction
  2. xConnect tutorial #2: Set contact and interaction facets
  3. xConnect tutorial #3: Get contacts
  4. xConnect tutorial #4: Search contacts and interactions
  5. xConnect tutorial #5: Create custom facets and events

You can also see the code used in the videos in my xConnect Tutorial GitHub repository:

Diving Deeper

The following documentation links will also help you get started using the xConnect API.