This guide will help you understand:

• What are Analyses in Bloomreach Engagement
• Analyses currently available in Bloomreach Engagement
• How to use Parameters

What are Analyses in Bloomreach Engagement

The Bloomreach Engagement platform contains several useful tools collectively called Analyses. The primary purpose of these tools is to allow you to manage your data effectively. Not only do they allow you to gather new insights into your customers' behavior, but they also help in presenting your findings by transforming raw data into comprehensible data structures.

The analytics can be found by clicking on the Analyses section located on the menu in the Bloomreach Engagement web application.

Analyses currently available in Bloomreach Engagement

Please visit their dedicated page in the subsections to learn more about specific analytical tools.

Analytics & Reporting Template Library

To overcome the complexity of analytics, the Analytics template library gives you the option to work with user-friendly predefined templates. Currently, the Analytics template library only offers dashboards and reports templates.

For the dashboards templates, navigate to Overview > My dashboards > '+ Create new'.

For the reports templates, navigate to Analyses > Reports > 'Create new'.

Simply,

1. Search for a specific template

• via tags as a filter
• via a search that looks for keywords in the name and description

2. Pick the template based on a use case and feature (reports, funnels, trends...)
3. Edit the analysis if necessary

All users who can edit the analysis can import the template.

👍

Suggest new templates

You are also invited to suggest a new template so that we know which predefined template to generate next.

How to use Parameters

Parameters allow you to filter and interact with the data in dashboards, analyses, and definitions. You can apply filters to all levels of underlying analyses (e.g., the filter applies to a condition in an aggregate nested in an expression).

Parameters are based on dynamic attributes, which can be added to any analysis (e.g., report, metric, funnel, etc.). They do not require you to provide an exact static value for a condition; instead, the dynamic parameter serves as a placeholder. This allows anyone in read or preview mode for a particular analysis to provide the static value at a later stage.

How to later provide the static value for a dynamic parameter?

• Manually by someone on the Preview screen for a particular report.
• Values such as ‘campaign_id’, ‘banner_id’, ‘experiment_id’, or ‘survey_id’ can be provided automatically for a particular campaign if the dashboard is picked in the Evaluate tab.

You can make use of Parameters in multiple different ways, including:

• filtering the data by a specific value of a condition in an aggregate
• specifying campaign_id, campaign_name or banner_id, etc., in multiple funnel steps or the running aggregate in an expression
• changing the attribution window of a report (used in multiple underlying analyses)

How to set up Parameters

1. Visit the Edit mode of your report.

2. In any place where a static value is used (e.g., example.com), replace it with a dynamic parameter. Start by typing double square brackets, continuing with the parameter name, and ending with double square brackets (e.g., [[email_domain]] ).

3. Once you close the brackets, the look of the input field changes to blue color, indicating that the application has accepted a dynamic parameter instead of a static value.

4. A new Parameter appears near the bottom of your analysis, helping you specify a static value and check if your analysis is calculated correctly.

5. Try to input different values and check if the report displays correctly by confirming the value using the ‘Preview’ or ‘Refresh’ button.

6. Suppose your analysis is used as part of another analysis (e.g., a metric is used in a report or a report in a dashboard). In that case, the Parameters are also displayed in the read mode for the top-level analysis. This allows the end-user to specify values for the controls and interact with the displayed data.

You can use the same naming conventions for the parameter in multiple different event attributes. What's important is to specify the logic in brackets [[example]]. If you use the same naming convention for the parameters in different events, the same value will be applied to all of them.

It's useful to use many parameters in the same dashboard to make it more user-friendly. Instead of adding values to each parameter, you should do it only once.

❗️

Limitations

• You can only specify one value for each control.
• There is no support provided in API for analyses with dynamic attributes.
• Jinja cannot be used where parameters are used (e.g., in filter conditions).
• Entities, that used parameters, cannot be downloaded as CSV.
• Using RegEx in the parameters is not supported.
• Entities that used parameters, cannot be accessed via jinja reference.