Tracker Design GuidelinesApr 27, 2017

This document includes design guidelines for the Samsung Health SDK’s tracker and tracker tile.

Tracker

The tracker is a basic building block of Samsung Health. The user’s health data can be monitored, measured or updated through the tracker such as counting steps, measuring heart rates, tracking exercises, collecting health data on background, or allowing user to enter data manually.

Samsung Health has useful health trackers and user can see interesting health data through the tracker tile on the main screen by turning on the each tracker’s switch for subscription on the Samsung Health > Manage items menu.

Samsung Health’s Trackers Samsung Health’s Trackers

Design Principles

Samsung Health SDK’s Health Service provides interfaces to create your app’s tracker and post its tile on Samsung Health to provide intelligent health service for user.

Your tracker will be shown on the Samsung Health > Manage items page after installation of your app on the device.
Consider the following principles before designing your tracker and its tile.

Principle 1 - Tracker Definition?

An application that defines a tracker can be rejected as Samsung Health’s partner apps if the tracker’s data is duplicated with Samsung Health’s trackers because the defined tracker’s tile can be posted on Samsung Health’s main screen with other Samsung Health’s trackers.
As the right figure, Samsung Health posts the related tracker’s tile automatically when your application writes measured data to Samsung Health. If your application’s tracker is defined to express the user’s blood pressure, two tiles for Samsung Health’s blood pressure tracker and your application tracker will be posted at the same time.
Check Samsung Health’s existing trackers before defining your tracker. If the cover your application’s health data, avoid to create a new tracker for your application if Samsung Health’s trackers cover.

Principle 2- How many your tracker can be defined?

Only one tracker is allowed for each Samsung Health’s partner application. Chang the tracker tile type whenever the app posts the its tracker tile if required instead of defining one more tracker definition.

Samsung Health Tracker’s operation Samsung Health Tracker’s operation

Tracker Operation

The following figure describes a use case for how your tracker’s tile is shown on Samsung Health.
You can select a different tile type when your tracker is posted.

Screen Grid

Samsung Health provides 2x and 3x screen grids.

The user can select the preferred grid in Samsung Health > Manage items.

If you set your tracker tile for the 2x grid only, the SDK’s Health Service resizes your tile automatically for the 3x grid. Some property values like the title, measured data, or button text can be clopped by cases.

Checking your tile on both grids is needed for the nice view to users.

Tracker Definition

If your application is registered as Samsung Health’s partner apps and user installs your application successfully, your application’s tracker is shown in the Samsung Health > Manage items menu.

Tracker Tile

If user subscribes your tracker on Samsung Health > Manage items, its tile is shown on the main screen of Samsung Health.

Tracker Tile

The subscribed tracker is visualized as a tile with the rectangular box on the main screen of Samsung Health. It has the three types as the figure below. It presents a notification to user or the latest data collected by its tracker such as calories burned, running distance, or number of activities. And it acts as a gateway to its tracker. E.g. it can jump to the tracker’s detailed page or start measurement when the tracker tile is selected.

Tracker Tile Types Tracker Tile Types

Tracker Tile Types 1

The tracker tile needs to be designed to consume it quickly on the main screen by user as well as perform the proper action for its tracker when it is selected.

Note that the background color of the tile is fixed. E.g. white. However, one can use the primary brand color for the title, content value and unit, and button background. They are marked with* in this guideline.

Tracker Tile Type 1

The type 1 is useful when notifying user without tracker’s measured data.
It contains only the following properties.

  • Icon

  • Title

  • Button

This tile type is useful to post the first tile when the user subscribes your tracker and there is no data to display yet.

You can add an event to the button to start the data measurement on your app.

Tracker Tile without Content Value Tracker Tile without Content Value
Tracker Tile Type 2

The type 2 presents the latest tracker’s latest data with the following properties.

  • Icon

  • Content value

  • Content unit (optional)

  • Title

  • Date

Tracker Tile with Content Value Tracker Tile with Content Value
Tracker Tile Type 3

The type 3 presents the tracker’s latest data with the button action and the following properties.

  • Icon

  • Content value

  • Content unit (optional)

  • Title

  • Date

  • Button

Tracker Tile with Content Value and Button Tracker Tile with Content Value and Button

Interaction Policy

You can add the intent on the tracker tile itself or the button to perform the specific action.

The tile intent is used to jump to its tracker to show its detailed information when the tracker tile is selected by user.

The button intent of the tracker tile is more specified. Its appropriate actions when the button is pressed are the following.

  • Start or stop a tracking session

  • Measure new health data

  • Update health data

For a tracker that collects data on background, use one of tile types without the button and periodically update its tile.

Tile Type 1 (2x Grid)

The following figure describes size information of the tracker tile without content value. Make your tracker to be in harmony with other Samsung Health’s tiles.

The figure below describes Tile Type 1’s detailed size information on the 2x grid.

Tile Type 1 (2x Grid)

Tile Type 2 (2x Grid)

The following figure describes size information of the tracker tile with content value. Make your tracker to be in harmony with other Samsung Health’s tiles.

Tile Type 2 (2x Grid)

Tile Type 3 (2x Grid)

The following figure describes size information of the tracker tile with a button. Make your tracker to be in harmony with other Samsung Health’s tiles.

Tile Type 3 (2x Grid)