Identity

Turn your website traffic into known people and companies.

ListenLayer automatically detects identity from forms, chat widgets, scheduling tools, and eCommerce transactions. You can also identify visitors programmatically using the SDK.

---

Automatic Identity Detection

ListenLayer detects identity automatically from multiple sources with varying confidence levels:

Source	Confidence	Description
form	High	Email captured from form submission
chat	High	Identity from chat pre-chat form
scheduling	High	Details from booking confirmation
ecommerce	High	Customer info from purchase
network	Medium	PII detected in XHR/fetch requests
datalayer	Medium	Identity pushed to dataLayer
urlParam	Medium	Email in URL parameters
video	Low	Video service email capture
custom	Low	Customer-provided via dataLayer

More details coming soon.

---

Identifying People with Code

Use _ll.identify() to associate a visitor with known identity information:

// Basic identify with email
_ll.identify({
  email: '[email protected]'
});

// Full identity with all properties
_ll.identify({
  email: '[email protected]',
  name: 'John Doe',
  phone: '[phone]',
  company: 'Acme Corp',
  user_id: '12345',
  plan: 'enterprise'
});

When to Use

Call _ll.identify() when you know who the visitor is:

• After login or signup

• When loading a page for an authenticated user

• After a form submission with identity fields

• When syncing with your backend user data

Identity Properties

Property	Description
email	User's email address (primary identifier)
name	Full name
phone	Phone number
company	Company name
user_id	Your system's user ID
*	Any additional custom properties

Identity persists across sessions. Once identified, the visitor remains associated with their identity on future visits.

---

Identity from DataLayer

ListenLayer also detects identity pushed to the dataLayer:

// Standard identity fields
dataLayer.push({
  user_id: '12345',
  email: '[email protected]'
});

// Or nested in a user object
dataLayer.push({
  user: {
    id: '12345',
    email: '[email protected]',
    name: 'John Doe'
  }
});

More details coming soon.