Mobile

Designing and launching research studies for mobile apps

To install Sprig on your mobile application, you and your team may choose iOS, Android and React Native. For a simple mobile install, most teams can complete this work in 1 to 4 hours.

1. Deploy SDK

Sprig provides iOS , Android and React Native SDKs. Choose the SDK based on your engineering team’s preferences.

  1. Partner with engineering to choose your Mobile SDK.
  2. Install the Mobile SDK on your product’s mobile application.
  3. Add a team member.
    1. Identify a colleague who has access to your codebase and code repositories.
    2. In the Navigation Pane, click Settings.
    3. Click Team.
    4. Click Add Member.
    5. Enter their first and last name, plus their email address, and assign them the developer role.
    6. Click Save.
  4. Request from your engineering team that the Mobile SDK be installed.
    1. Initialize the module first by navigating to Connectclick Get Environment ID and copy the Environment ID (the Production and Development IDs are the same for iOS, Android, and React Native.
    2. Use the following message to send to your engineering team to help get the Sprig/UserLeap SDK set up:
Hi there - can you find 90 minutes to accept the Sprig invite that I sent you 
and install the Sprig Mobile SDK?

The invite was sent via your email address from Sprig. 
Once you’ve accepted the invite, the snippet is described here in this link under 
https://app.sprig.com/connect on the card at the top. 

Make note that you'll need the Environment IDs contained there. 

If you need any help, you can contact the Sprig Customer Success team
https://docs.sprig.com/docs/support


Thank you,

[Your Name]

2. Identity and Attributes

  1. For any user attributes accessible from your mobile application, partner with your engineering team to identify the user ID or email address and pass along any additional user attributes to Sprig via the Mobile SDK. Sprig automatically tracks and attaches the following attributes:
    • App version
    • iOS/Android version
    • SDK version
    • Device type
    • System language

3. Add Event

  1. Verify with your engineering team that they have configured the events and attributes to track in your production mobile application.
    1. Code events must be approved in the Sprig app. The first call of UserLeap.track(YOUR_TRACKING_EVENT) will record the event, but it will not be Active for use until it is reviewed and approved in Data Hub > Events > Manage Requests.
      1. Alternatively, a study designer can add a Code Event first via Data Hub > Events > Add Event, and then share that name with their engineer to have them instantiate the event UserLeap.track(SHARED_TRACKING_EVENT_NAME).
      2. If you need help managing this workflow between team members, contact Customer Success.
    2. Note the particular event in your mobile app and its name, as you will need it later when you define the study audience.
    3. In the Navigation Pane, click Data Hub > Events and locate the desired event.
    4. Hover your pointer over the Usage icon to show Sprig tracking the event throughput.
    5. You are now ready to begin designing your study.

4. New Study

To create a new study, click + New Study, then click either Create from Scratch > Survey or select one of the predefined templates. The templates are organized by use case. Choose the collection that best fits your business problem. Then browse, preview, and select the template that best supports your needs.

  1. Click each template.
  2. Click on the questions and observe the preview on the right side.
  3. To choose the template, click Use this template.

5. Customize Study

For the Question tab:

  1. Review the questions.
  2. Customize by changing the wording, deleting a question, or adding a question.
  3. Click Save Changes, and you will be returned to the summary view. Your study will now have a Draft status.

To learn more about designing research questions, visit the following topics:

For the Audience tab:

  1. Select Mobile App for How to Send.
  2. Under When to Send, choose the event you added in the above step in partnership with your engineering team.
  3. Optionally, under Who to Send to, add a filter in your study to refine the target audience that should receive your study. Similar to your study trigger, select an event or attribute to segment your eligible users for this study.
  4. Click Save Changes.

To learn more about designing research questions, visit the following topics:

6. Launch Study

  1. Click the Launch Study button in the top right corner to view responses as your audience completes the study.

If you need help with either of these installations, please contact or book time with our Customer Success team. We’re happy to lend you a hand getting started.


What’s Next

For further information.