Link the app to your own Cloud4Wi account, by clicking "Scan Setting QR" on the first screen of the onboarding wizard. The QR code will be provided by Cloud4Wi team.
Note: if you don't have a Cloud4Wi account, you can continue by clicking Continue with default settings, to use the app connected to a default Cloud4wi account. You won't be able to test the app on your own WiFi network in this case.
Sign up. Enter your data on the signup screen so you can easily identify your data in the Cloud4wi dashboard for testing and troubleshooting purposes.
You can use the "identifier" filed to add any identifier that you want to match with external system of records such as a marketing automation platform or a CRM.
Grant location permissions, by responding to the OS dialog that ask permission to use location data. Each OS and OS versions have different experiences. In order to fully experience the Location SDK tracking capabilities, you should allow the app to Always allow access to location data, even when the app is not open (background)
For app stores compliance policy, the app cannot force user to provide location permissions in order to use the app. However, if you do not provide such permission, you won't be able to perform the functional tests that the Toolkit is designed for.
On the WiFi onboarding screen, accept the OS dialog that ask permission to connect to a suggested network. Also in this case the user interface and messages ar different per each OS and OS version (see user experience)
Allow push notifications permissions. Push notifications are used to send messages in reaction to location moments.
If you correctly linked your Cloud4Wi account, and if you have connectivity, you will see your user on the Contacts page in the dashboard.
To track in the background, move more than 100 meters! Note that location updates may be delayed significantly by Android Doze Mode and App Standby, iOS Low Power Mode, or if the device has connectivity issues, low battery, or wi-fi disabled.
If there are other WiFi networks in range that are known and your device has already saved their credentials, the device might prefer those networks instead of the new secure network.
For testing purposes only, we suggest removing from your phone all the known WiFi networks.
The Demo App is pre-configured to connect only to SSID named "Secure WiFi" via WPA2 Enterprise and uses the domain name cloud4wi.securewifi.io for Passpoint
When you integrate the SDK into your app, you can define your own SSID name and Passpoint parameters
Using the app
Once you have your lab correctly setup, these are the functional tests that you can run.
Create Geofences from the Compass dashboard. Enter/exist from geofences with your testing device.
You'll be able to see the location events (geo-arriving, geo-leave) on the Moments > Events page on the Cloud4wi dashboard.
You can setup a Geo Events webhook streaming out the entry/exit events to your own external system and process them for your own purposes
Enter in the range of coverage of your test WiFi network and verify that your device automatically connects
You'll be able to see the location events (Arriving in location, Leaving location) on the Moments > Events page on the Cloud4wi dashboard.
You can also inspect the WiFi connection logs associated with your user in the Connection logs in the classic dashboard.
You can use Campaigns to send an email or a text message triggered by the event of Arriving in a location. Campaigns, at this time, does not have yet a trigger associated with geofecing events.
How do I link the app to another Cloud4Wi account?
To link the app to another account, or register as a new user, you need to uninstall the app and install it from scratch
Copying your user IDs
For most of the troubleshooting operations, you'll need to retrieve the identifiers of your user to then inspect the data in the Clpoud4Wi dashboard or datasets. In the app, go to the Settings page and copy the GUID value and the CustomerId value.
CustomerId id the id that identifies a Cloud4Wi contact. This is the same ID used for identifying contacts in the APIs, manual exports and on the dashboards
GUID identifies a specific device in the App Consoler for troubleshooting geofecing events
Whenever you need support from the Cloud4Wi team, make sure to copy these values and report them in the support request. You can click the 'copy' icon next to the respective values to copy them to the clipboard and easily paste them into messages.
I get an error when I sign up on the mobile app
When these errors occur, one of the following situations might apply:
the setting QR code scanned is not valid. The app fails to add a user on a Cloud4Wi account because it is not correctly paired
During the app setup I get an error that says the device is unable to join the WiFi network
When the app attempts to install WPA-2 Enterprise profiles in iOS, the device attempts to connect to WiFi network immediatly. If the network is not in range, you'll get an error such as the one reported in the screenshot below. The profile is installed correctly and the device will reconnect automatically to WiFi whenever in rage.
When I click on the SSID I get a connection error
If you click on the SSID and do not get the prompt asking for username and password, it means that you have a valid profile on your device but the authentication fails.
Find the users of your app in the Cloud4Wi dashboard, open the user profile and inspect the troubleshooting tab to see if there are any errors.
One of the following situations might apply:
you misconfigured the RADIUS parameters in the HW setup
you don't have a valid Internet Plan assigned or it has expired
you don't have the right Access Point MAC address added to your Cloud4Wi account
When I click on the SSID I get a dialog asking for credentials
If you get a prompt to enter username and password after clicking on the SSID, it means that your device has not a valid WiFi profile installed for that network.
Make sure you named the test network SSID "Secure WiFi"
The device is not connecting automatically to the network
The time it takes to a device to automatically connect to the WiFi depends by many factors. It can be as fast as immediate or take a couple of minutes.
If the device does not connect at all, please make sure the SSID of your WiFi network is not hidden.
If the device attempts to connect but it fails, it is more likely a problem of authorization. Check the Internet Plan assigned to the user to make sure the user has traffic allowance .