Skip to content

Bitplaces


The 'Bitplaces' tab allows the user to create new Bitplaces, view, edit, delete, change status and share it with partner accounts.

BP
bitplace

Bitplaces are splitted into 3 tabs: (1) Geofences, (2) Beacons, (3) All.

A Geofence is a virtual geographic boundary.

BP
bitplace

BP
bitplace

A Beacon is a Bluetooth Low Energy sender to provide proximity interaction.

BP
bitplace

BP
bitplace

Bitplaces import


With the help of the "Import Bitplaces" button the user can import a larger list of locations (Geofences or Beacons) using an upload template in *.csv format.

BP
import start

The import workflow consists of several steps. Firstly you need to upload a csv file with Geofences/Beacons. To match the csv format you can use template csv files for Geofences/Beacons. Please, make sure you use the last version of the file format. To track the changes follow CHANGELOG section.

BP
import templates

In edit step you can edit data or even remove some bitplaces before import. BP
import edit step

In import step the data is uploading to the server and bitplaces are creating.

BP
import importing step

On the result page total amount of imported and invalid bitplaces is shown.

BP
import result step

Creating a new Bitplace


BP
create

When creating a New Bitplace, the user can choose the Bitplace type (Geofence Bitplace vs. Beacon Bitplace) and set additional parameters.

Creating a new Geofence-Bitplace

When choosing the Geofence Bitplace type, the user creates a geofence Bitplace for outdoors. You can use geofences to collect mobile user's check in information. Geofences are virtual circles around any location with a freely selectable radius of 75 meters to a few kilometers.

BP
creategeo

In addition to creating a Bitplace with a click on the map you can also use the quick menu "CreateNew". When choosing a geofence Bitplaces a geofence is created as an outdoor Bitplace.

Set the location of a Bitplace

BP create
setlocation

A geofence Bitplace’s location can be set and adjusted via the address field and/or by setting the geo-coordinates directly and/or by dragging the Bitplace directly on the map.

Set the radius of a standard Bitplace

BP create
setradius

The default radius of a Geofence Bitplace is set to 75m. It defines the Bitplace’s outer limits, setting its borders for IN- and OUT-event triggers. The size of the radius can be adjusted either by direct input of the figure or by dragging the slider until the desired radius size is reached.

Adding name and description for Geofence Bitplaces

BP create
setname

Name is a mandatory field, the field description contains additional information about the created bitplace.

Show the bitplaces around

BP create
showbparound

The check box "Show other Bitplace" shows or disable active bitplaces near the selected location.

Enable measurements

BP create
enablemeasurement

The "Measure Bitplace" checkbox allows you to determine whether or not data should be collected for the selected location.

Assign Location Tags to the Bitplace

Bp assign
locationtags

Location Tags can be assigned to the Bitplace. Main purpose of the Location Tags feature is to allow a richer understanding of bitplaces that can be used to create hidden interest tags.

Select the Bitplace as a Campaign or shop Bitplace

BP create
campaignorshop

In order to be able to perform extended reports, a Bitplace can be marked as campaign or shop Bitplace. This selection allows the automated calculation of message conversion (see also Analytics).

Managing the picture of a Bitplaces

BP create
managepicture

The “Upload Image” button triggers a pop up window. So the user can change the default image of a Bitplaces, either by uploading a new or selecting an already uploaded image. This image is displayed in the general message view page of an app (gallery view) next to each message, which was assigned to this Bitplace.

BP create
uploadpicture During upload process new image can be cropped. At the end the uploaded image is added to the gallery.

BP create
uploadpicture User also can select previously uploaded image from the gallery.

Other settings of geofence Bitplaces

Specifying the Campaign Labels of geofence Bitplace

BP create
other

The “Other settings” button allows the user to assign labels to the Bitplace. So the label "Shop Bitplace" or "Campaign Bitplace" can use it later to illustrate the conversion of a campaign. These labels represent a grouping mechanism for Bitplaces and messages, such as the grouping of all Bitplaces and messages belonging to a particular marketing campaign. Events and messages can then be evaluated and analyzed based on their membership in a campaign.

Setting the customer fields of geofence Bitplaces

BP
customerfield

“Additional fields" enable individual categorizations of Bitplaces. So, for example, IDs from third party systems can be linked with the location information.

Assign message to a Bitplace

BP create
assignmessage2

The “Manage Messages” button triggers a popup, via which the user can assign Messages to a Bitplace.

BP create
assignmessage1

These Messages are sent to the mobile app when an app-user creates the according event based on the chosen Message and Bitplace settings.

