Skip to content
  • Home
  • Developers
  • API
  • Releases
  • Community
  • University
  • Status
  • Home
  • Developers
  • API
  • Releases
  • Community
  • University
  • Status
Home Administration Data Governance Ongoing Maintenance
Session Replay Getting Started Administration Data Management Definitions Charts Analysis Examples Heap Plays Integrations Heap Connect Data Privacy

Read in Order

  1. Data Governance: Overview
  2. Naming conventions overview
  3. Categories overview
  4. Definition Verification
  5. Event Repair Flow
  6. Dataset Cleanup
  7. Definition History
  8. Managing Events, Segments, Properties, & Reports
  9. Ongoing Maintenance

Table of Contents

Was this article helpful?

Yes No

Thank you for your feedback!

Ongoing Maintenance

In this article you'll learn:

  • Use cases for conduct an audit to clean up your existing Heap dataset
  • Where to find information in your Heap account about general settings, your dataset, and your team
  • How to manage your existing team structure, definitions, identity configurations, and integrations
This doc is for: Admins Architects

Overview

As your dataset grows along with your product, there may come a time when you need to conduct an audit of your dataset and team in Heap as part of ongoing maintenance. This guide is designed for the following use cases where a review and cleanup of an existing Heap account is necessary:

  • You’ve had Heap for a number of months or years and have outgrown your original data governance strategy or team structure
  • You’re transitioning account owners and need a resource to help the new Admin(s) get to know your account
  • You’ve inherited a Heap account that has gone through multiple transitions and needs to be cleaned up

To support you through the process of reviewing and reorganizing an existing Heap account, this guide will walk you through the following:

  • How to review and manage the structure of your team
  • How each of our data management tools work and where they can be found in Heap
  • How identity is managed in Heap and where to find your identity settings
  • Where to see a list of integrations your account is already set up with and where that source data lives in your Heap account
  • A list of additional resources that may be helpful depending on your use case

If you need help, please post in Heap Community or visit our Get support page.

If you’re not already familiar with Heap, as a first step, it may be helpful to review the docs in How Heap Works. These docs cover what Heap is, our data model, and all of the data that Heap autocaptures. 

Architects can access some, but not all, of the configurations listed in this guide. For more information about what this role can do, and to set custom permissions for certain roles, see Teammates & Permissions.

Team Strategy

There are three general approaches to data governance that our customers typically use: conservative, liberal, and blended, as detailed in Plan Your Data Governance Strategy.

If you’ve previously applied one approach and want to shift to another, you can review and edit your team structure on the Teammates page in Heap. Click on any team member whose role you’d like to edit, then use the role drop-down on the right to update that person’s role.

A teammate's details as listed on the teammates page with an arrow pointed at the role drop-down

If you’re inheriting an existing Heap account and are not sure what structure was used before (or if there was a structure) try answering the questions in Plan Your Data Governance Strategy as applied to your Heap account to figure out the structure. You can also use these questions to determine the best structure for your organization moving forward.

For a complete understanding of the roles available in Heap, see the permissions table in Teammates & Permissions. You can also create custom roles for your organization.

Data Governance 

The magic of Heap is that most of your user interactions are automatically captured and made available to you from the moment you first install Heap. See Autocaptured Data for a full list of all of the properties and events that are automatically captured for web, iOS, and Android. 

In addition to this built-in dataset, Heap offers the ability to define and organize your dataset and results in a number of ways. Here’s a brief overview of each of these features:

Defining Events, Segments, & Properties

Events

Events are actions associated with users. Types of events include clicks, pageviews, field changes, form submissions, and mobile interactions like taps and screenviews. Examples of types of events you might want to define include Sign Up, Login, or Applied Promo Code. You can define events to answer specific questions in analysis, such as “how many users signed up last week?” or “what are the most popular codes this month?”

Here’s an example of a Click – Sign Up event as defined by our marketing team at Heap:

The edit event criteria section of the event details page for a signup event

