Firebot's analytics feature allow you to comprehensively analyze the user behavior of the bot over a defined period of time. In the following, the individual elements of Firebot's Analytics are described in more detail.
The widget bar provides a rough overview of various parameters over the selected time period. This can be selected in the upper left corner via the dropdown menu.
The widget bar shows the following parameters:
The number of user interactions over the selected time period. A user interaction is a click on a button (or Quick Reply), or a text input (freetext).
Interactions this billing month
This box displays information about bot interactions (not to be confused with user interactions) of the selected time period.
Each Firebot plan contains a different number of inclusive interactions - the number of remaining interactions this billing month can be read in the small info box below the box.
A billing month starts on the day the bot is created and lasts around 30 days (until the same day of the following month)
An interaction is a block sent by the bot to a user (one or more text or video messages) - regardless of how many user messages preceded it.
Users who communicated with the bot during the selected period for the first time.
- In the small info box below the box you can see the total number of unique users. Unique users are the group of new users plus existing users (from previous months) who communicated with the bot during the selected period.
Facebook users, split by gender (if set). This value will not be displayed for users of Amazon Alexa or the Firebot web client or if the anonymous user function (under Settings / Bot) has been activated.
This box displays the average session duration over the selected period.
A session is counted if:
- one user triggers at least 2 interactions within 10 minutes.
A new session is counted if:
- the distance from one interaction to the next is greater than 10 minutes.
No session is counted if:
- the user only saw one block (e.g. when reloading the page of the web client),
- the user only triggered a single user-interaction (for example, click on a quick reply) within 10 minutes.
Users with sessions
This box shows the number of unique users who have triggered at least one session. The small number (from 1 to 5 or more) indicates the total number of sessions of each unique user. For example, if the second ('2') value shows 240 above the small 2, it means that 240 unique users had 2 sessions, interacting with the bot 2 times more than 10 minutes apart (with at least 2 user interactions each).
The 3 graphs (Communication, Sessions and Users) show the respective values on a daily basis (over the selected period) and per source (Facebook, Web or Alexa).
Clicking on an element in the legend shows or hides the respective value.
This graph plots all user-interactions and blocks sent by the bot. The data is organized as follows:
Attachments : (file) attachments sent by users to the bot (eg images, locations).
Freetext : text input sent by users (_without misunderstood inputs).
Misunderstood : freetext input not understood by the bot.
These entries usually lead to the block for misunderstood free text input - this can be defined in the Bot Settings (Settings / Bot).
Quick Reply : that's how often Quick Reply Buttons were clicked.
Quick Reply Buttons are always links between 2 blocks.
User-messages total : all user messages added up.
Group messages : group messages sent by the bot.
Blocks : blocks sent by the bot.
This shows the total number of individually sent blocks . For example, if 2 blocks are linked via the Show Block action, these are considered 1 interaction , but are shown in this graph as 2 blocks .
This graph displays all sessions and their average duration (in milliseconds) for the selected time period. In addition, all values for users with sessions are displayed separately.
This graph displays all users and their gender for the selected period. Users are split up into the following groups:
New : all users who have communicated with the bot for the first time over the selected period.
Unique : all new and existing users who communicated with the bot for the selected time period.
Recurring : users who have already initiated at least one session and communicated again with the bot.
Recurring users are calculated from the difference between all individual and new users.
Male, female, other genders : Facebook users split by gender (if defined).
This graph shows the total number of all variables set and their individual values for the selected period. A click on Details opens a small pop-up window that displays a list of the concrete variable values.
This list shows all the blocks sent by the bot and the number of respective connections (user-interaction) for the selected period.
The accumulated number of all incoming and outgoing user interactions is shown in gray to the left and to the right of the name of the respective block.
A click on Funnel opens an interactive view of the bot-graph showing all links in different widths that depend on the number of views. The total number of views is indicated on the respective link as a number in square brackets.
Referral Parameter (enterprise plan only)
This list displays the total number of users who have started the bot via the respective set (e.g. Facebook Advert or Youtube) referral parameter. The list is divided as follows:
Total : Total clicks on the ad
Users can click multiple times on an ad - this will then count as 2 (or more) clicks.
Unique : Unique clicks on the respective ad (without duplicate users).
Entry : users whose initial contact with the bot was the respective ad.