Sie möchten z. B. Ihre Kontakte besser anhand der Interaktionen mit Ihrem Unternehmen und Content segmentieren. Dazu benötigen Sie mehr Informationen über sie. Ihre App kann benutzerdefinierte Events erstellen (Kontakte, die sich registriert, jedoch nicht an einem jüngsten Webinar teilgenommen haben; welche Variante eines Registrierungsprozesses einen Kontakt abgeschlossen hat, usw.), die Ihnen mehr Kontext über die Interaktionen von Kontakten mit Ihrem Unternehmen liefern.
## Eine Event-Vorlage erstellen
Bevor Sie Events erstellen können, müssen Sie eine Event-Vorlage erstellen. Event-Vorlagen beschreiben Aktionen, die Ihre App zur Chronik eines Kontakt-, Unternehmens- oder Deal-Objekts in HubSpot hinzufügt. Beispiele für diese Aktionen sind unter anderem das Aufrufen eines Videos, die Registrierung für ein Webinar oder das Ausfüllen einer Umfrage. Eine einzelne App kann bis zu 750 Event-Vorlagen erstellen.
Events werden standardmäßig für Kontakte erstellt, sie können jedoch mithilfe des `objectType`-Feldes auch für Unternehmen oder Deals erstellt werden. Im Abschnitt zur Erstellung einer Vorlage für Chronik-Events finden Sie weitere Informationen.
Jede Event-Vorlage verfügt über einen eigenen Satz an Token und Vorlagen. Sie können Events für Kontakte als Kriterien beim Erstellen neuer Kontaktlisten oder Workflows verwenden, z. B.: „Erstellen einer Liste aller Kontakte mit einem Video-Like, bei der der Videoname XYZ enthält“, wobei die Event-Vorlage „Video-Like“ heißt und über ein Event-Token mit dem Namen „Videoname“ verfügt."
### Event-Vorlagen über die API erstellen
In diesem Beispiel erstellen wir eine neue Event-Vorlage vom Typ „Beispiel-Webinar-Registrierung“. Verwenden Sie zur Authentifizierung den Entwickler-API-Schlüssel in Ihrem App-Entwickler-Account.
```shell theme={null}
curl -X POST
-H "Content-Type: application/json" -d '
{
"name": "Example Webinar Registration",
"objectType": "contacts"
}' \
'https://api.hubapi.com/crm/v3/timeline/<
Sie beginnen mit einem Entwurf Ihrer neuen Event-Vorlage. Nachdem Sie den Objekttyp und die Detail- und Header-Vorlagen für das Event festgelegt haben, klicken Sie auf **Erstellen**.
Legen Sie beim Erstellen oder Bearbeiten Ihrer Event-Vorlage auf der Registerkarte *Daten* alle Token fest, die Sie mit ihr verwenden möchten.
Klicken auf „Details anzeigen“ stellt die Details-Vorlage dar:
Weitere Informationen dazu, wie Sie Symbol festlegen, das neben den Events angezeigt wird, finden Sie unten unter "[Einrichten eines benutzerdefinierten Symbols"](/api-reference/crm-timeline-v3/guide#customicon).
Der Text „Beispiel-App-Name“ oben ist der Name der App. In der CRM-Chronik können Events nach App gefiltert werden.
### Alle Aspekte einer Event-Vorlage in einem einzigen Aufruf definieren
Bisher haben Sie gesehen, wie die einzelnen Aspekte einer Event-Vorlage schrittweise definiert wurden. Sie können aber auch alles in einem einzigen `POST`-Aufruf definieren.
```shell theme={null}
curl -X POST -H "Content-Type: application/json" -d '
{
"name": "Another Webinar Registration",
"objectType": "contacts",
"headerTemplate": "Registered for [{{webinarName}}](https://mywebinarsystem/webinar/{{webinarId}})",
"detailTemplate": "Registration occurred at {{#formatDate timestamp}}{{/formatDate}}",
"tokens": [
{
"name": "webinarName",
"label": "Webinar Name",
"type": "string"
},
{
"name": "webinarId",
"label": "Webinar Id",
"type": "string"
},
{
"name": "webinarType",
"label": "Webinar Type",
"type": "enumeration",
"options": [
{
"value": "regular",
"label": "Regular"
},
{
"value": "ama",
"label": "Ask me anything"
}
]
}
]
}' \
'https://api.hubapi.com/crm/v3/timeline/<
### Den Events-Zeitstempel festlegen
Der Zeitstempel des Events bestimmt, wo das Event in der Chronik des Objekts angezeigt wird. Standardmäßig wird der Event-Zeitstempel angezeigt, wenn der POST-Befehl gesendet wird. Sie können die Event-Zeit anpassen, indem Sie sie im Anfragetext in einer Zeitstempel-Eigenschaft angeben:
```shell theme={null}
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <
Durch Klicken auf diesen Link würde ein modales Fenster geöffnet, das die in der `url` festgelegte Seite anzeigt:
### CRM-Objekteigenschaften mit Event-Daten aktualisieren (stempeln)
In vielen Fällen möchten Sie die Eigenschaften für die Kontakte, Unternehmen oder Deals ändern, für die Sie Events hinzufügen, ändern. Dies geschieht häufig in Fällen, in denen über das Event tatsächlich ein Kontakt erstellt wird – Sie möchten wahrscheinlich die Eigenschaften „Vorname“ und „Nachname“ im Kontakt aktualisieren, damit Sie nicht nur einen Kontakt mit einer E-Mail-Adresse und einem Event erstellen.
Sie können das zugehörige Objekt mit Daten von einem Event aktualisieren (stempeln), indem Sie Ihre benutzerdefinierten Event-Token Kontakt-, Unternehmens- oder Deal-Eigenschaften zuordnen.
Ziehen Sie diesen `PUT`-Befehl zum Aktualisieren einer benutzerdefinierten Event-Vorlage in Betracht. Beachten Sie dabei das `objectPropertyName`-Feld:
```shell theme={null}
curl -X PUT -H "Content-Type: application/json" -d '
{
"label" : "Updated Webinar Name",
"objectPropertyName": "zz_webinar_name"
}' \
'https://api.hubapi.com/crm/v3/timeline/<
Hinweis: Wenn eine benutzerdefinierte Eigenschaft mit einem Event-Token aktualisiert (gestempelt) wird und diese benutzerdefinierte Eigenschaft für einen HubSpot-Account nicht vorhanden ist, wird der Wert weiterhin für das Event festgelegt, es wird jedoch für das entsprechende Objekt ignoriert.
### `extraData` Verstehen
Sie müssen möglicherweise detaillierte Daten zu einem Event hinzufügen, das nicht der einfachen Token-Wert-Struktur entspricht, die von den Event-Vorlagen-Token verwendet wird. Möglicherweise müssen Sie auch eine Liste oder eine gewisse hierarchische Aufschlüsselung zu einem Integrations-Event hinzufügen. Hier kommt nun `extraData` ins Spiel.
Sie können ein `extraData`-Attribut zum JSON-Text eines Events hinzufügen. Der Wert dieses `extraData`-Attributs kann beliebiger zulässiger JSON sein. Zum Beispiel:
```shell theme={null}
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <
Hinweis: Das `extraData`-Attribut kann nur in der Details-Vorlage für ein Event referenziert werden. Es kann weder in der Kopfzeilen-Vorlage oder in der Listensegmentierung verwendet werden.
### Ein benutzerdefiniertes Symbol einrichten
Um Ihre Chronikelemente visuell ansprechender gestalten, sollten Sie ein benutzerdefiniertes Symbol hinzufügen.
Diese Bilddatei für dieses Symbol sollte:
* ungefähr quadratische Maße aufweisen,
* einen durchsichtigen Hintergrund haben,
* den Inhalt in der Mitte des Symbols haben,
* auf bis zu 30 x 30 Pixel verkleinert werden können sowie
* über eine Dateigröße von höchstens 5 MB verfügen.
Um das Symbol für Chronik Events festzulegen, navigieren Sie zu „Chronik Events“. Klicken Sie auf das Platzhalterbild oder das vorhandene Symbol, um es festzulegen oder zu aktualisieren.
Nachdem Sie das oder die Symbole festgelegt haben, wird es bzw. werden sie neben allen mit dieser Anwendung verknüpften Chronik-Events angezeigt:
### Beschränkungen für Event-Instanzen
Bei der Erstellung eines Events unterliegt jede serialisierte Event-Instanz den folgenden Größenbeschränkungen:
* 500 Bytes für die Event-Instanz-ID,
* 510 KB pro Eigenschaft/Token sowie
* 1 MB Gesamtgröße für die Event-Instanz.
***
#### Verwandte Dokumente
[Grundlegendes zum CRM](/guides/crm/understanding-the-crm)
[CRM-Karten](/api-reference/crm-public-app-crm-cards-v3/guide)