Coming from Amplitude
Import
Amplitude charts become metric nodes: quantitative evidence connected to the outcomes they measure.
The structural finding
Amplitude stores measurements, not product decisions. The adapter maps named charts and funnels to UPG `metric` nodes with current_value and target_value, making Amplitude the quantitative evidence layer for UPG outcomes and key results.
What UPG adds
Typed metric nodes: Amplitude charts become named metrics with values, connected to the outcomes they track.
OKR evidence: link your Amplitude metrics to Quantive or Shortcut key results for automatic progress tracking.
Experiment traceability: Amplitude A/B tests become experiment nodes connected to the hypotheses they tested.
Schema mapping
The key edge
The single most important semantic relationship this integration enables.
Defined in the UPG specification
Sample import
Amplitude metric sync: charts become metric nodes connected to outcomes
Roundtrip
Import experiments and metrics → connect to UPG hypotheses and outcomes → push outcome context and experiment rationale back to Amplitude via API.
- ·Experiment hypothesis context written back to Amplitude experiment descriptions
- ·Outcome and key result links surfaced in Amplitude dashboard annotations
- ·UPG feature nodes linked back to Amplitude feature flag metadata
How to import your Amplitude data
The Amplitude adapter is built and tested. A one-command import via the UPG CLI is in development:
This will fetch your Amplitude data, map entity types automatically, and write everything to your graph. Today you can use the Markdown import or the adapter directly in code.
▸ For developers: use the adapter directly
Get started
The Amplitude adapter ships in @unified-product-graph/adapters. Install it, then run the import command.
$ npm install -g unified-product-graph
# then import
$ upg import --from notion