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.
Analytics Tools

Benutzerdefinierte verhaltensorientierte Ereignisse mit dem Code-Assistenten erstellen (BETA)

Zuletzt aktualisiert am: Juli 19, 2022

Produkte/Lizenzen

Marketing Hub Enterprise

Benutzerdefinierte verhaltensorientierte Events ermöglichen es Ihnen, Events definieren und nachzuverfolgen, die nur in Ihrem Unternehmen vorkommen. Benutzerdefinierte verhaltensorientierte Events können mit Event-Eigenschaften verknüpft werden, die Sie dann in allen Tools von HubSpot verwenden können. Ereignisse, die mit dem „Javascript-Code-Snippet“ erstellt wurden, fügen automatisch Ereignisdaten zum HubSpot-Tracking-Code Ihrer Website hinzu und erfordern zum Einrichten eine mit Javascript vertraute Person. Manuell nachverfolgte Events verwenden die Analytics-API und erfordern einen Entwickler für das Einrichten. 

Erfahren Sie, wie Sie mithilfe des neuen Tools für verhaltensorientierte Events Events vom Typ „Angeklicktes Element“ und Events vom Typ „Aufgerufene URL“ erstellen können.

Bitte beachten: Das Tool für benutzerdefinierte verhaltensorientierte Events ersetzt das vorherige Tool für benutzerdefinierte verhaltensorientierte Events (Legacy). 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 Event auslöst. 

Das Event in HubSpot erstellen

Um ein benutzerdefiniertes verhaltensorientiertes Event einzurichten, erstellen Sie zuerst das Event und ordnen Sie dann dem Event Eigenschaften zu:

  • Gehen Sie in Ihrem HubSpot-Account zu Berichte > Analytics-Tools.
  • Klicken Sie auf „Benutzerdefinierte verhaltensorientierte Events”.
  • Klicken Sie oben rechts auf Benutzerdefiniertes Ereignis erstellen.
  • Wählen Sie Code-Assistent aus.

  • Geben Sie einen Event-Namen  ein und geben Sie optional Ihre Event-Beschreibung ein
  • Wählen Sie im Dropdown-Menü Ihr zugeordnetes Objekt aus. So können Sie Ihre Event-Abschlüsse mit verschiedenen Objekten in HubSpot verknüpfen, einschließlich Kontakte, Unternehmen, Deals und Tickets

name-custom-behavioral event

  • Klicken Sie auf Weiter, um fortzufahren.

Event-Eigenschaften hinzufügen

Wenn ein Event erstellt wird, sind die Standard-Eigenschaften des Events 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 Event:

  • Wählen Sie den Eigenschaftstyp aus, indem Sie auf den Feldtyp für Ihre Eigenschaft klicken. Die Optionen umfassen: 
    • Benutzerdefinierte Zeichenketten-Eigenschaft: Erstellen Sie eine Eigenschaft, die eine Klartextzeichenfolge ist. 
    • Benutzerdefinierte Nummer-Eigenschaft: Erstellen Sie eine Eigenschaft, die einen Zahlenwert darstellt.
    • Benutzerdefinierte Zeitstempel-Eigenschaft: Erstellen Sie eine Eigenschaft, die ein Datumswert ist. Sie müssen Ihre Daten in Form von Epoche Millisekunden senden. 
    • Benutzerdefinierte Enumerationseigenschaft: Erstellen Sie eine Eigenschaft mit einem Satz vordefinierter Werte.

      erstellen-eigenschaft-brauchs-verhalten-ereignis
    • 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 für Enumerationseigenschaften auf Weiter, und geben Sie Ihre Eigenschaftsbezeichnungen und -werte ein. Sie müssen Ihre Werte und Beschriftungen festlegen, bevor Sie Daten an sie senden. Wenn dieser Schritt nicht abgeschlossen ist, bevor Daten gesendet werden, die nicht in der Liste enthalten sind, können die Daten nicht verwendet werden. Um mehrere Werte zu senden, trennen Sie sie mit einem Semikolon.
    • Klicken Sie auf „Fertig“.
    • Sobald Ihre Eigenschaft erstellt wurde, wird sie in der Tabelle unter den Standardereigniseigenschaften von HubSpot angezeigt. Sie können Ihre Immobilie bearbeiten oder löschen, indem Sie das Dropdown-Menü „Aktionen“ auswählen und „Bearbeiten“ oder „ Löschen“ auswählen. 
  • Klicken Sie auf „Weiter“.
  • Nachdem Sie das Event und seine Eigenschaften eingerichtet haben, können Sie dieses Event entweder dem Tracking-Code Ihrer Website hinzufügen, indem Sie Javascript-Code-Snippet auswählen, oder Daten über API an HubSpot senden, indem Sie Daten an HubSpot senden auswählen. 

