> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Überblick über App-Events (BETA)
> Erfahren Sie, wie Sie App-Events auf der neuesten Version der Entwicklerplattform definieren können.
Mithilfe von App-Events können Sie angereicherte Aktivitätsdaten von Ihren externen Systemen direkt an HubSpot senden. App-Event-Daten werden mit CRM-Datensätzen verknüpft und können in den Automatisierungs-, Analytics- und Berichterstattungstools von HubSpot verwendet werden.
Im Folgenden erfahren Sie mehr über die Funktionsweise von App-Events. So beginnen Sie mit dem Integrieren von App-Events in Ihr Projekt:
* [Erstellen Sie einen Event-Typ](/apps/developer-platform/add-features/app-events/create-and-manage-event-types)
* [Senden Sie Daten zu Event-Vorkommnissen](/apps/developer-platform/add-features/app-events/send-event-occurrences)
* Gehen Sie die Referenzdokumentation für [App-Events](/apps/developer-platform/add-features/app-events/reference) durch
Die in dieser Dokumentation beschriebenen App-Events sind für Apps gedacht, die mithilfe von Entwicklerprojekten für den [App Marketplace](https://ecosystem.hubspot.com/marketplace/apps) erstellt wurden. Um benutzerdefiniertes Event-Reporting für andere Arten von Integrationen zu erstellen, können Sie stattdessen [benutzerdefinierte Events](/api-reference/events-manage-event-definitions-v3/guide) verwenden.
## So funktionieren App-Events
Events sind Datenpunkte, die Ereignisse zu einem bestimmten Zeitpunkt erfassen, oft im Zusammenhang mit Nutzeraktionen, z. B. dem Einsenden eines Formulars, dem Senden einer SMS-Nachricht oder dem Anzeigen einer Seite. Im Gegensatz zu CRM-Datensätzen, die den aktuellen Zustand anzeigen sollen, können Events Ihnen ein besseres Verständnis von Aktivitätsmustern, Verhaltensänderungen im Laufe der Zeit und anderen Trends vermitteln.
App-Events sind ideal, wenn Ihre Daten:
* Aktionen oder Aktivitäten darstellen, die wiederholt auftreten
* im Laufe der Zeit in Bezug auf das Volumen oder Änderungen analysiert werden müssen
* nach der Erstellung nicht aktualisiert werden müssen
Übergeordnet zusammengefasst besteht ein App-Event aus Folgendem:
* **Definition des Event-Typs:** Dies ist ein JSON-Schema, das die Struktur, Eigenschaften und Validierungsregeln für das Event definiert. Dazu gehören der Event-Name, das Anzeigelabel, das Ziel-CRM-Objekt und die Event-Eigenschaften. Event-Typen enthalten auch Definitionen für Anzeige-Vorlagen für die CRM-Chronik-Darstellung. Event-Typen werden mithilfe von Entwicklerprojekten definiert.
* **Event-Vorkommnisse:** Dies sind einzelne Instanzen von Events, die tatsächliche Daten enthalten, die anhand Ihres Event-Typschemas validiert wurden. Daten zu Event-Vorkommnissen werden über die API für App-Events gesendet und umfassen die Event-Typ-ID, Eigenschaftswerte, Zeitstempel und zusätzliche Metadaten sowie CRM-Objekt-Referenzdaten für die Zuordnung von CRM-Datensätzen.
**Chronik-Events vs. App-Events**
Bisher hat HubSpot Chronik-Events veröffentlicht, damit Sie Event-Daten in CRM-Objekt-Chroniken anzeigen können. App-Events ermöglichen dieselbe Funktionalität für eine erweiterte Liste unterstützter Objekte und sind gleichzeitig auch in anderen HubSpot-Tools verfügbar. App-Events verfügen jetzt neben benutzerdefinierten Events über eine eigene Indexseite, die eine einheitliche Ansicht der Event-Aktivitäten bietet.
Bestehende Integrationen für Chronik-Events funktionieren weiterhin und werden an denselben Stellen wie App-Events angezeigt. Um jedoch neue Event-Typen zu erstellen oder Änderungen an vorhandenen Typen vorzunehmen, müssen Sie sie als App-Event in Ihrem Entwicklerprojekt neu erstellen.
## Unterstützte Objekte und Tools
Wenn Sie einen Event-Typ definieren, konfigurieren Sie ihn so, dass er mit einem bestimmten CRM-Objekt verknüpft wird, damit Sie Event-Daten mit der Quelle verknüpfen können, z. B. mit den Kontakten, die sich auf Ihrer Website anmelden. Event-Vorkommnisse können dann CRM-Datensätzen dieses Typs zugeordnet werden. App-Events können den folgenden CRM-Objekten zugeordnet werden:
* Kontakte
* Unternehmen
* Deals
* Tickets
* Benutzerdefinierte Objekte
* App-Objekte
App-Events können in den folgenden HubSpot-Tools verwendet werden:
* **Event-Management-Schnittstelle:** Zeigen Sie App-Event-Daten im Dashboard für benutzerdefinierte Events zusammen mit benutzerdefinierten Event-Daten an und analysieren Sie sie, indem Sie in Ihrem Account **Datenmanagement** > **Benutzerdefinierte Events** öffnen.
* **CRM-Datensatzchroniken:** Zeigen Sie chronologische App-Event-Aktivitäten in den Chroniken von CRM-Datensätzen an, die Event-Vorkommnissen zugeordnet sind.
* **Reporting-Tools:** Nutzen Sie App-Event-Daten, um benutzerdefinierte Berichte, Customer Journey Analytics und Datensätze zur Analyse und Visualisierung zu erstellen.
* **Leadscores, Listen und Workflows:** Segmentieren Sie Ihre CRM-Datenbank mithilfe von Events für dynamische Listen und Leadscoring sowie zum Auslösen von Workflows.
## Bewährte Methoden
Beim Erstellen von Event-Typen:
* Verwenden Sie eindeutige, aussagekräftige Namen für [Event-Typen](/apps/developer-platform/add-features/app-events/reference#event-type-schema) und [-Eigenschaften](/apps/developer-platform/add-features/app-events/reference#event-properties), da diese als Filter in Workflows, Listen, Berichten und dem Dashboard für benutzerdefinierte Events angezeigt werden.
* Wählen Sie geeignete Eigenschaften (Zeichenfolge, Zahl, Datum/Uhrzeit usw.), die zu Ihren Daten passen und eine ordnungsgemäße Filterung und Analyse ermöglichen.
* Fügen Sie Eigenschaften hinzu, die für die Segmentierung, Berichterstattung und Automatisierung nützlich sind (z. B. Transaktionsbeträge, Benutzerrollen, Aktionskategorien).
* Behalten Sie beim Entwerfen von Event-Typen Anwendungsfälle rund um die Berichterstattung und Workflows im Hinterkopf. Berücksichtigen Sie außerdem, wie Benutzer Event-Daten filtern und gruppieren.
* Vermeiden Sie Breaking Changes an bestehenden Event-Typschemata, da dies vorhandene Workflows und Berichte, die von der Event-Struktur abhängen, stören kann.
So sorgen Sie für eine hohe Qualität Ihrer Event-Daten:
* Überprüfen Sie alle Datenanforderungen für programmatische Event-Vorkommnisse, um sicherzustellen, dass sie ordnungsgemäß mit Ihrem Event-Typschema abgeglichen werden.
* Verwenden Sie eine einheitliche Formatierung für Event-Eigenschaften, insbesondere für Datumsangaben, Zahlen und kategorische Daten.
* Stellen Sie sicher, dass Event-Vorkommnisse [gültigen CRM-Datensatz-IDs](/apps/developer-platform/add-features/app-events/send-event-occurrences#crm-record-association) zugeordnet sind.
* Beobachten Sie Erfolgsquoten von Event-Einsendungen und [Fehlerantworten](/apps/developer-platform/add-features/app-events/reference#occurrence-send-errors).
* Überprüfen Sie regelmäßig in den Chroniken der CRM-Datensätze und im Dashboard für benutzerdefinierte Events die Event-Daten auf ihre Richtigkeit.
Optimieren Sie die Performance von Event-Einsendungen folgendermaßen:
* [Verarbeiten Sie mehrere Event-Vorkommnisse gleichzeitig](/apps/developer-platform/add-features/app-events/send-event-occurrences#sending-event-occurrences) in einzelnen API-Anfragen, wenn möglich (bis zu 500 Events pro Batch).
* Halten Sie die Payloads von Event-Vorkommnissen schlank, indem nur notwendige Eigenschaften berücksichtigt werden.
* Implementierung einer Wiederholungslogik mit exponentiellem Backoff für fehlgeschlagene Event-Einsendungen.
## Beschränkungen
Beachten Sie beim Planen und Erstellen von App-Events bitte die folgenden Einschränkungen.
### Versionsanforderungen
* App-Events können nur über die neueste Version der Entwickler-Projektplattform (`2025.2`) erstellt werden.
* Für bestehende Event-Typen können Sie weiterhin die [v1-](/api-reference/legacy/crm-timeline-v1/get-integrations-v1-application-id-timeline-event-event-typeid-event-id) und [v3-](/api-reference/crm-timeline-v3/guide) Chronik-Events-API verwenden. Sie können jedoch keine neuen Event-Typen mit den `v1`- und `v3`-APIs erstellen.
### Beschränkungen für Event-Typen
* Event-Vorkommnisse müssen dem definierten Event-Typschema entsprechen, sonst werden sie abgelehnt.
* Einige [Event-Typ-Felder](/apps/developer-platform/add-features/app-events/reference#event-type-schema) können nach dem Erstellen des Event-Typs nicht mehr aktualisiert werden (z. B. `name` und `objectType`).
* Neue Event-Typen werden vor der Aktivierung einem Überprüfungsprozess unterzogen.
### Datenbeschränkungen
* Einzelne Eigenschaften sind auf 510 KB beschränkt, wobei die Gesamtgröße des Events auf 1 MB begrenzt ist.
* App-Events sind für App Marketplace-Anbieter gedacht und funktionieren nur mit Apps, die für die Verwendung der OAuth-Authentifizierung konfiguriert sind. Interne Systeme sollten stattdessen [benutzerdefinierte Events](/api-reference/events-manage-event-definitions-v3/guide.mdx) verwenden.
## Erste Schritte
Hier sind die ersten Schritte, die Sie unternehmen müssen, um mit App-Events zu arbeiten:
* [Erstellen Sie einen Event-Typ](/apps/developer-platform/add-features/app-events/create-and-manage-event-types), um die Struktur Ihrer Event-Daten mithilfe eines Entwicklerprojekts zu definieren.
* \[Senden Sie mithilfe der [App-Events-API]() Daten zu Event-Vorkommnissen]\(/en-us/apps/developer-platform/build-apps/features/app-events/send-event-occurrences#send-a-single-occurrence) an die App.
* Nutzen Sie die Daten in HubSpot nach Bedarf mithilfe von Reporting-, Automatisierungs- oder Analytics-Tools.