[Beta]{class="badge informative"}

Namespace priority

AVAILABILITY
This feature is not yet available; the beta program for identity graph linking rules is expected to start in July on development sandboxes. Contact your Adobe account team for information on the participation criteria.

Every customer implementation is unique and tailored to meet a particular organization’s goals, and as such, the importance of a given namespace varies from customer to customer. Real-world examples include:

  • On one hand, you might deem the Email namespace to represent a person entity and thus be unique per person. On the other hand, another customer might consider the Email namespace as an unreliable identifier and therefore, they may allow a single CRM ID to be associated to multiple identities with the Email namespace.
  • You might collect online behavior using a “Login ID” namespace. This Login ID could have a 1:1 relationship with the CRM ID, which then stores attributes from a CRM system and may be considered the most important namespace. In this case, you are then determining that the CRM ID namespace is a more accurate representation of a person, while the Login ID namespace is the second most important.

You must make configurations in Identity Service that reflects the importance of your namespaces as this influences how profiles are formed and segmented.

Determine your priorities

Determination of namespace priority is based on the following factors:

Identity graph structure

If your organization’s graph structured is layered, then namespace priority should reflect this so that the correct links are removed in the case of graph collapse.

TIP
  • “Graph collapse” refers to scenarios where multiple disparate profiles are inadvertently merged together into a single identity graph.

  • A layered graph refers to identity graphs that have multiple levels of links. View the image below for an example of a graph with three layers.

A diagram of graph layers

Semantic meaning of the namespace

An identity represents a real-world object. There are three objects that are represented in the identity graph. In order of importance, they are:

  • People (Cross-device, Email, Phone number)
  • Hardware device
  • Web browser (Cookie)

Person namespaces are relatively immutable compared to hardware devices (such as IDFA, GAID), which are relatively immutable compared to web browsers. Basically, you (person) will always be a single entity, who can have multiple hardware devices (phone, laptop, tablet, etc.), and use multiple browsers (Google Chrome, Safari, FireFox, etc.)

Another way to approach this topic is through cardinality. For a given person entity, how many identities will be created? In most cases, a person will have one CRM ID, a handful of hardware device identifiers (IDFA/GAID resets should not happen often), and even more cookies (an individual could conceivably brows on multiple devices, use incognito mode, or reset cookies at any given time). Generally, lower cardinality indicates a namespace with a higher value.

Validate your namespace priority settings

Once you have an idea of how you will prioritize your namespaces, you can use the Graph Simulation tool to test out various graph collapse scenarios and ensure that your priority configurations are returning the expected graph results. For more information, read the guide on using the Graph Simulation tool.

Configure namespace priority

Namespace priority can be configured using Identity Settings. In the Identity Settings interface, you may drag and drop a namespace to determine its relative importance.

IMPORTANT
You cannot prioritize device/cookie namespaces over person namespaces. This restriction ensures that misconfigurations does not happen.

Namespace priority usage

Currently, namespace priority influences system behavior of Real-Time Customer Profile. The diagram below illustrates this concept. For more information, read the guide on Adobe Experience Platform and applications architecture diagrams.

A diagram of namespace priority application scope

Identity Service: Identity optimization algorithm

For relatively complex graph structures, namespace priority plays an important role in ensuring that the correct links are removed when graph collapse scenarios happen. For more information read the identity optimization algorithm overview.

Real-Time Customer Profile: primary identity determination for experience events

  • For experience events, once you have configured Identity Settings for a given sandbox, the primary identity will be determined by the highest namespace priority going forward.

    • This is because experience events are dynamic in nature. An identity map may contain three or more identities, and namespace priority ensures that the most important namespace is associated to the experience event.
  • As a result, the following configurations will no longer be used by Real-Time Customer Profile:

    • “Primary” checkbox on data element type in WebSDK.
    • Any fields marked as primary identity on an XDM Experience Event Class schema.
    • Default primary identity settings in the Adobe Analytics source connector (ECID or AAID).
  • On the other hand, namespace priority does not determine primary identity for profile records.

    • For profile records, you may use the schemas workspace in the Experience Platform UI to define your identity fields, including the primary identity. Read the guide on defining identity fields in the UI for more information.
