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

# Events-API | Event-Analytics

<DndSection>
  <DndModule numCols={10}>
    <div>
      # Event-Analytics

      <RelatedApiLink />
    </div>
  </DndModule>

  <DndModule numCols={2} />
</DndSection>

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](/api-reference/events-send-event-completions-v3/guide).

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`