Content Menu - MyCap

MyCap Overview

MyCap Setup

Creating Tasks and Surveys

Participant Use

Using MyCap

IRB Submissions

User Permissions

---

What is MyCap?

MyCap is a mobile app that participants can download to complete research data collection and the automated administration of Active Tasks (activities performed by participants using mobile device sensors under semi-controlled conditions) from any mobile device. All data collected in the MyCap App are automatically sent back to the REDCap server as soon as internet connection is available (i.e., it can also be used for offline participant data collection).  This app makes it simple and inexpensive (no-cost) for researchers to use a mobile app to capture participant reported outcomes on both iOS and Android devices. MyCap provides a quick two-way messaging system between REDCap and the participant's MyCap app (e.g., messaging and announcements).

MyCap can be enabled on a REDCap project by a REDCap Administrator when a project requests this feature. 

There are two different versions of MyCap on the app stores:  MyCap and MyCap Classic.  This page focuses on the features of MyCap.  

Device Requirements

MyCap is available on any iOS device (iOS v11.0+) and any Android device (Android v8.0+)

MyCap Core Features

• Compatible with iOS and Android devices
• Supports REDCap surveys
• Captures active tasks (e.g., audio recording, tone audiometry, tapping speed)
• Offers flexibility in scheduling including one-time and recurring tasks
• Allows for data collection multiple times per day
• Automates push notifications when tasks/surveys are scheduled to be completed
• Supports bi-directional, secure messaging between study teams and participants
• Supports the sending of announcements to all participants
• Allows for the creation of information screens (e.g., project overview, study contacts, get support)
• Supports custom themes for the project, including customized images and colors
• Captures links to websites and web-based resources
• Supports multiple projects/studies for a single participant
• Supports multiple profiles on single device
• Offers 6-digit passcode security, which can be disabled if desired
• Supports offline data collection, which is automatically synced with study database when internet connectivity is re-established
• Supports longitudinal projects with event timing for scheduling app tasks

MyCap Workflow Overview

Below is a high level overview of the steps in a MyCap Project Life Cycle.

1. Create your new REDCap project.
2. Request a REDCap administrator to enable MyCap for your REDCap project. (Make sure to include MyCap usage in your IRB submission.)
3. Continue designing your REDCap project (adding forms, surveys, Active Tasks, etc.).
4. Design the MyCap interface.
   1. Schedule when and how often tasks/survey should appear.
   2. Create information screens.
   3. Create a custom theme.
5. Test MyCap with colleagues.
6. Move project to Production, just as you would with a regular REDCap project.
7. Give unique QR code to participant. This QR code will bring them to the appropriate project.
8. Participant downloads MyCap app and joins the project by scanning the QR code.
9. The device pulls from the server the REDCap project configuration into the participant’s device.
10. Participant receives push notifications set up within project.
11. Participant enters data via the app.
12. Once study ends, participant can uninstall the app or delete the project from the app (if they are participating in multiple MyCap studies)

Each participant has to use only one device when reporting through MyCap. Say a participant has a cell phone and a tablet. Whichever device they use sends task results to the server. The server does not send task results to the device. The participant's tablet will have no knowledge of a task that was completed on the phone. If a participant were to get a different device, however the user could have the task results sent from the server to the participant’s new device. 

Messaging

MyCap uses an internal messaging system. There are no data charges. When using this feature, the participant will see the message ‘You have a secure message waiting’ displayed. When the participant clicks on that push notification, MyCap shows the message sent from the REDCap database.

Please note that if the participant messages the study team, the study team will not receive a notification about a waiting message outside of REDCap.  Any messages received will be available in REDCap's MyCap Participant Management message dashboard and indicated with a small visual icon. Ensure that your team informs participants the MyCap messaging is NOT to be used for 'urgent' contact.

MyCap vs MyCap Classic

