mirror of
https://github.com/openflocon/Flocon.git
synced 2026-05-07 21:46:20 +00:00
6c39bf2611
Some checks are pending
docs / deploy (push) Waiting to run
Co-authored-by: Florent Champigny <florent@bere.al>
54 lines
No EOL
1.9 KiB
Markdown
54 lines
No EOL
1.9 KiB
Markdown
### 📊 Analytics Event Viewer
|
||
|
||
<img width="1296" height="837" alt="Screenshot 2025-09-12 at 15 41 27" src="https://github.com/user-attachments/assets/e3f2a6ab-bf25-48ac-b9fe-8ea3f81206a1" />
|
||
|
||
<img width="1294" height="838" alt="Screenshot 2025-09-12 at 15 41 32" src="https://github.com/user-attachments/assets/b7be4f8d-afcb-4bbc-8da4-c09e1cd240a6" />
|
||
|
||
Flocon shows a real-time stream of **analytics events** emitted by your application. Whether you’re using Firebase Analytics, Segment, or a custom solution, the Flocon SDK can be plugged and forward these events to the desktop UI.
|
||
|
||
Each event includes:
|
||
- The event name
|
||
- Parameters and metadata (key-value pairs)
|
||
- Timestamps
|
||
|
||
This is especially useful for QA teams and product analysts to validate that the right events are triggered at the right time with the correct payloads.
|
||
|
||
#### Usage
|
||
|
||
You can log events by identifying the source (e.g., `"firebase"`, `"segment"`, or any custom ID). Flocon Desktop will group events by these IDs.
|
||
|
||
```kotlin
|
||
floconAnalytics("firebase").logEvents(
|
||
AnalyticsEvent(
|
||
eventName = "clicked_user",
|
||
"userId" analyticsProperty "1024",
|
||
"username" analyticsProperty "florent",
|
||
"index" analyticsProperty "3",
|
||
),
|
||
AnalyticsEvent(
|
||
eventName = "opened_profile",
|
||
"userId" analyticsProperty "2048",
|
||
"username" analyticsProperty "kevin",
|
||
"age" analyticsProperty "34",
|
||
)
|
||
)
|
||
```
|
||
|
||
#### Custom Analytics Wrapper
|
||
|
||
Often, you want to forward all your app's analytics to Flocon. You can easily do this in your analytics tracking implementation:
|
||
|
||
```kotlin
|
||
fun trackEvent(name: String, params: Map<String, Any>) {
|
||
// Forward to Flocon
|
||
floconAnalytics("app_events").logEvents(
|
||
AnalyticsEvent(
|
||
eventName = name,
|
||
params.map { it.key analyticsProperty it.value.toString() }
|
||
)
|
||
)
|
||
|
||
// Original tracking (e.g., Firebase)
|
||
firebaseAnalytics.logEvent(name, bundleOf(...))
|
||
}
|
||
``` |