Beacons

Beacon hardware.

From welcoming people as they arrive to an event to location specific real time information about your latest offer in-store. Beacons allows you to use your location awareness, and offers new opportunities for interactivity between your users with mobiles and the Beacon hardware.

What is iBeacon?

iBeacon is a Bluetooth advertising protocol designed by Apple. Apple’s own introduction to iBeacon is available at developer.apple.com/ibeacon.

Hardware requirement

Beacon is a small Bluetooth transmitting device which does not require any installation. These signals can be received by any other device within the range of approximately 150 feet. You can target message to anyone within this range. The advantage of beacon is that it can be placed anywhere with ease and can be removed easily as there is no installation needed.

Mobiconnect platform supports iBeacon format. Hence you can use any beacon which supports iBeacon format.

 

iBeacon normally has 3 main parts:

UUID

Unique Universal Identifier,16 bytes, usually represented as a string. This is the most generic information say for example, this beacon belons to a particular store location inside a mall.

Major

Number, 2 bytes, or an “unsigned short”, i.e., a number from 1 to 65,535. This is most generic info say for example to identify the store level.

Minor

Number, 2 bytes, or an “unsigned short”, i.e., a number from 1 to 65,535. This can be used for more fine-grained information say what aisle in the store level 1.

The iBeacon frame also gives you information about your proximity to the beacons as Immediate, Near or Far.

 Based on the above information you should be able to publish relevant information to the users.

Setting up your Beacon with Mobiconnect

  1. Authenticate to our platform using our authenticate API. (link to authenticate API)
  2. Add beacon to the platform using our add Beacon API or use our platform frontend.
POST https://live.mobiddiction.com/api/beacon
Content-Type: application/json
Payload:
{
  "name": null,
  "majorId": 10065,
  "minorId": 10063,
  "uuid": "fda50693-a4e2-4fb1-afcf-c6eb07647825",
  "radius": null,
  "active": true,
  "lat": "-37.84053811257083",
  "lon": "145.11531829838668",
  "proximity": "NEAR"
}

3. Create a segment for this beacon using create beacon segment API (link to create segment api)

POST https://live.mobiddiction.com/api/segment
Content-Type: application/json
Payload:
{
   "name":"Test",
   "beacon":{
      "uuid":"fda50693-a4e2-4fb1-afcf-c6eb07647825",
      "lat":13.0482176,
      "lon":77.66015999999999,
      "minorId":"45678",
      "majorId":"34567",
      "active":true
   },
   "proximity":"UNKNOWN"
}

4. Update the user/device with when they come in range of this beacon using our User/Device Beacon Update API.

Inform Mobiconnect that the device is in the beacon range.

PATCH https://live.mobiddiction.com/api/beaconUpdate?deviceId=<id>
Content-Type: application/json
Payload:
{
   &quot;uuid&quot;:&quot;fda50693-a4e2-4fb1-afcf-c6eb07647825&quot;,
   &quot;minorId&quot;:&quot;45678&quot;,
   &quot;majorId&quot;:&quot;34567&quot;,
}

Update Mobiconnect that the user is in the beacon range

PATCH https://live.mobiddiction.com/api/beaconUpdate?userId=
Content-Type: application/json
Payload:
{
   &quot;uuid&quot;:&quot;fda50693-a4e2-4fb1-afcf-c6eb07647825&quot;,
   &quot;minorId&quot;:&quot;45678&quot;,
   &quot;majorId&quot;:&quot;34567&quot;,
}

Not sure how Beacons work?