Metrics Part 1: Understanding Guide Metrics


Use Metrics to measure guide downloads and various usage data. Used properly, the Metrics Dashboard can help you answer questions like: Do people use my guide, and do they keep coming back? How can I improve my guide layout for the future? Should I adjust my promotion strategy?

In this article, we’ll take a look at the different guide actions that are recorded.

For a more in-depth look at how you can interpret your guide metrics, read part II of our series on Guidebook metrics.

Where can I view my Metrics?

Guide metrics can be viewed and exported from the metrics section of the guide dashboard. Your Metrics Dashboard will be broken down into two sections: Guide Metrics and Guide Insights. By default, the metrics will be based on a two week time period. Make sure to adjust the date range in the top right corner of the page to include the entire time period for which you’re trying to collect data.


Note: On the guide dashboard, you’ll see a prominently displayed number in the Users and Groups section. This number correlates to the number of logged-in users who have accessed your guide at least once. You’ll find more information in our Users and Groups article.

After we crunch some numbers, you’ll see your metrics dashboard. The metrics dashboard is broken down into two categories: Metrics and Insights. Within each category you’ll see a number of different data points, generally with a  top level number highlighting a quick takeaway.


Guide Metrics

Note: Unless otherwise specified, these metrics do not include usage from Guidebook Web.


Guide Downloads
This section will tell you how many times your guide has been downloaded onto a device. Guide previews will count towards this number. Make sure to adjust your date range for an accurate measure.

Guide Sessions
A “guide session” occurs each time a user opens up the guide on their mobile device. Here you'll see the total number of times this has occurred.

Unique Guide Users (max)
The top-level number for this section will tell you the greatest number of unique users that used your guide in a single time period. Clicking on this section to reveal more details will show you the number of unique users over time. The “time period” used will depend on the date range selected in the upper right corner — it may be as small as a day, or as large as a month if your date range spans many years.

Guide sessions per-user
This represents the total number of times a single user accessed your guide in a given “time bucket”. Depending on the size of date range you selected, the time bucket will either be one day or one month.

Typical session duration
Measured in seconds, this is the the average length of time a user spends in your guide in a single session.

Total time spent in guide
Here you’ll see the total amount of time spent in your guide, measured to the nearest tenth of a day.

Web sessions (this module measures usage of Guidebook Web)
Total number of times your guide was visited via web browser. A session begins when a user visits the webpage, and ends when they navigate away from the page. This does not measure unique users, so the same page on two tabs will count as two sessions.

Menu item launches
The total number of times your users have tapped on a guide module in the navigation drawer. This will include items such as pinned list items or schedule tracks.

Schedule session views
This lists the total number of views for all schedule sessions in your guide.

List item views
Here you’ll see the aggregate number of times all users have tapped on list items within your guide. All custom lists are used for this metric.

Within the Attendees module, users can elect to “check in” to your guide. This module displays the number of users who have checked in. Clicking on this section reveals a graph showing check-ins over time.

Guide Insights

Guide downloads by OS
This is a simple breakdown of downloads by platform: iOS or Android.
Note: Due to a switch in the way that Guidebook collects metrics info, you may see “iPhone OS” listed along with iOS/Android downloads. Downloads listed as iPhone OS should be considered iOS downloads. This is not an indication that an iPhone, rather than an iPad, performed the guide download.

Guide downloads by acquisition method
This reports the “guide discovery” method, or rather “How did people find and download your guide?”

  • Browse: Your guide was downloaded after tapping the “see more >” button.
  • Bundled: If you have a single-guide Branded app, your guide is “bundled” with the app download. You'll likely see the majority of your downloads here.
  • Code: A passphrase was used to discover your guide.
  • Link: This means that your user was directed to your guide through a special “Guidebook URL”. Most commonly, this occurs when a person has already downloaded the multi-guide app which contains your guide visits your landing page. There they'll see a special “Already have the app? Open the guide now.” link that takes them right to the guide.
  • One_step: If your guide lives in a multi-guide app, you can link to your landing page (found in the Promote section). From your landing page, your users will be able to download and install the app. After the app is launched, they’ll automatically be prompted to download your guide and their download will be recorded in this category.
  • Recommended: If access to device location services has been allowed by the user, there will be a special category on the home screen that shows guides that have a nearby guide location.
  • Restore: When you restore your iOS device from a backup, it will reinstall all apps and app data that were previously on your device. After the user launches the Guidebook app (or your own Branded app), they will be asked if they would like to re-download their previously saved guides. If they tap yes, you'll see those downloads here.
  • Root: Your guide was downloaded from the home page of the app.
  • Search: Your guide was found using the search box on the home screen of a multi-guide app.
  • Scan: A QR code was scanned to discover your guide.
  • Undefined: Generally, this means that a download was started, but not completed. This could be a result of the user cancelling the download or a poor network connection.

Guide downloads by location
This section will display a breakdown of the approximate geographic location of the device that requested a guide download. Guidebook does not use GPS to capture the download location. Instead, we use the location provided by the IP address of the device. This location is only accurate to the nearest city or town.


Top menu items launched
Here you’ll see which menu modules were launched out frequently. Any item pinned to the menu, such as  a list item or schedule track may display here.

Top viewed schedule sessions
This section will show you the most frequently viewed sessions in your schedule.

Top viewed custom list items
This section will show you which list items were most frequently viewed, across all of the custom lists present in your guide.

Top scheduled events
This section displays a bar graph, showing which schedule sessions were most frequently added to the My Schedule module. A session with “allow check-in” disabled will not display here.

Top items added to To-Do List
Only if your guide contains a To-Do module will you see any data in this section. Here you’ll see which custom list items were most frequently added to the To-Do module by users.

Sponsor impressions
The number of times banner ads were displayed to users.

Sponsor taps
The number of times banner ads were tapped by users.

Exporting Metrics

While you’re able to export guide data (such as the schedule) from the Advanced Tools menu, located on the guide dashboard, you can only export metrics data from the metrics dashboard. Before exporting your metrics, make sure to adjust the date range so your export includes the data you need.

There are two forms to choose from when exporting your data:

  1. A pre-generated graph: Saved in PNG, JPG, or PDF format.
  2. A spreadsheet with the raw numbers: Saved in CSV or XLSX format.

To export a spreadsheet containing raw metrics data, click on the “Export Data” option in the dropdown menu in the upper left corner of the page. Next, select the metrics you’re interested in. A CSV file will be emailed to you, containing all data for the selected category.


Note: It will not be possible to export all metrics in a single document. We’ll send you a separate spreadsheet for each metric selected.

If you’d like to download a pre-generated graph, rather than creating your own, you’ll be able to do that by clicking on the download button, located in the upper right corner of each metric section. You may also download a CSV or XLSX spreadsheet from the same location.


Explore the entire metrics series to learn more. Still have questions? Reach out to us at

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Powered by Zendesk