사용자 온보딩 계획

많은 앱에는 앱 기능에 대해 사용자를 교육하거나 사용자 동의를 요청하는 등의 워크플로를 위한 맞춤 온보딩 흐름이 있습니다. 원활한 연결 흐름을 만들기 위해 앱은 Matchmaking API를 사용하여 앱이 읽도록 구성된 데이터를 쓸 수 있는 다른 앱을 연결하라는 메시지를 사용자에게 표시할 수도 있습니다.

맞춤 온보딩 흐름을 포함하려면 권한이 부여된 후 자동으로 실행되도록 헬스 커넥트를 구성하세요. 하지만 매치메이킹 API는 이 트리거를 지원하지 않습니다. 이렇게 하려면 매니페스트에 다음을 추가하세요.

<!-- Required to support pre-Android 14 devices with APK Health Connect -->
<activity
  android:name=".OnboardingActivity"
  android:exported="true"
  android:permission="com.google.android.apps.healthdata.permission.START_ONBOARDING">
  <intent-filter>
    <action android:name="androidx.health.ACTION_SHOW_ONBOARDING"/>
  </intent-filter>
</activity>
<!-- Required to support Android 14+ devices with platform Health Connect -->
<activity-alias
  android:name="UAndAboveOnboardingActivity"
  android:exported="true"
  android:targetActivity=".OnboardingActivity"
  android:permission="android.permission.health.START_ONBOARDING">
  <intent-filter>
    <action android:name="android.health.connect.action.SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

사용자는 앱 내에서가 아닌 헬스 커넥트 앱에서 직접 앱에 연결을 시작할 수 있습니다.

버전 지원

Android 14 이전 기기와 Android 14 이상 기기를 모두 지원하려면 다음을 충족해야 합니다.

  • 권장 접근 방식: 두 시나리오를 모두 처리하는 단일 온보딩 활동을 만듭니다. 예에 표시된 대로 활동 별칭을 사용하여 Android 버전 간 호환성을 확인합니다.

  • 대체 접근 방식: Android 버전별로 별도의 활동 두 개를 내보냅니다. 이 접근 방식으로 인해 유지관리 복잡성이 증가할 수 있습니다.

내보낸 활동 요구사항

사용자가 앱을 헬스 커넥트에 연결하려고 하면 내보낸 활동이 실행됩니다. 이 활동은 다음 작업을 실행해야 합니다.

  • 쓰거나 읽은 데이터를 설명하는 등 관련 사용자 교육을 표시합니다.
  • 필요한 경우 사용자에게 동의를 요청합니다.
  • 헬스 커넥트에 권한을 요청합니다.
  • 주기적 worker를 예약하는 등 기타 애플리케이션별 로직을 실행합니다.
  • 완료되면 사용자가 활동을 닫을 수 있도록 합니다.

온보딩 활동을 내보내지 않는 앱의 경우 헬스 커넥트는 사용자가 앱을 연결하려고 하면 사용자를 대신 권한 관리 화면으로 안내합니다. 통합이 작동하기 위해 권한이 부여되기만 하면 되는 앱에는 이 방식이 적합할 수 있습니다.

온보딩 활동은 두 번 이상 실행될 수 있습니다(예: 사용자가 나중에 앱에 대한 권한을 취소한 후 다시 연결하는 경우).

이전
개요
다음
Matchmaking API