Beiwe Troubleshooting

From Beiwe Wiki
Revision as of 16:41, 22 January 2018 by Msimoneau (talk | contribs) (Not Any Receiving Data)

Jump to: navigation, search

“Can’t Open File” Error During Installation

Sometimes Android saves the .apk file such that it can’t be accessed on installation. To fix this access the file (beiwe.apk) directly from the phone’s MY FILES folder if the application won’t install from the “Downloads” folder. 

My Files is found in different locations depending on phone model, here are some of the most common directions:

  • Apps --> My Files --> All Files --> Downloads
  • Apps --> Samsung --> My Files --> Download History 
  • My Files --> Installation files (APK) --> Beiwe

Not Receiving Any Data

Android

If there's no data from an Android phone go through the following steps with the user:

  1. Have they been on Wi-Fi during the specified time period? If they haven’t, then Beiwe is unable to upload the data and the data is likely still on the phone.
  2. Have they allowed Beiwe to access their location as a “permission?” This is under Settings --> Device --> Applications --> Application Manager --> Beiwe and then scroll down to see Permissions. Location must be accessible for Beiwe to function properly.
  3. Have the user check Beiwe's information in the Application Manager (under Settings --> Device --> Applications --> Application manager --> Beiwe) and check the storage on that screen. If the amount of Storage used is very high, that might indicate that the phone is failing to upload data files. The user should connect to a reliable Wi-Fi server for an hour or longer.

iOS

If there's no data from an iOS phone go through the following steps with the user:

  1. Have they been on Wi-Fi during the specified time period? If they haven’t, then Beiwe is unable to upload the data and the data is likely still on the phone.
  2. Have they allowed Beiwe to access their location as a “permission?” This is under settings -> Privacy -> Location Services -> Beiwe, make sure it says “Always.” Location must "Always" be accessible for Beiwe to function properly.
  3. The user should connect to a reliable Wi-Fi server for an hour or longer.

Not Receiving Survey Notifications

Android

Check Settings --> Application Manager --> Beiwe and ensure notifications are enabled.  Notifications must be turned on for Beiwe and are required for the survey to be present. The user must click on the actual notification to access the survey. Turning on Do Not Disturb is another form of disabling notifications. 

iOS

Notifications are likely turned off.  Check Settings --> Notifications --> Beiwe and ensure that notifications are enabled. For Beiwe iOS, notifications are not required to take surveys. The user can simply login to Beiwe and the surveys should be available.

Question: What is the procedure when our study is over?

  1. Ask patients to uninstall (android) or delete (ios) the Beiwe app from their phone.  It will not affect data already collected, but will end the data collection.  You can also “unregister smartphone” for the patient ids in the Beiwe backend to make sure you stop collecting data as your various patient IDs wrap up.  (for android its settings>apps>app manager>beiwe>uninstall.  It will delete any remaining data on the phone, but that should be ok as long as the user has had a good wifi connection & Beiwe has uploaded their data recently.)

2. The only other thing some collaborators do is ask for feedback on the app/study.  Here’s one such question that was used.  Please share any such feedback from users if you request it!

We would appreciate any feedback about how you found participating in the month-long study. Would you recommend it to other people? Were there ways we could make the experience better? How easy or hard was it to use the app?

Additional Questions

If you have additional questions that aren't addressed here, please email Onnela Lab Research Assistant, Kenzie Carlson at kcarlson@hsph.harvard.edu. When emailing please provide the following information: phone type and brand, operating system type and number, GPS setting on phone, Wi-Fi setting on phone, notifications setting on phone, patient ID and study name.