You can use this event in analysis in all sorts of ways, including graphing how often the event occurs, or setting up a funnel for a series of events to see the conversion rate. Here’s an example of this event used in a funnel analysis to see the conversion rate from the marketing website to signing up.

A funnel where event 1 is view marketing homepage and event 2 is click - sign up

All of your events, including built-in events and events defined by your team, are listed on the Definitions > Events page. For steps to create and manage events, see our guide on Events.

The events page in Heap

If you’ve run across an event (or multiple events) that were defined before you joined Heap, and you have no idea what they were for, see the tips in How do I figure out the purpose of an event that was created by someone else?

Properties

Properties are bits of metadata associated with user interactions. You can define new properties for analysis, such as a custom marketing channel property that aggregates all of your marketing efforts, or a product category property that pulls out part of your shopping site’s URL (ex. pants).

Here’s an example of a defined event property, Analysis Module, created by our Product team in Heap. This property aggregates all of the different analysis pages by the analysis module used. (This definition criterion extends further down beyond this image). 

The edit property criteria section of the analysis module event with several conditions listed

Our Product team can use this to further refine analysis, such as graphing the amount of pageviews grouped by the analysis module. 

A graph to count pageviews grouped by the analysis module event

All of your properties, including built-in properties, custom properties, and defined properties are listed on the Definitions > Properties page. For a breakdown of the different types of properties in Heap and steps to define new properties, see our guide on Properties. 

The properties page in Heap with all properties listed

Segments

Segments are subsets of users defined by certain criteria you set. Examples include Active Users (users who log in more than x amount of times) and Frequent Buyers (users who have made x amount of purchases or more). You can define segments to filter down or group analysis results by types of users to answer specific questions like “What regions are my active users from?” or “What products are my frequent buyers purchasing most often?” 

Here’s an example of an Active Users segment that our Account Management team uses to group together users who conduct analysis regularly.

The edit segment criteria section of the active users segment

This segment is used in analysis to regularly check inactive users to spot opportunities to bring them back.

A graph of number of accounts without any users filtered by users who are in segment AM - active users

All of your segments are listed on (you guessed it) the Definitions > Segments page. For information on how to create and manage segments, see our guide on Segments.

The segments page in Heap with all segments listed

Creating Reports & Dashboards

Reports

Reports are saved analysis results. You can name and categorize any analysis, such as the examples above, to make it easy to reference later on. Heap also offers a set of built-in suggested reports to help you get started. Click the links below to check out some of our most popular suggested reports: 

  • Do users returning after a break convert at a higher rate than new users? 
  • Which countries are my visitors from?
  • Does a given user action drive higher retention?

All of your reports are listed on the Reports page, with suggested reports detailed in the pane on the right.

Dashboards

Dashboards are groupings of reports all grouped together on one page. For example, your marketing team may wish to save all of your reports regarding homepage interaction together as one Marketing Homepage dashboard.

All of the dashboards are listed in the dashboards drop-down available in the left navigation bar in your Heap account.

See our Reports, Dashboards, & Playbooks guide for steps to create and manage each of these.

Naming Conventions and Categorization

Categories

Categories are exactly as they sound – these are the names for groupings of events, segments, properties, and reports in Heap. For example, you may want to categorize your events based on their location in the app (ex. Account Settings Screen) and organize your segments by the team that uses them (ex. Marketing).

You can review your list of categories by visiting the events, segments, properties, and reports sections in Heap. They’ll be listed with arrows to drop-down what’s inside that category.

The saved reports page with a red box around the drop-down arrow for the Design category to highlight it

Our guide on Categories offers best practices and steps to create and organize categories. 

Naming Conventions

You may notice your account has a predefined naming convention applied to your definitions and/or reports. As part of onboarding to Heap, we recommend establishing and enforcing a consistent naming convention to keep your data as organized as possible everywhere it is listed.

For details, see the Establish Naming Conventions section of the Setting Up Heap guide.

Auditing & Updating Definitions

