ADD_CONTACTS event
If your organization sends orders using multiple events, the ADD_CONTACTS event is required to identify the guest.
If your organization sends orders using a single event, you do not use the ADD_CONTACTS event.
To send an ADD_CONTACTS event, use the following required attributes:
Attribute |
Type |
Description |
Example |
---|---|---|---|
|
string (uppercase) |
The touchpoint where the user interacts with your brand. |
|
|
string (uppercase) |
The type of the event that takes place when the user interacts with your brand. |
|
|
string (uppercase ISO 639-1) |
The language the user is using your app in. |
|
|
string (uppercase ISO 4217) |
The alphabetic currency code of the currency the user is using in your app. |
|
|
string |
The name of the webpage where the interaction with your brand takes place. This is a custom value of your choice. |
|
|
string |
The name of the point of sale where the interaction with your brand takes place. |
|
|
string |
The browser ID. |
|
|
array of objects |
Contact details. |
N/A |
The contact
array of objects:
Attribute |
Type |
Description |
Example |
Required/optional |
---|---|---|---|---|
|
string (title case) |
The title of the contact. |
|
Optional |
|
string (title case recommended) |
The first name of the contact. |
|
Optional |
|
string (title case recommended) |
The last name of the contact. |
|
Optional |
|
string |
The mobile number of the contact. |
|
Optional |
|
string |
The phone number of the contact. |
|
Optional |
|
array of strings (title case recommended) |
The street address of the contact. |
|
Optional |
|
string (title case recommended) |
The city address of the contact. |
|
Optional |
|
string (title case recommended) |
The state address of the contact. |
|
Optional |
|
string (uppercase ISO 3166-1 alpha-2) |
The country code of the contact. |
|
Optional |
|
string (uppercase recommended) |
The postcode of the contact. |
|
Optional |
|
string (ISO 8601) |
The date of birth of the contact. |
|
Optional |
|
string (lowercase recommended) |
The email address of the contact. |
Optional | |
|
string (lowercase) |
The gender of the contact. |
|
Optional |
|
array of objects |
The identifiers that are used to identify the users of your app. |
N/A |
Required |
The contact.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 CDP, 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 |
{
"channel": "MOBILE_APP",
"type": "ADD_CONTACTS",
"language": "EN",
"currency": "EUR",
"page": "home page",
"pos": "myretailsite/ireland",
"browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925",
"contact": [
{
"title": "Mr",
"firstname": "Jack",
"lastname": "Smith",
"mobile": "(+353)1234567",
"phone": "(+353)1234568",
"street": [
"123 Fake Street"
],
"city": "Dublin",
"country_code": "IE",
"postal_code": "1234",
"dob": "1975-04-23T00:00",
"email": "[email protected]",
"gender": "male",
"identifiers": [
{
"provider": "BXLP",
"id": "123456",
"expiryDate": "2024-01-01T16:17:16.000Z",
}
]
}
]
}
The ADD_CONTACTS event is required to create an order in Sitecore CDP. The contact is the owner of the order, meaning orders cannot exist in Sitecore CDP without a contact. The contact on the order must be a customer guest_type
.
To send an ADD_CONTACTS event, use the following required attributes:
Attribute |
Type |
Description |
Example |
---|---|---|---|
|
string (uppercase) |
The touchpoint where the user interacts with your brand. |
|
|
string (uppercase) |
The type of the event that takes place when the user interacts with your brand. |
|
|
string (uppercase ISO 639-1) |
The language the user is using your app in. |
|
|
string (uppercase ISO 4217) |
The alphabetic currency code of the currency the user is using in your app. |
|
|
string |
The name of the webpage where the interaction with your brand takes place. This is a custom value of your choice. |
|
|
string |
The name of the point of sale where the interaction with your brand takes place. |
|
|
string |
The browser ID. |
|
|
array of objects |
Contact details. |
N/A |
The contact
array of objects:
Attribute |
Type |
Description |
Example |
Required/optional |
---|---|---|---|---|
|
string (title case) |
The title of the contact. |
|
Required |
|
string (title case recommended) |
The first name of the contact. |
|
Required |
|
string (title case recommended) |
The last name of the contact. |
|
Required |
|
string |
The mobile number of the contact. |
|
Optional |
|
string |
The phone number of the contact. |
|
Optional |
|
array of strings (title case recommended) |
The street address of the contact. |
|
Optional |
|
string (title case recommended) |
The city address of the contact. |
|
Optional |
|
string (title case recommended) |
The state address of the contact. |
|
Optional |
|
string (uppercase ISO 3166-1 alpha-2) |
The country code of the contact. |
|
Optional |
|
string (uppercase recommended) |
The postcode of the contact. |
|
Optional |
|
string (ISO 8601) |
The date of birth of the contact. |
|
Optional |
|
string (lowercase recommended) |
The email address of the contact. |
Required: If your organisation uses the email attribute to determine guest identity. Optional: If your organisation uses identifier(s) to determine guest identity. | |
|
string (lowercase) |
The gender of the contact. |
|
Optional |
|
array of objects |
The identifiers that are used to identify the users of your app. |
N/A |
Required: If your organisation uses identifier(s) to determine guest identity. Optional: If your organisation uses the email attribute to determine Guest identity. |
The contact.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 CDP, 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 |
You do not have to include both the contact.identifiers
array and contact.email
attribute when sending an ADD_CONTACTS event. Your organization either uses the contact.identifiers
array or the contact.email
attribute to determine the identity of the guest. If your organization uses the contact.email
attribute to determine the guest's identity, then the contact.identifiers
array is ignored. If your organization uses the contact.identifiers
array to determine the guest's identity, then sending the contact.email
attribute is optional.
{
"channel": "MOBILE_APP",
"type": "ADD_CONTACTS",
"language": "EN",
"currency": "EUR",
"page": "home page",
"pos": "myretailsite/ireland",
"browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925",
"contact": [
{
"title": "Mr",
"firstname": "Jack",
"lastname": "Smith",
"mobile": "(+353)1234567",
"phone": "(+353)1234568",
"street": [
"123 Fake Street"
],
"city": "Dublin",
"country_code": "IE",
"postal_code": "1234",
"dob": "1975-04-23T00:00",
"email": "[email protected]",
"gender": "male",
"identifiers": [
{
"provider": "BXLP",
"id": "123456",
"expiryDate": "2024-01-01T16:17:16.000Z",
}
]
}
]
}