Sabaki Guide
PostHog Traction KPI Setup In Sabaki
How to connect PostHog to Sabaki, map Product KPIs, run the first sync, and check source-backed KPI values.
PostHog traction KPI setup is the Sabaki workflow for turning a saved PostHog app connection into source-backed Product KPI snapshots. It connects PostHog, maps Product KPIs to the app source, and syncs current activity values into the KPI workspace.
Key Takeaways
- Use a PostHog personal API key with private query access, not the event ingestion project token.
- Product KPI visibility depends on the KPI vertical and Source Map configuration.
- Manual KPI entries are preserved; a connector sync should not silently replace a manual value for the same metric and period.
How To Sync PostHog KPIs
- Connect PostHogOpen Apps, add PostHog, and save the private API host, project ID, and personal API key.
- Confirm product analytics identityMake sure the connected PostHog project receives production events and identifies signed-in users with stable IDs.
- Enable Product KPI visibilityOpen KPIs, review setup or preferences, and choose the KPI vertical that includes DAU, WAU, MAU, Activation, and Day-30 Retention.
- Map PostHog as the sourceOpen the KPI Source Map and assign PostHog to each Product KPI that should update from the connection.
- Run Sync NowUse the Source Map or Apps connection panel to sync PostHog, then check that current KPI rows show app-backed provenance.
Quick Comparison
| Setup Area | What To Check | Common Fix |
|---|---|---|
| Connection | Private API host, project ID, and personal API key are saved | Reconnect PostHog with the correct app host and key |
| PostHog data | Production events and identified users are present | Verify identify calls and avoid mixing test projects with production |
| KPI visibility | Product KPIs appear in the KPI workspace and Source Map | Update KPI preferences so Product metrics are active |
| Source Map | PostHog is assigned to the intended Product KPIs | Assign the app source before relying on automated updates |
| Sync result | Rows show app-backed provenance for the current period | Use Sync Now and review any connection error message |
Frequently Asked Questions
Which PostHog metrics can Sabaki sync?
Sabaki syncs Daily Active Users, Weekly Active Users, Monthly Active Users, Activation Rate, and Day-30 Retention as monthly KPI snapshots for the current Sabaki KPI period.
Does Sabaki need a PostHog dashboard or insight?
No. Sabaki reads the connected PostHog project directly and calculates the supported KPI snapshots from event data.
Why are PostHog KPIs missing from the Source Map?
Product KPI visibility depends on the workspace KPI configuration. Review KPI setup and choose a vertical that includes Product usage metrics.
Can PostHog overwrite a manual KPI value?
Manual KPI values are protected for the same metric and period. Clear or replace the manual value if you want connector updates to resume for that row.