Zum Hauptinhalt
Hinweis: Dieser Artikel wird aus Kulanz zur Verfügung gestellt. Er wurde automatisch mit einer Software übersetzt und unter Umständen nicht korrekturgelesen. Die englischsprachige Fassung gilt als offizielle Version und Sie können dort die aktuellsten Informationen finden. Hier können Sie darauf zugreifen.

Benutzerdefinierte Events erstellen

Zuletzt aktualisiert am: Februar 1, 2024

Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):

Marketing Hub Enterprise
Sales Hub Enterprise
Service Hub Enterprise
Operations Hub Enterprise
CMS Hub Enterprise

Mit benutzerdefinierten Ereignissen können Sie Ereignisse definieren und verfolgen, die für Ihr Unternehmen einzigartig sind. Benutzerdefinierte Ereignisse können mit Ereigniseigenschaften verknüpft werden, die Sie dann in allen HubSpot-Tools verwenden können. 

Es gibt drei verschiedene Möglichkeiten, benutzerdefinierte Ereignisse zu erstellen: 

  • Senden über API: Verwenden Sie den Endpunkt Benutzerdefinierte Ereignisdefinition, um Ihr Ereignis zu erstellen. Verwenden Sie von dort aus Ihre Ereignis-ID mit dem send Custom event endpoint, um Ereignisabschlüsse an HubSpot zu senden.
  • Erfassen Sie Daten von Ihrer Website ohne API:
  • Kalkulationstabelle importieren: laden Sie eine Kalkulationstabelle mit Ereignisdaten hoch, um Offline-Aktivitäten zu erfassen, Daten zu ergänzen oder ein beliebiges Tool manuell in HubSpot zu integrieren.

 

Bitte beachten Sie: das Tool für benutzerdefinierte Ereignisse ersetzt das bisherige Tool für Ereignisse. Alle Events, die im vorherigen Tool erstellt wurden, funktionieren weiter und Sie können nach wie vor diese Events im alten Tool verwalten und analysieren

Das Event-Erstellungsprozess besteht aus zwei Teilen:

  • Definieren des Events in HubSpot, einschließlich aller benutzerdefinierten Event-Eigenschaften.
  • Erstellen eines JavaScript Code Snippets oder Definieren des API-Aufrufs , der das Ereignis auslöst. 

Ereignis über API erstellen

Wenn Sie Daten über die API an HubSpot senden, müssen Sie den Endpunkt Benutzerdefinierte Ereignisdefinition verwenden, um Ihr Ereignis zu erstellen. Dann müssen Sie den API-Aufruf zum Auslösen des Ereignisses definieren. Erfahren Sie in der HubSpot-Entwicklerdokumentation, wie Sie Ihren API-Aufruf definieren.

Sie benötigen einige Informationen für Ihren API-Aufruf, die Sie in HubSpot finden:

  • Event-Name: Der interne Name für das Event. 
  • Eigenschaftsnamen: Die internen Namen für die Eigenschaften, an die Sie Daten senden.

So erstellen Sie Ihr Ereignis, um Daten über die API zu senden:

  • Wählen Sie Daten an HubSpot sendenund kopieren Sie die Tracking-ID.
  • Klicken Sie auf Erstellen.

So finden Sie den internen Ereignisnamen für ein vorhandenes Ereignis und die Eigenschaftsnamen:

  • Navigieren Sie in Ihrem HubSpot Account zu Reporting > Data Management > Custom events.
  • Klicken Sie auf Benutzerdefinierte Ereignisse.
  • Klicken Sie auf den Namen des Ereignisses. Sie werden dann zur Seite mit den Event-Details weitergeleitet.
  • Suchen Sie oben den Namen des Ereignisses unter Interner Name.

    interner-name-benutzerdefiniertes-ereignis
  • Um die internen Namen der zu aktualisierenden Eigenschaften zu finden, klicken Sie auf den Namen einer Eigenschaft.
  • Klicken Sie im rechten Bereich auf das Codesymbol und sehen Sie sich dann den Namen unter Interner Namean.
Bitte beachten Sie:
Für die Übermittlung von Daten an Ihre Veranstaltung gelten die unten aufgeführten Beschränkungen:
  • Die Eigenschaftsnamen sind auf 50 Zeichen begrenzt. 
  • URL- und Referrer-Eigenschaften können bis zu 1024 Zeichen enthalten, alle anderen Eigenschaften dagegen bis zu 256 Zeichen.
  • Jeder Event-Abschluss kann Daten für bis zu 50 Eigenschaften enthalten.
  • Interne Eigenschaftsnamen müssen mit einem Buchstaben beginnen und dürfen nur Kleinbuchstaben von a-z, die Zahlen 0-9 und Unterstriche enthalten. Eigenschaften mit dem gleichen internen Namen nach der Kleinschreibung werden als Duplikate betrachtet, und nur eine der Eigenschaften wird beim Abschluss verwendet.
