Datalyr starts with an anonymous visitor. When your application knows who that visitor is, identify attaches a stable customer ID so later events and eligible journey context can be joined.
Identify at a trusted moment
Call identify after signup, login, or another verified identity moment. Prefer your immutable internal user ID over an email address.
Email and plan are traits. usr_4821 is the primary ID. If an email changes, the user remains the same.
Call the SDK’s reset or logout method when someone logs out or switches accounts. This is essential on shared devices.
Automatic identity settings
Under Settings → Identity & Attribution, Datalyr can expose these web controls:
- Auto Identify captures email from supported form submissions and Shopify flows.
- Shopify cart attribution stamps supported visitor and click context into the cart for guest checkout attribution.
- CheckoutChamp domains lists checkout hosts that should participate in the supported bridge.
- Honor Global Privacy Control is on by default.
- Honor Do Not Track is off by default.
- Strict privacy mode disables auto-identify and applies conservative collection.
Sensitive workspaces use safer defaults. Review the effective label shown by each setting rather than assuming the default.
Verify identity
- Start a private session and browse anonymously.
- Sign up or log in.
- Open Users and search for the stable ID.
- Confirm the earlier visit and later known activity form the expected journey.
- Log out, then confirm a new account does not inherit the previous identity.
Use alias only when you know two IDs belong to the same person. Never join identities based only on IP, device, name, or a similar attribute.
