Skip to main content
ExLibris

 

Ex Libris Knowledge Center

Ordering iBeacons for Touchpoint Usage

Overview

Beacons are simple low energy Bluetooth emitters that comply with the Apple iBeacon protocol. By broadcasting identification information, portable electronic devices benefit from micro-location based services when in physical proximity with any specific beacon. This technology has been incorporated into the campusM app to allow customers to configure specific beacon locations which in turn may drive specific actions per defined beacon.

This document outlines how customers may order beacons from our authorized supplier, attain the necessary beacon specs from the supplier and return the required information back to Ex Libris so that these positions may be configured by Ex Libris in the relevant app.

Each beacon, when triggered, will execute all position actions associated with its position. Positions must be defined as a pre-requisite to setting up beacons in campusM. For more information on positions and position actions, please review this page.

Ordering iBeacons

An institution can independently purchase iBeacons from our certified provider: Kontakt.io.

Please follow these steps to complete the purchase and deployment process:

Step Details
Receive your institutional UUID (Universally Unique Identifier) Submit a Salesforce case to request your institutional UUID value (this is a persistent code you should use for all beacon purchases. This step need only be performed the first time you order a beacon)
Complete spreadsheet

Download and complete the iBeacon Location Template with the details and configuration for the beacons being ordered. 

For guidance on what UUID, major and minor values to use, please review the instructions below.

Send completed spreadsheet to Kontakt.io Send the completed template to the iBeacons supplier – Kontakt.io – who will process your order, together with pre-configuring the ordered physical beacons according to the filled template.
Note that the beacons are shipped to you directly and will include the details needed to populate your Kontakt Panel with the beacons.

Spreadsheet Completion Instructions

The iBeacon Location Template is divided into 3 worksheets:
  • Instructions – provides basic information on how to complete the sheet
  • Order Details – Contact and payment information for the order. You can also add your own logo to the beacons (the default is the campusM logo)
  • iBeacon details – The specific settings information beyond the UUID to set for each beacon in order to uniquely recognize and optimize its efficacy and location services

iBeacon Details tab

To complete the fields in the iBeacon Details tab, please use the guidelines in the table below. There are 4 mandatory parameters to set for each beacon in order to ensure they trigger the position action effectively when setup in campusM.

Field Details
UUID (Universally Unique Identifier) Unique institutional identifier value (will be supplied by Ex Libris on request, and used for all your purchased institutional beacons)

Major

The major value should range between 1 and 20, and should be varied between collocated/nearby positions to maximize touch point triggering.

Minor

Should be unique for every iBeacon configured in campusM

Power

This should range between 0 and 7 and indicate the power output of the iBeacon. This changes the range and the battery life according to the table below
 
For more details on major-minor details please review this page.

iBeacon Power and Battery Life

The table below provides an indication of the range and battery life of the Kontakt beacons based on the assigned power level:

Power Level

Approx. Range (Meters)

Approx. Battery Life (years)

0

2

6

1

4

5

2

10

4

3

20

3

4

30

3

5

40

2

6

60

1

7

70

<1

 

iBeacons Configuration

Once the beacons arrive, initiate the coordination for their configuration in campusM by following these two steps:
  1. Open a Salesforce case requesting the configuration of the new beacons in the campusM app, and attach the completed iBeacons Location Template to the case
  2. Ex Libris will complete the beacon configuration for your campusM app and update once completed