NOTE
  • Namespace priority is a property of a namespace. It is a numerical value assigned to a namespace to indicate its relative importance.

  • Primary identity is the identity in which a profile fragment is stored against. A profile fragment is a record of data that stores information about a certain user: attributes (usually ingested via CRM records) or events (usually ingested from experience events or online data).

Example graph scenario

This section provides an example of how priority configuration can affect your data.

Suppose that the following configurations are established for a given sandbox:

Namespace
Real-world application of the namespace
Priority
CRMID
User
1
IDFA
Apple hardware device (iPhone, IPad, etc.)
2
GAID
Google hardware device (Google Pixel, Pixelbook, etc.)
3
ECID
Web browser (Firefox, Safari, Google Chrome, etc.)
4
AAID
Web browser
5

Given the configurations outlined above, user actions and determination of primary identity, will be resolved as such:

User action (Experience event)
Authentication state
Data source
Identity map
Primary identity (primary key of profile fragment)
View credit card offer page
Unauthenticated (anonymous)
Web SDK
ECID
View help page
Unauthenticated
Mobile SDK
IDFA
View checking account balance
Authenticated
Web SDK
CRM ID
Sign up for home loan
Authenticated
Analytics source connector
CRM ID
Transfer $1,000 from checking to savings
Authenticated
Mobile SDK
CRM ID

Segmentation Service: segment membership metadata storage

A diagram of segment membership storage

For a given merged profile, segment memberships will be stored against the identity with the highest priority namespace.

For example, assume that there are two profiles:

  • The first profile represents John.
  • The second profile represents Jane.

If the John and Jane share a device, then the ECID (web browser) transfers from one person to another. However, this does not influence the segment membership information stored against John and Jane.

If the segment qualification criteria were solely based on anonymous events stored against the ECID, then Jane would qualify for that segment

Implications on other Experience Platform services implications

This section outlines how namespace priority can affect other Experience Platform services.

Advanced data lifecycle management

Data hygiene record delete requests functions in the following manner, for a given identity:

  • Real-Time Customer Profile: Deletes any profile fragment with specified identity as primary identity. The primary identity on Profile will now be determined based on namespace priority.
  • Data lake: Deletes any record with the specified identity as primary identity.

For more information, read the advanced lifecycle management overview.

Computed attributes

Computed attributes does not use namespace priority to compute values. If you are using computed attributes, you must ensure that the CRM ID is designated as your primary identity for WebSDK. This limitation is expected to be resolved in August 2024.

For more information, read the computed attributes UI guide.

Data lake

Data ingestion to data lake will continue to honor the primary identity settings configured on Web SDK and schemas.

Data lake will not determine primary identity based on namespace priority. For example, Adobe Customer Journey Analytics will continue to use values in the identity map even after namespace priority is enabled (such as, adding a dataset to a new connection), because Customer Journey Analytics consumes their data from data lake.

Experience Data Model (XDM) Schemas

Any schema that is not an XDM Experience Event, such as XDM Individual Profiles, will continue to honor any fields that you mark as an identity.

For more information on XDM schemas, read the schemas overview.

Intelligent services

When selecting your data, you will need to specify a namespace, which will be used to determine the events that compute scores and the events that store the computed scores. You are recommended to select the namespace that represents a person.

  • If you are collecting web behavior data using WebSDk, you are recommended to choose the CRM ID namespace within the identity map.
  • If you are collecting web behavior data using the Analytics source connector, then you should select the identity descriptor (CRM ID).

This configuration results in computing scores only using authenticated events.

For more information on, read the documents on Attribution AI and Customer AI.

Privacy Service

Privacy Service deletion requests function in the following manner, for a given identity:

  • Real-Time Customer Profile: Deletes any profile fragment with specified identity value as primary identity. The primary identity on Profile will now be determined based on namespace priority.
  • Data lake: Deletes any record with the specified identity as primary or secondary identity.

For more information, read the Privacy service overview.

recommendation-more-help
64963e2a-9d60-4eec-9930-af5aa025f5ea