Deutsch

Sauberer Export aus Pipedrive: Deals, Kontakte und Aktivitätshistorie

Ein Gründer migrierte 8.000 Deals aus Pipedrive in ein neues CRM. Der Import verlief sauber. Datensatzanzahlen stimmten überein. Sechs Monate später bat ein Board-Mitglied um einen Pipeline-Velocity-Report, der zeigt, wie lange Deals in den vergangenen zwei Jahren in jeder Phase verbracht hatten. Die Daten waren nicht vorhanden. Pipedrives Deal-Stage-Historie, das Protokoll wann jeder Deal von Phase zu Phase gewechselt hat, ist nicht im Standard-Export enthalten. Sie erfordert entweder die API oder ein Drittanbieter-Tool, und niemand hatte danach gefragt.

Die Stage-Historie war weg. Der Report konnte nicht erstellt werden. Zwei Jahre Pipeline-Musterdaten verschwanden zum Exportzeitpunkt.

Dieser Leitfaden beschreibt, was Pipedrive sauber exportiert, was es stillschweigend zurücklässt und wie Sie vor dem Wechsel einen vollständigen migrationsgerechten Datensatz erhalten.


Das Datenmodell von Pipedrive verstehen

Pipedrive ist um den Deal herum aufgebaut. Alles andere ist sekundär.

In den meisten CRMs (Salesforce, HubSpot, die meisten modernen Tools) sind Kontakte und Accounts die primären Objekte. Deals (oder Opportunities) verweisen auf sie zurück. In Pipedrive ist der Deal der primäre Datensatz. Persons (Kontakte) und Organizations (Unternehmen) existieren primär als Felder in Deals. Die Pipedrive API-Entwicklerdokumentation dokumentiert das vollständige Objektmodell und verfügbare Endpunkte für den Abruf von Deal-Flow und Stage-Historie.

Pipedrives Kernobjekte:

Pipedrive-Objekt Äquivalent in den meisten CRMs Wesentlicher Unterschied
Deal Opportunity Primäres Objekt; treibt die meisten Reports
Person Kontakt Sekundär; verknüpft mit Deals und Organizations
Organization Account Optional; viele Deals verweisen auf Persons, aber nicht auf Orgs
Activity Aufgabe/Ereignis Verknüpft mit Deals, nicht mit Persons
Note Notiz Kann an Deals, Persons oder Organizations angehängt werden
File Anhang An jedes Objekt anhängbar

Die strukturelle Konsequenz: In Pipedrive lebt die Beziehungshistorie eines Vertriebsmitarbeiters im Deal. In den meisten Zielsystemen lebt Beziehungshistorie im Kontakt. Diese Diskrepanz ist die zentrale Herausforderung jeder Pipedrive-Migration und muss vor oder während des Bereinigungsschritts gelöst werden, nicht nach dem Import. Felder zwischen Legacy-System und neuem System abbilden ist der Ort, wo Sie diese strukturelle Übersetzung vor Beginn der Bereinigung formalisieren.

Aktivitäten in Pipedrive verhalten sich ebenfalls anders. In Salesforce oder HubSpot werden Aktivitäten gegen einen Kontakt protokolliert. In Pipedrive werden Aktivitäten gegen einen Deal protokolliert. Wenn Sie zu einem kontaktzentrierten CRM wechseln, muss jede Aktivität einem Kontakt, nicht nur dem Deal, neu zugeordnet werden.


Schritt 1: Jedes Objekt separat exportieren

Pipedrives Export-Tool befindet sich unter Einstellungen, Datenexport. Sie exportieren jeweils ein Objekt.

Exportpfad: Einstellungen, Datenexport, Objekt auswählen

Was in welcher Reihenfolge exportiert werden sollte:

  1. Organizations: Zuerst exportieren (Äquivalent zu Accounts; Persons verweisen auf sie)
  2. Persons: Zweite exportieren (Kontakte; verweisen auf Organizations)
  3. Deals: Dritte exportieren (das primäre Objekt; verweist auf beide)
  4. Activities: Vierte exportieren (verweisen auf Deals, Persons und Organizations)
  5. Notes: Fünfte exportieren (können auf jedes Objekt verweisen)

Für jeden Export:

  • CSV-Format: Wählen Sie CSV gegenüber Excel. Excel erzeugt Datumsformatierungsinkonsistenzen und Kodierungsprobleme, die Bereinigungsprobleme verursachen.
  • Alle Felder einschließen: Pipedrive setzt standardmäßig eine Auswahl von Feldern. Nutzen Sie den Spalten-Selektor, um jedes gewünschte Feld einzuschließen. Verlassen Sie sich nicht auf die Standardauswahl.
  • Benutzerdefinierte Felder einschließen: Pipedrive listet Standard- und benutzerdefinierte Felder zusammen im Selektor. Stellen Sie sicher, dass benutzerdefinierte Felder ausgewählt sind.