Einen Javascript-Codeausschnitt erstellen

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

  • Wählen Sie Javascript-Code-Snippet. Verwenden Sie das Snippet im rechten Bereich, um das Event in HubSpot nachzuverfolgen. Alle erstellten benutzerdefinierten Eigenschaften werden im Code-Snippet vordefiniert. 
  • Ändern Sie das Snippet nach Bedarf, indem Sie Text im rechten Bereich eingeben. Jeder Code, den Sie hinzufügen, wird automatisch in Ihren HubSpot-Tracking-Code aufgenommen.
  • Wenn Sie fertig sind, klicken Sie auf „Erstellen“, um Ihr Ereignis zu beenden und automatisch mit der Nachverfolgung zu beginnen. 
    example-code-snippet-custom-event

Daten an HubSpot senden

Wenn Sie Daten an HubSpot senden, müssen Sie den API-Aufruf definieren, der das Event auslösen soll. 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.

Um das Erstellen Ihres Ereignisses zum Senden von Daten über API abzuschließen:

  • Wählen Sie Daten an HubSpot senden und kopieren Sie die Tracking-ID.
  • Klicken Sie auf „Erstellen“.

So finden Sie den internen Event-Namen für ein vorhandenes Event und die vorhandenen Eigenschaftsnamen:

  • Gehen Sie in Ihrem HubSpot-Account zu Berichte > Analytics-Tools.
  • Klicken Sie auf „Benutzerdefinierte verhaltensorientierte Events”.
  • Klicken Sie auf den Namen des Events. Sie werden dann zur Seite mit den Event-Details weitergeleitet.
  • Oben auf der Seite finden Sie unter „Interner Name“ den Event-Namen.
    internal-name-custom-event
  • Um die internen Namen für die Eigenschaften zu finden, die Sie aktualisieren möchten, klicken Sie auf den Namen einer Eigenschaft.
  • Klicken Sie im rechten Bereich auf das code-Symbol und zeigen Sie dann den Namen unter „Interner Name“ an.
Bitte beachten Sie:
Wenn Daten an Ihre Veranstaltung gesendet werden, gelten die folgenden Grenzwerte:
  • Die Eigenschaftsnamen sind auf 50 Zeichen beschränkt. 
  • 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 Grenzwerte beim Erstellen einer JS-API-Anforderung überschritten werden, kürzt HubSpot alle Eigenschaftsnamenwerte auf die zulässige Länge und/oder aktualisiert nur 50 Eigenschaften pro abgeschlossenem Ereignis.

Daten von benutzerdefinierten verhaltensorientierten Events verwenden

Daten von benutzerdefinierten verhaltensorientierten Events können in den Tools von HubSpot angezeigt und verwendet werden. Im Folgenden erfahren Sie, wo Sie abgeschlossene Events anzeigen und wie Sie diese Daten in andere Tools integrieren können.

Berichte zu benutzerdefinierten Events erstellen

Abgeschlossene benutzerdefinierte verhaltensorientierte Events können über das Tool für benutzerdefinierte verhaltensorientierte Events analysiert werden und Event-Daten sind ebenfalls im benutzerdefinierten Berichtdesigner und in Attribution-Berichten verfügbar.

Erfahren Sie mehr über das Analysieren Ihrer benutzerdefinierten verhaltensorientierten Events.

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 Kontaktdatensatz, der ein benutzerdefiniertes verhaltensorientiertes Event abgeschlossen hat.
  • Um eine Kontaktchronik nach abgeschlossenen Events zu Filtern, klicken Sie auf „Aktivität filtern“ und wählen Sie dann „Benutzerdefiniertes verhaltensorientiertes Event“ aus.
  • Klicken Sie in der Chronik des Kontakts auf das Event, um es zu erweitern und die Event-Details anzuzeigen.

Benutzerdefinierte verhaltensorientierte Events in Workflows verwenden

In einem Workflow können Sie mithilfe einer Aktion vom Typ „Verzögern, bis Event stattfindet“ basierend auf den Abschlüssen benutzerdefinierter verhaltensorientierter Events verzögern:

  • Gehen Sie in Ihrem HubSpot-Account zu Automatisierung > Workflows.
  • Klicken Sie auf den Namen eines Workflows. Oder erfahren Sie hier, wie Sie einen neuen Workflow erstellen.
  • Klicken Sie im Workflow-Editor auf das (+) Plus-Symbol, um eine neue Workflow-Aktion hinzuzufügen.
  • Wählen Sie im rechten Bereich die Option „Verzögern, bis Event stattfindet“ aus.
  • Konfigurieren Sie die Verzögerung:
    • Klicken Sie auf das Dropdown-Menü „Event“ und wählen Sie dann ein benutzerdefiniertes verhaltensorientiertes Event aus.
    • Wählen Sie dann die Event-Eigenschaft aus, für die Sie verzögern möchten.
    • Wählen Sie den Filter für die Event-Eigenschaft aus.
    • 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“.

Der Workflow verzögert dann aufgenommene Datensätze so lange, bis sie die festgelegten Kriterien eines benutzerdefinierten verhaltensorientierten Events erfüllen. 

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.