5. Tips and Guidelines

See some important tips as well as Apple's own guideline before starting to use the SDK.

This document refers to deprecated parts of the platform and has been left intact to help customers with legacy integrations. In order to access the latest platform features and documentation, please go to https://docs.sentiance.com.

Apple provides some useful tips about Requesting Permissions as part of their Human Interface Guidelines.

In addition to that, below are the things to consider for an optimal user experience:

Starting from version 5.6.0, Sentiance iOS SDK no longer asks for Motion Activity Permission and therefore it must be handled in the app level.

The Sentiance platform requires motion activities to improve the SDK detection quality and to do Lifestyle Profiling. Moreover, without this permission, some detections won't be possible (e.g. running detection). For any questions, please contact our support.

Privacy

• Request personal data only when your app clearly needs it.

• Explain why your app needs the information.

  • When the application requests permission for background locations or motion activities, a message will be shown to the user. You can configure this message by changing the value for the following keys in Info.plist

    • NSLocationAlwaysUsageDescription

    • NSLocationWhenInUseUsageDescription

    • NSLocationAlwaysAndWhenInUseUsageDescription

    • NSMotionUsageDescription

Keep the text short and specific, use sentence case, and be polite so people don't feel pressured. There’s no need to include your app name.

Consistency

• Request permission at launch only when necessary for your app to function.

• Use the system-provided alerts.

Efficiency

• Don’t request location information unnecessarily.