​
Overview

The core of the Valued data model is based on events, customers, and users, scoped to your project.

This data model allows us to better understand your users, the customer accounts they belong to, and the actions they take within your product.

Modern B2B SaaS products support users belonging to multiple customer accounts, and this is reflected in our event data modeling.

We also support the concept of customer events as we understand that not all events are associated with a user, For example, if you are extending the trial of a customer, you only need to associate that event with the customer.

​
Core models

​
Events

To understand feature adoption by your customers and users you will need to capture events that represent feature usage and activity. This includes action and page view activity throughout your product.

To update information related to a customer or user you can send a sync to Valued.

More information on the different events you can send to Valued, along with full specifications can be found on the Event Definitions page.

​
Customers

Customers are a top-level grouping of one or more users. This enables your team to understand how feature adoption and usage activity happens on a customer account level.

Customer accounts can include personal accounts, team accounts, company accounts, and organization accounts.

Additionally, we support users belonging to more than one customer, giving you the flexibility to model team membership as your product models it.

As an example, we recommend capturing and syncing the following information:

id: 123
name: "Highly Valued, Inc."
email: "hello@valued.app"
website: "https://valued.app"
location:
  country: "USA"
  state: "California"
plan_type: "free"
Customer