Identify your users

June / Docs

Users

Identify

Track behaviour

Companies

Identify

Track behaviour

Identify your users

See which users are using your product

Have you installed the June SDK?

If you haven't installed one of the June SDKs, please do that first before implementing the .identify method.

See how to install the June SDK →

Overview

This document provides guidance on using the identify method to successfully identify your product's users. This will show you which users are triggering events in June. It is recommended to include this code snippet in the section of your code where user sign-ups, logins, or account details updates are handled.

Code

Replace USER_ID with a unique identifier, preferably the user ID from your database. Including the user's email is also suggested, along with any additional "traits" like avatar_url, name, role, etc. This information will appear on the user's profile and can be used to filter users in reports.

1
window.analytics.identify('USER_ID', {
2
  email: 'test@example.com',
3
  // Optional
4
  name: 'Joe Bloggs',
5
  avatar_url: 'https://avatar.com/asd809sdhoif9as10nc29.png'
6
  // Add anything else about the user here
7
});

1
analytics.identify('USER_ID',
2
  traits: {
3
    email: 'test@example.com',
4
    // Optional
5
    name: 'Joe Bloggs',
6
    avatar_url: 'https://avatar.com/asd809sdhoif9as10nc29.png'
7
    // Add anything else about the user here
8
  });

1
analytics.identify({
2
  userId: 'USER_ID',
3
  traits: {
4
    email: 'test@example.com',
5
    // Optional
6
    name: 'Joe Bloggs',
7
    avatar_url: 'https://avatar.com/asd809sdhoif9as10nc29.png'
8
    // Add anything else about the user here
9
  }
10
});

1
analytics.identify(
2
  user_id="USER_ID",
3
  traits={
4
    "email": "test@example.com",
5
    # Optional
6
    "name": "Joe Bloggs",
7
    "avatar_url": "https://avatar.com/0sd9fsd8y97a0sf99asd.png",
8
    # Add anything else about the user here
9
  },
10
)

1
Analytics.identify(
2
  user_id: 'USER_ID',
3
  traits: { 
4
    email: "test@example.com"
5
    # Optional
6
    name: "Joe Bloggs",
7
    avatar_url: "https://avatar.com/d78979as8hlsa9088f.png"
8
    # Add anything else about the user here
9
  }
10
)

1
curl https://api.june.so/sdk/identify
2
-H "Content-Type: application/json"
3
-H "Authorization: Basic YOUR_WRITE_KEY"
4
-X POST
5

6
{
7
  "userId": "USER_ID",
8
  "traits": {
9
    "email": "test@example.com",
10
    # Optional
11
    "name": "Joe Bloggs",
12
    "avatar_url": "https://avatar.com/0sd9fsd8y97a0sf99asd.png",
13
    # Add anything else about the user here
14
  },
15
  "timestamp": "2012-12-02T00:31:38.208Z"
16
}

Next: Track user behaviour

Once you've implemented the identify method in your codebase, it's time to track what your users are doing in your product.

See how to track user behaviour →