In the app store for iOS and Android devices there are two different versions of the MyCap application, MyCap and MyCap Classic.  MyCap Classic is an older version of MyCap that is available but will no longer be receiving updates or new features and will be removed from the app store in August 2024. It is highly recommended to use the new MyCap app (purple background) for all future projects.

When participants download the app, the research team should make sure that their participants are downloading the correct version to their devices. 

Limitations of MyCap

The following REDCap features are not supported in MyCap:  piping, smart variables, field embedding, special functions, calculated fields, and most action tags (@HIDDEN and all @MC- prefixed action tags *are* supported). 

Branching logic is partially supported for single-statement branching logic, such as [field]='1', is supported. (i.e., does not contain AND, OR, or special functions)

For an updated full list of help resources, features, and limitations of MyCap please visit this site: https://projectmycap.org/mycap-resources/.

To the top

---

MyCap Setup

REDCap administrators can enable MyCap for a project upon request. 

Once enabled, MyCap can be configured and customized to match project needs.  You will see a new option specific for MyCap under Project Setup and in the Designer.

In the MyCap Design and Configuration window there are four different areas that will allow you to customize the appearance and navigation content of the app based on your project.  Adding app specific tasks or surveys will be added from the Designer as instruments in the project. 

Customizing About Page

The "About" pages are the first thing that participants will see after they add the project to their device.  One "Home" page is required, but several different pages of content can be added.  With each page you can customize the Icon or Logo that users will see at the top of the application. 

After customizing, you can select the "Preview" button to see an example of how your app will display on a phone.  It may also be useful to download the app to your device so you can see changes as they would appear to participants. 

Customizing Contacts Page

A "Contacts" page can be added to list any contacts that may be important for participants.  These can be contacts for participant questions or provide contacts for other resources as needed.  The contact information provided MUST be your valid university email address and/or phone number.  All IRB and UW policies must be followed.

After customizing, you can select the "Preview" button to see an example of how your app will display on a phone.  It may also be useful to download the app to your device so you can see changes as they would appear to participants. 

Customizing Links Page

The "Links" page can contain links to other websites or helpful documents that participants may find useful to open on their devices.  Multiple links can be added as needed. 

Customizing the Theme and Look of the App

The "Theme" tab allows you to select a color scheme or create your own to customize how the app will appear.  If your study is associated with particular colors or branding this can help create uniformity between content that a participant would see. 

To the top

---

Creating Tasks and Surveys

Once MyCap is enabled there will be new options specific to the app in the Online Designer. 

Available Options:

• "MyCap Options" can bring you back to App Design, provide details on tasks, or allow you to enter a field as a "Baseline Date" for task scheduling purposes. 
• Under Data Collection Instruments you can search for Active Tasks from the available library.  The tasks will be added to the list of Instruments with a note that they are an "(Active task)".
• "Enabled as MyCap task" option to enable instruments, tasks, and surveys as a MyCap task.  This is similar to how you would typically enable a survey regularly. 
• "MyCap related options":  allows customizing of task settings and frequency, much like survey settings. 

Once you select "MyCap settings" for a given instrument there are several options to customize how the task will be handled by the app.  This includes some visual customization like Task Title and Descriptions as well as setting the schedule for when the task should be completed by the participant. 

Some of the Tasks have Task specific customization that will apply to only that task.  In the example of the Two Finger Tapping Task there are additional custom fields for the duration of the tapping test and which hands should be tested.

You can find a list of available tasks with descriptions here.

Scheduling Tasks and Surveys

Tasks may be scheduled for specific times or dates based on project a designated project Baseline date or participant app install dates.  

If the project is Longitudinal, then tasks may be scheduled based on Event Days Offset.

Applying Changes

Once you make changes to Tasks or Designs there will be a note in the top right corner of the screen informing that the current changes need to be updated to the devices using the app for this project.  You will need to select "Publish new MyCap version" each time you would like new changes to be applied to the app. 

To the top

---

Distributing Project to Participant

