Configure identity rules

This topic describes how to configure the identity rules for your organization's tenant.

Team members with an Organization Admin or Organization Owner role in Sitecore Cloud Portal can configure identity rules.

You can do this after your organization's tenant is created and before you start sending events to Sitecore CDP. We recommend you familiarize yourself with identity resolution before reading this topic.

Danger

If you want to make changes to your organization's identity rules that are already in use, we strongly recommend contacting Sitecore Support. This is to ensure that your changes will have the desired result and that Sitecore Support is aware that they need to reindex the guest profiles using the new identity rules to avoid the creation of duplicate guest profiles when existing customers visit your site.

To configure your organization's identity rules:

On the navigation menu, click , Identity rules.
From the Identity Rules screen, click Add Rule.

Warning

If you want to add more than one identity rule, you must add them in the order you want them prioritized, starting with the identity rule with the highest priority. If you want to change the priority of the identity rules, you must delete the identity rules and add them again in order of priority.
Complete the following fields on the Add Identity Rule screen:
- Rule name - enter the name of the identity rule.
- Identifier provider - enter the required provider attribute that Sitecore Personalize uses to identify the guest. For example, CRM_ID. This must be the same name as the provider attribute in the IDENTITY event that your organization sends to Sitecore Personalize. If it is not the same, Sitecore Personalize can not successfully evaluate identity rules. To review examples, see Identity rules using unique identifiers.
Click Save. The new identity rule takes a few minutes to become effective. This means if you start sending IDENTITY events to Sitecore Personalize immediately after adding a new rule, Sitecore Personalize cannot identify the guest using the new rule until a few minutes have passed.
To add additional identity rules, click Add Rule. You can enter up to five identity rules. Most organizations use one or two identity rules.

In the following image, the organization uses two identity rules:
- CRM number - with CRM_ID as the identifier.provider.
- Loyalty number - with loyalty_ID as the identifier.provider.

Using this same example, your organization must send an IDENTITY event that contains a value for either the CRM_ID or loyalty_ID attributes, for Sitecore Personalize to identify a guest. If Sitecore Personalize does not find a match with the first listed identity rule, it evaluates the next, and so on.

If a guest profile is matched, Sitecore Personalize assigns a guest type of customer. If no guest profiles are matched, Sitecore Personalize assigns or retains a guest type of visitor.

The following IDENTITY event meets the required identity rules because it contains at least one of the required provider attributes, CRM_ID or loyalty_ID:

RequestResponse

{
   "channel":"WEB",
   "type":"IDENTITY",
   "language":"EN",
   "currency":"EUR",
   "page":"home page",
   "pos":"myretailsite.com",
   "browser_id":"56860bff-94ba-4d84-aa37-2b5a83d5411b",
   "identifiers":[
      {
         "provider":"CRM_ID",
         "id":"123456"
      },
      {
         "provider":"loyalty_ID",
         "id":"xni8934y77"
      }
   ]
}

Do you have some feedback for us?

If you have suggestions for improving this article,