Skip to end of metadata
Go to start of metadata

On this page:

Related pages:

After you have created a search for the Analytics data that you want to visualize, you are ready to configure a widget to display the results of the search graphically.

Access the Analytics Widget Builders

You can access the Analytics visualization widgets from Analytics Search UI or directly from Dashboards & Reports.

To access the Analytics widget builder from Analytics
  1. At the top of the Controller UI, select Analytics > Searches to view the saved searches list.
  2. Double-click the search that you want to visualize or add a new search.
To access the Analytics widget builder from a Custom Dashboard
  1. From the top navigation bar, click Dashboards & Reports to see the custom dashboard list.
  2. Either double-click the dashboard where you want to add the Analytics widget or click Create Dashboard to create a new dashboard.
  3. In the custom dashboard click Edit, then Add Widget.
  4. Click Analytics, Saved Searches, or Experience Levels
  5. Add Analytics widgets as needed to your dashboard.

Build a Widget

To use the Analytics widget builder: 
  1. Click the Visualization tab.
  2. In the Visualization canvas, you can create widgets with one of the following modes:
    • In Drag and Drop Search (Basic) mode you can create multiple widgets in the canvas.
    • In Query Language Search (Advanced) mode you can generate one widget from your ADQL query at a time. In addition, when you use the Visualization tab in this mode, the order of functions and fields in the query matters. For all widgets (except table), the aggregate functions, such as count(*), avg(), sum() and so on, should always be preceded by a field. If the fields and functions in the query are not in this order, some visualizations do not work.
    For an example of creating a conversion analysis using the funnel widget, refer to the next procedure: Conversion Analysis.
  3. Click Add Widget, then select Custom Widget Builder or Funnel Widget Builder depending on the type of widget that you want to create.
    The funnel widget is configured differently from the other custom widgets, which use Y and X axes as the basis of the configuration. A funnel widget is used to display data in progressively staged proportions in a color-coded funnel.
    You can add a title to the widget by over-writing Widget Title on the canvas.
  4. After adding a widget and fields, you can right-click a widget value to see other options. Select "Apply a global filter for <field_value>" to add the value to the existing search criteria.
  5. Click Save & Close to save the widget configuration.

Conversion Analysis Using Funnel Widget

Funnel analysis involves using a series of events that lead towards a defined goal, such as from user activity in a mobile app to a sale on an eCommerce website or from advertisement to purchase in online advertising. With the funnel widget, you can visualize use cases such as:

  • Retail application checkout drop-off rates from the point of adding items to the shopping cart to actual purchase
  • Home mortgage loan approval drop-off rates from submitted application to approved applications
  • Impact of performance issues by total sales, customer segment, location and products purchased can be gauged by using a funnel along with other health rule widgets as shown in this custom dashboard:

Funnels return the number of unique actors that successfully (or unsuccessfully) make it through a series of steps. Actors could mean users, devices, or any other identifiers that are meaningful to you. A funnel analysis reveals where a given flow loses the most actors. This helps identify areas for improvement, as well as the overall health of your business.  

The first step in the funnel is the anchor step, and always represents 100% of the results. The filter criteria for the first step creates a set of unique values, and every subsequent step results in a subset of the values from the previous step and renders the corresponding drop-offs. The second and later steps describe the number of events that match criteria for each step towards the goal. This number is typically less than 100%, but could be 100% if every event matches the subsequent steps. 

Build a Funnel Widget

  1. From the Analytics Search page using Drag and Drop (Basic) Mode, select the Visualization tab.
  2. Click Add Widget > Funnel Widget Builder.
  3. In the Funnel Definition pane, click the down arrow to select the unique field representing the items that you are counting. In this example, following the steps of a loan approval process, LoanId is used. The fields depend on your application. There is a limit of 50,000 unique values for the first step. If you encounter this limit, you can try decreasing the global time range and look at fewer values at a time.
  4. Label the first step and continue to add steps as needed for your application process.

    For this example, the first step represents the number of submitted loan applications. The search criteria includes the AD-Capital application and the /portal/SubmitApplication business transaction.
  5. Continue to add and label your steps. This step represents the number of loan applications that reached the stage "Documents Verified".
  6. After you have added all the necessary steps, click Add & Close Widget Builder to save the completed funnel widget. This example contains two additional steps representing loans that reached the credit check and approval stages.
  7. Once you finish building your funnel, remember to name and save your Search. 
  8. To add the finished funnel widget to a custom dashboard, click Actions > Add to Dashboard.

Using Funnel to Troubleshoot 

The finished funnel widget for the above example shows the drop-offs (Abandoners) in unique loan Ids from submission to approval. When creating the funnel, you can also select Show Health in the properties pane to display a health overlay that correlates application health data with the business conversion data. This helps to visualize performance for each step of the funnel widget.

 Using the health overlay is supported for events types that contain a user experience value:

  • Transaction Events – userExperience
  • Browser Records – pageexperience
  • Mobile Snapshots (Network Requests) – networkrequestexperience
  • Web Session Records (Browser Sessions) – experience
  • Mobile Session – networkrequest.networkrequestexperience

For enhanced troubleshooting, you can drill down to event data from any of the funnel steps by double-clicking the numbers on conversions and abandoners, or by using health overlay and clicking on each health segment.

Configure Custom Widgets

To configure custom widgets for your analytics searches:

  1. From the Analytics Search page using Drag and Drop Search (Basic) Mode, select the Visualization tab.
  2. Click Add Widget > Custom Widget Builder.

  3. To add a field to a widget, drag the field from the Fields panel on the left to the Y or X axis on the right. The available fields are based on the fields returned by the search.
  4. From the Chart Types panel on the right, click the widget type to use for the display. The widget is previewed in the main panel. You can experiment previewing which widget type is best for visualizing a particular data set.

    • Usage for the X and Y axes depends on the chart type. The UI prevents you from adding more fields than the widget supports. Different widgets have different limits for the maximum number of fields permitted on each axis.
    • For the time series widgets (area, line, scatter, histogram), you can use the Resolution field that appears on the X axis to customize the frequency displayed if you do not want the widget to automatically select a default resolution based on the current time range. This time resolution field is not counted toward the field limit. Granularity of resolutions that can be chosen depends on the Global time range.

Custom Widget Builder Data Type and Field Restrictions

Widget Type

Data Type

Number of fields on Y-axis

Number of fields on X-axis

Column (simple)



up to two


up to two

two or three

zero or one

Pieanyoneup to two
Tableanyoneup to ten
Tree Mapanyoneup to two

Time Series (Area, Line, Points, Column)






two or three


Percentile Histogram
(Not available in Advanced Mode)

Numeric (Univariate)anyonezero
  • No labels