Launching studies on iOS & Android
Approaches for recruiting participants from within your native iOS or Android apps.
We do not currently have native iOS or Android SDKs. If you want to conduct studies with users recruited within your mobile application, there are two approaches that allow you to achieve this, which we go through below. Both approaches require you to first create a study that can be shared via a link. You'll then use that URL to display your study to your users. Find out more about creating studies that can be shared via a link.
Please note that both of these approaches will likely require development work from an engineer on your team.
Reduced block support
Image and Prototype tasks are currently not supported on mobile devices.
Direct participants from your app to a linked study in a new browser window
The most straightforward way to direct your users to a Wondering study is to create a study that can be shared via a link, and then open this URL in the user's native browser when the user meets your required criteria.
Display your study in-app using a web view
If you would prefer to display your study in-app, instead of linking to your study in a new browser window, you can display your study in a web view. There are multiple options for doing so on both iOS and Android, and we've set out our advice below.
When displaying a study in-app in a web view, please note that you must ensure your application is able to request permission to access the microphone to avoid your application being forcibly terminated by the operating system.
Displaying studies in a web view on iOS
We recommending using SFSafariViewController
(https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller) to display the study seamlessly without leaving your app. Using SFSafariViewController
to open a linked study will display an embedded Safari view, with Safari handling the complexity of requesting microphone permissions, and means your users can make use of Safari's accessibility features if needed.
It is also possible to use WKWebView
, however you must ensure your application is able to request permission to access the microphone (https://developer.apple.com/documentation/webkit/wkuidelegate/3763087-webview), and you must have set the NSMicrophoneUsageDescription
key in your app’s Info.plist
(https://developer.apple.com/documentation/bundleresources/information_property_list/nsmicrophoneusagedescription) otherwise your application will be forcibly terminated by the operating system. Your application will also need to be submitted to Apple for review when this permission is added to Info.plist
.
Recommended reading
Should I use WKWebView or SFSafariViewController for web views in my app?
SFSafariViewController | Apple Developer Documentation
Displaying studies in a web view on Android
On Android, we recommend using a Custom Tab (https://developer.chrome.com/docs/android/custom-tabs/overview/) to display the study within your app seamlessly. This way, the Custom Tab will handle the permissions needed to access the microphone for you. Users will also be able to enjoy the same accessibility features they can access in their native browser.
You may also choose to implement a WebView
(https://developer.android.com/reference/android/webkit/WebView), however you must ensure your application is able to request permission to access the microphone, otherwise your application can be forcibly terminated by the operating system. You must declare the RECORD_AUDIO
permission in your app’s AndroidManifest.xml
(https://developer.android.com/reference/android/Manifest.permission#RECORD_AUDIO).
Recommended reading
Updated 28 days ago