Monitoring Custom Event Usage

As your Iterable projects grow to contain more users—and more custom events from their interactions with your marketing campaigns, websites and apps—it can be helpful to understand which custom events they're using and how they're being used.

Iterable's Custom Event Usage screen provides details about a project's custom events, how many have been saved, and the workflows and dynamic lists that reference them.

This screen does not include information about contact profile fields—only custom events.

# Table of contents

# Custom Event Usage screen

The Custom Event Usage screen displays usage data for an Iterable project's top 1000 most-saved events, as counted over the project's entire lifetime. This screen only displays events that the project has saved at least once (regardless of whether or not they've been defined on the Settings > Project Settings screen).

To view the Custom Event Usage screen, you'll need the Project Configuration > Project Settings permission. With that permission, navigate to Settings > Current Project > Custom Event Usage.

On this screen, you can filter and sort custom events, view the dynamic lists or workflow nodes that reference them, and export the displayed data.

# Viewing dynamic lists that reference a particular custom event

When defining segmentation queries for dynamic lists, you might select contacts who have particular custom events saved to their Iterable profiles. From the Custom Event Usage screen, you can view the dynamic lists whose segmentation queries reference particular custom events by clicking the numbers in the List References column.

For example, in the above table, clicking the promoRedeemed event's List References value brings up the following screen:

On this screen, you can navigate to a dynamic list's details by clicking its name, and export the table's data by clicking Export to CSV.

# Viewing workflow nodes that reference a particular custom event

Workflows can reference custom events in trigger and filter nodes. To view these references on the Custom Event Usage screen, click the number found in an event's Workflow Node References column.

For example, in the above table, clicking the completedOnboarding event's Workflow Node References value brings up the following screen:

From here, you can view the related workflow node's details by twirling open the arrow in the Nodes column, navigate to a workflow's definition by clicking its name, and export the table's data by clicking Export to CSV.

# Further reading

• Managing Custom Events
• Project Settings Overview