Wenn diese Obergrenzen bei einer HTTP-API-Anforderung überschritten werden, schlägt die Anfrage fehl. Wenn diese Beschränkungen bei einer JS-API-Anfrage überschritten werden, schneidet HubSpot alle Eigenschaftsnamenwerte auf die zulässige Länge ab und/oder aktualisiert nur 50 Eigenschaften pro Ereignisabschluss.

Ereignisse mit einem JavaScript-Codefragment erstellen

  • Navigieren Sie in Ihrem HubSpot Account zu Reporting > Data Management > Custom events.
  • Klicken Sie oben rechts auf . Erstellen Sie ein Ereignis.
  • Wählen Sie Code JavaScript.
code-Javascript
  • Klicken Sie auf Weiter.
  • Geben Sie einen Veranstaltungsnamen und optional eine Beschreibung Ihrer Veranstaltung ein.
  • Wählen Sie ein Zugehöriges Objekt. So können Sie Ihre Veranstaltungsabschlüsse mit verschiedenen Objekten in HubSpot verknüpfen, darunter Kontakte, Unternehmen, Deals und Tickets
custom-event-details

  • Klicken Sie auf Weiter.

Eigenschaften hinzufügen

Wenn ein Ereignis erstellt wird, sind standardmäßige Ereigniseigenschaften verfügbar. Sie können auch Ihre eigenen benutzerdefinierten Eigenschaften erstellen. Event-Eigenschaften werden getrennt von anderen CRM-Eigenschaften gespeichert und sind für das Event eindeutig (d. h., Sie können diese Eigenschaften nicht in Ihren Account-Einstellungen bearbeiten). 

So erstellen Sie Eigenschaften für ein Ereignis:

  • Wählen Sie den Eigenschaftstyp aus, indem Sie auf Feldtyp für Ihre Eigenschaft klicken. Die Optionen umfassen: 
    • Benutzerdefinierte Stringeigenschaft: Erstellen Sie eine Eigenschaft, die eine einfache Textzeichenfolge ist. 
    • Benutzerdefinierte Zahleneigenschaft: Erstellen Sie eine Eigenschaft, die ein Zahlenwert ist.
    • Benutzerdefinierte Zeitstempel-Eigenschaft: Erstellen Sie eine Eigenschaft, die ein Datumswert ist. Sie müssen Ihre Daten in der Form von Epochen-Millisekunden oder ISO8601 senden. 
    • Benutzerdefinierte Aufzählungseigenschaft: erstellt eine Eigenschaft mit einer Reihe von vordefinierten Werten.

      create-property-custom-behavioral-event
    • Wenn Sie Ihre Eigenschaft ausgewählt haben, konfigurieren Sie die Eigenschaft im rechten Bereich:

    • Geben Sie einen Namen für die Eigenschaft ein und geben Sie eine Beschreibung für die Eigenschaft ein.
    • Klicken Sie bei Aufzählungseigenschaften auf Weiter und geben Sie Ihre Eigenschaftsbezeichnungen und Werteein. Sie müssen Ihre Werte und Bezeichnungen festlegen, bevor Sie Daten an sie senden. Wenn dieser Schritt vor dem Senden von Daten, die nicht in der Liste enthalten sind, nicht abgeschlossen wird, können die Daten nicht verwendet werden. Um mehrere Werte zu senden, trennen Sie sie durch ein Semikolon.
    • Klicken Sie auf Fertig.
    • Sobald Ihre Eigenschaft erstellt ist, wird sie in der Tabelle unter den standardmäßigen Ereigniseigenschaften vonHubSpot angezeigt. Sie können Ihre Eigenschaft bearbeiten oder löschen, indem Sie das Dropdown-Menü Aktionen auswählen und dann Bearbeiten oder Löschenwählen. 
  • Klicken Sie auf Weiter.
  • Nach dem Einrichten des Ereignisses und seiner Eigenschaften können Sie dieses Ereignis in den Tracking-Code Ihrer Website einfügen, indem Sie das JavaScript-Code-Snippet auswählen.

Das Erstellen von Ereignissen mit einem Javascript-Code-Snippet ermöglicht es Ihnen, Ihrem HubSpot-Tracking-Code automatisch Javascript hinzuzufügen. Dies kann für die Erfassung komplexerer Ereignisdaten verwendet werden, die der Tracking-Code standardmäßig nicht erfasst. 

  • Wählen Sie ein Javascript-Codefragmentaus. Verwenden Sie das Snippet im rechten Bereich, um das Ereignis in HubSpot zu verfolgen. Alle benutzerdefinierten Eigenschaften, die erstellt werden, sind im Code-Snippet vordefiniert. 
  • Ändern Sie das Snippet nach Bedarf, indem Sie im rechten Feld Text eingeben. Jeder von Ihnen hinzugefügte Code wird automatisch in Ihren HubSpot-Tracking-Code aufgenommen.
  • Wenn Sie fertig sind, klicken Sie auf Erstellen , um Ihr Ereignis abzuschließen und automatisch mit der Verfolgung zu beginnen. 
    beispiel-code-snippet-custom-event

