RunKeeper Connector

Intro

RunKeeper is a GPS fitness-tracking app for iOS and Android. It allows users to track fitness activities using GPS and to see detailed statistics around their pace, distance, and time. You can use Domo's RunKeeper connector to compile reports about physical activity, health, and nutrition. To learn more about the RunKeeper API, visit their page (http://runkeeper.com/developer/healthgraph/).

The RunKeeper connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking Cloud App in the toolbar at the top of the window.

You connect to your RunKeeper account in the Data Center. This topic discusses the fields and menus that are specific to the RunKeeper connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.

Primary Use Cases	Monitoring fitness over time and exercise trends Competition between friends and coworkers about running data
Primary Metrics	Distance traveled Time of activity Average pace Location of activity Friends' activities Rankings Type of activity Sleep Nutrition data Weight data
Primary Company Roles	HR roles Anyone who wants to keep track of health and fitness data
Average Implementation Time	5 minutes
Ease of Use (on a 1-to-10 scale with 1 being easiest)	2

Best Practices

Authenticate when you create the DataSet.
Use the RunKeeper QuickStart App to quickly generate relevant cards and metrics from different connector reports.

Prerequisites

To connect to your RunKeeper account and create a DataSet, you must have the following:

The email address you use to log into RunKeeper
The password you use to log into RunKeeper

You can also connect to your RunKeeper account by signing into Facebook or Google+ and indicating that you want to create a connection to RunKeeper.

Connecting to Your RunKeeper Account

This section enumerates the options in the Credentials and Details panes in the RunKeeper Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

Credentials Pane

The Domo RunKeeper connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click Connect (or select Add Account if you have existing RunKeeper accounts in Domo) to open the RunKeeper OAuth screen where you can choose whether to connect to RunKeeper by entering your RunKeeper, Facebook, or Google+ credentials. Once you have connected to RunKeeper and authorized Domo to connect to RunKeeper, you can use the same account any time you go to create a new RunKeeper DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

Note: If you are already logged into RunKeeper when you connect in Domo, you are authenticated automatically when you click Add account. If you want to connect to an account that is different from the one you are logged into, you must first log out of RunKeeper.

Details Pane

This pane contains a primary menu, Report, along with two fields for entering timeframe data.

Menu

Description

Report

Select a RunKeeper report. The following reports are available:

Background Activities	Returns information about physical activity that occurs normally throughout the day, such as calories burned and steps taken.
Diabetes Measurements	Returns metrics about the user's blood glucose and hormone levels.
Fitness Activities	Returns activities that appear in the user's fitness feed on the RunKeeper website.
Friends	Returns the user's list of friends, with user ID, full name, profile URL, and status (pending or member).
General Body Measurements	Returns body measurements such as blood pressure, cholesterol, vitamin intake, white cell count, etc.
Nutrition	Returns statistics about the user's diet.
Personal Records	Returns a list of the user's personal best records.
Profile	Returns the user's profile information, such as identity, geographical location, and fitness goals.
Settings	Returns the user's sharing and display preferences.
Sleep	Returns sleep statistics for the user, such as the length of time spent in various sleep stages and the number of times awoken during the night.
Strength Training Activities	Returns information about the user's strength training activities.
Weight	Returns statistics about the user's weight and body mass in kilograms.

Start Days

Enter the number of the farthest day back that should be represented in the report. Combine with End Days to create a range of represented days. For example, if you entered 10 for Start Days and 5 for End Days, the report would contain data for 10 days ago up until 5 days ago. Enter 0 for today.

End Days

Enter the number of the most recent day back that should be represented in the report. Combine with Start Days to create a range of represented days. For example, if you entered 10 for Start Days and 5 for End Days, the report would contain data for 10 days ago up until 5 days ago. Enter 0 for today.

Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.

Troubleshooting

Ensure you are using the correct credentials.

Intro﻿