Letzte Änderung: 28. August 2025
Verwenden Sie die Event-Analytics API, um mit CRM-Datensätzen aller Typen verknüpfte Events abzurufen (nur Marketing Hub Enterprise, Sales Hub Enterprise, Service Hub Enterprise oder CMS Hub Enterprise). Dazu gehören Standard-Events, z. B. Aufrufe von Website-Seiten und E-Mail-Öffnungen sowie benutzerdefinierte Events. Verwenden Sie beispielsweise diese API, um eine Chronik der Interaktionen zu sehen, die ein Kontakt mit Ihren Inhalten hatte. Sie können diese Chronik dann nutzen, um einen Datensatz für benutzerdefinierte Analytics zu erstellen oder eine Kontaktchronik in einer externen Anwendung anzuzeigen.

​
Einzelne Event-Abschlüsse abfragen

Diese API gibt Events für jeweils einen CRM-Datensatz zurück. Sie können den Datensatz auswählen, indem Sie den objectType angeben und entweder den objectId- oder objectProperty-Abfrageparameter hinzufügen.

​
Nach Objekt-ID auswählen

Um einen Datensatz anhand seiner ID anzugeben, fügen Sie den objectId-Abfrageparameter hinzu. Um beispielsweise einen Kontaktdatensatz mit der ID 2832 anzugeben, müssen Sie die folgende GET-Anfrage vornehmen: /events/v3/events/?objectType=contact&objectId=224834

​
Nach Objekteigenschaft auswählen

Um einen Datensatz anhand einer eindeutigen Eigenschaft anstelle der Kontakt-ID anzugeben, fügen Sie den objectProperty-Parameter hinzu. Verweisen Sie auf die Eigenschaft, indem Sie den Eigenschaftsnamen und den Wert im folgendem Format einschließen: objectProperty.{propname}={propvalue} Um beispielsweise einen Kontakt anhand seiner E-Mail-Adresse anzugeben, müssen Sie die folgende GET-Anfrage vornehmen: /events/v3/events/?objectType=contact&objectProperty.email=user12@dev.com

​
Abfragen von und Filtern nach Event-Typen

Beim Abfragen der Events, die einem bestimmten CRM-Objekt zugeordnet sind, umfasst die Antwort alle Event-Typen, einschließlich benutzerdefinierter verhaltensorientierter Events. Um nur Event-Abschlüsse zurückzugeben für einen bestimmten Event-Typ, können Sie einen eventType-Parameter gefolgt vom Event-Namen einschließen. Um eine Liste aller verfügbaren Event-Typen abzurufen, können Sie eine GET-Anfrage an /events/v3/events/event-types durchführen. Die Antwort gibt alle Event-Typen in Ihrem Account zurück. Sie können dann einen dieser Event-Namen als Abfrageparameter in einer GET-Anfrage den Endpunkt /events/v3/events verwenden. Zum Beispiel: /events/v3/events/eventType={EVENT_NAME}&objectType=contact&objectId=224834