Ereignisdaten importieren

Laden Sie Ihre Anwesenheitsdaten von persönlichen Veranstaltungen, zeitgestempelte Daten aus Anwendungen, die Sie nicht in HubSpot integrieren, einmalige Lead- oder Kampagnendaten von einem Anbieter oder andere Veranstaltungsdaten in Tabellenform hoch. Mit Ereignissen können Sie Verhalten erfassen und dann in ganz HubSpot verwenden. 

  • Navigieren Sie in Ihrem HubSpot Account zu Reporting > Data Management > Custom events.
  • Klicken Sie oben rechts auf . Erstellen Sie ein Ereignis.
  • Wählen Sie Tabellenkalkulation importieren.
import-Spreadsheet
  • Klicken Sie auf Weiter.
  • Geben Sie einen Veranstaltungsnamen und optional eine Beschreibung Ihrer Veranstaltung ein.
  • Wählen Sie ein Zugehöriges Objekt. So können Sie Ihre Veranstaltungsabschlüsse mit verschiedenen Objekten in HubSpot verknüpfen, darunter Kontakte, Unternehmen, Deals und Tickets

custom-event-details

  • Ziehen Sie eine Datei in den Bereich Wählen Sie eine Datei oder klicken Sie auf Wählen Sie eine Datei, um eine Datei von Ihrem Computer hochzuladen.
Bitte beachten Sie: beim Import von Ereignisdaten gelten die unten aufgeführten Beschränkungen:
  • Ihre Datei muss ein csv-, .xlsx- oder .xls-Dateityp sein 
  • Beschränkung auf 1 Million Zeilen.
  • Momentan können Ereignisse, die über den Import erstellt wurden, nur mit Kontakten verknüpft werden. 
  • Ereignisse cerstellen und aktualisieren Datensätze. Terstellt der Import neue Datensätze und Aktivitäten, identifiziert und aktualisiert aber auch bestehende Datensätze. Um neue Datensätze oder Aktivitäten zu erstellen, muss Ihre Datei die erforderlichen Eigenschaften für diesen Kontaktenthalten. Um bestehende Datensätze zu aktualisieren, muss Ihre Datei einen eindeutigen Bezeichnerenthalten.
  • Der Ereignisimport sollte für Ereignisse verwendet werden, die bereits stattgefunden haben, Ereignisse mit zukünftigen Daten werden nicht unterstützt.

 

  • Klicken Sie auf das Dropdown-Menü, um die Sprache für die Kopfzeilen Ihrer Spalten auszuwählen.
upload-spreadsheet-events
  • Klicken Sie auf Weiter.
  • Auf dem Bildschirm Spalten in Ihrer Datei den HubSpot-Eigenschaften zuordnen ordnet HubSpot die Spalten in Ihrer Datei den Kontakt- und Ereigniseigenschaften zu, basierend auf der Kopfzeile, der Sprache der Kopfzeile und dem Namen der Eigenschaft.
  • Der Mapping Guide zeigt die Eigenschaften an, die zum Erstellen und/oder Aktualisieren der Kontakte und Ereignisse erforderlich sind. Wenn in Ihrer Datei eine der Eigenschaften fehlt, die für die Erfüllung des Ziels Ihres Imports erforderlich sind, sollten Sie Ihre Importdatei korrigieren und den Import neu starten, um Fehler zu vermeiden.
  • Die Spalten in Ihrer Kalkulationstabelle können entweder Kontakteigenschaften oder Ereigniseigenschaften zugeordnet werden. Klicken Sie auf das Dropdown-Menü Importieren als , um auszuwählen, wie die Daten in die Datei importiert werden sollen. Wählen Sie dann die HubSpot-Eigenschaft aus, der sie zugeordnet werden soll. Sie können sie einer bestehenden Eigenschaft zuordnen oder eine neue Eigenschaft erstellen.
create-new-property
  • Klicken Sie auf Weiter.
  • Bestätigen Sie den Namen Ihrer Importdatei.
  • Klicken Sie auf das Kontrollkästchen , um zu bestätigen, dass die Kontakte erwarten, von Ihnen zu hören und dass Ihre Importdatei keine gekaufte Liste enthält. Erfahren Sie mehr über HubSpot's Richtlinie zur akzeptablen Nutzung.
  • Klicken Sie auf das Dropdown-Menü, um das Datumsformat für die Eigenschaft Occurred at auszuwählen.
  • Klicken Sie auf „Import beenden“.

