- 1. Bitplaces Cloud Management
- 2. Bitplaces
- 2.1. Bitplaces import
- 2.2. Creating a new Bitplace
- 2.2.1. Creating a new Geofence-Bitplace
- 2.2.2. Set the location of a Bitplace
- 2.2.3. Set the radius of a standard Bitplace
- 2.2.4. Adding name and description for Geofence Bitplaces
- 2.2.5. Show the bitplaces around
- 2.2.6. Enable measurements
- 2.2.7. Select the Bitplace as a Campaign or shop Bitplace
- 2.2.8. Managing the picture of a Bitplaces
- 2.2.9. Other settings of geofence Bitplaces
- 2.2.10. Assign message to a Bitplace
- 2.2.11. Creating a beacon Bitplace
- 2.2.12. Show, sort, search and edit existing Bitplaces
- 3. Messages
- 3.1. Creating a new message
- 3.1.1. Message types
- 3.1.2. Setting the push content to a message
- 3.1.3. Setting the title of a message
- 3.1.4. Setting the body of a message
- 3.1.5. The image of a message
- 3.1.6. Assigning labels to a message
- 3.1.7. Save settings
- 3.1.8. Assign a message to a Bitplace
- 3.1.9. Other Settings
- 3.1.10. Location-based Messages features
- 3.1.11. Interests tags
- 3.1.12. Set the time related message settings
- 3.1.13. Setting the event trigger of a message
- 3.1.14. Setting the delivery time
- 3.1.15. The Inbox settings
- 3.1.16. Settings for the number of messages
- 3.1.17. App specific settings
- 3.2. Creating a new Local broadcast message
- 3.3. Creating a new broadcast message
- 3.4. Show, edit and delete existing messages
- 3.1. Creating a new message
- 4. Analytics
- 4.1. Dashboard
- 4.2. Analyzing visits, visitors and visitors frequencies
- 4.3. Analyzing sent, push and read messages
- 5. Settings
- 6. Imprint
1. Bitplaces Cloud Management
The Bitplaces cloud management is divided into 5 areas:
1.2. Language selection
After logging in, the so-called “Map View” appears with a map included existing Bitplaces.
The user can change the main language of the platform in the top menu bar.
1.3. Bitplaces View
After clicking the gear icon the user can filter the Bitplaces shown in the map.
1.4. Map View
The Home screen map view is activated by clicking the globe icon in the menu on the left side.
The QuickView with first additional information about the selected Bitplaces can be activated by clicking on the Bitplaces icon on the map.
After activating the “more” button, the user receives detailed information about the selected Bitplace.
Clicking the “Analytics” provides access to first analytics details regarding the number of visitors in the last 7 days at this location and the currently active users.
By using the ‘Bitplaces’ tab the user can create new Bitplaces, view, edit, delete, change the status (active vs. inactive) and share existing Bitplaces with partner accounts.
2.1. Bitplaces import
With the help of the “Import Bitplaces” button the user can import a larger list of locations (Geofences or beacons) using a upload template in *.csv format.
2.2. Creating a new Bitplace
When creating a New Bitplace, the user can choose the type Bitplace (Geofence Bitplace vs. Beacon Bitplace) and set additional parameters.
2.2.1. 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 users check in information. Geofences are virtual circles around any location with a freely selectable radius of 80 meters to a few kilometers.
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.
2.2.2. Set the location of a Bitplace
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.
2.2.3. Set the radius of a standard Bitplace
The default radius of a Geofence Bitplace is set to 50m. 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.
2.2.4. Adding name and description for Geofence Bitplaces
Name is a mandatory field, the field description contains additional information about the created bitplace.
2.2.5. Show the bitplaces around
The check box “Show other Bitplace” shows or disable active bitplaces near the selected location.
2.2.6. Enable measurements
The “Measure Bitplace” checkbox allows you to determine whether or not data should be collected for the selected location.
2.2.7. Select the Bitplace as a Campaign or shop Bitplace
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).
2.2.8. Managing the picture of a Bitplaces
The “Manage Picture” 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.
2.2.9. Other settings of geofence Bitplaces
Specifying the Campaign Labels of geofence Bitplace
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
“Additional fields” enable individual categorizations of Bitplaces. So, for example, IDs from third party systems can be linked with the location information.
2.2.10. Assign message to a Bitplace
The “Manage Messages” button triggers a popup, via which the user can assign Messages to a Bitplace or create new Messages directly from the popup.
These Messages are sent to the mobile app when an app-user creates the according event based on the chosen Message and Bitplace settings.
2.2.11. Creating a beacon Bitplace
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. 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
Selecting the Bitplaces type “Beacon” opens the setting options for this type of indoor Bitplaces.
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. Its 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.
The Major and the Minor a beacon Bitplace
The Major and Minor are the secondary iBeacon identifiers. If left blank, they will be filled with arbitrary values, which do not repeat within one account. By doing so, there is the need to configure your beacon with the Major and Minor in order to use them.
The Beacon ID of a beacon Bitplaces
The Beacon 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.
Creating an Eddystone namespace
The Namespace is the primary Eddystone Beacon identifier. The Namespace field is pre-filled for every Eddystone Beacon with the specific account-Namespace. In the default scenario, each Eddystone Beacon is synced with this account-Namespace. Its 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.
Creating an Eddystone Instance ID
The Instance ID is the secondary Eddystone Beacon identifier. If left blank, it will be filled with an arbitrary value, which do not repeat within one account.
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.
2.2.12. Show, sort, search and edit existing Bitplaces
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.
Perform group-edits on Bitplaces
After selecting the checkbox of a Bitplace an “edit” and a “delete” button will appear above the Bitplace- List. Those buttons enable you to perform operations on all checked Bitplaces at once.
By clicking the delete-button you can delete all selected Bitplaces in one step.
When you click on the edit button you can decide if you want to change the status (active vs. inactive), change the radius or enable/disable measurement for all selected Bitplaces.
By choosing one of this options, a Pop-up window will appear, that allows you to perform the desired operation.
Filtering, searching or sorting Bitplaces
The user can filter which Bitplace type is to be displayed in the Bitplaces overview and can sort or search for keywords.
It is possible to specify the search even further, by entering a keyword and search only for the ID, name, adress or description of the bitplace.
For that one have to write the following into the searchfield:
- id: 12345, in order to search for a bitplace with id 12345
- name: testName, in order to search by name only
- adress: testAddress, in order to search by adress only
- descr: testDescription, in order to search by description only
By default (if no keyword is provided) the search is by name, adress and description.
By using the ‘Messages’ tab the user can create new Messages, view, edit or delete them.
Using the “Create Messages” quick menu the user can create new messages or view, edit and delete existing messages.
3.1. Creating a new message
When the user creates message different types of messages and content can be set. This feature requires the integration of the Bitplaces “Toolbox” framework.
The following message types, which differ in the graphical representation and the use of the routing function to the location, can be selected:
In addition, you can select the following content types:
3.1.1. Message types
Creating a Text Message
Creating a link message
A link message will open the entered URL inside the application.
Creating an HTML message
The content of an HTML message can be created and adapted in a WYSIWYG HTML editor.
3.1.2. Setting the push content to a message
If no push message content is defined, the app user receives only an inbox message without push notification (background notification)
Emojis can be selected and sent via the push notification.
3.1.3. Setting the title of a message
The title of a message will appear in the message overview of the app, as well as in the message itself, as the heading of message body.
3.1.4. Setting the body of a message
The message body is displayed in the message view of the app and is the main content of each message. It can take various formats, such as text, HTML, or the form of an URL that links directly to external content.
3.1.5. The image of a message
The “Upload Image” button creates a pop-up window that allows the user to attach an individual picture to the message, either by uploading a new or selecting an existing image. This image is displayed in the message view of the app. (single message view)
3.1.6. Assigning labels to a message
Under “Labels” the message can be provided with individual labels. These labels provide a group mechanism for Bitplaces and Messages, which e.g. belong to the same marketing campaign. Events and messages can then be evaluated and analyzed based on which campaigns the respective Bitplaces and/or Messages belong to.
3.1.7. Save settings
The ‘Save’ button saves the message settings.
3.1.8. Assign a message to a Bitplace
The button “Manage Bitplaces” generates a pop-up window that allows you to assign a message to a Bitplace.
The message is delivered to this Bitplace when the app user triggers events defined in the message- and bitplaces settings.
3.1.9. Other Settings
The Configure Settings button brings the user to additional settings.
3.1.10. Location-based Messages features
The option “Location Dependent” offers different setting options for sending messages to specified locations.
3.1.11. Interests tags
This message setting allows the selection of interest tags that are displayed in the app and can be selected by the app users. The interest tags allow sending a targeted message to app users with matching content.
3.1.12. Set the time related message settings
You can set different rules for the date, time, and period to send messages.
One can choose if the message should be send immediately after the triggering event occured, after a specified time passed by or even enter a precise time of the day.
In addition, the user can set, on which days and at what time the message should be ‘active’; E.g. if the message is to be sent only during specific opening times or on specific weekdays. A start and end date can also be set here so that the message is not sent before and afterwards. If no start date is defined, the message is active immediately after saving.
Changing the settings in the field “Time Settings” (Immediately, All day, no start date, no end date) is optional.
3.1.13. Setting the event trigger of a message
The primary message settings let the user define if the message should be sent to the app-user when he enters the Bitplace connected to this message (BitplaceIN), or when he exists this Bitplace (BitplaceOUT), or after the app-user remains in this Bitplace for a chosen amount of minutes (Stay).
3.1.14. Setting the delivery time
Under “Delivery Time”, the user can choose whether to send a message immediately after the occurrence of the selected event, specify a specific time delay or also an exact time of the day.
Changing the settings “Message Settings”, (BitplacesIN) is optional.
3.1.15. The Inbox settings
The “Inbox Settings” pop-up allows you to specify how long the message should be displayed in the user’s inbox (Message Lifetime) and whether a message is sent to the same user more than once.
3.1.16. Settings for the number of messages
Under “Number of messages”, the user defines the time interval in which the message is to be sent and how many of these messages are to be sent per Bitplace and in total.
3.1.17. App specific settings
Under “apps” you can define / change to which apps the message is to be assigned.
Changing the settings in the field, “Application Settings” is optional.
3.2. Creating a new Local broadcast message
With the radio button “At a specific time” the user can create a new local broadcast message. So you can specify whether the local broadcast message should be sent immediately or at what date and at what time.
3.2.1. Assign a Bitplaces and send a local broadcast
Created the user a local broadcast, he can assign it to a Bitplace using the “Bitplace manage / assign” button. All app users that are in this Bitplaces will receive the broadcast immediately (default) or later, depending on the time and date settings in the “Time settings”. You can also use the “Select users” button to filter message recipients based on their interests that they have selected in the app.
3.3. Creating a new broadcast message
“Configure Settings” allows the user to create a new broadcast message or to define already created messages as a broadcast message.
3.3.1. Setting Properties of a broadcast message
After activating the broadcast radio button, you can change the following settings of the broadcast message:
“Interests tags” defines whether the broadcast is be sent only to app users, which have selected certain interests in the app.
“Starting Time” defines if the shipment is immediately (default) or later, depending on the time and date settings will be made.
In addition, it is possible to determine the lifetime of the message in the app’s inbox and to select the apps to which the message has to be sent.
3.4. Show, edit and delete existing messages
In the message list view you can activate messages using the corresponding action buttons, view, edit or delete.
The Analytics part is divided into three areas:
- Bitplaces Analytics
- Message Analytics
The Dashboard provides an overview of user data (registered apps, allowing push) and the inventory (number of messages, number of Bitplaces).
4.2. Analyzing visits, visitors and visitors frequencies
The “Analytics” menu item offers a variety of widgets, which display standard information differently and which can be customized with the help of setting options.
When analyzing bitplaces, the graph can be customized to show visits, visitors, app users, visit frequency, the number of new and returning visitors, and the dwell times for selected time periods, bitplaces, operating systems, and apps.
Activating the checkbox “Comparison to the previous period” displays or disables the alternative data in the selected widget.
Visitor frequency widgets and the dwell time give a deep insight into the selected locations.
Positive or negative percentages in the “Visits” column provide a quick view of the performance of a location.
The analysis of individual bitplaces in detail is possible after clicking on the analysis button in the table view of the bitplaces.
Shown is there in addition the current number of active users and a 12 hours summary overview of the selected Bitplace.
4.2.1. Selecting analysis period
The fastest results are obtained by selecting one of the predefined time periods. Choose from ‘Today’, ‘Last Day’, ‘Last 7 Days’, ‘Last 14 Days’, ‘Last 30 Days’, ‘Last Calendar Week’ and ‘Last Calendar Month’.
In addition, there is the possibility to select the time period individually.
4.2.2. Selecting analyze granularity: hour, day, week, month
Each selected time span can be displayed in different granularities.
For short periods, the setting ‘hour’ makes the most sense and is only available for the selection “today” and “yesterday”. For longer periods (from one week) the setting “Day” or “Week” should be selected.
4.2.3. Selecting the mobile app releases to be analyzed
A further refinement of the evaluation can be done by selecting the app release. The user can choose his own releases, from his partner or a combination of both to evaluate bitplaces events and messages in a given period of time.
4.2.4. Selecting the bitplaces to be analyzed
The user can either analyze all bitplaces at a time, or only view bitplaces relevant to him. These can be selected individually or by campaign affiliation..
4.2.5. Analyzing all Bitplaces
By default, all bitplaces are included in the overall analysis of the ‘Tools and Analytics’ tab.
4.2.6. Analyzing campaigns
The Campaign selection list allows the user to select all the bitpaces associated with a particular campaign. If he clicks on “Refresh Visit Report” after selection, only the analysis of the events and messages of the corresponding campaign will be displayed.
4.3. Analyzing sent, push and read messages
After clicking the Messages button, the graphics show the number of sent messages and sent push messages for selected time periods, messages, and apps. The information is displayed in different widgets and it additionally allows a comparison with the results of the previous period.
The click rate (CTR) represents the ratio between the sent and the read messages. Push CTR refers exclusively to the sent push messages.
The CTR widget shows how the click rate has evolved over a period of time and allows you to compare to the previous time period.
The message distribution graph summarizes information about sent, read, and pushed messages, and it also compares them with a previous period of time.
The tabular view and the representation of percent changes in the reference period allow a quick overview of the success or failure of a sent message.
4.3.1. Selecting period, granularity and app release for the message analysis
As with the Bitplace analysis, it is also possible to use analysis time, analysis granularity, and mobile app releases for message analysis.
In the ‘Settings’ section, the user can make general account settings and also:
5.1. Managing the account
Upload a company logo and edit the contact details.
5.2. Assigning and managing apps
The tabular view of the connected app provides information about the owner of the app, the name, the ID, the creation date, the ID of the push certificate for iOS (including the date of validity), and the status. It also allows the owner of the app to edit or delete the app.
You can use the Apps menu item to add or manage new apps to the account. A new iOS or Android app can be assigned to the account with the required certificates (for iOS). In addition, additional settings, e.g. The maximum number of push messages per day, can be set.
5.3. Beacon list view
The sub-item “Beacon UUIDs” lists the UUIDs of all beacons used in tabular form.
5.4. Managing graphics in the gallery
Under the menu item “Gallery”, the graphics used can be displayed and removed or new graphics can be added.
When importing a graphic, it can be cropped manually after selection.