Zone Analytics

This section includes a guide on how to visualize datas of your application, create charts and build your own dashboard.

Structure of "Zone Analytics" section :

  • Setup
  • Query builder
  • Key indicators
  • Chart Builder
  • Dashboard


1. Setup

Before diving into how to create a visualisation, make sure your setup correspond to the venue you want to visualize, by choosing the right application and the right venue. NB: all the fields (Insert access token, Choose application, Choose venue) must be thicken in green

2. Query Builder

This section is composed of 4 components (from right to left) :

  • (1) Eye widget : Depending on it's state this widget enables to update automatically the timeframe by setting the end date to the current date. When the widget is crossed, the end date is updated to the current date every 30 seconds. If not the timeframe remains unchanged.

  • (2) Date Range Picker : By choosing the date range, all statistics of the Dashboard are calculated and visualised within this date range. Two options for choosing the date are available : Absolute : You have the possibility to pick the start/end date and time manually. Quick : You have the possibility to set a date range based on the predefined options (Today, Last 1 hour, Last 1 year ...)

  • (3) Query field : By using this field you can apply queries on statistics to select or unselect specific values.

      Example 1 - "zone.name:tech AND zone.name:sales"  to visualise only statistics related to the zones named "tech"  and "sales"
    
      Example 2 - "zone.name:tech AND NOT zone.name:sales" to visualise statistics related to the zone named "tech"  and hide those related to "sales" 
    

The list of the accepted variables and values are listed in the following table :

Table to come

  • (4) Add a filter : You can add filters to the Dashboard view by clicking on "+ Add a filter". When it is done, you must choose a source , an operator and a value. Two fields (filter query and status) on top of the query builder will appear. You can then activate/disable the filter by clicking on the status field. NB : Clicking on the cross will delete the filter.

3. Key indicators by zones

By default, the Zone Analytics section contains a table that summarizes key statistics of the venue related to the selected timeframe . It enables the user to get an overview of basic statistics related to each zone of the map. Below, you can find the different entries of the table :

(1) Type : the type of the tracked asset. It can take 2 values - smartphone or token (2) # devices : the number of unique devices that entered each zone (3) # entries : the number of entries in each zone (4) Avg visit : the average duration of a visit in each zone (in second) (5) Min presence : the minimum duration of an asset in each zone (in second) (6) Max presence : the maximum duration of an asset in each zone (in second)

4. Chart Builder

This part enables you to create/edit/delete a graph of your Dashboard and design it according to your needs. Your dashboard is flexible as all graphs can be resized as you wish and positioned wherever you want by dragging them. NB :

  • A small arrow in the bottom left corner can be clicked to change the visualisation mode (graphical vs raw datas)
  • You can always edit your graph by clicking on the "pencil" on the chart

To create a visualization:

  1. Click on the tab "Chart" in Chart builder navbar .
  2. Choose the visualisation type :
    • Pre Define
    • Basic Chart
    • Indoor Map
Predefine Graphs

By selecting Pre Define you can choose the inhouse available visualisations that are ready to be added to your dashboard, give them a title and choose its size.

Here is the list of the available pre define graphs :

  • Alerts
  • EntriesOverTime
  • FlowOfTransition
  • TimeInZone
  • EntriesOverTimeByZone

Once you decided the type of the visualisation you want to generate :

  1. Select a radio button :
    • alerts if you want to visualize graphs related to Alerts
    • zone_visits if you want statistics on zones
    • positions if you want statistics on conitinuous positions (for heatmaps)
  2. Select Pre Define graph
  3. Choose the type of the graph
  4. Add a title
  5. Choose the Width and Height of the graph (NB : the size can be redefined by reducing the size of the graph container)
  6. Click on "Go" button to add the graph to your dashboard

  7. Alerts : All alerts defined and generated in the "Real Time Visualization" view can be visualised in the Alert timeline visualisation. MousingOver the symbol in the graph enables you to identify the device.

  8. EntriesOverTime, shows the aggregated number of entries in all zones.

  9. FlowOfTransition also called "sankey diagram" enables you to visualize the flow transition between zones during a trajectory. Each node represent a zone, and the thicker is the edge the more often the transition occured.

  10. Time in zone can be visualised through a pie chart and represent the distribution of the time spent in each zone.

  11. EntriesOverTimeByZone represent in a timeline the number of entries for each zone.

Basic Chart
  1. Select type "Basic Chart" and choose the representation you want to create :
  2. Pie enables you to display each source’s contribution to a total.
  3. HorizontalBar, VerticalBar, Line and Area allow you to plot your data on X/Y axis

  4. Add a title

Now that you selected the representation, you need to select your metric which define the value you want to focus on.

  1. Go to the section "Aggs" to choose : a- your metric aggregation b- your metric c- your bucket aggregation d- your field bucket

  2. (Optional) Add a filter to your chart

  3. Click on "Go" button to add the graph to your dashboard

NB : in "Options" you can see the code of the graph you created.

Below the list of the possible metric aggregations:

Count : The count aggregation returns a raw count of the elements in the selected index pattern. Average : This aggregation returns the average of a numeric field. Select a field from the drop-down list. Sum : The sum aggregation returns the total sum of a numeric field. Select a field from the drop-down list. Min : The min aggregation returns the minimum value of a numeric field. Select a field from the drop-down list. Max : The max aggregation returns the maximum value of a numeric field. Select a field from the drop-down list. Unique Count : The cardinality aggregation returns the number of unique values in a field. Select a field from the drop-down list.

Indoor Map

You can also access detailed analytics about where your application users have been moving through two visualisations :

  • Heat Map
  • Choropleth
Heat Map
  1. Select Type "Indoor Map"
  2. Select radio button "positions"
  3. Select HeatMap
  4. Select the venue
  5. Add a title
  6. Click on Go

Chorolpeth
  1. Select Type "Indoor Map"
  2. Select radio button "zone_visits"
  3. Select Choropleth
  4. Select the venue
  5. Add a title
  6. Go to "Aggs"
  7. Choose your metric and the aggregation's bucket
* Example : If you want to visualise the users' density of each zone, you need to have the following : 
    *  Aggregation.metric: Unique Count
    * Field.metric : user_id
    * Aggregation.bucket: Terms
    * Field.bucket : zone_name
  1. Click on Go

results matching ""

    No results matching ""