This page will guide you through the process of getting started with the proximity platform and receiving your first Bluetooth beacon or region notification.
To use beacons and geo-fences (regions), you need a mobile app. The app is basically a browser you can use for mobile sites (apps) and landing pages created with the proximity platform or any other content you're hosting online.
Information on where to download and how to use the app, can be found at the app user manual.
Before we can start using the app's proximity features, we need to add a beacon, a mobile site or landing page and a scenario board to the Proximity Platform.
Proximity > Beacons and click the
New beacon button at the right top. Here we can enter the UUID, major and minor of the beacon. Usually, you can retrieve these settings with the app of your beacon vendor. With this app you can also modify the settings.
If you don't have any Bluetooth beacons, you can use regions. Go to
Proximity > Regions and click the
New region button at the right top. Here we can manage the location and radius.
For now we're going to add a mobile site instead of a landing page, but both are possible. Mobile sites are called
apps in the Proximity Platform. That's because there're a lot of similarities between these mobile sites and hybrid apps.
Create a mobile site at
Apps > Apps and click the
New App button at the right top. Follow the instructions and create at least one page for the app. A simple content page like
About Us is enough.
A scenario board brings the beacons and mobile sites and landing pages together. When creating a scenario board, you can select the mobile site (app) we've just created. You can add or remove apps at
Scenarios > Edit scenario board > Options > Board settings.
Now all prerequisites are met, we can add a few scenarios to test our beacons or regions. Make sure that if the Bell icon (between the If someone and Location columns) is visible, you enter a notification text. If there's no text, the scenario won't be triggered in the app. Also make sure there is content available at the Then column. Depending on the type of content selected, an icon will show between the Then and When columns. Click this icon and select or enter the content you want to show.
If you're testing regions, be aware of the fact they behave differently per device by design (Android or iOS). You need to move at least a couple of meters on Android in order for the region to be triggered, and on iOS it can be up to a hundred meter (or more).
Finally, make sure the app has the right permissions. Allow the app to access your location even when you're not using the app, allow permission to receive push notications and make sure Bluetooth is enabled.
To test these scenarios with the app, go to
Apps > Edit App > Options > QR code. Scan this QR code by tapping the QR scanner icon in the app.
You can also enter the code. The code of a mobile site or landing page, is the last part of the url. In the case of
https://demo.pulseplatform.io/mobile/XYTW-J4LS-62D5-U4NV, the code is
Of course this is tedious for an app user to enter, so you can change this to for example
ADVENTURE_TIME by updating the domain when editing a mobile site or landing page at
Options > App settings (or Website settings) > Domain.