User Properties

What are user properties?

User properties are attributes you send to Zata from your product about your users. They are the “adjectives” that describe your users. Examples include things like Name, Email Address, Company, Role, Created Date, etc.

Some user properties, like Browser and Current Page URL, are automatically sent to Zata. For custom user properties specific to your application, however, you will need to send them to Zata, yourself.

Why send user properties to Zata?

One of the powerful features of Zata is the ability to very specifically target users based on who they are or where they are in their customer lifecycle. For example, you may want to target “new marketing admins”, for which you would need to know “created date”, “role”, and “team”. All of these are user properties you can send to Zata.

How do I send user properties?

Custom user properties are sent to Zata when a user is identified. Check out the section on sending user properties in our Installation Overview (for Developers) article for more information.

Where can I see which user properties I’m sending?

All your custom properties will be listed on the Events and Properties page in your Zata settings. Please note that user properties will only appear on this list after at least one user with this property has been identified in Zata.

Here’s a set of recommended user properties to start sending first. You can add more later as well

Recommended

Additional / Optional

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

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

<script>
zata.identify( 
 "UNIQUE USER ID", // Used to identify users 
 { 
   name: "John Doe", // Full name 
   email: "customer@example.com", // Email address 
   created_at: "1519205055", // Signup date as a Unix timestamp 
   // Account parameters (optional), used to target users that belong to a certain organization.
   company: {
    id: 1, // Required, used to identify the company
    name: 'Acme Labs',
    created_at: "1519205055"
   }
   // Additional properties 
   // createdProject: "true",
   // projectId: "1",
   // trialEnds: '2019-10-31T09:29:33.401Z'
 } 
); 
</script>

For example, if you want to pass the user attribute projectID, you'd add projectID: 1.

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 zata.identify() function again.

This will cause Zata 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.

Last updated