How to enable SignMetrix Audience Measurement Extension on BrightSign Players?

Quickstart Guide

Version 1.3

Pre-Requisites

1. BrightSign 3,4,5,6 Series Player
2. BrightSign Wi-Fi / Bluetooth Module installed (WS-103, WD-104, or WD-105)
3. SignMetrix Data Analytics Dashboard login credentials

Steps:

1. STEP 1: Update BrightSign Player OS
2. STEP 2: Install the SignMetrix OS extension to the Player
3. STEP 2: Add Player to SignMetrix Dashboard

STEP 1: Update BrightSign Player OS 

Please update your BrightSign Player's OS version 9.1.92 or higher.

STEP 2: Enable SignMetrix Extension 

To add SignMetrix audience measurement to your BrightSign player, you need to install the SignMetrix OS extension. There are a number of SignMetrix OS extension downloads that support BrightSign players ranging from Series 3 to Series 6. Please download the version that matches your player from the SignMetrix Dashboard > Downloads > BrightSign > OS Extensions

If you don't have your SignMetrix Login Credentials, please visit https://signmetrix.com, complete the Subscription request form to receive your Login credentials. 

There are handful of ways to enable SignMetrix Extension on your BrightSign Media Players:

1. Using SD Card

2. Using The Remote Diagnostic Web Server (RDWS) 

3. SignMetrix Panel, Push Extension Page

1. SD Card

Copy the Extension to the SD card

The SignMetrix OS extension needs to be copied to the player’s SD card, and the player needs to be rebooted. After the player reboots, the extension will appear in the info tab of the BrightSign player’s device webpage. It is that simple.

How do you put the OS extension onto the SD card? 

Three options:

1. Remove the SD card from the player and copy the extension to the card. Return the SD card to the player and reboot.
2. Use the BrightSign device webpage and upload the extension using the SD tab, and then, in the Control tab, reboot the player.
   
   
   
   
   
   
3. Publish a presentation using Standalone or LFN (Local File Networking), and select the extension as an OS update in the Publish tab. The player will automatically reboot.
   
   

2) Using The Remote Diagnostic Web Server (RDWS) 

3. In BrightSignOS Update > Update Options, select the Custom URL option and paste the SignMetrix Extension link, and click Update. This will update the OS on the player. As part of this process, the player will reboot.

 

 

 

 

 

4. When the player is rebooted, click the Info tab to see the SignMetrix Extension indicated. 

3) SignMetrix Panel, Push Extension Feature

This SignMetrix feature enables you to remotely deploy or update the BrightSign extension across thousands of online media players via the SignMetrix Panel.

Helps you to:

• Import BrightSign devices into the SignMetrix system

• Send the latest extension to BrightSign players

• Set register values for BrightSign players

To use these functions, you must log in to a BrightSign network.

Please enter an authorized Client ID and Client Secret, which can be obtained from:
https://adminpanel.bsn.cloud/

More detailed information is available at:
https://docs.brightsign.biz/developers/authentication#api-workflow

To use all functionality, please ensure the following permissions are granted:

• Main Features > Actions

• Main Features > Devices > Retrieve

• Self Features > Networks > Retrieve

After entering the Client ID and Client Secret, select the network from which you want to retrieve devices.

Importing Devices from a BrightSign Network

1. Go to panel.signmetrix.com
2. Click Downloads > BrightSign > Setup >
   Synchronize with BrightSign Network
3. Log in with your Client ID and Client Secret,

4. Click the Import Players tab.

5. Click Fetch Players. All players in the selected network will be displayed in the grid.

6. Select the players you want to import.

7. Choose a Device Group to assign or update the device group.

8. Select a License to assign during the import process.

9. Click Import Players.

You will see either Imported or Import Failed next to each selected player.

Pushing the Latest Extension to BrightSign Players

1. Click the Push Extension tab.

2. Click Fetch Players. All players in the selected network will be displayed in the grid.

3. Select the players to which you want to push the latest extension.

4. Click Push Extension.

You will see either Installed or Install Failed next to each selected player.

Setting Register Values for BrightSign Players

1. Click the Register tab.

2. Click Fetch Players. All players in the selected network will be displayed in the grid.

3. Select the players for which you want to set register values.

4. Click Register.

You will see either Registered or Register Failed next to each selected player.

Registering a player sets the BrightSign register section to "signmetrix", the key to "config_api_server", and the value to the content of the API Server URL textbox.  

STEP 3: Add Player to SignMetrix Dashboard

• Single Player (Email)
  Send the BrightSign player serial number and player location details to support@signmetrix.com. We’ll complete the remaining onboarding steps and assign licenses.

• Multiple Players (Excel Import)

1. Download and fill out the onboarding Excel template here.
2. Submit in one of the following ways:
   1. Email the file to support@signmetrix.com, or
   2. Upload to SignMetrix Panel > Downloads > BrightSign > Setup > Import Excel.

RESULT

• Your existing content will function exactly as before.
• The new SignMetrix Extension will run in the background, allowing SignMetrix Analytics to operate without disrupting any visual content or CMS functionality.