Configure an identity namespace

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

The Adobe Experience Platform Identity Service sets a common visitor ID across all Adobe solutions in order to power Experience Cloud capabilities such as audience-sharing between solutions. 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.

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 be using the latest version of Visitor API or the Experience Cloud ID Service tag extension. See ID Migration for more information.


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. While you can use these steps to create a different identity for your own purposes, to learn the capabilities of the Identity Map in the Data Collection interface it is recommended that you first follow along to capture the example identity.

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.

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 you are using for the tutorial


    If you are the customer of a Platform-based application like Real-Time CDP, 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 following and select Create.

    Field Value
    Display name Luma CRM ID
    Identity symbol lumaCrmId
    Type Cross-Device ID

    Create Namespaces

    The Identity namespace populates in the Identities screen.

    Create Namespaces


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

Create the identity namespace in your production sandbox

Due to a current limitation in the Web SDK extension, identity namespaces must also be created in the production sandbox in order to use the namespace to send data to a development sandbox. So, if you have been using a development sandbox for this tutorial, please also create the Luma CRM ID namespace in your production sandbox.

Additional Resources

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

On this page