HubSpot → Mart: Deal-Zählebene zum Pilotprojekt-Mart
Aus dem freigegebenen HubSpot Quellumfang einen ersten Deal-Mart mit klarem Zählebene, Fakten- und Dimensionskandidaten und versionierten KPI-Karten für einen Pilotprozess ableiten.
Ein freigegebener HubSpot-Quellumfang legt fest, welche Objekte, Eigenschaften und Beziehungen geladen werden dürfen. Damit ist aber noch kein Mart entstanden. Dieses Kapitel zeigt den nächsten Schritt: einen kleinen Deal-Mart mit einer Zeile pro Verkaufschance, klar benannten Fakten und Dimensionen sowie einer ersten Version der wichtigsten Pipeline-Kennzahlen.
Der Fokus liegt bewusst auf einem kleinen, vollständigen Pilot-Mart statt auf einer Kopie des gesamten HubSpot-Portals. Eine Auswertung, die die Steuerung der Vertriebsphasen zuverlässig unterstützt, schafft mehr Vertrauen als ein breiter, aber unfertiger Export aller Objekte.
Herausforderung
HubSpot-Portale sind konfigurierbar: Pipelines, Stages, Custom Properties und Association Labels unterscheiden sich zwischen Portalen und sogar zwischen Business Units desselben Unternehmens. Ein Mart, der Deal-Objekte ungeprüft übernimmt, erbt typische Probleme.
- Ein Deal kann mit mehreren Companies oder Contacts assoziiert sein; ohne eine explizite Primary-Company-Regel entstehen doppelte oder willkürlich reduzierte Zeilen.
- Property History und der aktuelle Deal-Zustand werden vermischt, sodass eine Analyse des Verlaufs durch die Vertriebsphasen denselben Datensatz mehrfach oder falsch datiert zählt.
- Deal Amount wird ohne Line-Item-Kontext summiert, obwohl Revenue nach Produkt eigentlich Positions-Körnung benötigt.
- Pipeline- und Stage-Bezeichnungen werden als stabile Business-Begriffe behandelt, obwohl sie im Portal jederzeit umbenannt oder neu sortiert werden können.
Der freigegebene Quellumfang aus Welche HubSpot-Tabellen laden — und welche skippen entscheidet, welche Objekte und Properties überhaupt verfügbar sind. Die Entscheidung über Zählebene und Fakten für den Mart bleibt trotzdem ein eigener Schritt.
Ansatz
Freigegebener Quellumfang
→ Geschäftsereignis und gewünschte Zählebene
→ Fakten- und Dimensionskandidaten
→ KPI-Karten auf derselben Zählebene
→ Mart-Steckbrief
Für einen ersten Pilotprojekt-Mart ist Deal-Zählebene der pragmatischste Startpunkt: eine Zeile pro Deal, angereichert um governte Company-, Contact- und Angaben zu verantwortlichen Personen. Diese Zählebene beantwortet die häufigste Einstiegsfrage — wo in der Pipeline muss eingegriffen werden — ohne Produktkomplexität vorwegzunehmen.
Sobald Revenue nach Produkt eine Rolle spielt, wird eine zweite Faktentabelle auf Line-Item-Zählebene ergänzt, statt den Deal-Mart nachträglich zu verbiegen. Für Company-Assoziationen gilt eine feste Regel: Wenn ein Deal mit mehreren Companies verknüpft ist, wird eine Primary-Company-Zuordnung dokumentiert und angewendet — nicht implizit die erste oder zufällig zurückgegebene Assoziation verwendet.
Zählebene und Fakten- und Dimensionskandidaten
Primäre Zählebene: eine Zeile pro Deal.
Alternative Zählebene (Produkt-Mart): eine Zeile pro Deal-Line-Item.
| Rolle | HubSpot-Objekt | Verwendung |
|---|---|---|
| Fact-Quelle (Deal-Zählebene) | Deal |
Amount, Close Date, Pipeline, Stage je Deal |
| Fact-Quelle (Positions-Zählebene) | Line Item |
Quantity, Price je Position, nur bei Produkt-Mart |
| Dimension: Unternehmen | Company |
über die dokumentierte Primary-Company-Association |
| Dimension: Kontakt | Contact |
nur mit freigegebener Property-Allowlist |
| Dimension: Owner | HubSpot Owner / Team | verantwortliche Vertriebsperson |
| Dimension: Pipeline und Stage | governte Pipeline-/Stage-Referenz | Mapping auf eine stabile Stage-Reihenfolge je Pipeline |
| Dimension: Produkt | Product |
nur bei Positions-Zählebene erforderlich |
| Dimension: Datum | Kalender-Dimension | Close Date, Create Date, Last Stage Change getrennt gehalten |
Amount und Quantity nur im vereinbarten Grain und über kompatible Dimensionen summieren. Währungen und Mengeneinheiten vereinheitlichen; viele-zu-viele-Joins dürfen Beträge nicht vervielfachen. Deal-Snapshots sind über Snapshot-Daten nicht einfach additiv. Der Dealbetrag ist zudem nicht automatisch gebuchter Finance-Umsatz. Stage und Deal Status sind Statusattribute. Eine Analyse des Verlaufs durch die Vertriebsphasen benötigt einen eigenen Snapshot- oder Event-Fact (eine Zeile pro Deal und Stage-Wechsel oder Berichtsdatum) statt einer Ableitung aus dem aktuellen Deal-Zustand.
Personenbezogene und ausgeschlossene Daten
Contact- und Company-Felder werden nur mit freigegebener Property-Allowlist übernommen. Notes, Messages, Calls und Meetings bleiben außerhalb des Pilotprojekt-Marts, solange kein benannter Aktivitäts-Use-Case existiert. Property History wird nur für die tatsächlich benötigten Felder geladen, nicht pauschal für das gesamte Deal-Objekt.
Die vollständige Entscheidung über Objekte, Felder, Associations und Löschverhalten steht in Welche HubSpot-Tabellen laden — und welche skippen. Für die Feldklassifikation eignet sich der PII Recommend Generator.
Standard-KPIs
Teilabgleich 23.10.2026: HubSpot Deals API dokumentiert propertiesWithHistory für ausgewählte Eigenschaften. Benötigten Zeitraum, tatsächliche Connector-Lieferung und Stage-Mapping getrennt prüfen; ein aktueller Stage-Name rekonstruiert keine vollständige Historie. Der Status aus dem Portal ist kein Additionswert.
Auf Deal-Zählebene lassen sich für den Piloten definieren:
- Pipeline Coverage — Verhältnis von offenem Pipeline-Wert zu Zielumsatz je Periode.
- Win Rate — Anteil gewonnener Deals an allen abgeschlossenen Deals im Zeitraum.
- Average Deal Size — Durchschnittlicher Amount gewonnener Deals.
- Sales Cycle Length — Tage zwischen Create Date und Close Date bei gewonnenen Deals.
- Deal Velocity — durchschnittliche Verweildauer je Stage.
Jede Kennzahl benötigt eine eigene KPI-Karte statt nur einer Formel. Nutze KPI definieren für die Methodik und den KPI Definition-Generator zur strukturierten Erfassung.
Artefakt
source-scope.csv/source-scope.md— freigegebene HubSpot-Objekte, Properties und Associations.kpi-cards.csv— die Standard-KPIs mit Formel, Angabe der Zählebene, Filtern und verantwortliche Person.mart-design-brief.md— Geschäftsereignis, Zählebene, Fact-/Dimension-Kandidaten, Primary-Company-Regel und bewusst ausgeschlossene Inhalte für den Deal-Mart.
Dieselben Dateinamen werden über alle Guides dieser Serie hinweg verwendet, damit Exporte, Tools und Dokumentation konsistent bleiben.
Tools und nächste Schritte
- Quellumfang Builder — HubSpot-Objekte, Properties und Associations als
source-scope.csvdokumentieren. - personenbezogene Daten Recommend Generator — Feldrisiko für Contact- und Company-Properties klassifizieren.
- Mart-Steckbrief-Generator — Zählebene, Fakten, Dimensionen und bewusst ausgeschlossene Inhalte als
mart-design-brief.mdfreigeben. - KPI Definition — Standard-KPIs als
kpi-cards.csvversionieren.
Für die grundsätzliche Priorisierungsfrage — ob HubSpot überhaupt die richtige erste oder nächste Quelle ist — bleibt der Governance Advisor der Einstiegspunkt. Dieser Guide vertieft die Entscheidung, ersetzt sie aber nicht.
Verwandte Playbooks
- Welche HubSpot-Tabellen laden — und welche skippen — die vorgelagerte Load/Skip-Entscheidung für Objekte, Properties und Associations.
- Vom Stakeholder-Interview zum Tabellenmodell — die allgemeine Methodik für Zählebene, Fakten, Dimensionen und den Mart-Steckbrief.
- Welche Quelle zuerst laden? — die Portfolio-Entscheidung, falls HubSpot noch gegen andere Kandidaten priorisiert werden muss.
Das vollständige Supplier-Profil mit Produktkontext, Compliance-Hinweisen und weiteren Ressourcen steht in der Supplier Library: HubSpot.
Supplier to Mart
Part 2 of 5
View series