Was jeder Export enthält:

Pipedrive-Exporte liefern Ihnen flache CSVs mit jedem ausgewählten Feld als Spalte. Deal-Exporte enthalten Person-Name und Organization-Name als Spalten (die Beziehungen sind denormalisiert). Aber sie verwenden Namen, keine IDs, für diese Referenzen, was beim Import Abgleichsprobleme erzeugt, wenn Ihre Daten doppelte Namen enthalten.


Schritt 2: Deal-Stage-Historie exportieren

Das ist, was der Standard-Export nicht liefert. Die Deal-Stage-Historie, das Protokoll wann jeder Deal von einer Pipeline-Phase zur nächsten gewechselt hat, liegt im Aktivitätsprotokoll von Pipedrive, nicht im Deal-Datensatz selbst. Der Deal-Datensatz speichert nur die aktuelle Phase.

Warum es wichtig ist:

Stage-Historie ist die Grundlage für die Pipeline-Velocity-Analyse (durchschnittliche Zeit in jeder Phase), Conversion-Rate-Reports nach Phase und jede historische Musteranalyse. Ohne sie startet Ihr neues CRM ohne Pipeline-Referenzdaten. Laut Harvard Business Review sind Unternehmen, die Pipeline-Stage-Daten systematisch analysieren, deutlich genauer bei der Umsatzprognose. Die historische Stage-Entwicklung ist oft die umsetzbarste Grundlage für die Verbesserung künftiger Win-Rates.

Optionen zur Erfassung der Stage-Historie:

Option A: Pipedrive API

Die Pipedrive API stellt einen Deal-Flow-Endpunkt bereit, der Stage-Wechsel-Events für jeden Deal zurückgibt:

GET /api/v1/deals/{id}/flow

Dieser gibt ein Protokoll aller Updates zum Deal zurück, einschließlich Stage-Wechsel mit Zeitstempeln. Für große Portale (tausende von Deals) erfordert dies geskriptete API-Aufrufe, die durch Deal-IDs schleifen. Wenn Sie eine technische Ressource haben, ist das der vollständigste Ansatz.

Option B: Drittanbieter-Export-Tools

Tools wie Coupler.io und Hevo Data haben Pipedrive-Konnektoren, die Deal-Stage-Historie als Teil ihrer Synchronisation abrufen. Das Setup dauert einige Stunden und erfordert keine API-Programmierung. Die Kosten variieren, liegen aber für eine einmalige Migration typischerweise unter 100 €/Monat.

Option C: Dokumentieren und überspringen

Wenn Stage-Historie im Zielsystem operativ nicht wichtig ist, was bei vielen kleinen Teams der Fall ist, dokumentieren Sie die Entscheidung explizit, setzen Sie das Exportdatum als historische Baseline und fahren Sie fort. Machen Sie das nicht zum Blocker, wenn der Geschäftsbedarf es nicht rechtfertigt. Datensätze, die Sie nicht migrieren möchten, gehören in ein geplantes Archiv. Langzeit-Archivierung von Legacy-CRM-Daten beschreibt die Aufbewahrungsoptionen, die keine dauerhafte Pipedrive-Lizenz erfordern.


Schritt 3: Benutzerdefinierte Felder korrekt exportieren

Pipedrives benutzerdefinierte Felder werden mit internen Feld-IDs als Spaltenüberschriften exportiert, nicht mit den Labels, die Sie in der UI sehen. Eine Exportspalte könnte als abcdef123456 statt als „Vertragswert" erscheinen. Das ist eine bekannte Eigenschaft vieler CRM-Export-Tools. Der Wikipedia-Artikel zum Data Dictionary beschreibt die Dokumentationspraxis zur Pflege von Feld-Name-zu-ID-Zuordnungen, genau das, was Sie vor dem Ausführen von Pipedrive-Exporten aufbauen müssen.

So erhalten Sie die Label-Zuordnung vor dem Export:

Einstellungen, Datenfelder, Benutzerdefinierte Felder. Für jedes Objekt (Deals, Persons, Organizations) zeigt Pipedrive den Feldnamen und seinen internen Schlüssel. Exportieren oder machen Sie einen Screenshot dieser Zuordnung, bevor Sie Ihre Exporte starten. Sie benötigen sie bei der Feldzuordnung und Bereinigung.

Alternativ, wenn Sie Data Loader oder API-Export verwenden, sind Feld-Labels abrufbar über:

GET /api/v1/dealFields: Gibt alle Deal-Felder einschließlich Namen und Schlüssel zurück GET /api/v1/personFields: Dasselbe für Person-Felder GET /api/v1/organizationFields: Dasselbe für Organization-Felder