Projects can be distributed to participants by link or by QR Code linked to their specific Record.  Distribution options are found under "MyCap Participant Management" in the left-side menu under "Data Collection". 

Under MyCap Participant List there are options to individually invite participants or invite in bulk using the "Invite Participants" button.  Each participant can use a field to assign a "Custom Participant Label" to help sort the records.  This will also show the dates each person Installed the project on a device and their Baseline Date if a date field has been assigned the Baseline Date in the Online Designer. 

Once you have selected to invite a participant you will have the option to invite based on a QR Code they will scan using the app on their device or a link that they can open on their device once the app is installed. 

QR Code Generation and Distribution

There are several different ways you can distribute a QR code to a participant. Here are some options:

1. Take a screenshot of the QR code and email to a participant
2. A coordinator may help direct the participant to download the MyCap and scan the QR code in person if the participant is visiting a clinic
3. Print the QR code onto paper and mail to a participant
4. Pipe the QR Code into the Survey Completion Text of a public survey. 
5. Use REDCap’s Alerts & Notifications feature to automatically email a QR code to a participant. Use REDCap’s piping mechanism to pipe the participants QR code value into the content of the email.  This method can work similarly to scheduling Automated Survey Invites. 

This QR Code is unique to a record and should only be shared with the specific participant it is for. 

To the top

---

Using the MyCap App

  Expand All Collapse All  

Setting Up App on a New Device

Setting Up Profiles and Projects

Task Lists and History

Completing Tasks

Removing Participants from a Project

Participant removal from a study

If a participant is only participating in a single project and they want to leave the project, then they can simply uninstall the MyCap app.

Removing oneself from the MyCap app or deleting the MyCap app entirely only deletes data on the participants device. No previously transmitted data will be deleted from the REDCap project.

Participant removal from a specific MyCap project

A user can delete a project from their profile by navigating to the list of projects under their profile, then pressing and holding on the project they want to remove.  This will create a Delete Study pop up that will ask a user to confirm that they wish to remove this project from their profile. 

This will delete the MyCap project from the MyCap app. This is typically only useful if a participant is participating in multiple MyCap projects and one of them has ended.

To the top

---

Referencing MyCap in IRB Submissions

Language recommendations when using MyCap for IRB applications and consent forms is listed below.  The provided language is meant to be used as a template, but may need to be adjusted to fit your specific project details. 

Recommended IRB Application / Protocol Language

This study will be using a mobile application called MyCap that will need to be downloaded to a participant’s personal mobile device (iOS or Android).  We will use this app to send push notifications and reminders to complete tasks related to participation in this study.  UPDATE BASED ON YOUR STUDY'S USAGE: The tasks will include survey questionnaires, and the following Active Tasks [insert names of specific active tasks that will be used]. Data entered into this device will be automatically synchronized to the study team’s SMPH REDCap project. 

Recommended Consent Form Language

This study will be using a mobile application called MyCap for this project.  This app will need to be downloaded to your personal mobile device (iOS or Android).  The study team will use this app to send you push notifications and reminders to complete tasks related to participation in this study. 

Ensure that your team informs participants the MyCap messaging is NOT to be used for 'urgent' contact. This should also be listed in a study information sheet provided to participant.

Active Task Language

If you are planning on using any of the built in Active Tasks, reference this page to find the appropriate task with provided explanations of the app to reference for your application or protocol submission:  https://kb.wisc.edu/smph/informatics/133154

You do not need to provide documentation for built-in active tasks as long as the title and provided explanation is listed in protocol.

Custom instruments/surveys will still need to have a PDF of the custom survey provided to IRB for review.

To the top

---

REDCap User Permissions

REDCap administrators must enable MyCap for a project.  Once enabled, individual users will need to have "Manage MyCap Participants" Privileges in order to create invites and see the active list of app participants within the project. 

If you have a UW-Madison REDCap project and have questions about MyCap, please send them to REDCap@ictr.wisc.edu

To the top