Note: To avoid redundant third-party notifications, changes to the text editor and mockups are delayed by at least five minutes, waiting for five minutes after the most recent change.

Aha! Roadmaps | Integrate with Google Analytics

Aha! Roadmaps offers a one-way integration with Google Analytics that connects your team's work with key engagement metrics. This integration helps you determine the impact of your work by displaying measurements from web properties on the key pieces of your plans and roadmaps.

Click any of the following links to skip ahead:


Integration type

  • One-way (Google Analytics to Aha! Roadmaps)

Aha! Roadmaps level

  • Account level

  • Workspace level

Required user permissions:

Required user permissions:
Add measurements

Associated record types

  • Initiatives

  • Epics

  • Features / Activities

  • Requirements


Known limitations

The Aha! Roadmaps integration with Google Analytics supports Universal analytics. It does not support Web+App analytics. This is due to a limitation in the Google Analytics API, which only provides access to Web properties, and considers Web+App properties in the beta development stage.

  • If you do not see your Google Analytics property in the list of available properties, it is unsupported.

  • We are tracking feedback on this limitation in this idea. Please vote and comment with details of your use case!


Configure the integration

Aha! Roadmaps users can configure an integration with Google Analytics on an individual workspace level or across an entire account. To add an integration with Google Analytics to a workspace, you must have owner permissions. To set up an integration at an account level, you must have account administrator permissions.

To configure your workspace with an integration to Google Analytics:

  1. Navigate to Settings ⚙️ Account Integrations or Settings ⚙️ Workspace Integrations and click the + icon next to Integrations in the left navigation bar.

  2. Choose Google Analytics in the Engagement grouping.

  3. Enter a name in the Integration name field and then click Save and continue.
    Note: You should name your integration something unique based on the configuration settings that you make — especially if you plan to have multiple Google Analytics integrations for a single workspace.

  4. In the Configure account section, click Authenticate. Then, follow the Google authentication steps using the account information that is tied to your Google Analytics account.

  5. In the Select account section, pick the Google Analytics account that you would like to integrate.

  6. In the Select web property section, choose the web property that you would like to integrate.
    Note: If you would like to manage more than one web property, you will need to set up another integration.

  7. In the Select view tab, choose a view from your Google Analytics account.

  8. In the Enable for records tab, choose the Aha! Roadmaps records that you would like tied to the integration. Once the integration has been enabled for your record type(s), a new Engagements section appears on your records. The available record types include initiatives, epics, features, activities, and requirements.

  9. In the Enable tab, click Enable to complete the integration configuration. To disable or delete the integration at a later time, click the More options button located on the upper-right corner of the integration setup page.


Add a measurement

Now that you have configured the integration, you can start adding measurements from Google Analytics to your Aha! Roadmaps records.
Note: You must have owner or contributor permissions to add or edit measurements.

To add a measurement to a record:

  1. Navigate to an Aha! Roadmaps record that has an enabled Google Analytics integration for the record type.

  2. Notice the Engagements section on your record. If you do not see this section, it is likely that the record type you have chosen has not been added to your integration in your integration setup.

  3. To add a measurement from Google Analytics to your record, click the + icon on Engagements and complete the modal. Then, click Create measurement to add the measurement to your record.

  • Name: Give your measurement a unique name.

  • Integration: Choose from the enabled Google Analytics integrations available for your workspace.

  • Dimension: Seven dimensions are included in the integration. Choose a dimension which contains rows that you want to integrate (e.g. campaign, source, page, medium, etc.).

  • Dimension name: Dimension names are the rows that appear for each dimension in your Google Analytics account. Select the dimension name that you would like to see on your Aha! Roadmaps record.

  • Goal (optional): This dropdown will show all goals that are associated with the dimension name that you have selected.

  • Metrics: Twelve metrics are stored and tracked in Aha! Roadmaps for each measurement that you create. Of the twelve, you can choose up to six metrics that you would like to display in the Engagement tab of the record drawer. The remaining metrics can be viewed with analytics reports. See the complete list of metrics at the bottom of this article.


Manage engagement details

Measurements can be viewed and modified from the Engagement tab that appears on integrated records.

