Setting up a Proof of Concept

This guide gives a detailed introduction to create a proof of concept and how to set up a pilot before going into production. Feel free to contact for further questions.

You should keep on reading if you:

  • want to run campaigns using beacons or geofences
  • want to set up location-based services at the point-of-sale
  • want to collect location data with your own mobile apps
  • want to set up Nearby Notifications for Android (no app required)
  • want to integrate location data into your marketing or CRM solution in real-time


Quick Start

Sign up for a Proximity DMP trial account at to get access to the dashboard and to manage your beacon and geofence infrastructures and proximity campaigns. See this 15 minutes introduction video explaining the different features.

If you don't own a mobile app you can directly jump to the Nearby Notifications section which don't require a mobile app.

If you are interested in app-based solutions download the:

  • Proximity App for Android or the
  • Proximity App for iOS.

Open this app and go to "Settings". Select "Enable your own account" and enter your API token. In the Proximity DMP web client under Settings --> Application you will find your API token that authorizes mobile apps to retrieve data. You have to keep this token private. It's easier to directly scan the QR code.

From Pilot to Production

After testing with the Proximity App 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.

The same account as for the proof-of-concept can be used. You can also set up a new DEV vs. LIVE access token under Settings --> Applications.


It's best to test with a physical beacon. We recommend a few vendors and beacon models on our website. A virtual beacon works as well, see the how-to.

Under Infrastructure -> Beacons you can quickly add your beacon by clicking the + button. If you ordered beacons from Beaconinside we can automatically import all your beacons with the correct settings.

Meta Data

For beacons and geofences you can add meta data. This simplifies the handling and integration into 3rd-party systems, e.g. StoreID=123, Zone=Cashier, ERP_ID=123.


Testing geofencing is as simple as setting up a 100-150m geofence in Infrastructure --> Geofences.
See also the complete geofencing guide.

Nearly everything you can do with beacons you can also do with geofences but with less location accuracy. It's recommended to test beacons along geofences.

Proximity Campaigns

Proximity campaigns are used to define interactions between mobile users and beacon or geofence zones. Campaigns include a notification message when entering a zone and a target action like an image or a custom in-app landingpage. You can also define your own scheduling and additional targeting criteria like the day of the week or the mobile operating system. Select the All Beacons or All Geofences 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. Campaigns require a mobile SDK integration.

Visitor Analytics

Under Analytics you'll find various charts to show what's going on.

It's possible to use collected visitor data to create your own dashboards if needed.

You can also easily do custom analytics with business intelligence tools like Tableau.

Nearby Notifications

Nearby Notifications can be used to show relevant nearby content to Android users.

Please provide a landing page and a list of 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.

Unfortunately Nearby Notifications are not available for iOS users.


NFC support is in early alpha stage and is not yet officially released to the app store versions.

NFC tags are low cost and can be attached to products or objects. Your mobile app can interact with your tags and the customer profile can be enriched with product-level interests.

NFC tags can be linked to web pages (e.g. product info pages) that are opened directly within the application. The Proximity SDK helps with tracking these events.


  • Configurable NFC tags

On iOS:

  • Open Proximity App
  • Click on the NFC icon (top right)
  • Put the NFC tag to the top of the iPhone

On Android:

  • Open Proximity App
  • Put the Nfc tag to the back of the Android device

Frequently Asked Questions

How do I ensure everything is set up in the right way?

  • Check if the beacon is turned on and can be detected with the Proximity App.
  • Grant location and notification permissions within the application (typically at app start)
  • Check if device is online (to request beacon and campaign content)
  • Android: Enable Bluetooth on your device (not required with iOS 11+)
  • iOS: Check in App Settings if Background App Refresh is active
iOS: Did you provide the right app permissions? (in Settings > App)

iOS: Did you provide the right app permissions? (in Settings > App)

What is the battery drain of the SDK?

In short, below 1-2% of the daily energy usage. See the battery drain guide.

Setting up a Proof of Concept

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.