Benutzerdefinierte Ereignisdaten verwenden

Benutzerdefinierte Ereignisdaten können in allen HubSpot-Tools angezeigt und verwendet werden. Im Folgenden erfahren Sie, wo Sie abgeschlossene Events anzeigen und wie Sie diese Daten in andere Tools integrieren können.

Sie können die ausgewählten Ereignisse direkt in ausgewählten HubSpot-Tools über das Dropdown-Menü "Aktionen" in der Ereignisliste, in der Einzelereignisansicht oder in der oberen rechten Ecke der Diagramme auf der Registerkarte "Analysieren" öffnen.

Berichte zu benutzerdefinierten Events erstellen

Benutzerdefinierte Ereignisabschlüsse können mit dem Tool für benutzerdefinierte Ereignisse analysiert werden, und die Ereignisdaten sind auch im benutzerdefinierten Berichtsersteller und in den Attributberichten verfügbar.

Erfahren Sie mehr über und die Analyse Ihrer benutzerdefinierten Ereignisse.

Abgeschlossene Events in der Kontaktchronik anzeigen

Abgeschlossene Events werden in der Chronik des Kontaktdatensatzes zusammen mit allen Eigenschaften angezeigt, die ausgefüllt wurden.

So zeigen Sie Event-Details in der Chronik des Kontakts an:

  • Navigieren Sie zu einem Datensatz, der ein benutzerdefiniertes Ereignis abgeschlossen hat.
  • Um eine Kontaktchronik nach abgeschlossenen Ereignissen zu filtern, klicken Sie auf Aktivität filtern, und wählen Sie dann Benutzerdefiniertes Ereignis.
  • Klicken Sie in der Kontaktzeitleiste auf das Ereignis, um die Ereignisdetails anzuzeigen.

Benutzerdefinierte Ereignisse in Workflows verwenden

In einem Workflow können Sie eine Verzögerung auf der Grundlage von benutzerdefinierten Ereignisabschlüssen mithilfe einer Verzögerung bis zum Eintreten des Ereignisses Aktion oder eines Triggers für die Ereignisregistrierung erreichen.

  • Klicken Sie in Ihrem HubSpot-Account auf Automatisierung und dann auf Workflows.
  • Klicken Sie auf den Namen eines Workflows. Oder Sie erfahren, wie Sie unter einen neuen Workflow erstellen.
  • So fügen Sie einen Trigger hinzu:
    • Klicken Sie im Workflow-Editor auf Trigger einrichten.
    • Wählen Sie im linken Bereich Wenn ein Ereignis eintritt. Richten Sie den Trigger ein und klicken Sie dann auf Filter anwenden.
    • Um Ihren Trigger weiter zu verfeinern, klicken Sie auf Verfeinerungsfilter hinzufügen. Sie können weitere Eigenschaften auswählen, um die Objekte, die Sie in den Workflow aufnehmen möchten, zu verfeinern.
    • Standardmäßig werden Datensätze nur dann in einen Workflow aufgenommen, wenn Sie zum ersten Mal die Aufnahme-Trigger für einen Workflow erfüllen. Um die erneute Registrierung zu aktivieren, wählen Sie unter Should [object] be re-enroll in this workflow? die Option Yes, re-enroll every time the trigger occurs.
  • Um eine Verzögerung hinzuzufügen:
    • Klicken Sie im Workflow-Editor auf das Plus-Symbol, um eine Workflow-Aktion hinzuzufügen.
    • Wählen Sie im rechten Feld Verzögerung bis zum Eintreten des Ereignisses.
    • Konfigurieren Sie die Verzögerung:
      • Klicken Sie auf das Dropdown-Menü Ereignis und wählen Sie dann ein benutzerdefiniertes Ereignisaus.
      • Wählen Sie dann die Event-Eigenschaft aus, für die Sie verzögern möchten.
      • Wählen Sie den Filter für die Ereigniseigenschaft.
      • Klicken Sie auf „Filter anwenden“.
      • Wählen Sie die maximale Wartezeit aus oder aktivieren Sie das Kontrollkästchen „So lange wie möglich verzögern“.
  • Klicken Sie auf Speichern.

Bitte beachten Sie: alle Trigger für die Ereignisregistrierung werden mit dem Operator OR getrennt. Das bedeutet, dass nur einer der Trigger für die Ereignisregistrierung eintreten muss, damit der Datensatz in den Workflow aufgenommen werden kann.

Der Workflow verzögert dann die Registrierung von Datensätzen, bis sie die angegebenen benutzerdefinierten Ereigniskriterien erfüllen, oder er wird bei Eintreten des Ereignisses ausgelöst.

War dieser Artikel hilfreich?
Dieses Formular wird nur verwendet, um Feedback zur Dokumentation zu sammeln. Erfahren Sie, wie Sie Hilfe bei Fragen zu HubSpot erhalten können.