-
null
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Table 3-1 describes the steps to be followed while configuring the CMX Mobile Application SDK in the Connect & Engage User Interface (UI):
|
|
---|---|
See the following URL: Creating a New Points of Interest |
|
See the following URL: Creating Routes for Navigation Points |
|
See the following URL: Creating the Zone |
|
See the following URL: Creating a Banner |
|
See the following URL: Creating a New Campaign and Associating Campaign with the Banner |
|
See the following URL: Push Notification Setup |
From the Connect & Engage UI, choose Mobile App > Mobile App Server from the left sidebar menu to view the Mobile Application Server details.
The Mobile App Server page displays the following:
A Points of Interest (POI) is a location of interest on the map. A POI can be a conference room, bathroom, or anything of interest within a building.
With the CMX Connect & Engage user interface, you can create various POIs highlighting specific zones. The maps and location data for campus, building, or floor is uploaded into the Prime Infrastructure and synchronized with the Location MSE.
As an administrator, you can create zones within a venue to use location specific messages and banners. You can mark specific areas on the map that you want to make a point of interest in the CMX Connect & Engage UI.
To create a new Points of Interest (POI), follow these steps:
Step 1 Choose Mobile App > Point Of Interest from the left sidebar menu.
Step 2 Click + Create New Point Of Interest in the right pane.
The Add/Edit Point of Interest group box appears.
Step 3 Configure the following in the Point Of Interest (POI) group box:
Step 4 Configure the following in the Address group box:
To activate the newly create POI, follow these steps:
Step 1 Choose Mobile App > Point Of Interest from the left sidebar menu.
Step 2 Click Inactive in the right pane to view all inactive POIs.
Step 3 In the Inactive Point Of Interests group box, click to highlight the POI that you want to activate.
The activated POI appears in the All Point Of Interests group box.
To edit the existing Point of Interest (POI), follow these steps:
Step 1 Choose Mobile App > Point Of Interest from the left sidebar menu.
Step 2 Click All in the right pane to view both active and inactive POIs.
Step 3 In All Point Of Interests group box, click to highlight the POI that you want to edit.
Step 5 Make necessary changes in the Add/Edit Point Of Interest group box and the Address group box.
Step 6 Click Submit to apply your changes and Cancel to cancel the changes.
To delete a point of interest, follow these steps:
Step 1 Choose Mobile App > Point Of Interest from the left sidebar menu.
Step 2 Click All in the right pane to view both active and inactive POIs.
Step 3 Click to highlight the POI that you want to delete in the All Point Of Interests group box.
Step 5 Click OK in the Delete Confirmation dialog box.
The floor navigation allows the user to define routes on the map to allow them to navigate to the desired destination. The routes are used to determine how to navigate a user from their current location to a point of interest on the same floor.
The below table lists the route configuration icons.
|
|
---|---|
Draw Line—Identify two nodes to connect together with a line in which people can move in both directions |
|
You must configure routes on the map to allow the user to navigate to the desired destination. For navigation points, you must create floor maps in the Prime Infrastructure, position access points on the Prime Infrastructure (PI), and synchronize maps to a location MSE in the PI.
To create routes for navigation points, follow these steps:
Step 1 Choose Mobile App > Floor Navigation from the left side bar menu.
Step 2 Choose Maps > System Campus > Building > Desired Floor to add routes in the right pane.
Step 3 To create a route, click Draw Point icon and place the point on the map. You can repeat this by placing points at different places on the map.
Step 4 To connect various points and paths on the floor, click Draw Line icon and draw lines to connect the routes. Click on a point to begin and another point to join the line.
Step 5 After creating routes, click Save to save the information.
To add a points of interest (POI), follow these steps:
Step 1 Choose Mobile App > Floor Navigation from the left side bar menu.
Step 2 Choose Maps > System Campus > Building > Desired Floor to add routes in the right pane.
Step 3 To add a POI, click Plot POI icon and place the point on the map.
Step 5 Right-click on the POI icon after placing it on the map and choose points of interests from the pop up window. This helps while searching for POI on the floor in the mobile application.
You can configure zones on the map to perform mobile push notification to the device.
If you modify the campus, building, or floor on the Prime Infrastructure (PI), you have to update them in the CMX Connect & Engage application.
Note While upgrading the Prime Infrastructure server, the map IDs and the information also gets updated. This results in the new identifiers for maps. The new identifiers are not automatically synchronized with the CMX Connect and Engage. This causes the location updates to use the new identifiers but the CMX Connect and Engage will not be aware of the new identifiers and cause the location updates to get ignored. To resolve this issue, you must update maps in the CMX Connect and Engage user interface. To update maps from the Prime Infrastructure, follow these steps:
Step 1 Choose Maps from the left sidebar menu.
Step 2 Click Update Maps from PI in the right pane.
Step 3 Click OK in the Update Confirmation dialog box.
This imports and overwrites any existing maps.
You can configure zones on the map to perform mobile push notification to the device. You can create zones inside a venue to use location specific messages and banners.
To create a zone, follow these steps:
Step 1 Choose Mobile App > Zone Editor from the left sidebar menu,
Step 2 Choose Maps > System Campus > Building > Floor.
Step 3 Click the Floor Plan tab.
Step 4 To set up a new zone on the floor map, click the Draw Polygon icon. Left click on the map to start creating the zone and double-click to complete the zone. You can repeat this by placing points at different places on the map.
Step 5 Enter a name and description to the zone that you created in the Add/Update Zone group box.
Step 6 Click Submit to save the zone on the map.
When a guest or a customer walks into a zone and connects to the Wi-Fi network, you can place a banner in the form of a logo or image on their mobile device.
To create a banner, follow these steps:
Step 1 Choose Mobile Apps > Banners from the left sidebar menu.
Step 2 Click + Create New Banner in the right pane.
Step 3 Configure the following in the Add/Edit Banner group box:
Step 4 Configure the following in the Setup Content drop-down list:
To activate banners, follow these steps:
Step 1 Choose Mobile App > Banners the left sidebar menu.
Step 2 Click Inactive in the right pane to view all the inactive banners.
Step 3 In the Inactive Banners group box, click to highlight the banner that you want to activate.
You must associate a newly created banner to a campaign. See Creating a New Campaign and Associating Campaign with the Banner for more information.
To edit the existing banner, complete the following steps:
Step 1 Choose Mobile App > Banners from the left side bar menu.
Step 2 Click All in the right pane to view both the active and inactive banners.
Step 3 In the All Banners group box, click to highlight the banner that you want to edit.
Step 5 Make the necessary changes in the Add/Edit Banner group box and Setup Content group box.
Step 6 Click Submit to apply your changes or Cancel to cancel the changes.
To delete a banner, follow these steps:
Step 1 Choose Banners from the left side bar menu.
Step 2 In the right pane click ALL to view both the active and inactive banners.
Step 3 Select the banner that you want to delete in the All Banners group box.
Step 5 Confirmation dialog box appears. Click OK to delete the banner.
To view the existing active or inactive banner, follow these steps:
Step 1 Choose Banners from the left side bar menu.
Step 2 Click ALL in the right pane, to view both the active and inactive banners.
Step 3 Select the banner in the All Banners group box and click Preview.It shows the banner's display when available to the customers on mobile devise.
The campaigns are ways to group a set of banners together to be displayed for a zone.
To create a campaign, follow these steps:
Step 1 Choose Mobile App > Campaign from the left side bar menu.
Step 2 Click + Create New Campaign, in the right pane.
Step 3 Enter a name for the campaign in the Campaign Name text box.
Step 4 Select the point of interest from the Point of Interests drop-down list. It is the zone where you want to display the campaign.
Note You must create a points of interest to populate in the Points of Interests list box.
Step 5 Select the zone on which you want to display the campaign from the Zones list box. You can add multiple zones to for a particular campaign.
Step 6 Select the banner that you want to associate with the campaign from the Banners list box. You must create banners before in order to appear in the Banners list box. You can add multiple banners for a particular campaign. See Creating a Banner for more information on how to create banners.
To make the newly created campaigns active, follow these steps:
Step 1 Choose Mobile App > Campaigns the left sidebar menu.
Step 2 Click Inactive in the right pane to view all the inactive campaigns.
Step 3 In the Inactive Campaigns group box, click to highlight the campaign that you want to activate.
Push notifications can be sent to mobile devices using the Mobile App server after registering for push notifications. To send notifications for Apple devices, you need .p12 file and password from Apple Developer web site. Android application users need sender Id and API key from Google play developer console web site.
To set push notifications, follow these steps:
Step 1 Choose Mobile App > Push Notification Set up from the left sidebar menu.
Step 2 Click the Apple tab to configure the following:
Step 3 Click the Android tab and enter the Android push notification key in the Android push Notification key text box. This is the key that received from Google play developer console Website.
Note The BLE Beacon Configuration is a Demonstration feature in Release 8.0.
The Cisco Mobility Service Engine (MSE) and Cisco CMX Software Development Kit (SDK) together support Bluetooth Low Energy (BLE) beacon configuration on MSE 8.0 and later Versions and CMX iOS SDK 1.0.0 and later Versions.
Note This feature is available only on Apple iOS devices that support Bluetooth and has BLE turned on.
The CMX SDK along with the BLE beacons can:
To configure the BLE Beacon, follow these steps:
Step 1 Choose Mobile App > Mobile App Server from the left sidebar menu.
Step 2 Click Download to download the sample beacon file and make necessary changes and save the file.
Step 3 To upload a BLE beacon file, click Click to select.txt file to browse and to select the beacon file.
The following example shows a sample BLE Beacon file.
"uuid" : "A77A1B68-49A7-4DBF-914C-760D07FBB87B",
"bleBeaconName" : "iPadTestBeacon",
"regionIdentifier" : "com.abc",
"message" : "Welcome to beacon zone!"
"uuid" : "A77A1B68-49A7-4DBF-914C-760D07FBB87B",
"bleBeaconName" : "iPadTestBeacon",
"regionIdentifier" : "com.abc",
"message" : "Welcome to beacon zone!"