Manage product usage fields

Who can use this feature?

  • All roles with access level "high"
  • Available on all plans

Product usage fields allow you to stream product events to Catalyst from Mixpanel, Pendo, or Segment. By leveraging the COUNT and RANK functions within calculated fields, you can map these product events to your account and contact objects to further manipulate and query data against your Catalyst customer base.

Suggested uses

  1. Use calculated fields to create engagement benchmarks (e.g. MAU, WAU) to understand customer behavior
  2. Create expansion indicators based on customer product usage
  3. Get a richer picture of renewal risk by enriching health score with usage data
  4. Run usage playbooks and measure their impact
  5. Automatically move customers to the next stage in Journey Builder when product adoption stage goals are met

Create a product usage field

Once you create a new calculated field, you cannot edit the field configuration; this allows Catalyst to maintain field history.

You must have a product usage integration configured (Mixpanel, Pendo, or Segment) before you can create a product usage field in Catalyst.

  1. Navigate to Settings > Object Configuration.
  2. Open one of your objects (e.g., accounts or contacts).

    Catalyst cannot capture total events at the contact-level if the Salesforce contact (and the associated email address) has not been synced over from your integration (Mixpanel or Segment) or if the visitor and contact objects have not been mapped (Pendo). Catalyst does not create new contact records that are detected from a product usage integration. 

  3. Click the Calculated Fields tab.
  4. Click + Add Calculated Field.
  5. Choose Pre-built Functions.
  6. Enter a field name and description.
  7. Configure the formula you want to use for either the COUNT or RANK functions (see below).

    Calculated fields are case-sensitive. If you use a text filter with a "contains" operator, be sure to use the proper case for your input.

  8. Click Save.
    Calculated fields can take up to 24 hours to calculate, depending on the data source. See more cautions.

 

Count

Count the number of events or unique users performing the events. 
Example: Total times a contact used a certain feature in your product

  • Associated object: Choose the Product usage object.

    If you do not see this object, ensure you have a product usage integration configured.

  • Measurement: Available on the accounts object. Choose whether to measure by product events (count total times an event is performed) or users (count total number of unique users performing the event).
  • Product Event: Click inside the box to load available events that the integration is streaming to Catalyst.
  • Filter: Optionally add a filter to narrow down the record set. 

    If using Segment or Mixpanel, the OR operator is not available. To combine multiple conditions, only the AND operator is supported.

  • Timeframe: Choose the timeframe to measure (e.g., last X [timeframe]). Supports up to 365 days of a look-back. Available timeframes include:
    • Days: Looks at the last number of days from yesterday. Example: If today is April 15, "last 30 days" looks at March 15 - April 14.

    • Weeks: Looks at the last completed Sunday through Sunday.

    • Months: Looks at the last calendar month. Example: If today is April 15, "last 1 month" looks at March 1 - March 31.

    • Quarters: Looks at the last fiscal quarter, as configured for your Catalyst instance.

 

Rank

Find out the max or min value of a product event for an account or contact.
Example: The last date a contact performed an action in your product

  • Min/Max: Choose which option to use for the calculation.
  • Associated object: Choose the Product usage object.

    If you do not see this object, ensure you have a product usage integration configured.

  • Product Event: Click inside the box to load available events that the integration is streaming to Catalyst.
  • Filter: Optionally add a filter to narrow down the record set. 

    If using Segment or Mixpanel, the OR operator is not available. To combine multiple conditions, only the AND operator is supported.

  • Field: Choose the timestamp field type you want to use. 

Looking for inspiration?

Here are some additional use cases for product event metrics

Example 1: Total events performed by each contact 

On the contacts object, COUNT the number of times each contact "created a note" (example event) in the last calendar month.
Contact events.gif

Example 2: Total active users on each account

On the accounts object, COUNT (distinct) the number of users that have "created a note" (example event) at least once in the last calendar month.

Active users refers to users tracked in your product usage tool, not limited to contact records in Salesforce.

active users .gif

Example 3: Last date each contact performed an event

On the contacts object, RANK (max) the latest date each contact "created a note" (example event).
slide_15_gif.gif

Example 4: Number of days since any on the account last performed an event 

On the accounts object, find the DURATION since an event was last performed (RANK).

This technique requires you to create a new calculated field based on a product usage field (see Example 3).
slide_17_gif.gif

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request