Events

Events overview

Events, or event streams, show Faraday how to recognize actions taking place in your data, such as purchases, renewals, click events, upsells, etc. Events are defined while creating a dataset, in which you'll either create a new event stream, or add the event to an existing one. Most events will be a series of recurring actions, such as transactions, but events can also come in the form of individual occurrences, such as an account opening or closing.

Dates are often the most useful piece of data to include when defining an event, and not including a date can negatively impact prediction performance. Beyond dates, you can add value to the event, such as how much money was gained or lost during its occurrence, and event properties, which are data points you want to associate with an event, such as product type of a specific purchase.

Events are used to define cohorts, which are the building blocks of your predictions. You'll define those cohorts by choosing a specific event that everyone in that cohort should have encountered, like a transaction for your "customers" cohort. Event properties can be used to further customize your cohors–for example, you might create a cohort of your customers by selecting the orders event, then select the product category property to specify the type of product everyone in this cohort should've purchased.

Those cohorts will then be used to define propensity predictions in outcomes and persona predictions in persona sets. Additionally, events themselves are used to create recommender predictions based on event properties.

For event creation instructions using both the Dashboard UI and API, see our how-to docs for event streams.

Deleting an event

Before deleting an event, ensure that resources using it, such as a cohort or a recommender, are no longer using it. Once there are no other resources using the event, you can safely delete it.

• Dashboard: click the options menu (three dots) on the far right of the event you'd like to delete, then click delete.
• API: use the delete stream API request.