Personyze Wiki Personyze Wiki docs
Deutsch
Open Personyze
Docs/ CRM und Marketing/ HubSpot-Integration
CRM und Marketing

HubSpot-Integration

HubSpot per OAuth verbinden, Eigenschaften zuordnen und die CRM-Daten in Targeting, Inhalten und A/B-Tests nutzen.

9 min read Updated 23 Minuten ago


Mit der HubSpot-Verbindung liest Personyze die Kontakteigenschaften Ihres CRM und nutzt sie zur Personalisierung der Website. Berufsbezeichnung, Lifecycle-Phase, Firma, Branche, Kontostufe — alles im HubSpot-Kontaktdatensatz wird zu etwas, das Sie ansprechen, in Seitentexte schreiben und im A/B-Test prüfen können.

Im Panel: Einstellungen › Integrationen › HubSpot.

Die Seite „Integrationen“ mit verbundenen und verfügbaren Integrationen, nach Kategorie gruppiert
Einstellungen › Integrationen. HubSpot steht unter CRM & Marketing-Automation. Zum Vergrößern klicken.

Wie Sie verbinden

OAuth ist der einzige Weg, HubSpot zu verbinden. Klicken Sie auf Mit HubSpot verbinden, bestätigen Sie den Lesezugriff, und fertig — die Autorisierung erneuert sich selbst; es gibt also nichts zu pflegen und nirgendwo etwas zu übertragen. Personyze ist eine App im HubSpot Marketplace, und Marketplace-Apps authentifizieren sich per OAuth.

Die Einrichtung

Der Bereich „HubSpot konfigurieren“ mit der Eigenschaftszuordnung und einer empfohlenen Einrichtung per Klick, die Vorname, Nachname, E-Mail, Telefon, Berufsbezeichnung, Lifecycle-Phase, Firma und Branche zuordnet
Eigenschaftszuordnung im Bereich „HubSpot konfigurieren“, mit einer Empfohlenen Einrichtung per Klick, die die Felder anlegt und befüllt, die die meisten Konten ansprechen — Vor-/Nachname, E-Mail, Telefon, Berufsbezeichnung, Lifecycle-Phase, Firma und Branche. Zum Vergrößern klicken.
  1. Öffnen Sie Einstellungen › Integrationen und klicken Sie auf der HubSpot-Karte auf Konfigurieren.
  2. Klicken Sie auf Mit HubSpot verbinden. Ein HubSpot-Fenster öffnet sich.
  3. Melden Sie sich an und bestätigen Sie den Zugriff. Personyze fordert crm.objects.contacts.read an — Lesezugriff auf Kontakte.
  4. Der Bereich zeigt dann Connected — Reading contact properties with crm.objects.contacts.read.

Um später zu trennen, nutzen Sie das Löschsymbol in dieser Zeile. Personyze bittet Sie außerdem, die App unter HubSpot › Settings › Integrations › Connected Apps zu deinstallieren, damit auf der HubSpot-Seite nichts in der Luft hängt.

Die gewünschten Felder zuordnen

Die Verbindung autorisiert das Lesen; die Eigenschaftszuordnung entscheidet, welche HubSpot-Felder tatsächlich im Personyze-Besucherprofil landen, wo sie für Segmente, Personalisierung und Berichte bereitstehen.

Am schnellsten beginnen Sie mit Empfohlene Einrichtung aktivieren; das ordnet die Felder zu, die die meisten Konten ansprechen. Jedes Personyze-Profilfeld, das es noch nicht gibt, wird für Sie angelegt — diese sind mit NEW FIELD markiert:

HubSpot-Eigenschaft Personyze-Profilfeld
User: Vorname User: Vorname
User: Nachname User: Nachname
User: E-Mail User: E-Mail
User: Telefon User: Telefon
User: Berufsbezeichnung User: Berufsbezeichnung
User: Lifecycle-Phase User: Lifecycle-Phase
Company: Name User: Firma
Company: Branche User: Branche

Eigene Eigenschaften hinzufügen

