Flag impressions

3 minute readData analytics

CloudBees Feature Management flag impressions allow you to visualize and analyze your feature flag configuration data. Impressions are captured by adding the impressionHandler to each installed SDK, and displayed in the flag’s Impressions tab.

Every time a flag is evaluated, that evaluation is counted as an impression. The CloudBees Feature Management impression handler evaluates a combination of the number of times the flag configuration is accessed by visitors, and the flag value that is displayed.

Flag impression data is frequently retrieved, however, reporting may be delayed by a few minutes in the Impressions tab.

Configuring the impression and fetched handlers

The impression and fetched handlers must first be added to the SDK before they are reported to the CloudBees Feature Management Impression tab.

To add the handlers to the SDK, refer to the following pages for instructions:

When your handlers have been added to the SDK you can analyze the impression data from within CloudBees Feature Management.

Accessing impression data

When your impression and fetched handlers are added to the SDK, you can access the data in the flag’s Impressions tab.

To access the flag impressions:

  1. From the CloudBees Feature Management Home page, select your email and avatar, and then select the organization. Disregard this step if you are a member of only one organization.

  2. Select All apps from the left pane, and then select the app that contains the flag.

  3. Select the environment from the left pane, and select the flag.

  4. Select the Impressions tab.

The flag impressions are displayed within a view on the main screen.

Analyzing impression data

Impressions are reported to the flag’s Impressions tab, and are displayed in a data visualization.

To analyze the impressions received:

  1. From the top-right corner of the data visualization on the main screen, select the Last 7 days or Last 24 hours to update the view.

  2. Hover over a bar within the view to access the following impression data:

    • The creation date and time:

      • For the Last 7 days the time is reported at 12:00:00 AM UTC.

      • For the Last 24 hours the time is reported by hour.

    • The flag value for each variable:

      • A variable can be a configured set of flag values, or the true or false percentage of visitors the flag is active for.

    • The number of impressions for each variable:

      • Displayed after the flag value (for example, at end of the string), and separated by a colon.

The impressions view

This section describes the data that is displayed in the Impressions view.

  1. Visualization title: Browser Visitors or Platform Visitors

  2. Time duration of reported impressions: Can be configured as Last 7 days or Last 24 hours

  3. The total number of all impressions within the specified time duration

  4. The flag value, such as the following:

    • The string value

    • The variable value

    • False: The configuration is not active

    • True: The configuration is active

  5. The number of impressions for the specified flag value

  6. The percentage of impressions for the specified flag value

  7. The number of impressions axis: A continuous range based upon the total number of impressions

  8. The range of time axis: A range of days or hours based on the selected duration

  9. The legend: May include the number of times the flag is evaluated as True or False, the string information, or a variable set by the flag configuration for example

  10. The tooltip display when hovering over the impressions bar

Impressions view with numbers marking each section of the Impressions view

Reporting impressions to third party data visualization tools

You can also add a function to the SDK to report the flag state or other data to third party data visualization software or application performance management systems. Refer to your third party analytics provider SDK for more information.