Cloud4Wi WiFi SDK
Cloud4Wi WiFi SDK allows to automatically check-in your mobile user upon arrival with a touchless and seamless experience, and unlock reliable location-aware experiences.
Seamless, secure WiFi Connection.
Cloud4Wi WiFi SDK empowers mobile apps with instant, automatic and fully-encrypted WiFi connection upon arrival to enabled locations, empowering your app with a stable and fast connection to deliver a smooth on-site experience.
All your mobile users will be automatically connected and authenticated to the WiFi network as soon as they are in the rage of the network.
The WiFi connection leverage WPA-2 enterprise security standard.
Location Moments and check-in
With Cloud4Wi WiFi SDK your app becomes aware when end users enter and visit any of your locations, and every Moment become an opportunity to deliver powerful location-based experiences or drive monetization.
The automatic connection to WiFi allows Cloud4Wi to detect precisely all the customer visit and interactions and push the relevant Location Moments to your application systems.
Location Moments are deterministic, overcoming the limitations of geofencing, unlocking check-in applications also in indoor and high-dense urban environment.
No smartphone location permission required! User opt-in is collected with the consent experience experience you design in the app. The location is detected by the network, it doesn't requires the smartphone location services.
Cloud4Wi WiFi SDK offers in-venue precision comparable to Bluetooth beacons — with scale and availability that Bluetooth cannot match.
When used with Compass, the WiFi SDK allows to profile your mobile users with location-based behavioral attributes.
Privacy and compliance
The WiFi SDK does not require Location permissions form the operative system to work. However, the SDK processes personal data for different purposes so privacy regulations might require that you to collect the consent form the customer.
You can design your own enrollment experience within your mobile app.
For example, you can promote the new service to your mobile users (with a notification, banner or button) and collect their acknowledgment and consent when they enroll.
Speed pilot program
In order to let you test the possible experience and benefits, we can support you to run a proof of concept in your environment (eligibility criteria applies).
The process is simple:
- Get a compatible WiFi access point. Clou4Wi team will help you to configure it properly.
- We'll setup your AP in our Cloud4Wi Sandbox account
- Download our Demo Mobile App and set it up according
You'll be able to experience the power of a smooth and automatic WiFi connection as soon as you are in range of your test network and to experience the location moments triggered by your interactions.
Get started in 3 steps
1 . Setup the network
Add to your Access Point a dedicated SSID configured with WPA2-Enterprise settings (here you can see for example the Cisco Meraki docs).
Note that the new SSID can also be hidden if you prefer. In any case, the process won't affect the existing experience and security of your existing network.
We provide a step by step documentation for each certified vendor. Tested vendors at this time are: Cisco, Cisco Meraki, Ruckus, Mikrotik, Huawei.
Add the Access Point MAC address in the Cloud4Wi Dashboard.
2 . Install and integrate the SDK
Get the authorization token form Cloud4Wi and install the SDK following the user guide.
You can develop any enrollment experience that you like (such as a button, a form or an additional opt-in) or trigger it automatically in background.
Min required version for Android is Android 4.3 (Android Jelly Bean MR2, API version 18). Min required version for iOS is 11.0
3 . Setup and receive Location Moments
Form the Cloud4Wi Dashboard, you can enable the webhooks that you are interested in and send the notifications to your application servers. Learn more about the webhooks.
How the SDK setup works
The SDK allows the mobile app to pre-activate users in the Cloud4Wi platform and generate a local WiFi profile that enables the phone to automatically associate and authenticate to the enabled access points, even if the app is in background.
The SDK offer the developer 2 main methods:
1) CREATE THE USER
In order to authenticate the user on the network, each user must have a unique account in the Cloud4Wi core authentication system, identified by a username and password. The credentials can be generated by the mobile app and sent to Cloud4Wi or they can be generated automatically by the Cloud4Wi cloud authentication systems. If you generate the credentials on the mobile app, we suggest to use a random password or at least different form any other existing user password for additional security.
The method also allows passing the user contacts and demographic attributes, so it gets stored in the Cloud4Wi CRM for using it in combination with the Cloud4Wi marketing tools.
To create a user account in the system, Cloud4Wi requires to specify also the user agreements that have been accepted by the user. Cloud4Wi allows clients to create their own custom agreements and opt-ins, so a dedicated method allows the developer to optionally pull the list of all the possible opt-ins configured in the Cloud4Wi account so that they can be used when invoking the method to create a new user. You can also use this method to gather the list of opt-ins and create an experience in your app to collect your customer's consent.
2) CREATE AND INSTALL THE PROFILE
Once the user account has been pre-activated, this method allows creating a configuration profile for the user device. The result of this method is different for iOS and Android devices.
On Android versions prior to 10 WiFi profiles can be seen on dedicated settings page and can be removed manually.
On Android 10+ versions WiFi SDK will trigger a network suggestions notification that needs to be accepted by the user. By uninstalling the app WiFi profile will be removed automatically
In iOS devices, the profile can't be found in the list profiles managed by the OS, so they cannot be removed manually by the users. By uninstalling the app, also the WiFi profile is removed automatically. Moreover, on iOS the attempt of installing the WiFi profile will prompt a native dialog of the operative system that ask a confirmation to the user.