Auch alles Benutzerdefinierte in HubSpot lässt sich zuordnen:

  1. Öffnen Sie in HubSpot die Eigenschaft und klicken Sie auf edit.
  2. Notieren Sie ihren Internal Name — nicht die Beschriftung. Das ist der Wert, mit dem Personyze abgleicht, und die übliche Ursache einer Zuordnung, die stillschweigend nichts liefert.
  3. Fügen Sie in Personyze eine neue Zuordnung hinzu und tragen Sie diesen Namen mit einem properties. -Präfix ein — eine
    Eigenschaft mit dem internen Namen segment wird als properties.segmenteingetragen. Personyze liest die
    Eigenschaft über ihren Pfad in der Antwort von HubSpot; segment allein passt also auf nichts und liefert nichts.
  4. Wählen Sie das Personyze-Profilfeld, das sie befüllen soll, und klicken Sie auf Speichern.

Das Eigenschaftsfeld ist keine feste Liste: Es schlägt die gängigen Eigenschaften vor und akzeptiert alles andere, was Sie eintippen —
erst dadurch wird eine benutzerdefinierte Eigenschaft überhaupt erreichbar.

Der Kopf des Bereichs zeigt eine Live-Zählung — 0 properties mapped, bis Sie etwas zuordnen. Eine Integration, die verbunden ist, aber nichts zugeordnet hat, wirkt gesund und liefert keine Daten.

Wie ein Besucher einem Kontakt zugeordnet wird

Personyze ordnet einen Besucher einem HubSpot-Kontakt über die E-Mail-Adresse zu — erfasst aus einem Login, einer Formulareinsendung, einem URL-Parameter oder der Tracking-API.

Weil der Abgleich über die E-Mail-Adresse statt über das Gerät läuft, funktioniert er geräteübergreifend: Wer aus einer HubSpot-E-Mail auf dem Handy kommt und sich später am Laptop anmeldet, landet im selben Profil.

HubSpot-Daten im Targeting nutzen

Eine HubSpot-Zielgruppe können Sie auf zwei Wegen bauen: in Alltagssprache beschreiben und den KI-Targeting-Assistenten die Regel schreiben lassen oder die Regel selbst in der Auswahl hinzufügen. Beides ergibt dasselbe — gewöhnliche Zielgruppenregeln, die Sie bearbeiten können.

Die Zielgruppe beschreiben und die KI die Regel bauen lassen

Tippen Sie im Schritt Zielgruppe einer Kampagne in den KI-Targeting-Assistenten, was Sie möchten — zum Beispiel „Besucher, deren HubSpot-Firmendatensatz zeigt, dass sie in der Softwarebranche arbeiten“ —, und klicken Sie auf Regeln generieren. Er schreibt die passende HubSpot-Regel (hier HubSpot: industry contains software), die Sie an Ihre bestehenden Regeln anfügen oder mit der Sie sie ersetzen können, um sie dann von Hand zu verfeinern. Der Bereich rechts zeigt dabei eine Live-Zielgruppenprognose.

Der KI-Targeting-Assistent im Schritt „Zielgruppe“ einer Kampagne macht aus der Anweisung zu HubSpot-Firmen der Softwarebranche die Zielgruppenregel „HubSpot industry contains software“, mit einer Live-Zielgruppenprognose
Der KI-Targeting-Assistent im Schritt „Zielgruppe“: Eine Anweisung in Alltagssprache wird zu einer HubSpot-Zielgruppenregel (industry contains software), mit der Live-Zielgruppenprognose rechts. Zum Vergrößern klicken.

Eine HubSpot-Zielgruppe mit dem KI-Targeting-Assistenten bauen, von Anfang bis Ende.

Oder die Regel von Hand bauen

Die Auswahl „Targeting-Regel hinzufügen“ mit Kategorien für Besucherkontext, Verhalten, E-Commerce, Inhalte, Integrationen und gespeicherte Vorlagen
Targeting-Regel hinzufügen. CRM-Daten liegen unter „Besucherkontext“. Zum Vergrößern klicken.

HubSpot-Daten tauchen an zwei Stellen in der Regelauswahl auf, und sie erfüllen verschiedene Aufgaben.

Die Kategorie „Integrationen“ — HubSpot als eigene Regel

Die Targeting-Regelauswahl, durchsucht nach „hubspot“, mit nur der HubSpot-Integrationsregel unter der Kategorie „Integrationen“
Tippen Sie „hubspot“ in die Regelsuche, um direkt dorthin zu springen. Unter Integrationen hat HubSpot einen eigenen Regeltyp — „Kontotyp, Funnel-Phase, Score“ — mit einer Verbindungsanzeige (hier Nicht verbunden, weil sich eine Regel schon hinzufügen lässt, bevor die Integration eingerichtet ist). Zum Vergrößern klicken.

