Skip to main content
The customer_details tracking event is used when a customer logs in on the site or the site is aware of who the customer is, such as when a user registers on the site. At least one of email, userid or accid must be sent:
  • If accid is sent, then userid will be ignored – as all subsequent events will be tracked against the account.
  • If userid is sent, then this will be taken as an identifier for the user across the site. Use this same identifier when the user logs in; makes an order; or in any offline orders that are submitted.
  • If neither accid or userid is sent, then email will be used as the unique identifier for the user. This should be used whenever the user logs in; makes an order; or in any offline orders that are submitted.
  • If accid or userid is set – and email is set as well – then the email address will just be stored against the user. It will be used if any Triggered Emails are sent.
  • Best practice is to send the userid (or accid if using accounts). This is because it will remain unique to that user – email addresses may well be changed over time.
  • The Id should match the Id sent in the user feed.
If you are passing groupid, then this must match one of the groups sent in the GroupPricing field in the Product Feed.

Properties

userid
string
A unique ID for the user
email
string
The users email address
accid
string
If the user is part of business account this value can be used to ensure customer specific account pricing, and personalization at the account level rather than the user level.
group_id
string
Optional user group. Used to support price banding (prices per user group)
firstname
string
First name of the user
lastname
string
Last name of the user
title
string
The prefix of the userExample: Mr

Example

{
  "userid": "USR123",
  "email": "fred@smith.com",
  "firstname": "Fred",
  "lastname": "Smith",
  "title": "Mr"
}

With Account and Group

{
  "accid": "ACCID123",
  "groupid": "group10",
  "email": "fred@smith.com",
  "firstname": "Fred",
  "lastname": "Smith",
  "title": "Mr"
}