Schreiben Sie die Label-Zuordnung in eine separate Referenz-Spreadsheet. Bewahren Sie sie neben Ihren Exportdateien auf.


Schritt 4: Die Account-Kontakt-Deal-Hierarchie rekonstruieren

Das ist der strukturelle Übersetzungsschritt. Pipedrives Person/Organization/Deal-Modell muss in das Kontakt/Account/Opportunity-Modell umgeformt werden, das die meisten Zielsysteme verwenden.

Die Zuordnung:

Pipedrive Zielsystem
Organization Account
Person Kontakt
Deal Opportunity
Activity (mit Deal verknüpft) Aufgabe/Ereignis (mit Kontakt und Opportunity verknüpft)
Deal-Eigentümer (Nutzer) Opportunity-Eigentümer
Organization-Eigentümer Account-Eigentümer

Die Grenzfälle:

Persons ohne Organization-Verknüpfung. Pipedrive erlaubt es, dass Persons ohne Organization-Link existieren. In einem Zielsystem mit obligatorischer Account-Verknüpfung bei Kontakten schlagen diese Persons beim Import fehl, es sei denn, Sie legen Platzhalter-Accounts an oder entfernen die obligatorische Verknüpfung vorübergehend während des Imports. Identifizieren Sie diese Datensätze, bevor die Bereinigung beginnt.

Deals, die mit Persons, aber nicht mit Organizations verknüpft sind. Das ist in Transaktions- oder Kleinunternehmens-Pipelines häufig. Im kontaktzentrierten Modell werden diese zu Opportunities, die mit einem Kontakt, aber keinem Account verknüpft sind. Entscheiden Sie vorab, ob Sie für jeden dieser Persons einen Account anlegen oder Kontakt-only-Opportunities akzeptieren. Das Zielsystem kann das unterschiedlich handhaben.

Mehrere Persons in einem Deal. Pipedrive unterstützt das Hinzufügen mehrerer Kontakte zu einem Deal. In den meisten Export-CSVs wird nur die primäre Person exportiert. Um alle Kontaktverknüpfungen zu erfassen, nutzen Sie die API oder prüfen Sie, ob Pipedrives Exporteinstellungen sekundäre Teilnehmer einschließen. Diese Multi-Kontakt-Deal-Datensätze sind ein spezifischer Fall, wo sich Umgang mit historischen Aktivitäten, Notizen und E-Mails mit der strukturellen Übersetzung überschneidet. Jeder Kontakt im Deal kann seinen eigenen Aktivitätskontext haben, der eine Migration wert ist.

Objektzuordnungs-Referenztabelle:

Pipedrive-Feld Zielsystem-Feld Hinweise
Deal-Titel Opportunity-Name Direkte Zuordnung
Deal-Wert Opportunity-Betrag Währungsfelder prüfen
Voraussichtliches Abschlussdatum Abschlussdatum Datumsformat prüfen
Phase Phase Erfordert Phasenname-Zuordnung
Person-Name Kontaktname (Vor-/Nachname) Bei Bedarf am Leerzeichen trennen
Organization-Name Account-Name Beim Verknüpfen auf Namen abgleichen
Activity-Typ Aufgaben-/Ereignistyp Typen passen möglicherweise nicht 1:1
Notizinhalt Notiztext Zeichenbegrenzungen prüfen

Schritt 5: Den Export validieren

Führen Sie diese Checks durch, bevor Sie zum Bereinigungsschritt übergehen.

Datensatzanzahl-Validierung:

Öffnen Sie Pipedrives Insights oder Listenansichten, um die maßgebliche Datensatzanzahl zu erhalten:

Objekt Wo in Pipedrive zählen Was zu vergleichen ist
Deals Deals, Listenansicht (alle Pipelines, alle Phasen, alle Nutzer) CSV-Zeilenanzahl minus Kopfzeile
Persons Kontakte, Personen, Listenansicht (alle Eigentümer) CSV-Zeilenanzahl
Organizations Kontakte, Organizations, Listenansicht CSV-Zeilenanzahl
Activities Aktivitäten, Listenansicht (alle Typen, alle Eigentümer) CSV-Zeilenanzahl

Große Abweichungen (mehr als 2 bis 3 %) weisen auf Filterprobleme im Export hin. Häufige Ursachen: Export verwendet standardmäßig „Meine Datensätze" statt aller Datensätze, oder aktive/inaktive Filter.

Vollständigkeit benutzerdefinierter Felder:

Nehmen Sie Ihre Label-Zuordnungsreferenz (aus Schritt 3) und prüfen Sie, ob jedes benutzerdefinierte Feld eine entsprechende Spalte in der Export-CSV hat. Fehlende Spalten bedeuten, dass diese Felder beim Export nicht ausgewählt wurden.

