Skip to content

Broox Studio

Broox Studio is the online Content and Interaction Management System for the Broox Platform.

Broox Studio is a cloud-based, multiaccount solution.

Concepts

  1. Media are images, videos, active content, etc.
  2. Media are grouped into Playlists.
    • A playlist is just an ordered list of videos, images, HTML content...
  3. Playlists are grouped into Campaigns.
    • A campaign is a container for one or more playlists, and allows scheduling them.
  4. Each Media in a Playlist can be activated by a Trigger Event.
    • A trigger is some kind of "real world" event: picking up a tagged product from the shelf, a presence event, pushing a button...
  5. Every Campaign can be deployed to an Installation.
    • An Installation is some group of screens and interaction devices installed in a given Location .
  6. Each Installation can have one or more Canvases.
    • A canvas is either some whole screen or a part of a screen, and reproduces one Media at a time.

Entering the Studio

Logging in

Broox Studio is an online solution. Depending on the needs of the client, you can use a shared instance or, for larger companies, a dedicated instance.

In any case, you will be sent a Web address and login credentials via email or other means.

  1. Open a browser and type the address of your assigned Broox Studio Instance.
  2. You will be greeted by the login page.
  3. Enter your email in the first field.
  4. Enter your password in the second field.
  5. Click the Login button.

Account Selection

If your account is for a single Account you will go straight to your Home Page.

If you manage content or installations for several accounts, you'll be given the option to select the account you want to work with.

Just Click on the line and you'll access this account home page.

Forgot password?

If you've forgotten your password, you can click on the Forgot Password? link.

  1. Type your email address (the one that you were registered with).
  2. Click on Reset

You will receive an email with a link to a password reset page.

* Note that to avoid leaking user presence information, if you enter a wrong email, the result will be the same.

** If you receive a reset email that you haven't solicited, avoid clicking on the link. Go to the website and change your password.

Home Page

By default, your Home Page shows the Analytics section (If not enabled a placeholder image is shown).

  • At the top right of the page is your user name, that gives you access to the Profile, Settings and Logout Button.

  • At the left, the main menu. If you have multiple accounts, there is also a Back to Accounts button.

  • The central part will display the selected menu option.

Editing your name and password

Clicking your name at the top-right and selecting Profile lets you edit your user name and password (you cannot edit your email address, as it is your login).

  • To change your password, enter your old password and the new one twice, and click Update.
  • To change your common name, just edit it and click Update.

Logging out

Clicking your name at the top-right and selecting Logout will bring you back to the Login Page

Campaigns Section

The campaign section is the more "marketing" oriented one. It lets you control the delivery of media to the different locations/installations. It contains four subsections. From bottom to top:

  • Media Library: A repository of all the uploaded videos, images, sites, etc.
  • Trigger Sets: Allows you to match one or more physical triggers (sensors, tags, etc.) with a product or product range.
  • Playlists: Lets you create lists of media and associate them to those triggers.
  • All Campaigns: Allows you to deliver different playlists and set dates and times of presentation.

Media Library

The Media Library is divided into an Upload Area (top) and a Media List (bottom).

You can drag and drop:

  • Images (JPG or PNG).
  • Videos (MP4 with H264 encoding recommended).
  • HTML5 apps (ZIP compressed).

You can also click Upload new file to open the OS file browser to select file(s).

The uploaded files will show on the bottom Media List.

You can Search for uploaded files, filter by type, resolution and whether used in some playlist.

