Showcasing Health Connect in your app depends on the UX patterns and conventions established in your UI.
Focus on the user benefit
The first time you introduce Health Connect to users, provide a meaningful reason for them to set it up.
Rather than describing Health Connect's features, tailor your message to how a user benefits from those features.
Use clear language
Don't ask users to "Connect to Health Connect." This is a jarring sentence and may also confuse a user's understanding of the relationship between apps in the Health Connect ecosystem.
Your UX should help users form an idea of how Health Connect interacts with your app, so it's important to consider which button labels work best toward achieving that goal.
Try using verb phrases like "set up" or "get started" on your button labels. Or, if you're launching the permissions view, use more specific button text, like "Choose data to share."
How to promote Health Connect
Here are a few ways you can promote Health Connect in your app:
- As part of your app's setup flow.
- With a card in your app's home screen.
- Through an entrypoint within a Settings screen.
- With an Android 13 APK download button for Android 13 versions and lower.
- When promoting new data types.
- With a modal or dialog when updating the app, similar to the app's setup flow.
App setup and requesting permissions flow
Home Screen Promo Card Flow
Settings
Android 13 APK Download
Onboard new data type(s) and requesting permissions
Apps that already have a Health Connect integration can request new data types in addition to the already granted ones.
Only the new data type(s) requested should be shown in the permissions screen, to avoid confusing users.
The following are a few examples of how to promote new data types(s):
Reuse existing conventions
If your app already promotes new data in other ecosystems, we recommend doing the same for Health Connect in Android, and adapt the language where relevant.
Emphasize the value proposition
Why would users want to use this data in your app?
- Examples: reading the data
- Gives users more accurate insights in your app
- Users can see all data in one place in your app
- Example: writing the data
- Users can share this new data from your app with other compatible health and fitness apps on their phone
Contextualize permissions
Ask for new permissions where it makes sense for users, so they know what's being asked of them.
Examples:
- Ask for exercise routes permission after users finish a workout in your app.
- If your app implements new permissions, show these together in one promo on the home screen.
- If you have a dedicated section in your app, for example Sleep, promote the corresponding permission there.
