login Event

The login event tracks when a user successfully signs into their account. It’s a key signal for authenticated activity and user-level tracking across sessions.

This model captures the method and identifiers related to a successful login.

Properties

Name
event
Type
string
Description
Must be set to login.
Name
method
Type
string
Description
The login method used (e.g., email, google, facebook).
Name
user_id
Type
string
Description
Unique ID for the logged-in user.
Name
session_id
Type
string
Description
Current session ID.
Name
user_data.email_hash
Type
string
Description
Hashed email (SHA-256, lowercase, trimmed).
Name
user_data.phone_hash
Type
string
Description
Hashed phone number (SHA-256, lowercase, trimmed).

Push event to the dataLayer

dataLayer.push example

dataLayer.push({
  event: 'login',
  method: 'email',
  user_id: 'user-abc',
  session_id: 'session-4567',
  user_data: {
    email_hash: 'abc123hashedemailvalue',
    phone_hash: 'def456hashedphonevalue'
  }
});

Best Practices

Fire only after successful login.
Normalize and hash identifiers before sending.
Include method to help identify friction across login types.

Use Cases

The login event supports: