Identify Users & Send Tracked Events

Identifying users & letting Userpilot track events can help you create powerful user segments to target & track goals as well.

The more information you pass, the more power you will have at your hands.

Identifying Users

To pass a user attribute, you must call the userpilot.identify() function as shown below. 

<script>
  userpilot.identify( "UNIQUE USER ID", // Used to identify users 
    { 
         name: "John Doe", // Full name 
         email: "customer@example.com", // Email address 
         created_at: '2019-10-17' // ISO8601 Date
	 company: {
	  id: 1, // Required, used to identify the company
	  name: "Acme Labs",
	  created_at: '2019-10-17' // ISO8601 Date
	 },
         // Additional properties 
         // projectId: "1",
         // trialEnds: '2019-10-31' // ISO8601 Date
    }     
  );
</script>

Passing date parameters

You can pass extra date parameters other than the created_at parameter using the  ISO 8601 format. 

For example, you can pass the date where the trial for a certain user ends as follows trialEnds: '2019-10-31T09:29:33.401Z'

IMPORTANT: If your user’s data changes in some way without a page load, you should call the userpilot.identify() function again.

This will cause Userpilot to check for any new changes to the user’s data. You only need to include whatever has changed—you don’t need to include all user data in each update.

You can send tracked events and pass them to Userpilot using the userpilot.track() function.

// You can track your events using the "Track" method 
<script> 
userpilot.track("Event"); 
</script> 
// You can also specify more information about your event 
<script> 
var meta = {URL: "/growth"}; 
userpilot.track("Page Event", meta); 
</script>
//A second example
<script>
userpilot.track("Created an Invoice", {
 number_of_invoices: 2,
});
</script>