Tracker

The tracker and tracker tile are the basic features of Samsung Health. Your app can show the measured data on the Samsung Health's tracker or launch it through the SDK. Understanding the tracker and tracker tile's operation on Samsung Health is required first.

Tracker

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

Samsung Health has various trackers for its supported data types already as Figure 6. Check the supported trackers on the tracker tab of Samsung Health > Manage items. The user can subscribe to the tracker by switching it on the tracker tab.

Figure 6: Samsung Health's trackers Figure 6: Samsung Health's trackers

Tracker Tile

The tracker is expressed to the user as the tracker tile. It is shown on the Samsung Health's main screen and represents the latest data collected by its tracker. It acts as a gateway when the user taps it. It's jumped to:

  • The tracker's detailed page in case that the Samsung Health tracker's tile.

  • The app's specific page if it's the app tracker's tile.

The SDK enables an application to synchronize its health data with Samsung Health through the SDK's Health Data. If the application writes health data and the Samsung Health‘s related tracker exists, the tracker's tile is posted to the Samsung Health's main screen without the user's subscription.

For example, there is an application measures the blood pressure and writes the measured data to Samsung Health with the Health Data API. If it succeeds to write data to Samsung Health, Samsung Health posts its blood pressure tracker's tile with the measured value and time on Samsung Health automatically even the tracker has not been subscribed like Figure 7.

Figure 7: Operation of Samsung Health's tracker Figure 7: Operation of Samsung Health's tracker

It means that the app's doesn't need to define its tracker for the blood pressure on Samsung Health separately. Otherwise, the both tracker tiles of the app and Samsung Health will be posted at the same time with duplicated information. It would be not a good user experience definitely.

Tracker Manager

If Samsung Health has a proper tracker for your app's feature, the TrackerManager helps your app to launch the Samsung Health's available tracker.

Figure 8 shows the flow how to launch the Samsung Health's tracker.

  1. 1) The app gets the interesting tracker's info and checks its availability.
  2. 2) If it is, the app launches the tracker. The Samsung Health's tracker is foregrounded.
  3. 3) The user selects the back key and your app is foregrounded.
Figure 8: Launching the Samsung Health's tracker Figure 8: Launching the Samsung Health's tracker

See Launching Samsung Health's Tracker for an example.

Limitations

There are limitations on launching the Samsung Health's tracker.

  • It works on Samsung Health 4.8 or above.

  • Some trackers of Samsung Health may not be available by the local law or device specifications.
    Therefore, check the wanted tracker's availability before launching it.