Aktivitäts-zu-Deal-Verknüpfung:

Wählen Sie 20 zufällige Deals. Prüfen Sie für jeden, ob Ihr Aktivitätsexport mindestens eine Zeile enthält, in der der Deal-Name (oder die Deal-ID) übereinstimmt. Wenn Deals in Pipedrives UI Aktivitäten haben, im Export aber nichts erscheint, gibt es ein Filter- oder Exportoptionsproblem bei Ihrem Aktivitätsexport.

Persons ohne Organization-Verknüpfung:

Verwenden Sie eine Spreadsheet-Formel, um Person-Zeilen zu zählen, bei denen die Organization-Spalte leer ist. Das zeigt Ihnen, wie viele Platzhalter-Accounts Sie anlegen müssen (oder welche Entscheidungen Sie treffen müssen) vor dem Import.


Pipedrive-Export-Checkliste

  • Organizations zuerst exportiert
  • Persons exportiert (enthält Organization-Name-Spalte)
  • Deals exportiert (enthält Person-Name- und Organization-Name-Spalten)
  • Activities exportiert (enthält Deal-Name-Spalte)
  • Notes für alle Objekttypen exportiert
  • Benutzerdefinierte Feld-Label-Zuordnung neben Exportdateien dokumentiert
  • Deal-Stage-Historie erfasst (über API, Drittanbieter-Tool oder als außerhalb des Umfangs dokumentiert)
  • Datensatzanzahlen gegen Pipedrive-Listenansichten für alle Objekte validiert
  • Persons ohne Organization-Verknüpfung identifiziert und gezählt
  • Aktivitäts-zu-Deal-Verknüpfung für 20 zufällige Deals stichprobenartig geprüft

Häufige Fehler

Gewonnene/verlorene Deal-Gründe verlieren. Pipedrive speichert Gewinn-/Verlustgründe als separates Feld, das nicht immer in den Standard-Exportspalten erscheint. Fügen Sie „Gewonnener/Verlorener Grund" explizit Ihrer Deal-Export-Feldauswahl hinzu. Das Feld ist vorhanden, nur standardmäßig nicht ausgewählt.

Notizen vermissen, die an Activities statt Deals hängen. Notizen in Pipedrive können unabhängig an Deals, Persons oder Activities angehängt werden. Ihr Notizen-Export sollte eine Spalte „Verknüpfter Typ" und „Verknüpfte ID" enthalten, damit Sie nach dem Import rekonstruieren können, welche Notizen wohin gehören.

E-Mail-Integrationshistorie vergessen. Wenn Ihr Team Pipedrives E-Mail-Sync-Funktion genutzt hat, befinden sich diese E-Mails in der Deal-Timeline, werden aber möglicherweise nicht über Standard-Tools exportiert. Prüfen Sie den Deal-Flow-Endpunkt der API, wenn E-Mail-Historie für die Migration wichtig ist.

Doppelte Persons für denselben Kontakt. Pipedrive erzwingt standardmäßig keine E-Mail-Eindeutigkeit bei Persons. Teams, die über Jahre hinweg manuell Persons hinzufügen, häufen Duplikate mit leicht abweichenden Namen oder derselben E-Mail an. Deloittes Forschung zum Datenqualitätsmanagement identifiziert doppelte Datensätze als das häufigste und kostspieligste Datenqualitätsproblem in CRM-Systemen, mit Behebungskosten, die sich erheblich erhöhen, je länger Duplikate unbehandelt bleiben. Führen Sie vor der Bereinigung einen Deduplizierungsdurchlauf auf Person-E-Mails durch. Der vollständige Deduplizierungsprozess wird in Datenbereinigung: Deduplizierung, Normalisierung und Anreicherung beschrieben.


Wie Sie weitermachen

Ihr Pipedrive-Export liefert Ihnen die Rohdaten. Aber das Datenmodell muss übersetzt werden, von Person/Organization zu Kontakt/Account, bevor es zur Bereinigung und zum Import bereit ist.

Der nächste Schritt ist Felder zwischen Legacy-System und neuem System abbilden. Hier formalisieren Sie das Pipedrive-zu-Zielsystem-Feldmapping und handhaben die strukturelle Übersetzung von deal-zentriert zu account-zentriert.

Bevor die Bereinigung beginnt, bereiten Sie Ihre Daten vor, bevor Sie irgendetwas migrieren, falls Sie noch nicht Umfang, Datensatztypen und Datenqualitätsstandards definiert haben.

Dann beschreibt Datenbereinigung: Deduplizierung, Normalisierung und Anreicherung die eigentliche Bereinigungsarbeit, sobald Export und Zuordnung stabil sind.


Mehr erfahren