We are excited to introduce our new feature, "Step Events." This enhancement allows users to obtain hourly step metrics, significantly improving the experience and insights available to our customers.
Previously, the only way to access step data through ROOK was via the Physical Summary, which provides a daily summary of steps after the day ends, or through Physical Events during specific activities. However, many customers have expressed the need to obtain step information throughout the day at various times. In response, we developed "Step Events," a solution that allows frequent and manual step updates, getting as close to real-time as possible.
Features of Step Events
- Update frequency: "Step Events" extracts and updates step data within every hour in the background.
- Compatibility: Available for Apple Health, Health Connect, React Native, Flutter, and Capacitor SDKs.
- Integration with Apple Health and Health Connect: On iOS devices, data is extracted from Apple Health, while on Android devices, it is extracted through Health Connect and Android operating system data.
- Data transmission: Data is efficiently transmitted through ROOK SDKs and Data Webhook, ensuring quick and reliable delivery to our customers' backends.
How it works
Step data accumulates from 00:00 to the current time of day and is transmitted via an optimized JSON to ensure quick visualization of the metrics. Here is an example of the JSON used:
{
"client_uuid":"ClientUUID",
"user_id":"UserId",
"version":2,
"document_version":1,
"auto_detected":true,
"data_structure":"steps_event",
"physical_health":{
"events":{
"steps_event":[
{
"non_structured_data_array":[
{}
],
"metadata":{
"datetime_string":"2023-12-29T21:07:14.402999Z",
"sources_of_data_array":[
"Apple Health"
],
"user_id_string":"UserId",
"was_the_user_under_physical_activity_bool":false
},
"physical_health":{
"accumulated_steps_int":0
}
}
]
}
}
}
Frequently Asked Questions
What is "Step Events"?
“Step Events" is a new feature launched by ROOK that allows users to obtain hourly step metrics. This functionality significantly enhances the user experience and provides more detailed insights for our customers.
Is this new functionality on-demand?
No, this functionality is integrated with the ROOK SDKs.
What problems does "Step Events" solve?
"Step Events" addresses the need for more frequent step information updates, allowing manual and frequent data updates, getting as close to real-time as possible.
What is the update frequency?
The SDKs extract and update step data as frequently as possible in the background, every hour.
What technologies are compatible with this feature?
Available for iOS, Android, React Native, Flutter, and Capacitor SDKs.
From which data sources are the steps extracted?
On iOS devices, data is extracted from Apple Health; on Android devices, data is extracted from Health Connect and the Android operating system data.
How does "Step Events" work?
Step data accumulates from 00:00 to the current time of day and is transmitted via an optimized JSON to ensure quick visualization of the metrics.