Creating a beacon Bitplace

BP create
beacon When choosing a “Beacon Bitplaces” an indoor Bitplace is created. Just as with a geofence Bitplace the user can also in case of a beacon Bitplaces specify the location of Bitplaces, manage the image of a Bitplaces, assign a Bitplace campaigns labels, assign a Bitplace categories and assign a Bitplace messages.

BP create
beacondetails In addition to these options there are three Beacon types:

  • iBeacon (Apple default)

  • Eddystone Beacon (Google Standard)

  • Physical Web URL (Google Chrome browser support)

Creating an iBeacon

BP create
ibeacon

The UUID of a beacon Bitplace

The UUID is the primary iBeacon identifier. The UUID-field is pre-filled for every iBeacon with the specific account-UUID. In the default scenario, each iBeacon is synced with this account-UUID. It's also possible to add additional (multiple) UUIDs to the account. By doing so, there is no need to reconfigure already existing beacons in order to use them.

To create new account UUIDs go to Settings/Beacons BP generate
uuid

Here you can see partners UUIDs if there is any. They are read only and manageable by main account.

BP partners
uuid

Account UUID is generated for account automatically and cannot be deleted.

BP account
uuid

To create new UUID you need to specify UUID of your iBeacon and assign Name to it.

BP account
uuid

The Major and the Minor a beacon Bitplace

The Major and Minor are the secondary iBeacon identifiers. There is the need to configure your beacon with the Major and Minor in order to use them. UUID + Major + Minor should be a unique triple.

The Beacon Hardware ID of a beacon Bitplaces

The Beacon Hardware ID is another a further secondary iBeacon identifier. It is unique and can serve the purpose to sync the iBeacon and the Beacon-Bitplace. The internal identifier can left blank.

Creating an Eddystone Beacon Bitplace

This can only be used with the operating system Android. iOS Smartphones will not recognize an Eddystone Beacon in the background.

BP create
eddystone

Creating an Eddystone namespace

The Namespace is the primary Eddystone Beacon identifier. The Namespace field is pre-filled for every Eddystone Beacon with first available Namespace if there is any. In the default scenario, each Eddystone Beacon is synced with this account-Namespace. It's also possible to add additional (multiple) Namespaces to the account. By doing so, there is no need to reconfigure already existing beacons in order to use them.

By default there is no account-Namespace. In order to create it go to Settings/Beacons/Namespaces page.

BP create
eddystone

BP create
eddystone

You have to specify device Namespace and assign Name to it in order to create new Namespace.

Creating an Eddystone Instance ID

The Instance ID is the secondary Eddystone Beacon identifier.

Creating a Physical Web URL

The Physical Web allows to send push notifications with an URL to Android Chrome browsers nearby an Eddystone Beacon. There is no need to install an app for that. If a URL is saved the first time a shortened link is created and displayed. This link is a permanent link and needs to be synced on the Eddystone Beacon. At any time the URL in the Bitplaces Cloud Management can be changed and the shortened link will point to the new URL. This allows to change the content for the Physical Web without changing anything on the Eddystone Beacon. Google has specific requirements on URL storage be send via an Eddystone Beacon. We recommend to use an URL validator to check an URL beforehand.

BP
physicalweb

Show, sort, search and edit existing Bitplaces

BP show search

In the “Bitplaces” tab you can view, edit, sort or change the status (active vs. inactive) of existing Bitplaces with the help of the action buttons.

BP show search
advanced You can use advanced search to add additional filters to search by, such as Location Tags and Labels.

BP show search
in

Also you can select columns to search in in "Search" dropdown.

It is possible to specify the search even further, by entering a keyword and search only for the ID of the bitplace. For that one you have to write the id: 12345, in order to search for a bitplace with id 12345

BP show search
by id

Perform group operations on Bitplaces

BP group
selection

After selecting the checkbox of a Bitplace an "edit" and a "delete" button will appear above the Bitplace Table. Those buttons enable you to perform operations on all checked Bitplaces at once.

BP group
delete

By clicking the Delete button you can delete all selected Bitplaces in one step.

When you click the edit button you can decide if you want to change the status (active vs. inactive), change the radius, enable/disable measurement or perform add/remove/set label operation for all selected Bitplaces. You can do multiple operations at once.

By choosing one of this options, a section with additional parameters will appear, that allows you to perform the desired operation.

BP group
edit2

For Geofences it is also possible to create Shop/Marketing Bitplaces with the same coordinates but different radius. Shop and Marketing Bitplaces will make a pair and will be used to calculate conversion.

BP group
edit2

BP group
edit2