Creating Views

MyDataHelps Views are powerful tools allowing you to embed your own web page/app into the participant experience. This can range from static web pages to dynamic applications which can launch surveys or display unique participant results.

Introduction to Views

MyDataHelps views are web-based, and leverage embedded browsers on iOS and Android (or iFrames on web). Views can be used as one of the tabs inside MyDataHelps. You can also navigate to different views from inside your application, allowing the creation of highly sophisticated projects.

Getting Started

Before using MyDataHelps in a custom application, you will still need to have a MyDataHelps account and project. See the Getting Started guide if you do not already have one.

To create a MyDataHelps view for your project:

  1. Create your web application using modern tools (Angular, React, Vue, etc.) and the MyDataHelps JavaScript SDK.
    • MyDataHelpsStarterKit is a React web application template that you can clone/fork to accelerate your custom view development.
    • The MyDataHelpsUI React component library can be used to import standard views and components into your web application, so that you don’t have to build them yourself.
  2. Host your application on an external web server. See hosting for details.
  3. Submit your application for a security review.
  4. Use your view in your project.

Configuring Views as Project Tabs

You can use your view as one of the tabs that will display to your participants in MyDataHelps. For example, if you have a view that shows participant rewards, you can create a “Rewards” tab.

  1. Go to the “App Layout” tab on your project settings screen.
  2. Select an existing tab or click “Add Tab” to create a new one.
  3. Select “Custom View URL” for the view type, and enter your app’s URL in the box below.

You can use the MyDataHelps JavaScript SDK to navigate to a view from another view, building more sophisticated applications. See navigation for details.

Testing Views

In order to access project/participant data using the MyDataHelps SDK, the view must be running from within MyDataHelps with a logged in participant.

To test your view, we suggest creating a separate test or “dry run” project with fake participants. You can then log in as one of the test participants to see the view as a participant would. See Testing Projects and Surveys for more information about creating test accounts and hosting for help setting up a test version of your project.