You can also remove unused files by checking the square checkbox and clicking the trash icon. (If the file is being used, you will get a warning and won't be able to delete it until you unassign it from the playlists it is on).

Trigger Sets

Triggers are abstract interaction events, for example "Raise Product 1" that can be reused for different purposes in different installations.

Trigger Sets allow us to associate this abstract events to concrete, campaign-related actions. For example, "Raise Blue Shoe" in the "Shoe Shop Campaign".

It also allows to group several triggers to the same action.

Creating a playlist

Under Campaigns click on the Playlists button.

You will access the Playlists section where you can create, edit and remove playlists.

Playlists are sets of media to be displayed sequentially, with a common theme or grouping (same product, etc).

We will add a New Playlist by clicking on the rightmost button. This opens the playlist pop-up.

On top, we can set a Name for the playlist.

Under that, we have the Media screen where we can upload, drag and drop or select media from the Media Library by clicking the Browse Media Library button.

Once added, we can assign a QR Coded URL to be shown below each media on the displays.

On Interactive campaigns, we can also assign triggers to each item of the media list. By clicking on the Add button next to each media, we can select the triggers that will activate said media.

Once we have some media added, we can Save the playlist or Cancel the changes. The created playlist will appear on the Playlists screen.

Creating a campaign

Campaigns are groupings of Playlists with different presentation criteria. The most basic one contains just a single content-sequence playlist.

The campaign list shows us all the available campaigns and whether those are being used now in any installation.

As usual, we can create campaigns by clicking the Add Campaign rightmost button, edit existing ones (by clicking on them) and delete unassigned ones (by selecting and clicking the trash bin icon).

We can search by name and filter by type and state.

Creating a campaign shows us the creation pop-up with a Name field, an optional UTM tag (for cross-site tracking).

Under that the Scheduling section and the Playlist Selection section.

We can select a date-time range when the campaign is active, or leave it empty for "always on".

On the Playlists section we select one or more playlists and set its showtimes.

We can click Save or Cancel to record the changes.

If we already have an installation to deploy the campaign to, an additional Assign Canvas section will show, where we can assign the created campaign.

Also, a Save and Deploy button allows us to both save the changes and immediately reload the target installations with the changes.

Analytics Section

Analytics

In the sidebar, select Analytics.

The Analytics Panel show aggregated analytics for all the available installations.

Filtering

You can filter by:

  • Location (or all locations)
    • then Installation (or all of them)
      • then Campaign (or all of them)

The filtering is hierarchical. Selecting a store filters only the installations in that store, and selecting an installation filters only the campaigns in that installation.

  • Date Range, selecting a start and end day:

Exporting

The Export Button will generate a PDF file of the current page.

Sharing

The Share Button will generate an embeddable link of the currently selected options. You can share this link via email/message.

The Graphs

  • Traffic: Count of people passing by in the current period.
  • Dwell Time: Average time people stay in view of the camera.
  • Views: Count of people that have been detected looking at the screen (front-facing to the camera).
  • Avg. attention time: Average percent of the dwell time that the person has been looking at the screen.

  • Audience Gender: Split percent of onlookers gender.
  • Audience Age: Split percent of onlookers age group.
  • Audience Emotion: Split percent of onlookers emotional group.

  • Histogram: Accumulated Graph over time (hours of the day, days of the week, months and years) for:
  • Traffic
  • Views
  • Dwell Time
  • Attention Time
  • Age (split)
  • Gender

Installations Section

Adding a Location

In the Installations section of the menu, we pick Locations and go to the Locations list.

A Location is a physical location where one or more installations are placed.

As usual we have the Add Location button.

This will pop up a form with the location information (name, location, country…) and very importantly timezone if we are to use scheduled campaigns.

Those will start and stop in the selected hours in the location timezone.

Once created, we click on it and start the set-up of the controller.

Creating a location Controller

In the location settings, we find a default created Controller.

We can click on the Edit button of the controller and change the values, but it should not be necessary.

  • Controller Name: whatever you want the controller to apper in the list.

  • IDENTIFIER: A defined name, without spaces for the controller. > e.g. MY-CONTROLLER-1

  • IP Address: If you know it, if not enter a placeholder like 127.0.0.1 or the like.

Clicking on the reload icon will generate a new API key. You should not change it after the installation is running.

License File

To install Broox Controller you can download your .license file using the icon.

This will create a NAME-OF-CONTROLLER.license file that you will use when setting up Broox Controller.

Creating an analytics installation

  1. Open Broox Studio

  2. Go to Installations->Locations and into the previously created Location.

  3. If the Broox Controller was running while you tested the Vision Node, the Vision Node will appear in the list of devices.

    1. If not, start up Broox Controller.
    2. Then start up Broox Vision Node selecting the active controller. The Vision Node will appear in the list.

  4. Go to the Installations tab.

  5. Click on Add Installation.

  6. Set a name for the new installation.

  7. Select the nodes you want to add, and click Next

  8. If you have any Media Players, add the necessary canvases.

  9. Click Next and Save.

Now you can restart Broox Controller and Broox Vision Node on the PC. Data should start going into the Analytics tables as soon as people are detected exiting the scene.

Getting a Licence

  1. Log in to Broox Studio with your provided credentials.

  2. On the "Accounts" screen, select your target account:

  3. You will be directed to the main screen, showing analytics (if present, if not a placeholder) and a left-side menu.

  4. Move to the Locations section of the menu.

  5. Press Add Location button.

  6. This will pop up a form with the location information (name, location, country…) and very importantly timezone if we are to use scheduled campaigns. Those will start and stop in the selected hours in the location timezone.

  7. In the location settings, we found a newly created controller in the Nodes page.

  8. Download your .license file clicking the Download License button.

  9. This will create a NAME-OF-CONTROLLER.license file that you will need to activate Broox Controller.