Skip to main content
Every Radar visitor starts anonymous: Radar recognizes them without any personal information and shows a generated name. A visitor becomes an identified person when Radar learns their email, and in some cases their name. This guide explains the two ways that happens, which fields Radar reads, and the rule that decides whether a name shows up on the People page. Not a developer? The Help Center article on identifying visitors gives the short version.

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 a payment event. See track revenue.

Identify with a custom event

Add the identity fields to the properties of any visitors.track call:
If custom events are new to you, start with send custom events.

The fields Radar reads

Which field wins

When an event carries name 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:
Keep payment for real sales. It is the event that carries the amount of a sale, so do not send it only to make a name appear.

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 the payment event once the payment is confirmed. This is the only event on which the name fields reach the People page.
The three arguments are detailed in track revenue.

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.
You can run the same check from your own tools with the Radar API. The identity filter keeps only identified visitors:
Each person comes back with a 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

Identifying visitors is not the same thing as anonymous analytics. Features that identify visitors require a consent banner. Read privacy, cookies and GDPR and check your banner and your privacy policy first.

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.