Usage
Default properties
See which contextual fields the engine promotes and why they matter for segmentation and analysis.
Source of truth
server/engine/cmd/sankofa/main.gosdk/sankofa_flutter/lib/sankofa_flutter.dartThe Flutter SDK gathers default properties and sends them beside each event. The engine then promotes the highest-value fields for easier querying.
Common promoted defaults
| Field | Type | Required | Description |
|---|---|---|---|
$city | string | No | City resolved from GeoIP or SDK context. |
$region | string | No | Region resolved from GeoIP or SDK context. |
$country | string | No | Country resolved from GeoIP or SDK context. |
$timezone | string | No | Timezone resolved from GeoIP or client context. |
$os | string | No | Operating system value promoted for device segmentation. |
$device_model | string | No | Device model promoted for hardware-level breakdowns. |
Why promotion matters
Promoted fields make it easier to:
- break down events by geography
- compare device families
- segment cohorts by platform
- join replay and session analysis more quickly