The Usage Summary tool shows data-driven statistics and reports on your Organization’s usage of Bloomreach features. It also allows you to filter and aggregate the data per your needs to help analyze usage patterns and traffic to make better decisions impacting the business and revenue.
Whether you're interested in tracking your usage trends over time, keeping an eye on resource utilization, or staying within your usage quotas, these reports can serve a variety of use cases.
By default, the Usage app will be present in your dashboard. To begin, users must be granted the "Usage Report User" role on the organization or account level. This can be accomplished by someone with the “IAM Admin” role by navigating to “Setup > User management”. Users should log out and refresh their role assignment for the new role to take effect.
Once the "Usage Report User" role has been granted on the organization or account level, the Usage tool can be accessed inside the Bloomreach Dashboard by navigating to “Setup > Usage”.
Note: By default, the report shows usage for the entire organization, irrespective of the account or site currently being viewed. Account level Usage stats can be viewed by applying the "Account Name" filter.
The generated usage report has different components to help find what’s most important to you at a glance. This section will briefly walk through each component, see what information they provide, and how you can use it to make more informed decisions.
Good to know
The report’s data is calculated by using aggregation pipelines on the API requests that our internal system receives.
The Total Requests section displays the total number of all types of API requests made in the last 24 hours, last 7 days, and last 30 days. These numbers are for your entire organization and can be considered as Key Performance Indicators. Note that this includes all the Request Types aggregated.
Under the number of requests made, you can find the absolute increase/decrease in that number (and % change) from the previous 24 hours, 7 days, and 30 days respectively.
All this data can be helpful for tracking adoption and usage over time and identifying potential trends or patterns in how your service is being used. You can alter your resource allocation based on the search traffic you’re getting.
For example, if you see a sudden spike in total requests, you might want to consider allocating more resources. A steady increase in search requests might indicate increased demand for your products, so you can focus more on the business plans to continue with the growth and capitalize on the opportunity. The data can also help you troubleshoot issues. A decrease in the number of requests might be due to performance issues or other pain points in your website.
The Request Count section is a bar graph visualization of your organization’s API request data. Unlike the Total Requests section, this is an interactive section, and you can manipulate and configure the graph by drilling down the bars using filters and ranges.
The visual representation is perfect for quickly finding low-performing days/months and looking at variations.
On hovering over different bars in the bar graph, you can see the exact dates, request count and request type that the bar represents.
To get the data for a specific time duration, apply a Date Range. The default view shows the Last 30 Days’ data, but you can choose from Last Year, Last Month, or even a custom date range from the calendar.
Analyzing the data from a specific time duration, like a quarter or your sprint duration, helps you quickly and easily compare the trends and patterns of usage. You can use that to find the areas of improvement, gain a deeper understanding of the drivers behind your usage and find seasonal opportunities.
You can easily switch between Day-wise or Month-wise views. Each bar will represent a day if you select “Day” and a month if you select “Month”.
Group By helps you group and aggregate the search request data by different parameters. By grouping the data, you will be able to see the individual figures for different available values of the selected parameter. For example, if you select “Environment”, the graph will highlight which requests were made from production and staging differently for the selected time range.
The Requests section shows the same data as above but in tabular format to help you analyze the absolute numbers in more detail.
We also provide a Download CSV button to let you download the tabular data as a CSV file if needed.
A powerful way to make the best out of the Usage Summary dashboard is to use the different available filters and only focus on the data that is most relevant to you.
Here are the filtering capabilities available currently for the usage statistics:
You can filter the API requests for the production and the staging environment. You don’t need to go to tools-staging to access usage for staging.
Filtering by the environment helps distinguish between production and staging requests.
You can filter the API request data by the HTTP status code.
Filtering by status code allows you to identify points of failure and errors. By focusing on requests with a response code of 400 or 500, you can quickly identify issues such as invalid requests, authentication failures, or server errors, and take the appropriate action to resolve them. Additionally, it can also help you monitor the performance and availability of your site’s functionalities.
If you’re interested in looking at your usage of a specific Bloomreach API, you should filter by Request Type.
Here’s a list of the different request types and what they mean:
|keyword||The Product Search API sends a keyword query to retrieve results about products and other content on your site|
|mlt||More Like This (MLT) extends search results to show visitors more products similar to a product that they already searched for or viewed|
|bestseller||The Bestseller API returns the products that are likely to generate the most revenue|
|suggest||Autosuggest guides site visitors by providing search term suggestions, which are sometimes called autocomplete or type-ahead|
|category||The Category API sends a category query to retrieve results about products within the categories that you specify|
|jfy||Just For You (JFY) is a Product Recommendations service that displays product recommendations for customers based on their browsing history|
|keyword-widget||The Keyword-based Widget API sends a keyword or query to get the product results via a widget|
|category-widget||The Category-based Widget API sends a keyword or query to get the product results via a widget|
|co-viewed||The Recommendations Widgets API that shows the co-viewed products (Frequently Viewed Together)|
|co-bought||The Recommendations Widgets API that shows the co-bought products (Frequently Bought Together)|
|recently-viewed||The Recommendations Widget API that shows recently viewed products in the widget|
|trending||The Recommendations Widget API that shows the trending products across that category|
|past-purchases||The Recommendations Widget API that shows the products included in the past conversions|
|experience-driven||The Recommendations API that displays highly targeted product recommendations by leveraging Bloomreach Search understanding as well as site browsing behavior (also known as "realtime_recs")|
|invalid-widget||All the incorrect requests we receive for the Widget APIs|
|thematic||Thematic pages are customized landing pages that are similar to category pages|
|visual-search||The Visual Search APIs fetches a list of objects and similar products identified from the uploaded image|
The Catalog filter helps identify the number of requests made to a particular catalog.
This can be helpful if you want to focus on a few particular catalogs and optimize product performance or manage inventory.
The default view shows your Organization-wide usage statistics. It is highly likely that you will need to drill that down to a particular account’s usage and only focus on that data.
This can be helpful if you’re looking, for example, for the trends in traffic from a specific region that that account is for.
If you are using both Product search and Catalog search, choosing their corresponding data types will narrow the results down by the type of search performed (or the type of data returned):
- "product" - for Product search (returns product data)
- "content" - for Content search (returns content page data like blogs, articles, etc)
Updated 6 days ago