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.

Manuell nachverfolgte benutzerdefinierte verhaltensorientierte Events erstellen

Zuletzt aktualisiert am: Januar 19, 2023

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

Marketing Hub   Enterprise

Manuell nachverfolgte benutzerdefinierte verhaltensorientierte Events ermöglichen es Ihnen, Events zu 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. 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.
  • 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:

  • Klicken Sie auf „Benutzerdefinierte verhaltensorientierte Events”.
  • Klicken Sie oben rechts auf „Event erstellen“.
  • Geben Sie im rechten Bereich einen Namen für Ihr Event ein und wählen Sie dann „Manuell nachverfolgtes Event“ aus.
    create-manually-tracked-event
  • Das Event wird dann erstellt und Sie können den internen Namen kopieren, der bei der API-Anfrage verwendet wird. Um den internen Namen zu kopieren, klicken Sie auf „Kopieren“.

Als Nächstes richten Sie die Eigenschaften ein, die Sie in Ihrem API-Aufruf verwenden.

Event-Eigenschaften hinzufügen und verwalten

Wenn Sie ein Event erstellen, steht Ihnen eine Reihe von Standard-Event-Eigenschaften zur Verfügung. Sie können jedoch 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 können Sie Eigenschaften für ein Event anzeigen und erstellen:

  • Klicken Sie auf „Benutzerdefinierte verhaltensorientierte Events”.
  • Klicken Sie auf den Namen des Events, das Sie anzeigen oder aktualisieren möchten. Sie werden dann zur Seite mit den Event-Details weitergeleitet.
  • Zeigen Sie in der Tabelle „Eigenschaften“ die Standardeigenschaften an, die für das Event erstellt wurden. 
  • So bearbeiten Sie eine Eigenschaft:
    • Klicken Sie auf den Namen der Eigenschaft.
    • Im rechten Bereich können Sie einen neuen Namen oder eine neue Beschreibung eingeben. Durch das Ändern des Eigenschaftsnamens wird nicht der interne Name geändert, sodass Sie Ihren API-Aufruf nicht aktualisieren müssen, wenn Sie den Namen einer Eigenschaft ändern.
    • Um den Feldtyp zu ändern und die Eigenschaft weiter zu konfigurieren, klicken Sie auf die Registerkarte „Feldtyp“ und verwenden Sie dann die Dropdown-Menüs, um einen neuen Feldtyp auszuwählen und Ihre Eigenschaftsdetails zu konfigurieren. 
    • Klicken Sie auf „Speichern“.
  • So erstellen Sie eine neue Eigenschaft:
    • Klicken Sie oben rechts auf „Eigenschaft erstellen“.
    • Konfigurieren Sie im rechten Bereich die Eigenschaft:
      • Wählen Sie eine Gruppierung für die Eigenschaft aus, indem Sie auf das Dropdown-Menü „Gruppe“ klicken und dann eine Gruppe auswählen.
      • Um den Namen der Eigenschaft festzulegen, geben Sie im Feld „Label“ einen Namen ein. Der Name, den Sie eingeben, erstellt automatisch den internen Namen für die Eigenschaft.
        • Um den internen Namen zu bearbeiten, klicken Sie auf das code Code-Symbol und klicken Sie dann auf das Feld „Interner Name“, um einen neuen Namen einzugeben. Sobald die Eigenschaft erstellt ist, kann der interne Name nicht mehr aktualisiert werden.

          Bitte beachten: Eigenschafts-Label und interner Name sind auf 50 Zeichen begrenzt.
        • Um den Namen zu speichern, klicken Sie auf „Speichern“
      • Geben Sie optional im Feld „Beschreibung“ eine Beschreibung für die Eigenschaft ein.
      • Klicken Sie auf „Weiter“.
      • Wählen Sie den Eigenschaftstyp aus, indem Sie auf das Dropdown-Menü „Feldtyp“ klicken und dann einen Feldtyp auswählen. Standardmäßig ist die Eigenschaft in Formularen und Bots verfügbar. Um zu verhindern, dass das Feld in Formularen und Bots verwendet wird, deaktivieren Sie das Kontrollkästchen „In Formularen anzeigen“.
    • Klicken Sie auf „Erstellen“.

Den API-Aufruf definieren

Nachdem Sie das Event eingerichtet und seine Eigenschaften festgelegt haben, 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.

So finden Sie den internen Event-Namen und die internen Eigenschaftsnamen:

  • 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.

    custom-event-internal-name
  • 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 Code-Symbol und zeigen Sie dann den Namen unter „Interner Name“ an.

Bitte beachten: Wenn Sie Daten an Ihr Event senden, sollten Sie die folgenden Obergrenzen beachten:

  • Das Eigenschafts-Label und der interne Name 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 Obergrenzen bei einer JS-API-Anforderung überschritten werden, schneidet HubSpot alle Eigenschaftsnamenwerte auf die zulässige Länge ab und/oder aktualisiert nur 50 Eigenschaften pro Event-Abschluss.

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.

custom-behavioral-events-contact-timeline-filter

  • Klicken Sie in der Chronik des Kontakts auf das Event, um es zu erweitern und die Event-Details anzuzeigen.
    custom-behavioral-events-contact-timeline-info

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 Automatisierungen > 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.

workflow-delay-until-event-happens-action

  • 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“.

      workflow-delay-until-event-device-type
    • 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. 

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.