Öffnen Sie Zielgruppenregel hinzufügen und wechseln Sie zum Tab Integrationen. HubSpot steht dort neben den anderen CRM- und Reverse-IP-Anbietern — Tealium Audiences, Leadfeeder, 6sense, LeadRebel, Clearbit, Albacross und ZoomInfo. Der HubSpot-Eintrag spricht nach Kontotyp, Funnel-Phase und Score an.

Jeder Eintrag hat eine Verbindungsanzeige. Eine Integration, die nicht verbunden ist, erscheint trotzdem in der Liste; dass HubSpot hier steht, heißt also nicht, dass Daten fließen — prüfen Sie die Markierung und die Zählung properties mapped in den Einstellungen, bevor Sie annehmen, dass eine Regel auf irgendjemanden passt.

Die Regel CRM/ABM/Profil — jedes zugeordnete Feld

Klicken Sie im Schritt Zielgruppe einer Kampagne auf Zielgruppenregel hinzufügen und wählen Sie Benutzer-CRM/ABM/Profil — „Profilfelder aus Ihrem CRM“. Jede zugeordnete HubSpot-Eigenschaft erscheint in ihrem Feld-Dropdown.

Der Editor der Targeting-Regel „Benutzer-CRM/ABM/Profil“ mit Feldauswahl und Operatorliste
Die Regel CRM/ABM/Profil. Regeln können einschließen oder ausschließen und auf eine oder alle Bedingungen passen. Zum Vergrößern klicken.

Verfügbare Operatoren: enthält, enthält nicht, ist gleich, ist ungleich, ist eines von (Liste, Datei), ist keines von (Liste, Datei), passt auf Regex, beginnt mit, endet mit, ist leer, ist nicht leer.

Eine Falle, die Sie kennen sollten. Negative Operatoren — ist ungleich, ist keines von — passen nur auf Besucher, die einen Wert in diesem Feld haben. Jemand ganz ohne Lifecycle-Phase passt nicht auf „Lifecycle-Phase ist ungleich Kunde“. Um diese Menschen zu erfassen, nutzen Sie ist leer, meist mit einem ODER kombiniert.

Einige ausgearbeitete Beispiele:

  • ABM-LandingpageCompany: Branche ist eines von (Finanzen, Versicherung) UND Berufsbezeichnung enthält VP, mit einem branchenspezifischen Hero.
  • Upgrade-HinweisLifecycle-Phase ist gleich Kunde UND Kontostufe ist gleich Free.
  • Das falsche Angebot unterdrücken — fügen Sie eine Ausschluss-Gruppe für Lifecycle-Phase ist gleich Kunde hinzu, damit bestehende Kunden das Akquise-Banner nie sehen.
  • Unbekannte BesucherFirma ist leer, mit Rückfall auf allgemeine Texte.

Weil Regeln mit UND / ODER / XOR kombiniert werden, mischen sich CRM-Attribute frei mit Verhalten: „VP im Finanzbereich, auf der Preisseite, zweiter Besuch diese Woche“ ist eine Zielgruppe.

HubSpot-Daten in den Inhalten nutzen

Dieselben Felder lassen sich in die Inhalte selbst schreiben, nicht nur zur Entscheidung, wer sie sieht. Klicken Sie im WYSIWYG-Editor auf den Text und fügen Sie eine dynamische Variable ein; zugeordnete HubSpot-Eigenschaften erscheinen in der Liste neben den eigenen Profil- und Sitzungsfeldern von Personyze.

Die Auswahl „Variable einfügen“ im Personyze Popup Builder mit den HubSpot-CRM-Feldern Lifecycle-Phase, Branche, Lead-Status, Berufsbezeichnung und Firma unter „User Variables“, neben einer Überschrift mit der Vornamen-Variable
Die Auswahl Variable einfügen im Popup Builder. Ihre zugeordneten HubSpot-Eigenschaften — Lifecycle-Phase, Branche, Lead-Status, Berufsbezeichnung, Firma — stehen unter User variables, bereit für eine Überschrift, einen Button oder den Fließtext. Die Überschrift rechts begrüßt den Besucher bereits mit ${first_name} und dem Fallback „friend“. Zum Vergrößern klicken.
Der Personyze-Live-Editor (WYSIWYG) auf der Website, mit einem zugeordneten Feld, das als dynamische Variable paid_account in Dollar-Klammer-Schreibweise in den Seitentext eingefügt ist, dem Button „Variable einfügen“ und dem Änderungsbereich des Live-Editors
Der Live-Editor auf der Website (der visuelle WYSIWYG-Editor): Laden Sie Ihre echte Seite, klicken Sie ein beliebiges Element an und setzen Sie mit dem Button { } Variable einfügen ein zugeordnetes Feld direkt in den Text — hier ${paid_account} in der Dachzeile. HubSpot-Felder wie Branche und Kontotyp werden genauso eingefügt, und der Bereich rechts protokolliert jede Änderung zur Prüfung vor dem Veröffentlichen. Zum Vergrößern klicken.
Das Feld „Edit text with AI“ im Live-Editor mit einem Vorschlag zur Neufassung des gewählten Textes
Derselbe Editor mit KI-Unterstützung: Wählen Sie ein beliebiges Element und lassen Sie Edit text with AI es umschreiben — prägnanter, kürzer, nutzenorientiert oder in Ihrer Markenstimme —, dann „Apply“. Zum Vergrößern klicken.

