Configure an identity namespace

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.

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: / 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


You must have already completed the previous lessons:

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:

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
    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

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

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