DocumentationExperience PlatformWeb SDK Tutorial

Configure an identity namespace

Last update: Mon May 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Beginner
  • Intermediate
  • Developer

Learn how to configure identity namespaces to use with Adobe Experience Platform Web SDK.

The Adobe Experience Cloud Identity Service sets a common visitor ID (the ECID) across SDK-based Adobe applications to power Experience Cloud capabilities such as audience-sharing between applications. You can also send your own customer IDs to the Service to enable cross-device targeting and integrations with other systems, such as your Customer Relationship Management (CRM) system.

The Adobe Experience Platform Identity Service (yes, there are two!) uses the ECIDs and customer IDs to generate identity graphs, allowing you to merge attributes and behaviors into Real-Time Customer Profiles.

NOTE
A custom identity namespace is not required to implement Adobe Analytics, Adobe Target, or Adobe Audience Manager with Web SDK (authenticated identities can be passed in the data object instead of the xdm object as you will see later). Identity namespaces are required for Platform-native applications like Journey Optimizer, Real-Time Customer Data Platform, Customer Journey Analytics. While you may decide not to use an identity namespace in your own implementation, you are expected to do so as part of this tutorial.
NOTE
For demonstration purposes, the exercises in this lesson have you capture the identity details of a fictional customer logged into the Luma Demo Site using the credentials, user: test@adobe.com / password: test.

Learning objectives

At the end of this lesson, you will be able to:

  • Understand identity namespaces
  • Create a custom identity namespace to capture an internal CRM Id

Prerequisites

You must have already completed the previous lessons:

IMPORTANT
The Experience Cloud ID Extension is not needed when implementing Adobe Experience Platform Web SDK, as the Web SDK JavaScript library contains the Visitor ID service functionality.
If your website is already using the Experience Cloud ID Service on your website—either through Visitor API or the Experience Cloud ID Service tag extension—and you would like to continue using it while migrating to Adobe Experience Platform Web SDK, you must use the latest version of Visitor API or the Experience Cloud ID Service tag extension. See ID Migration for more information.

Create an identity namespace

In this exercise, you create an identity namespace for Luma’s custom identity field, lumaCrmId. Identity namespaces play a critical role in building real-time customer profiles, as two matching values in the same namespace allow two data sources to form an identity graph.

Before you begin the exercises, watch this short video to learn more about identity in Adobe Experience Platform:

https://video.tv.adobe.com/v/27841?learn=on

Now, create a namespace for the Luma CRM ID:

  1. Open the Data Collection interface

  2. Select the sandbox that you are using for the tutorial

    note note
    NOTE
    If you are the customer of a Platform-based application like Real-Time CDP or Journey Optimizer, we recommend using a development sandbox for this tutorial. If you are not, use the Prod sandbox.

  3. Select Identities in the left navigation

  4. Select Browse

    A list of identity namespaces appears in the main interface of the page, showing their names, identity symbols, last updated date, and whether they are standard or custom namespaces. The right rail contains information on Identity graph strength.

  5. Select Create identity namespace

    View identities

  6. Provide details as follows and select Create.

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Field Value
    Display name Luma CRM ID
    Identity symbol lumaCrmId
    Type Individual cross-device ID

    Create Namespaces

    The Identity namespace populates in the Identities screen.

    Create Namespaces

NOTE
In the Create Identities lesson, you will learn how to use this namespace when sending identities to Platform Edge Network.

Now that identities are in place, the datastream can be configured.

Next: Configure a datastream

NOTE
Thank you for investing your time in learning about Adobe Experience Platform Web SDK. If you have questions, want to share general feedback, or have suggestions on future content, please share them on this Experience League Community discussion post
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4