The SignMetrix API provides direct access to our Audience Engagement and Measurement engine, allowing you to programmatically integrate foot traffic, dwell time, and customer journey analytics into your own systems.
Core Data Structure
The SignMetrix API is structured around three primary data sets. All reporting and analytics capabilities are derived from these sources, with Track serving as the foundational layer.
1. Track (Raw Event Data)
Track is the most detailed and fundamental data set.
-
A track refers to the monitoring of a Bluetooth-enabled device (MAC ID) as it enters and exits defined Smart Circles within a Zone.
-
Each Smart Circle generates its own track. A single visitor may create multiple track records depending on movement and proximity.
-
Example: Walkby (Circle 3) → OTS (Circle 2) → Impression (Circle 1)
-
-
Each record includes:
-
Entry and exit timestamps per circle
-
Dwell time per circle
-
Bluetooth MAC ID (anonymized)
-
-
This raw data provides granular insights into visitor movement, dwell behavior, and engagement level.
2. Summary (Aggregated Data)
Summary is a Zone-based aggregation derived from Track data, intended for dashboard visualization and high-level analysis.
-
Includes:
-
Hourly, daily, and monthly aggregates
-
Total foot traffic per time period
-
Total and average dwell times
-
MAC ID-level dwell time breakdowns
-
Duration-based visit counts (e.g., 0–5 minutes, 5–15 minutes)
-
This dataset enables trend analysis, performance monitoring, and reporting across time windows.
3. Customer Journey (Session-Based Data)
Customer Journey data represents the full session path of an individual visitor across zones during a single visit.
-
Captures the movement and behavior of each MAC ID during a visit session
-
Includes:
-
Entry and exit timestamps
-
Zones visited in sequence
-
Dwell time per zone
-
Total session duration
-
This data set is essential for understanding how visitors navigate and interact with the environment from entry to exit.
HOW TO USE THE PUBLIC API