Tracker Design GuideSep 13, 2018

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 the user can see interesting health data through the tracker tile on the main screen by turning on each tracker’s switch for subscription on the Samsung Health > Manage items menu.

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 an intelligent health service for user.

Your tracker will be shown on the Samsung Health > Manage items page after your app installation your app on the phone.

Consider the following principles before designing your tracker and its tile.

Principle 1 - Tracker Definition

Defining an app’s tracker tile can be rejected if the tracker’s data is duplicated with Samsung Health’s trackers. As the defined tracker’s tile can be posted on Samsung Health’s main screen with other Samsung Health’s tracker.


The following figure, Samsung Health's blood pressure tracker tile shows the latest data when your application writes measured data into Samsung Health. If your application’s tracker is defined to express the user’s blood pressure also, Samsung Health’s blood pressure tracker and your app tracker will show the same data.


Check Samsung Health’s existing trackers before defining your tracker and avoid to create a new tracker for your application if Samsung Health’s trackers cover.

Samsung Health Tracker’s operation
Principle 2- How many your tracker can be defined?

Only one tracker definition is allowed for each Samsung Health’s partner application. The app can post only one tracker tile on the Samsung Health’s main screen. The posted tracker tile can be changed with a different tile template.

  • Samsung Health Tracker’s operation 1. Posting an app’s tracker tile with type 1 at first.
  • Samsung Health Tracker’s operation 2. If data exists to show, the tile is posted
    with the type 3 on the same place.

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.

Tracker Definition

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

1. Tracker

- The allowed tracker number for each service is 1.

2. Icon size

- 36 dp(H) x 36 dp(W)

3. Title text

- Max text length: 16

- Color: Assigned by Samsung Health

- Left aligned

Tracker Tile Templates

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

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 the 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 1 Tracker Tile Type 1
Tracker Tile Types 2 Tracker Tile Type 2
Tracker Tile Types 3 Tracker Tile Type 3

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

Samsung Health SDK provides the following tracker tile types and you can choose one of them for your application. Make your tracker to be in harmony with other Samsung Health’s tiles.

Tracker Tile Type 1

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

  • Icon

  • Title

  • Button

Tracker Tile without Content Value Tracker Tile without Content Value

This tile type is used to post the first tile when the user subscribes to 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.

1. Icon size

- 60 dp(H) x 60 dp(W)

2. Title text

- Max text length: 15

3. Button text

− Max text length: 14

− Center aligned

− CAPITAL letters

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

Tracker Tile with Content Value Tracker Tile with Content Value
1. Icon size

- 30 dp(H) x 30 dp(W)

2. Content value

- Max text length: 7

- Numeric value

Good example

"2500"

"2.5"

Bad example

Meaningless data like "- - - - "

"Running"

3. Content unit

- Optional

- Max text length: 5

4. Title text

- Max text length: 15

- Center aligned

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

  • Button

Tracker Tile with Content Value and Button Tracker Tile with Content Value and Button
1. Icon size

- 30 dp(H) x 30 dp(W)

2. Content value

- Max text length: 7

- Numeric value

Good example

"2500"

"2.5"

Bad example

Meaningless data like "- - - - "

"Running"

3. Content unit

- Optional

- Max text length: 5

4. Title text

- Max text length: 15

- Center aligned

5. Button text

- Max text length: 14

- Center aligned

- CAPITAL letters

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 the 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.