To see additional metrics for a particular measurement, click the measurement to open the Engagement drawer view.

Note: Only one metric can be shown per measurement on the record. To choose the metric that appears on the drawer view, enable the pin icon on the desired metric.

Each measurement includes 12 metrics. Six of these metrics are shown on the record (chosen during creation of the measurement). The remaining metrics can be accessed from analytics reports which are explained further in the next section.

When you create a measurement in Aha! Roadmaps, all available data on the measurement up to 90 days will be collected from Google Analytics. After creation, the measurement data is updated on a daily basis. This data is stored in Aha! Roadmaps and retained until the measurement is deleted.

If no new data is present for a measurement for 30 days, Aha! Roadmaps will stop collecting data for the measurement and prompt the user with a Resume tracking measurement link. Clicking this link will reconnect the integration and gather all available data for the past 90 days.

The date dropdown that appears on the Engagement drawer view allows you to select a time frame for each measurement. The Custom option includes the following:

  • First 7 days: This option will represent the first 7 days of available data. If data is present, the date range will be visible in the dropdown.

  • First 30 days: This option will represent the first 30 days of available data. If data is present, the date range will be visible in the dropdown.

  • Last 7 days: This option will represent data that was collected over the last 7 days.

  • Last 30 days: This option will represent data that was collected over the last 30 days.


Report and analyze your measurements

Analytics reports help you understand, compare, and share results in the form of lists, pivot tables, and charts.

To quickly view a measurement in a list report, navigate to the engagements section of your Aha! Roadmaps record and click the View in list report link.

To view multiple measurements on a single report that can be filtered based on your needs, start with a list report:

  1. Navigate to Roadmaps List.

  2. Click the Create new report button. The report builder will open.

  3. Choose to Create your own list report.

  4. Choose a primary record type (this is the record type that you have integrated with Google Analytics).

  5. In the Add fields step of the report builder, add Engagement measurement as a secondary record type, then add the measurement(s) you'd like to report on.

  6. Add filters to your report.

  7. Click Create report.

Once the report has been created, you can further customize it. Click the Customize view drop down to Edit data or Sort columns. Click the Edit filters icon to add advanced filters, or hover over the filters bar and click the Add filters + icon to add a basic filter quickly.

You can also change the report type to visualize the data in a pivot report or chart.


Common terms in Google Analytics

Terms (from Google’s Dimensions and Metrics, About goals, About properties, The difference between Google Ads Clicks, and Sessions, Users, Entrances, Pageviews, and Unique Pageviews in Analytics, Bounce rate, and Set up a property):

  • Dimensions are attributes of your data. For example, City indicates the city from which a session originates. Page indicates the URL of a page that is viewed.

  • Goals measure how well your site or app fulfills your target objectives. A goal represents a completed activity, called a conversion, that contributes to the success of your business.

  • Metrics are quantitative measurements. The metric Sessions is the total number of sessions. The metric Pages/Session is the average number of pages viewed per session.

  • Web properties are where you send data and set up reporting views. When you track a resource using Google Analytics, you include a property ID in the tracking code that you put on your web pages or in your app source code. Performance data, like number of users or pageviews, for resources tagged with the same ID is collected into the corresponding property.


Available metrics

  • Average session duration: The average length of a session.

  • Bounce rate: The percentage of single-page sessions in which there was no interaction with the page.

  • Bounces: A bounce is a single-page session on your site.

  • Goal completions: The number of conversions to the goal.

  • Goal conversion rate: The percentage of visits that resulted in a conversion to the goal.

  • Goal value: The monetary value of conversions to the goal.

  • New users: The number of first-time users during the selected date range.

  • Pageviews: Total number of pages viewed. Repeated views of a single page are counted.

  • Pageviews per session: The average number of pages viewed during a session. Repeated views of a single page are counted.

  • Sessions: Total number of sessions within the date range. A session is the period of time that a user is actively engaged with your website, app, etc.

  • Unique pageviews: The number of sessions during which a page was viewed one or more times.

  • Users: Visitors who have initiated at least one session during the date range.


If you get stuck, please reach out to our Product Success team. Our team is made up entirely of product experts and responds fast.

Aha! Roadmaps
      Aha! Ideas
      Aha! Develop