Two ways a visitor gets identified
Radar has no separate
identify method. Identity travels on your custom events, as ordinary properties with reserved names.Identify through Stripe
When Stripe is connected, each paying customer is identified automatically. Radar takes the email and the name from the payment and links them to the visitor’s session. You have nothing to send. This covers customers who pay on the Stripe Checkout page, the payment page hosted by Stripe. If your site has its own payment page, you also send apayment event. See track revenue.
Identify with a custom event
Add the identity fields to the properties of anyvisitors.track call:
The fields Radar reads
Which field wins
When an event carriesname together with first_name and last_name, name takes priority. Send name when you already have the full name as your customer typed it.
The rule about names and payment
An email identifies the visitor on any event. A name does not. Radar copies name, first_name and last_name to the People page only when they arrive on an event named exactly payment. On any other event, these fields stay attached to the event itself, and the People page keeps showing the generated name.
Compare the two calls:
When to identify
Identify a visitor at the first moment you know who they are. Their earlier, anonymous history stays with them, so you see what they did before and after.
The event names are examples, except
payment. Use the names that fit your product.
On sign-up or login
Send the event once the account is created or the login has succeeded. Read the email from your own user object instead of typing it in the code.On a booking or a form
One call records the action and identifies the person. In this example,submitBooking stands for your own booking code.
On a purchase
On your own payment page, send thepayment event once the payment is confirmed. This is the only event on which the name fields reach the People page.
Check that a visitor is identified
1
Do the action yourself
On your published site, sign up, log in or fill in the form with a test email address.
2
Open the People page
In your Radar project, go to People and find your visit. The visitor now carries the email you sent. Click the line to open their full history.
3
Check the name, if you sent a payment event
After a
payment event with name fields, the People page shows the real name instead of the generated one.identity filter keeps only identified visitors:
status (identified or anonymous), an email, and a name that holds the real name when Radar knows it and a generated one otherwise. See the people endpoint. The Radar API is available from the Pro plan.
Before you ship this
Good to know
- Radar only knows what it is sent. It does not reveal the name or the company of a visitor who never gave you their details.
- Every call is an event. An identifying event counts toward the events your plan includes each month, like any other custom event. See plans and events.
- No webhooks. Radar does not notify your systems when a visitor is identified or comes back. Read the data with the Radar API instead.
Next steps
Send custom events
The call, its arguments and when to send it.
Track revenue
Connect Stripe or send a payment event from your own payment page.