Skip to main content
Important: Please ensure your CMP configuration includes new Vendor ID 1469 for 1st Party data tracking. Additionally, include Vendor ID 301 if cookie sync is enabled. Learn more
This is a core function used to associate specific identifiers (like email, phone number, or your own internal IDs) with the current user’s session and subsequent activities tracked by the Zeotap SDK. Why use it?
  • User Stitching: Allows Zeotap to link user activity across different sessions or devices when a known identifier is provided.
  • Data Enrichment: Provides key identifiers needed for potential data enrichment processes.
  • Audience Building: Enables creating audiences based on specific known identifiers.
PersistenceIdentifiers set using setUserIdentities() are persisted (based on your persistenceInCookieStorage configuration) and automatically included in the user node of the payload for all subsequent events sent during the user’s session(s).

Understanding Identifier Types

You can send different categories of identifiers:
  1. Personal Identifiable Information (PII): Standardized identifiers like email or phone number. These can be sent raw or pre-hashed.
  2. Custom Identities: Your own first-party identifiers (e.g., crmId, loyaltyId). Hashing configurations don’t apply to these.

Choosing Your Hashing Strategy

Before using setUserIdentities, you must decide how PII (like email and phone numbers) will be handled regarding hashing. This choice affects your SDK configuration and the keys you use in the setUserIdentities call. Click on each scenario below for details:

Sending Raw Identifiers

View Example

Sending Pre-Hashed Identifiers

View Example

SDK Performs Hashing

View Example

PII Identifier Key Reference

Depracatedcellno_cc is depreacted. It is recommened to use cellno for all cellphone number related scenarios.
How to Use This Table:
  1. Identify the PII Property you want to send (e.g., Email, Cell Phone).
  2. Determine your Hashing Scenario:
    • Scenario 1 (Raw) or 3 (SDK Hashing): Look at the “Key to Use if Sending RAW” column. Use that key (e.g., email, cellno) and provide the raw value. Pay attention to the recommended format for cellno.
    • Scenario 2 (Pre-Hashed): Look at the “Key to Use if Sending PRE-HASHED” column. Choose the key that matches the exact hashing algorithm and format you used (e.g., email_sha256_lowercase, cellno_with_country_code_sha256) and provide the pre-computed hash value.
  3. Remember: For a single PII property (like email), you will use either the raw key or a hashed key in your setUserIdentities call, never both simultaneously for the same piece of information.

Custom Identities

You can include any other key-value pairs representing your own first-party identifiers. These are sent as-is and are not affected by the PII hashing configurations.
Last modified on June 25, 2026