Typische Anwendungen:

  • „Willkommen zurück, [Vorname]
  • „Vertraut von Teams aus [Branche]
  • „Ihr Tarif [Kontostufe] umfasst …“

Legen Sie immer einen Fallback-Wert fest. Nicht jeder Besucher hat jedes Feld befüllt, und eine Variable ohne Standardwert wird leer gerendert — „Willkommen zurück, “ ist schlimmer als gar keine Personalisierung. Legen Sie beim Einfügen einen Standard wie „zusammen“ fest. Siehe Dynamische Variablen einfügen.

A/B-Tests mit HubSpot-Daten

Es gibt zwei unterschiedliche Dinge, die Sie testen möchten, und sie werden unterschiedlich eingerichtet.

Die Inhalte für eine CRM-Zielgruppe testen

Bauen Sie die Zielgruppe wie oben mit einer CRM-Regel und schalten Sie dann im Schritt Inhalte A/B-Tests aktivieren ein. Personyze teilt diese Zielgruppe auf Ihre Varianten auf und hält jeden Besucher in dem Zweig, dem er zugewiesen wurde.

Im Aktionseditor hat jedes Look-and-Feel-Preset ein Steuerelement ⚡ Variations — der schnellste Weg zu einem zweiten Zweig, der sich nur in Text oder Akzentfarbe unterscheidet.

Testen, ob Personalisierung mit CRM-Daten überhaupt hilft

Machen Sie einen Zweig zur personalisierten Version (dynamische Variablen, branchenspezifische Texte) und den anderen zur allgemeinen Version, mit derselben Zielgruppe. Das beantwortet, ob sich die Personalisierung lohnt, statt welcher Blauton gewinnt.

Wählen Sie das Gewinnerkriterium bewusst — es entscheidet, was Sie berichten müssen. Siehe A/B-Tests, und beachten Sie, dass ein Test nach Klicks ein anderes Signal misst als einer nach gekauften Produkten.

Weil die Zuweisung pro Besucher gilt und bestehen bleibt, sieht ein HubSpot-Kontakt, der morgen wiederkommt, denselben Zweig — der Test misst also das Erlebnis, nicht den Besuch.

Wenn es verbunden aussieht, aber nichts passiert

  • 0 properties mapped. Die Verbindung autorisiert nur das Lesen. Bis Sie Felder zuordnen, erreichen keine CRM-Daten das Profil. Das ist die häufigste Ursache.
  • Eine zugeordnete Eigenschaft liefert nichts. Zwei Wege zur selben Stille: Statt des Internal Name wurde die Beschriftung eingetragen, oder der interne Name wurde ohne das properties. -Präfix eingetragen. Richtig ist properties.segment, nicht segment.
  • Anonyme Besucher werden nicht erkannt. Erwartet — der Abgleich läuft über die E-Mail-Adresse; ein Besucher wird also erkannt, sobald er sich zu erkennen gibt (ein Login, ein Formular oder ein E-Mail-Link), nicht vorher.
  • Eine negative Regel passt auf niemanden. Denken Sie daran, dass negative Operatoren Besucher ohne Wert überspringen; ergänzen Sie ist leer.
  • Bei bekannten Kontakten wird nichts gerendert. Prüfen Sie, ob die Kampagne live ist und die Aktion eine Platzierung hat, bevor Sie die Integration verdächtigen.

Verwandte Themen

Auf der Personyze-Website

Did this page answer your question?
Thank you — that goes to whoever maintains this page.