To create a new Element, navigate to the Elements section in your account's settings. Click the Create New element button to view a form like this:


Here, you'll be presented with three options for the type of Element you'd like to create. The first two options (tracking the state of an integration or a specific configuration option) measure 'binary' states - i.e. is the feature currently on or off at the customer. This is tracked through 2 events:

  • The 'Enable' event (required) - Your analytics service should send this event whenever the feature is enabled by the customer (e.g. 'Intercom integration enabled', 'Widget installed')
  • The 'Disable' event (optional) - Your analytics service should send this event whenever the feature is disabled by the customer (e.g. 'Intercom integration disabled', 'Widget removed')

The third option measures how often a feature that requires the user to create some data is used by each customer. This is tracked through 3 events:

  • The 'Create' event (required) - Your analytics service should send this event whenever the feature is used and data is created by the customer (e.g. 'Project created')
  • The 'Update' event (optional) - Your analytics service should send this event whenever data created by the Create event is updated (e.g. 'Project updated')
  • The 'Delete' event (optional) - Your analytics service should send this event whenever data created by the Create event is deleted (e.g. 'Project deleted')

Note that while Update and Disable/Delete events are optional, they are highly recommended. Elements are meant to track the current configuration state of your product at your customers. Therefore, if you are only tracking events when the feature is used and are not tracking events when data is updated/deleted, then Elements won't be able to accurately show you the actual, current state of the feature at the customer.

An Example

Let's say you work at Asana or Trello and want to track the Projects created by your customers. This is a perfect feature to create an Element for since Projects are critical to the overall health of the product's implementation. Without Projects, users cannot create tasks and thus cannot see the full value offered by the product.

To create a 'Projects' Element, the configuration should look something like this:

https://cdn.elev.io/file/uploads/rsVNBydcI0oDOpH0-5LcIes9-tG1wQo8r1t7aqlWfxc/0onkFXRvt7ikP2LNx1VAttQSdVb7fjioOHfYJxMn0b0/Screen Shot 2018-06-17 at 11.17.59 AM-6QY.png


Here, we've selected events for when a Project is created, updated, or deleted by a user. We've also selected that the id event property 'links' Projects across these events. This property allows Vitally to locate the exact Project that gets updated or deleted, which ensures we provide you with the most up-to-date information about the customer's Projects.

If you do not track events when Projects are updated and deleted, then the information we provide you about a customer's Projects will quickly become outdated. For example, a user could create 10 Projects in their initial session. However, they could very well have been experimenting with the feature and may decide to delete those Projects later. Without tracking the Delete event and including the same id sent for the Create event, Vitally will falsely tell you that the customer has 10 Projects in their current implementation, when in actuality they have none.

Wondering what Elements look like when created in Vitally? Check out our Overview article!