IDENTITY event
An IDENTITY event contains data that enables Sitecore Personalize to perform identity resolution. When Sitecore Personalize receives an IDENTITY event, it runs a linking algorithm to try to match guest data from separate guest profiles, based on your organization's identity rules. We recommend that you learn about identity resolution in Sitecore Personalize before you start sending IDENTITY events.
You can pass personally identifiable information (PII) to Sitecore Personalize in an IDENTITY
event using the following options:
-
To use PII data to perform identity resolution, you must send PII data using the
identifiers
object. For example, you can use a guest's email address to perform identity resolution. To do this, send theemail
attribute in theidentifiers
object. After Sitecore Personalize receives the IDENTITY event, it adds theidentifiers
object to the guest profile, to use for identity resolution in the future. -
To pass PII data to Sitecore Personalize so that it is available as supplementary, additional information in the guest profile, send PII data outside the
identifiers
object.
You must capture IDENTITY events wherever in the site that the guest provides data that might help identify them. It is common for a single browser session to have multiple IDENTITY events.
To send an IDENTITY event, use the following attributes:
Attribute |
Type |
Description |
Example |
Required/optional |
---|---|---|---|---|
|
string (uppercase) |
The touchpoint where the user interacts with your brand. |
|
Required |
|
string (uppercase) |
The type of the event that takes place when the user interacts with your brand. |
|
Required |
|
string (uppercase ISO 639-1) |
The language the user is using your app in. |
|
Required |
|
string (uppercase ISO 4217) |
The alphabetic currency code of the currency the user is using in your app. |
|
Required |
|
string |
The name of the webpage where the interaction with your brand takes place. This is a custom value of your choice. |
|
Required |
|
string |
The name of the point of sale where the interaction with your brand takes place. |
|
Required |
|
string |
The browser ID. |
|
Required |
|
string (lowercase recommended) |
The email address of the guest. |
Optional | |
|
string (title case) |
The title of the guest. |
|
Optional |
|
string (title case recommended) |
The first name of the guest. |
|
Optional |
|
string (title case recommended) |
The last name of the guest. |
|
Optional |
|
string |
The gender of the guest. |
|
Optional |
|
string (ISO 8601) |
The date of birth of the guest. |
|
Optional |
|
string |
The mobile number of the guest. |
|
Optional |
|
string |
The phone number of the guest. |
|
Optional |
|
array of strings (title case recommended) |
The street address of the guest. |
|
Optional |
|
string (title case recommended) |
The city address of the guest. |
|
Optional |
|
string (title case recommended) |
The state address of the guest. |
|
Optional |
|
string (uppercase ISO 3166-1 alpha-2) |
The country address of the guest. |
|
Optional |
|
string |
The postal code of the guest. |
|
Optional |
|
array of objects |
The identifiers that are used to identify the users of your app. |
N/A |
Required |
The identifiers
array of objects:
Attribute |
Type |
Description |
Example |
Required/optional |
---|---|---|---|---|
|
string |
The unique guest identifier provided by your organization's identity system, such as a Customer Relationship Management (CRM) system. |
|
Required |
|
string |
The name of your organization's identity system, external to Sitecore Personalize, that provided the unique guest identifier. |
|
Required |
|
string (ISO 8601) |
The date the unique guest identifier expires. This is determined by your organization's identity system. |
|
Optional |
identifiers
{
"channel": "MOBILE_APP",
"type": "IDENTITY",
"language": "EN",
"currency": "EUR",
"page": "home",
"pos": "myretailsite/ireland",
"browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925",
"identifiers": [{
"provider": "BXLP",
"id": "123456"
}]
}
identifiers
and personally identifiable information (PII){
"channel": "MOBILE_APP",
"type": "IDENTITY",
"language": "EN",
"currency": "EUR",
"page": "home",
"pos": "myretailsite/ireland",
"browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925",
"identifiers": [
{
"id": "123456",
"provider": "BXLP"
}
],
"email": "[email protected]",
"firstname": "Jane",
"lastname": "Doe"
}