If you’ve inherited an account with an abundance of definitions, but aren’t sure which ones are relevant or even being used, you can evaluate them via our Data Governance features. Here’s a quick overview of each one:

Definition Verification allows you to establish a trusted and shared set of event definitions for your team to use in analysis. As part of this process,  team members with permissions to create definitions can submit unverified definitions for Admins and Architects to review. Once a definition has been verified, only Admins and Architects will be able to update the definition.

Here’s what the verification badge looks like on the definition details page:

A hexagon with a green check mark inside listed at the top of an event details page to indicate the event is verified

Our Dataset Cleanup features enable you to review and take action on inactive (haven’t received any new data in the past 72 hours) and unused (haven’t been used in a report, dashboard, or ad-hoc query in more than 90 days) definitions. You may choose to repair, update, or archive these definitions.

Your inactive and unused definitions are listed in their own queue on the Definitions page.

The events page with a red box around the inactive and unused categories to highlight them

Event Repair Flow allows you to easily spot and fix broken event definitions, including those surfaced in your dataset cleanup definition lists. If a product change broke one or several of your Heap events, you can easily repair them without impacting saved reports, dashboards, or downstream syncs.

When you click the Repair button, you are presented with a list of options to repair the event based on the current state of the event.

The repair event pop-up with the three options listed described in this article

Definition History: When reviewing your definitions, you can review the history of the definition to inform your decision about what to do with the definition. This history includes who originally created the definition, who made each change, when the change was made, and whether the definition was previously verified or archived.

The event history section of an event details page, with events listed in chronological order starting from the most recent

Details and instructions on how to use all of these features are available in our Data Governance guide.

If you’re on a paid plan, you may be able to request a data audit from your Customer Success Manager. Reach out to sales@heap.io to learn more.

User Identity

You can find information on how user identity is managed in your Heap account by navigating to the Account > Manage > User Identities page.

If you haven’t used Heap’s APIs to capture user identity information, you’ll see instructions for how to do so via our identify and addUserProperties APIs. If you are capturing this information, you’ll see a list of identities and custom user properties captured most recently.

For steps and best practices on capturing user identity, see the Using Identify in our developer documentation.

Integrations

Heap offers a wealth of integrations to bring in data from outside sources for analysis. You can see which sources are active in your Heap account by navigating to Integrate > Sources and clicking on each source listed. 

If the integration is enabled, you’ll see a Connected button on the top-right corner of the source page.

The Appcues integration page with an arrow pointing to the Connected button to highlight it

If it is not enabled, you’ll see a See Documentation or Contact Us button depending on the integration. 

The Shopify integration page with an arrow pointing to the Contact Us button to highlight it

Tealium and Segment

Tealium and Segment may still show a See Documentation button even if connected. To double-check if you have one of these two sources connected, login to your Tealium or Segment account and check in their interface to see if Heap is connected.

To understand each of these integrations, check out our Integrations guides.

You may also want to check if you’re syncing your data to a data warehouse via Heap Connect, as this will impact your ability to make changes to your dataset. To do so, navigate to Integrate > Connect. If you have one or more data warehouses connected, you’ll see them listed on this page. To learn more about how Heap Connect works, see our Heap Connect guide.

Additional Resources

Now that you’ve got a sense of how these features are set up, you may want to restructure your account going forward. Our full guide to Setting Up Heap will help you make important decisions and provide detailed information on all of the features available to you.

It’s also important to understand and consider what data privacy settings you may already have or want to have enabled. Learn more about our options by reviewing our Data Privacy documentation.

More information on Heap’s administration features, including security options like SSO and 2FA and how to see and manage your time zone, can be found in our Heap Administration section.

When you’re ready to dive into analysis, check out our Analysis Examples.

Was this article helpful?

Yes No

Thank you for your feedback!

Last updated September 7, 2022.

changing account ownerinherited heap accountnew account ownerold heap accountongoing maintenance
  • Blog
  • Partners
  • Legal
  • Security
  • Terms
  • About
  • Careers
  • Privacy
  • Contact Us

© 2023 Heap, Inc.