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 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 accessing the Connect tab and copying the Production Environment ID from the correct operating system overview card.
    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 within your mobile application, partner with your engineering team to identify the user ID and/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. Please note that Sprig has implemented an auto-accept mechanism within the Mobile SDK that allows a call of UserLeap.track\YOUR_TRACKING_EVENT to instantiate the event.
      1. Once your Engineering team has enabled that name for the event, it becomes available to you in the UI when designing the Study to Trigger the study. Thus as long as that's enabled, a study designer shouldn't have to manually create it.
      2. Alternatively a study designer can Add an Event via the UI and choose Code to name an event, then share that name with their engineer to have them instantiate the event UserLeap.track\YOUR_TRACKING_EVENT.
      3. If you need help managing this workflow between team members, download this product team Study, Event & Attribute Tracker or contact Customer Success.
    2. Make a note of a particular event in your mobile app and its name as you will need it later when you define your audience in the study.
    3. In the Navigation Pane, click Events and locate the event that they defined.
    4. The green Daily Usage icon shows that Sprig is tracking that event. Hold the pointer over the icon to view the event throughput.
    5. You are now ready to begin designing your study.

4. Choose Template

Navigate to the Templates section within your account to browse expert-written research templates. Templates are organized into use case collections to help you easily find what you need, like:

  • Onboard More Customers
  • Create Better Content
  • Launch a New Product or Feature
  • Recruit Interview Participants
  • Reduce Customer Churn
  • & more!

Choose the collection that best fits your business problem. Then browse, preview, and select the template that best supports your research.

  1. Scan and hover over each template.
  2. Observe the preview on the right side.
  3. To choose the template, either select the template card or click the green Customize and Launch button on the right, under the preview of the template.
  4. If you'd rather not use a template, you can always choose to Create from Scratch via the purple button in the top right corner to create your custom study.

5. Customize Study

For the Question selection:

  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:

  • Skip Logic
  • Default Text
  • Thankyou Card

For the Audience selection:

  1. Choose Mobile as the platform.
  2. Under Triggers, choose the event that you added in the step above in partnership with your engineering team.
    1. Select the dropdown to search and choose the corresponding event for your mobile study.
  3. 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. Saving the changes of your study places it into a status called Draft.

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

  • Total Responses
  • Recontact Options

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 any help with either of these installations, please reach out or book time with our Product Support and Customer Success teams. We’re happy to lend you a hand getting started.