Cisco Meraki

Resources required for customers with Cisco Meraki access points to connect with the Beaconinside DMP platform.

This manual gives a detailed guide on the usage of data from Cisco Meraki Dashboard on the Beaconinside Proximity Data Management Platform (DMP). You can sign up and log in at dmp.beaconinside.com.

Initial Setup

Connect via Meraki API Key

In order to begin importing data from your Cisco Meraki Dashboard in to the Proximity DMP, you will need an API Key. Once a valid API key has been registered, you will be prompted to import.

Follow the below steps:

  1. To generate the API Key visit Dashboard API access on your Cisco Meraki account (Home -> Organization -> Settings -> Dashboard API Access).
  1. Check Enable access to the Cisco Meraki Dashboard API and click on profile.
  2. Scroll down until you find the API access section, click on Generate new API Key.

API Key

The API Key will only be displayed once. Please ensure to copy and paste it immediately and store it elsewhere for documentation purposes.

  1. After copying it check the I have stored my new API key option and click on Done.
  1. Log in to your Proximity DMP account: dmp.beaconinside.com.
  2. Within your Proximity DMP account, open the Cisco Meraki page (Home -> Integration -> Cisco Meraki).
  3. Paste the API Key and Click on Connect.
  1. Once it is confirmed, you will get a Network Overview of all the access points in your network which can be activated as beacons.

Import via CSV

You can import your list of beacons from a csv file. Find below the steps to extract the beacon list from your Cisco Meraki Dashboard as a CSV and import them.

  1. Login to your Cisco Meraki Dashboard.
  2. Go to the Bluetooth Settings page (Home -> Wireless -> Bluetooth Settings).
  1. Scroll down till you see a table with Node, Major and Minor.
  1. Click on the Download CSV button.
  2. Now log in to your Proximity DMP account: dmp.beaconinside.com.
  3. Within your Proximity DMP account, open the Cisco Meraki page (Home -> Integration -> Cisco Meraki).
  4. Navigate and select the CSV you downloaded and click on Import.

Beacon Advertising

The fundamental purpose of the bluetooth settings in Cisco Meraki access points is its capability to broadcast advertisement packets. Once enabled, you can setup and manage campaigns that reach your audience in real-time.

  1. Log in to your Proximity DMP account: dmp.beaconinside.com.
  2. Open the Cisco Meraki page (Home -> Integration -> Cisco Meraki).
  3. Select the networks using the checkboxes.
  4. Click on Enable/Disable Advertising.
  1. Toggle the button to enable beacon advertising.
  2. Ensure that the UUID is set.
  3. Click OK.

Enable BLE Scanning

Another significant feature of the Cisco Meraki access points is its capability to scan for any and all Bluetooth enabled devices within its range. This includes mobile phones, other deployed beacons, smart devices etc.
To enable the Scanning API:

  1. Login to your Cisco Meraki Dashboard.
  2. Go to the Location & Scanning section (Home -> Network-wide -> General).
  3. Configure and host your HTTP server to receive JSON objects.
Protocol Flow between Cisco Meraki cloud and Beaconinside server

Protocol Flow between Cisco Meraki cloud and Beaconinside server

  1. Turn on the API by selecting Scanning API enabled in the dropdown box.
  2. Enter the post URL: https://cisco-meraki-213309.appspot.com/v1/events/ and the authentication secret (the secret is used by our HTTP server to validate that the JSON posts are coming from the Meraki cloud)
  3. Share the Validator token and Secret with your contact representative at Beaconinside.
  1. The Scanning API version can remain as 2.0 to receive and process.
  2. Click on Validate and, on successful validation, click on the Save button to save the page.
  3. Log in to your Proximity DMP account: dmp.beaconinside.com.
  4. Open the Cisco Meraki page (Home -> Integration -> Cisco Meraki).
  1. Click on Enable/Disable Scanning.
  2. Toggle the button to enable bluetooth scanning.
  3. Click OK.

Network-wide

Please note that enabling the Scanning API under the General Settings is network specific. So if you have multiple networks please ensure that each of them have the Scanning API enabled as directed above.

Disconnect

Incase you want to cut off the connection with your Cisco Meraki dashboard, you can use the Disconnect option.

Disconnect

Choosing to disconnect from your Cisco Meraki Dashboard will deactivate all features and delete all network related data that was imported.

  1. Log in to your Proximity DMP account: dmp.beaconinside.com.
  2. Open the Cisco Meraki page (Home -> Integration -> Cisco Meraki).
  1. Click on DISCONNECT.
  2. Click OK.

Application Scenarios

Setup
Gain access to real-time events such as Visitor frequency, Loyalty, Heatmaps etc by leveraging the Proximity DMP platform and the BLE enabled Cisco Meraki access points. After testing with the Beaconinside apps you can also directly download the mobile SDKs for iOS or Android from Github. Integration effort is typically only a few hours plus testing. Make sure you check out the READMEs to get a full feature overview. If you do not have an App yet, you can still use the Nearby Notifications.

Nearby Notifications
Nearby Notifications can be used to show relevant nearby content to Android users. Neither App nor development time is required to use this feature. Provide a landing page and a list of Cisco Meraki access points as beacons that should be enabled for Nearby Notifications. We'll set it up in the Google Beacon Platform and track what's going on. We also support working with the Eddystone URL format instead of using the Google Beacon Platform.

Proximity Campaigns
Once you have the Beaconinside SDK integrated into your App, you can immediately start utilising the Campaign management features available. Proximity campaigns are used to define interactions between mobile users and the Cisco Meraki access points. Campaigns include a notification message when entering a zone and a target action like an image or a custom in-app landing page. You can also define your own scheduling and additional targeting criteria like the day of the week or the mobile operating system.

You can select all your Cisco Meraki access points by choosing All Beacons group to create a trigger event. With the help of groups you can flexible create various campaign triggers, e.g. a zip code area, all shopping windows or all entrances.
Go to Marketing --> Campaigns to create a new one.

Visitor Analytics
The Proximity DMP comes with insightful dashboards and live analytics created using beacons imported from the Cisco Meraki dashboard. Track the effectiveness of your location-based campaigns with analytics data on online to offline conversions, POS performance and frequency of visits.

It's possible to use collected visitor data to create your own dashboards with visitor frequency, loyalty, dwell time, heat maps etc.

Beacon Network Sharing
You are a venue or infrastructure owner. You can offer your partners your network of Cisco Meraki access points (full/partial) and monetize them. The Proximity DMP enables you to set up and share any size of beacon infrastructure and provide access over the cloud and monitor the usage in a precise and effective way.