Engage
With the Engage functionality, network administrators or guestbook operators can configure and manage guest user accounts from CloudVision Cognitive Unified Edge (CV-cue). Engage functionality also lets network administrators analyze the various statistics and demographic profiles of guest users who access your Wi-Fi setup. You can obtain the user profiles by using custom plug-ins, except Clickthrough, or through entries from a private guest book.
users access the Wi-Fi through custom captive portals created in CV-cue. These portals can be configured to enable users to access the Wi-Fi by using their credentials or by using user accounts that you have created in the portal guest book.
manage guest users
Network administrators or guestbook operators can configure and manage guest user accounts using the Engage > users tab. As a network administrator, you can create multiple user accounts, set their credentials, and share the account details with the guest users over email. You can create individual user accounts or create user accounts in bulk. guest users can use these administrator-generated credentials to access the internet through your Wi-Fi setup.
- Allow guest users to Self-Register: users can self-register directly from the splash page. Administrators can modify the user account settings once the user successfully registers.
- Admin Generated Credentials:Administrators can create users or user batches and share the account credentials and details with the guest users.
Use Case
Consider a scenario where you are conducting a seminar or an event for a large number of users. You want to allow these users to access your Wi-Fi network for a short period of time and once the event is done, you need to revoke the access. You can achieve this by creating a batch of users or by importing a large number of users. You can set the validity of the user accounts, login-limits, device limits, and also specify Quality of Service Setting parameters to ensure smooth connectivity.
Create users
To create a user account:
- Go to
- From the drop-down menu, select the SSID profile with the configured captive portal.
- Click Add and provide the following details:
Field Description User Name Name of the guest user account. Password Password for the guest user account. Email Email address of the guest user to send notifications. User Status Set it as Unlocked to enable the user to access the network. Validity Set the time duration for which you want the user to be able to access the network. guest users will not be able to access the network once the validity expires. SSID Name SSID Name on which the user is available. SSID Key SSID Key to get access to the SSID on which the user is available. Device Limit The maximum number of devices a guest user can simultaneously log in. Login Limit The number of times the guest user can log-in from the splash page using these credentials. If the account is valid and the user has crossed the login count limit,the user will not be allowed to log-in. Quality of service settings Login Timeout The time period after which the guest user session expires. The user must re-authenticate with their login credentials to continue using the Wi-Fi service. If you leave this setting blank, the user session does not timeout and the user must explicitly log out from the portal. Blackout Time The time period during which a user cannot log in to the portal after the last successful login has timed out. Max Download Bandwidth The maximum download bandwidth, in Kbps, for the guest user. Max Upload Bandwidth The maximum upload bandwidth, in Kbps, for the guest user. - Save the settings.
Importing users
You can also import multiple users by providing the user details in a .csv file.
To import users,
- Go toand click Import users.
- Upload a .csv file with the user details.
You can view the imported users in the User tab. users imported from .csv file are tagged as batch users and a batch is created for every imported .csv file. The username prefix is left blank for imported users.
Create User Batches
You can also create multiple users simultaneously by creating a batch of users. Creating a batch of users is useful when you need to create a large number of guest user accounts.
To create a user batch:
- Go to
- From the drop-down menu, select the SSID Profile with the configured captive portal.
- Click Add and provide the following details:
Field Description Username Prefix Prefix for the guest user accounts batch. This is applied to all the users in the batch. Batch Type - Select Random users to generate users with random user names with the specified prefix in the guest user batch.
- Select Incrementing users to generate usernames with the specified prefix and an incremental index in the batch.
Username Length The length of the user name. This setting is available only for Random users. Start Index The numerical index to start the user names. This setting is available only for Incrementing users. Password Length Length of the password. Number of users The number of users to create in this batch. Expires At Set the time to expire the validity of all the users in this batch. - Specify the Login Limit, Device Limit, and Quality of service setting parameters applicable to all users in this batch.
- Save the settings.
You can export the created user batch to retrieve the usernames and passwords and share them with your guest users.
guest Insights
View guest Overview
All charts on the Overview tab display data for Today’s date. To view overview-related data for a specific date, select the date from the date picker at the top.
The Overview tab contains the following charts:
Conversion
Wi-Fi users
New vs. Repeat users
The New Vs Repeat users widget indicates the total number of users using the guest Wi-Fi, along with the percentage of new and repeat users. It also presents the average number of days between visits for repeat users.
Dwell Time
Demographics - Male
The Demographics - Male widget displays the percentage of male users using the guest Wi-Fi through a social media plugin. This data is derived from the social media sites used by the guest Wi-Fi users to log in to CV-cue.
Demographics - Female
The Demographics - Female widget displays the percentage of female users using the guest Wi-Fi through a social media plugin. This data is derived from the social media sites used by the guest Wi-Fi users to log in to CV-cue.
View guest Presence
To view guest Presence data, navigate to
All charts on the Presence tab display data for Today’s date. To view presence-related data for a specific date, select the date from the date picker at the top.
Footfall by Duration
When you need a 7 day chart, you will easily be able to track the per day data of the visitors in and around the store from Monday to Sunday. But when you go for >60 days slot you will be able to see per week data for 60 days. And for 365 days you can view the per month data. The granularity changes as per the data distribution for the duration. If a user accesses the Wi-Fi in a particular time slot like 8 am-12 pm multiple times, it will be counted as one visit for that time slot. But if the user logs in under different time slots, the user will be counted different for each time but for an overall view for the parent location, the guest user will be counted as one visitor.
Similarly, If a user logs in through different devices in the same time slot or different slot, the user will be counted as a different visitor each time as that login depends on the MAC address of the device. Different MAC addresses will count as different visitors.
Footfall by Location
Dwell Time by Duration
This is a bar graph showing total number of users who have accessed the Wi-Fi for different time periods during each visit for the specified duration and at the selected location.
The Dwell time depends on the received RSSI value. The relative signal strength of the Wi-Fi is considered to be good the more its value is close to 0. So, when a client connects for a particular time slot its duration is mapped. This is again an aggregated data. Suppose, in the time slot of 8-11 am, a client logs in at 8-9 am for 4 minutes and again logs in from 9-10 am for 3 minutes. The total time slot of the client will be 4+3= 7 minutes and will be depicted on the chart, accordingly.
Dwell Time by Location
View guest Demographics
To view guest Demographics data, navigate to Demographic charts provide social analytic information for guest users who use Wi-Fi by authenticating with their social media accounts.
Login Methods by Duration
Login Methods by Location
This is a bar graph showing the login method-wise percentage of guests for the selected location and its child locations who have accessed the Wi-Fi during the specified time duration for the selected SSID.
Social Engagement by Duration
This is a chart showing the number of guest users who logged in using a social media application and engaged with the platform for a selected duration.
Social Engagement by Location
This is a chart showing the number of guest users who logged in using a social media application and engaged with the platform for a selected location.
View guest Profiles
To view guest Profiles, navigate to The Profiles tab displays the guest profile information available for each location in the location tree.
The profile information of guests or visitors is presented in a tabular format. The information displayed is the information that the guest user has allowed to be displayed. When a user logs in to Wi-Fi, he logs in through a plugin, such as a Social plugin, guestbook, or Webform. While logging in through the plugin, the user is asked to fill in various fields. Those fields, such as profile picture, portal, plugin, gender, or location, are displayed in the Profile tab.
| Field | Description |
|---|---|
| Profile Picture | The photograph of the guest. This is retrieved from the social media site based on the respective social media account the user uses to access the Wi-Fi. |
| Portal | The name of the portal used to access the Wi- Fi. |
| Plugin | Name of the plug-in used to authenticate. |
| User Name | Login name of the guest as mentioned on the social media account. |
| First Name | First name of the guest as mentioned on the social media account. |
| Last Name | Last name of the guest as mentioned on the social media account. |
| Gender | Gender of the guest as mentioned on the social media account. |
| Number of Visits | Number of visits by the guest to the portal. |
| Location | Location of the guest as mentioned on the social media account. |
| Login Location | Location of the AP to which the guest connected. This is the location defined in the Wireless manager. |
| Email ID | The E-mail ID of the guest as mentioned on the social media account. |
| Last Authentication Time | Date and time of the last visit by the guest to the portal. |
| Client MAC | MAC Address of the client. |
| Age Range | Age range of the guest. |
| Phone Number | Phone number of the guest as mentioned on the social media account. |
| Languages | Languages known to the guest as mentioned on the social media account. |
| Friends Count | Number of friends the user has on the social media account. |
| Followers Count | Number of followers as mentioned on the social media account. |
| DOB Day | Day of birth of the guest as mentioned on the social media account. |
| DOB Month | Month of birth of the guest as mentioned on the social media account. |
| DOB Year | Year of birth of the guest as mentioned on the social media account. |
| Date Created | Date of account creation. |
| Last Skip Time | Date and time of the last splash page skipped by the guest user. |
| Skip Visit Count | Number of time the guest user skipped the splash page. |
| Membership ID | Membership ID of the guest user. |
| Marketing Opt-in | Marketing Opt-in if used by guest user. |
View Wi-Fi Usage
To view Wi-Fi Usage data, navigate to WiFi Usage tab contains the following charts:
- Data Transfer by Duration
- Data Transfer by Location
Data Transfer by Duration
This is a line graph that plots the data received and transmitted and the total data exchange over the specified duration at the selected location for the selected SSID.
Data Transfer by Location
This is a bar graph that plots the data transmitted and received for the specified duration at the selected location and its immediate child locations for the selected SSID. When you select a particular location from the root folder, the chart depicts the total Wi-Fi usage done in that particular location. The line data shows the data that is being transferred from AP to the client(download data) and from the client to the AP(upload data). The data transferred can be chosen for a particular location along with its child locations, SSID or duration. An aggregated data for the location is presented.
guest Insights for Clients with Random MAC Addresses
iOS, Android, and Windows OS have introduced the use of randomly generated, locally-administered MAC addresses for Wi-Fi clients. It is done to hide the hardware MAC for security reasons. As a result, identifying such devices by its MAC is not possible because the MAC address keeps changing with time.
When clients with random MAC addresses connect to an AP, the actual count and the absolute count of the clients are vastly different. Due to MAC Randomization, the same client can connect multiple times with an AP using MAC addresses in a shorter duration. The AP will consider such clients as different clients as the MAC addresses are different in every association. When clients with randomly assigned MAC addresses connect to CV-cue, CV-cue uses an approximation algorithm to identify such clients. GM then displays a percentage approximation of such clients in all the client-association charts, instead of displaying the actual count.
Login Method by Duration with MAC Randomization Enabled:
Login Method by Duration with MAC Randomization Disabled:
- Overview > Conversion: Shows only the total footfall.
- Overview > Wi-Fi users: Shows only the percentage change in footfall instead of the absolute count.
- Overview > New us Repeat users: Not available if MAC Randomization is enabled. Instead, a widget displaying Repeat users is shown.
- Overview > Dwell Time: Shows approximate number.
- Overview > Demographics - Male: Not affected by MAC Randomization.
- Overview > Demographics - Female: Not affected by MAC Randomization.
- Presence > Footfall by Duration: Shows an approximate number instead of total count.
- Presence > Footfall by Location: Shows an approximate number instead of total count.
- Presence > Dwell Time by Duration: Converted the Y-axis into an approximate percentage count instead of an absolute count.
- Presence > Dwell Time by Location: Converted the Y-axis into an approximate percentage count instead of an absolute count.
- Demographics > Login Methods by Duration: Y-axis shows the approximate percentage count instead of the absolute count of visitors.
- Demographics > Login Methods by Location: Y-axis shows the approximate percentage count instead of the absolute count of visitors.
- Demographics > Social Engagement by Duration: Y-axis shows the approximate percentage count instead of the absolute count of visitors.
- Demographics > Social Engagement by Location: Y-axis shows the approximate percentage count instead of the absolute count of visitors.
Create Reports
You can create one or more custom reports for a location floor. Each report can have segments with different filter criteria. A custom report can have one segment with a Dashboard section, one segment with a Floor Maps section, and one or more segments with the remaining sections.
The Demographics, Presence, Engagement, and Wi-Fi Usage sections can be repeated in a custom report with different filters applied to each of the repeating sections.
- Navigate to tab.
- Select the location for which you want to create the report.
- Click New Report.
- Enter the report name.
- Click the Add icon to add a new segment.
- Select the section, chart, and duration.
- Select the appropriate option from any other filters that appear.
- Repeat steps 5 through 7 to add new segments to the report.
- Click Save.
Once a report is saved, you can schedule it from the Reports Listing page.
To schedule a report:
- Go to
- Select Schedule from the three-dot menu next to your saved report.
- Provide schedule details.
- Click Save.
You will receive the generated report in the provided recipient’s email. To generate a report in pdf format instantly, click Download from the three-dot menu and provide the date for the report.
Admin Settings
Third-Party Integration
You can configure Third-Party Endpoints to receive Notifications when a guest user connects to the Wi-Fi or to Validate the request for accessing the guest Wi-Fi. An endpoint is a destination, say a service running on a server, to which the guest profile information is to be sent. When you configure the endpoint, you specify the destination URI, the HTTP method to use for data transfer, and the information (key-value pairs) to be sent to this endpoint.
CV-cue provides a predefined set of values for a guest profile based on the information it captures. The individual fields in the guest profile information can be mapped to relevant keys or field names in a third-party application. Keys are the identifiers derived from the third-party application to which you want to associate this information to form a key-value pair.
After you define the endpoints, you must configure them in the respective plug-in QoS on the portal. This helps in sending the requested key-value pairs to the appropriate endpoint when a user authenticates from the portal splash page using the plug-in.
- Notification Service
- Validation Service
The notification service occurs after the user logs in to the server, while the validation service happens when the user tries to connect to the server to gain access to the guest Wi-Fi.
Notification Service
By configuring an endpoint with a Notification service, you can send real-time guest profile information to third-party applications as soon as a guest user accesses a portal and successfully authenticates using one of the plug-ins defined on the portal.
This works for all the plug-ins like SMS, guestbook, Facebook, LinkedIn, Google, Twitter, Foursquare, Instagram or Clickthrough. The third-party application can store it for future use. This information is sent in the form of key-value pairs and can be stored in any desired format, JSON, XML, or in a database by the third-party application. The information sent to the third-party plugins can be different for different plugins.
Validation Service
By configuring an endpoint with a Validation service, you can add an extra step for validation to secure the Wi-Fi access granted to guest users. The validation is needed to allow only authenticated users to have access to the Wi-Fi.
How does validation work?
The authentication process is done by specifying certain primary parameters which will perform the authentication process. In case of the SMS plugin, we need a valid phone number of the user which will receive an OTP or any authenticated code that will validate the user. This can be a combination of two or more than two parameters.. It depends on the customer and its customized splash page.
For example, if a user logs in to the portal and needs to access the guest Wi-Fi in a particular office area. He is then asked to provide a valid phone number and an insurance id. These two unique primary factors define the user and the information is sent to the server. The server then sends an OTP via SMS plug-in to the user's phone number. Once the details have been put in, the authentication process takes place and a corresponding success or failure message is sent based on which the guest user can log in.
Configuring an Endpoint for Third-Party Integration
You can add endpoints for third-party integration. The guest profile information can be sent to the endpoint using the HTTP GET and HTTP POST methods or the redirect method. You can send guest profile information that is collected by guest manager and custom data where you can specify your own key and corresponding value for the key.
When adding an endpoint, you must enter at least one notification parameter for the endpoint. If you select the parameter type as guest manager, you must select a value from the predefined list of values.
If you select the HTTP GET method or redirect, the key-value pairs are appended to the endpoint URL. If you select HTTP POST, the key-value pairs are sent as encoded form-data. A Notification Preview is presented on the bottom of the page as you enter the key-value pairs. This is a preview of the actual form in which the data will be sent to the third-party application using an HTTP request. The Validation Preview has a header tab and request body. The request body parameter generates only when the call is POST Call and for SMS plugin specifically.
- Navigate to
- Click New Endpoint.
- Provide the endpoint details:
Table 2. End Point Details Field Description Service The service type can be either Validation or Notification. Name A user-defined name of the endpoint. End Point URL The URL of the endpoint. This is URL to which the key-value pairs will be sent. This could be a service listening for requests and handling the incoming key-value pairs. Description An optional description of the endpoint. Method Type You can select only one method for an endpoint. Select GET, POST, or Redirect option. If you select the HTTP GET method or redirect, the key value pairs are appended to the endpoint URL. If you select HTTP POST, the key-value pairs are sent as encoded form-data. If you select the Redirect option, you must select the third-party endpoint as the Redirect URL in the respective plug-in QoS tab of the portal. Response Timeout The timeout, in seconds, for which CV-cue keeps the data in its cache for sending it to the endpoint. After the timeout period, the data is deleted from the cache. The default value is 10 seconds. Response timeout can have a maximum value of 60 seconds. Retry Count This is an integer value that specifies the number of times server will try reconnecting to the third-party server. The maximum retry count is 3. Notification Preview Preview the Requested URL and encoded form data. - Select Request Body as Form Data. Click Add new row to add Parameters as specified in the following table. Repeat this step to add multiple parameters.
Field Description Parameter Type The type of parameter to pass to the third-party application. Select guest manager if you want to pass a parameter captured by the guest manager. To send custom key-value pairs, select the Custom option. You can include a mix for Custom and guest manager notification parameters. Key The key name to which the corresponding value will be associated. You can define key names that map with the appropriate fields or attributes defined in the third-party application. Value The parameter to pass to the third-party application. For a guest manager parameter, select a predefined value from the drop-down list that will be mapped to the corresponding key. If the parameter type is Custom, you can enter any string here. - For POST operations, you can also define the parameters through the Raw Body section where you can define the JSON parameters in parentheses. The possible values for the parameters are:
portal_name visit_count birth_day email ap_mac private_data friends_count languages first_name plugin_name last_visit birth_month gender ap_ssid membership_id followers_count location last_name client_mac date_created phone_number picture_url username marketing_option birth_year login_location age_range - Click Done.
While CV-cue tries to connect with the third party and fails to receive a response, it submits the request again after trying for the specified response time. The server can retry to establish a connection, but the maximum number of retries is only 3. There is no retry for failure in connection establishment.
View Logs
You can use logs to analyze usage pattern of the Wi-Fi as well as the actions performed on your account.
- Audit Logs
- guest Wi-Fi Access Logs
- SMS Logs
- Payment Logs
- Navigate to
- Select Log Type. You can select from:
- Audit Logs: Audit logs provide information about the guest manager user activities. Audit logs are available for the past 365 days. They contain the following information:
Table 3. Audit Logs Field Description IP Address IP address of the computer device from which the operation was performed. Operation Type Type of operation. The operation types logged are Create, Read, Update, Delete, and Other. Some operations, such as login and logout, are categorized as Other. Operation Performed Details about the performed operation. Date/Time Date and time of the operation. Username Username of the CV-cue user who performed the operation. Role Role of the user who performed the operation. Portal Name Name of the portal for which the operation was performed. - Wi-Fi Access Logs: You can download access logs for a particular portal. Wi-Fi Access Logs contain the following information:
Table 4. Wi-Fi Access Logs Field Description Portal Name of the portal accessed by the guest user. Type Type of access operation. This indicates whether it is a login, logout, portal access or gate access. Portal access entry is recorded when the user accesses the portal. A gate access entry is recorded when the access point opens the gate for the user to access the Internet. Client Public IP IP address of the client used by the guest user to connect to the access point. Client Local IP If NAT is enabled, Client Local IP is from the IP Pool defined in the NAT configuration. If NAT is disabled, it is the same as Client Public IP. Client MAC MAC address of the client used by the guest user to connect to the access point. AP MAC MAC address of the access point used by the guest user to access Wi-Fi. AP IP IP address of the access point accessed by the guest user. AP SSID SSID of the access point accessed by the guest user. AP Port Port number used to communicate with the access point. User Agent User agent details of the browser used by the guest user to access Wi-Fi. User URL URL accessed by the guest user. Username The user account used to access the Wi-Fi, followed by the plug-in name. Message Provides gateway access and log-off URLs. Message also include session timeout, blackout time, download limit, upload limit, and the redirect URL configured on SSID. Date/Time Date and time of access by the guest user. - SMS Logs: SMS logs contain detailed information about which code was sent to which number and how many times, the last login status, and other information such as the client and AP MAC address. SMS logs are generated for the selected account. SMS logs contain the following information:
Table 5. SMS Logs Field Description SMS Account Name Name of the configured SMS account. Service Provider The service provider used to send the SMS. This can be Twilio, MSG91, or a custom service provider. Sender ID The Twilio number or short code configured or the MSG91 sender ID configured on the plug- in. Mobile No The mobile number provided by the guest for receiving the SMS with Internet access code. SMS Content Message content of the sent SMS containing the authentication code. Date Created Date of SMS code generation. Sender Component Sender Component could be SMS Test Health or SMS Authentication Plugin. SMS Test Health corresponds to the option to test out if the SMS App is working or not. SMS Authentication Plugin gets triggered through the Authentication workflow upon client connection. Other Other details such as SSID, Client MAC address, AP MAC address. - Payment Logs: Payment Logs contain detailed information about payment transactions. The following information is captured in payment log:
Table 6. Payment Logs Field Description MGM Transaction ID Transaction ID generated by MGM for every transaction. Payment Gateway Transaction ID Transaction ID generated by the payment gateway. Timestamp - Transaction Initiated Timestamp when the transaction with the gateway was initiated. Timestamp - Transaction Completed Timestamp when the payment gateway responds with a code. Status Internal MGM recorded internal status of the transaction. - Initiated
- Completed - Passed
- Completed Failed
- Timed out
Status - Payment Gateway Payment gateway generated status. Transaction Amount Amount value of Transaction Payment Tier Chosen by User The tier that the user chose while doing the transaction.
- Audit Logs: Audit logs provide information about the guest manager user activities. Audit logs are available for the past 365 days. They contain the following information:
- Select Custom to enter a custom date and time or select Last to generate logs for the last specified days, hours, or months.
- Click Download.