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

# Benutzerdefinierte Event-Abschlüsse senden

export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => {
  const translations = {
    header: "Unterstützte Produkte",
    description: "Erfordert eines der folgenden Produkte oder höher.",
    productNames: {
      marketing: "Marketing Hub",
      sales: "Sales Hub",
      service: "Service Hub",
      cms: "Content Hub"
    },
    tiers: {
      free: "Kostenlos",
      starter: "Starter",
      professional: "Professional",
      enterprise: "Enterprise"
    }
  };
  const translateTier = tier => {
    if (!tier) return '';
    const lowerTier = tier.toLowerCase();
    return translations.tiers[lowerTier] || tier;
  };
  const products = [{
    name: marketing ? translations.productNames.marketing : '',
    level: translateTier(marketingLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg",
    alt: "Marketing Hub"
  }, {
    name: sales ? translations.productNames.sales : '',
    level: translateTier(salesLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg",
    alt: "Sales Hub"
  }, {
    name: service ? translations.productNames.service : '',
    level: translateTier(serviceLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg",
    alt: "Service Hub"
  }, {
    name: cms ? translations.productNames.cms : '',
    level: translateTier(cmsLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg",
    alt: "Content Hub"
  }].filter(product => product.name && product.level);
  if (products.length === 0) return null;
  return <div>
      <div className="text-sm mb-2">{translations.description}</div>
      <div className={`grid ${products.length === 1 ? 'grid-cols-1' : 'grid-cols-2'} gap-1.5`}>
        {products.map((product, index) => <div key={index} style={{
    display: 'flex',
    alignItems: 'center'
  }}>
            <img src={product.icon} alt={product.alt} className="w-3.5 h-3.5 mr-1.5 mt-2.5 mb-2.5 flex-shrink-0 align-middle" />
            <span className="font-medium mr-1 text-sm">{product.name} -</span>
            <span className="text-sm">{product.level}</span>
          </div>)}
      </div>
    </div>;
};

export const ScopesList = ({scopes = [], description = "Diese API erfordert einen der folgenden Bereiche:"}) => {
  if (!scopes || scopes.length === 0) {
    return null;
  }
  const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
  return <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

<AccordionGroup>
  <Accordion title="Unterstützte Produkte" defaultOpen="true" icon="cubes">
    <SupportedProducts marketing={true} marketingLevel="enterprise" sales={true} salesLevel="enterprise" service={true} serviceLevel="enterprise" cms={true} cmsLevel="enterprise" />
  </Accordion>

  <Accordion title="Bereichsanforderungen">
    <ScopesList
      scopes={[
  'analytics.behavioral_events.send'
]}
    />
  </Accordion>
</AccordionGroup>

<RelatedApiLink />

Benutzerdefinierte Events sind Account-definierte Events, die Event-Details in Event-Eigenschaften speichern. Sie können nicht nur [Ihren Tracking-Code anpassen](/api-reference/legacy/tracking-code-v1/overview), um Event-Daten an HubSpot zu senden, sondern auch Event-Abschlussdaten über diese API senden.

Im Folgenden erfahren Sie, wie Sie die API verwenden, um benutzerdefinierte Events zu erstellen und benutzerdefinierte Event-Daten zu senden bzw. abzurufen.

## Das Event definieren

Um Daten zu Event-Abschlüssen an HubSpot zu senden, müssen Sie zunächst das Event selbst definieren, einschließlich seiner Metadaten, CRM-Objektzuordnungen und Eigenschaften. Sie können Events mit der [„Benutzerdefinierte Event-Definition“-API](/api-reference/events-manage-event-definitions-v3/guide) definieren, oder wenn Sie ein ***Marketing Hub** Enterprise*-Abonnement haben, können Sie das [Event in HubSpot erstellen](https://knowledge.hubspot.com/de/analytics-tools/create-codeless-custom-behavioral-events). Bei der Erstellung des Events bietet HubSpot die Möglichkeit, eine Reihe von [Standard-Event-Eigenschaften](/api-reference/events-manage-event-definitions-v3/guide#hubspot-s-default-event-properties) einzubinden, die Sie zum Speichern von Event-Daten verwenden können. Sie können auch [zusätzliche Eigenschaften für das Event erstellen](/api-reference/events-manage-event-definitions-v3/guide#define-new-properties). Diese Eigenschaften können jederzeit erstellt oder bearbeitet werden.

Sobald Sie Ihr Event eingerichtet haben, können Sie Daten über die API oder durch [Anpassen Ihres HubSpot-Tracking-Codes](/api-reference/legacy/tracking-code-v1/overview) an das Event senden.

## Event-Daten senden

Um Event-Daten an HubSpot zu senden, führen Sie eine `POST`-Anfrage an `https://api.hubspot.com/events/v3/send` mit Ihren Event-Daten im Anforderungstext durch. Bevor Sie Event-Daten senden, überprüfen Sie die folgenden Beschränkungen, da ein Überschreiten dieser Beschränkungen zu einem Fehler führt.

```json theme={null}
{
  "eventName": "pe1234567_login_event",
  "objectId": "608051",
  "occurredAt": "2024-06-28T12:09:31Z",
  "properties": {
    "hs_city": "Cambridge",
    "hs_country": "United States",
    "hs_page_id": "53005768010",
    "hs_page_content_type": "LANDING_PAGE",
    "hs_device_type": "PDA;Smartphone",
    "hs_touchpoint_source": "DIRECT_TRAFFIC"
  }
}
```

| Parameter    | Typ          | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `eventName`  | Zeichenfolge | Der interne Name des Events. Sie finden ihn durch [Abfragen Ihrer bestehenden Event-Definitionen](/api-reference/events-manage-event-definitions-v3/guide#get-existing-event-definitions) oder [in der HubSpot-App](https://knowledge.hubspot.com/de/reports/create-custom-events#find-internal-name).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `objectId`   | Zeichenfolge | Die ID des CRM-Datensatzes, dem das Event zugeordnet wird. Bei Kontakten können Sie alternativ das `email`-Feld oder das `utk`-Feld verwenden, um den Kontakt anhand der E-Mail-Adresse oder des [HubSpot-Benutzer-Tokens](/api-reference/legacy/tracking-code-v1/overview) zu identifizieren. Alle anderen Objekttypen erfordern `objectId`, es sei denn, für das Event ist eine benutzerdefinierte übereinstimmende ID definiert. Wenn eine `customMatchingId` für das Event definiert ist, nimmt HubSpot Folgendes vor: Die `objectId` wird auf der Grundlage der konfigurierten Zuordnung automatisch festgelegt oder überschrieben. Weitere Informationen finden Sie in der [Anleitung für Definitionen für benutzerdefinierte Events](/api-reference/events-manage-event-definitions-v3/guide#create-an-event-definition).                                                                                                                                                                                                                                                                                                                               |
| `occurredAt` | Zeichenfolge | Standardmäßig legt HubSpot den Zeitstempel für den Abschluss des Events auf den Zeitpunkt fest, an dem die Anfrage gesendet wird. Um die Zeit des Event-Abschlusses anzugeben, fügen Sie einen Zeitstempel in ein `occurredAt`-Feld im `POST`-Anforderungstext ein ([ISO 8601-Format](https://en.wikipedia.org/wiki/ISO_8601)). Dies kann besonders für die Rückdatierung von Event-Daten hilfreich sein, um die genaue Zeit der Event-Abschlüsse besser widerzuspiegeln.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `properties` | Objekt       | Die Event-Eigenschaften, an die Daten gesendet werden sollen. Dies kann die [Standard-Event-Eigenschaften von HubSpot](/api-reference/events-manage-event-definitions-v3/guide#hubspot-s-default-event-properties) oder jede [benutzerdefinierte Eigenschaft](/api-reference/events-manage-event-definitions-v3/guide#define-new-properties) umfassen, die Sie für die Event definiert haben. Die meisten Standard-Event-Eigenschaften sind Zeichenfolgeneigenschaften, aber Sie können alle Event-Eigenschaften überprüfen, indem Sie entweder die [Event Definition abfragen](/api-reference/events-manage-event-definitions-v3/guide#get-existing-event-definitions) oder zum Event in HubSpot gehen. Wenn eine benutzerdefinierte, übereinstimmende ID [für das Event](/api-reference/events-manage-event-definitions-v3/guide#create-an-event-definition) eingerichtet ist, können Sie die `objectId` weglassen. HubSpot versucht, das Event mit einem CRM-Objekt zu verknüpfen, indem die `objectId` zum Event basierend auf der konfigurierten Zuordnung festgelegt wird. Erfahren Sie im Folgenden mehr über [Event-Eigenschaften](#event-properties). |

<Warning>
  ### Hinweis:

  Ein Überschreiten einer der folgenden Beschränkungen führt zu einer fehlgeschlagenen Anfrage:

  * Das Eigenschaftslabel und der interne Name sind auf 50 Zeichen begrenzt.
  * URL- und Referrer-Eigenschaften können bis zu 1.024 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 sowie Unterstriche enthalten.
  * Eigenschaften mit dem gleichen internen Namen nach der Kleinschreibung werden als Duplikate betrachtet, und nur eine der Eigenschaften wird beim Abschluss verwendet. HubSpot sortiert in aufsteigender lexikografischer Reihenfolge, wobei die zuletzt angezeigte Eigenschaft unter den ersten 50 Eigenschaften beibehalten wird.
  * Es gibt ein Limit von 500 eindeutigen Event-Definitionen pro Account.
  * Es gibt ein Limit von 30 Millionen Event-Abschlüssen pro Monat.
</Warning>

## Event-Daten abrufen

Um die [Event-Daten abzurufen](/api-reference/events-manage-event-definitions-v3/guide#get-%2Fevents%2Fv3%2Fevents%2F), führen Sie eine `GET`-Anfrage an `/events/v3/events` durch.

* Um alle Event-Abschlüsse für ein bestimmtes Event zurückzugeben, fügen Sie den `eventType`-Parameter zusammen mit dem internen Event-Namen ein (z. B. `pe123456_custom_event`). Sie können alle Event-Typen mit der [Event-Analytics-API](/api-reference/events-manage-event-definitions-v3/guide#get-%2Fevents%2Fv3%2Fevents%2Fevent-types) abrufen.
* Um Event-Abschlüsse für ein bestimmtes Objekt zurückzugeben, schließen Sie den `objectType`-Parameter zusammen mit den `objectId`-Parametern oder `objectProperty.<property>` ein. Unter `objectType` sollte der Typ des CRM-Objekts angegeben werden (z. B. `contact`), während die anderen Parameter den eindeutigen Bezeichnerwert für das Objekt angeben (entweder die Datensatz-ID oder einen „Eindeutige ID“-Eigenschaftswert). Für Kontakte können Sie `email` als eindeutige Eigenschaft zur Identifizierung verwenden.

Um beispielsweise alle Events abzurufen, die von einem bestimmten Kontakt abgeschlossen wurden, könnte Ihre Anfrage-URL wie folgt lauten:

`/events/v3/events?objectType=contact&objectId=111111`.

Alternativ können Sie auch die E-Mail-Adresse des Kontakts verwenden:

`/events/v3/events?objectType=contacts&objectProperty.email=bilbo@shire.com`

Um die Ergebnisse nach Event-Abschlüssen mit einem bestimmten Event-Eigenschaftswert zu filtern, können Sie den `property.<propertyName>`-Parameter einschließen. Um beispielsweise Events rund um Seitenbesuche Ihrer Homepage abzurufen, könnte Ihre Anfrage-URL wie folgt lauten:

`/events/v3/events?eventType=e_visited_page&property.hs_page_title=home`

<Info>
  Ersetzen Sie bei Eigenschaftenwerten mit Leerzeichen die Leerzeichen durch
  entweder `%20` oder `+`. Zum Beispiel: `property.hs_page_title=home+page`.
</Info>

[In der Referenzdokumentation](/api-reference/events-manage-event-definitions-v3/guide#get-%2Fevents%2Fv3%2Fevents%2F) erfahren Sie mehr über die verfügbaren Parameter.

## Event-Eigenschaften

Daten zu Event-Abschlüssen werden in Event-Eigenschaften gespeichert, entweder im Satz der [Standard-Event-Eigenschaften](/api-reference/events-manage-event-definitions-v3/guide#hubspot-s-default-event-properties) oder in [benutzerdefinierten Eigenschaften](/api-reference/events-manage-event-definitions-v3/guide#define-new-properties). Fügen Sie beim Senden von Event-Daten ein `properties`-Objekt mit Schlüssel-Wert-Paaren für die Eigenschaften, die Sie aktualisieren möchten, zusammen mit den zu speichernden Eigenschaftswerten ein.

```json theme={null}
"properties": {
    "property1": "string",
    "property2": "string",
    "property3": "string"
  }
```

Welche Werte Sie senden, hängt vom Typ der Event Eigenschaft ab. Die meisten Standard-Event-Eigenschaften sind einzeiliger Text (Zeichenfolge). Sie können jedoch benutzerdefinierte Eigenschaften beliebigen Typs für jedes Event erstellen. Überprüfen Sie die folgende Tabelle, wenn Sie Eigenschaftswerte formatieren.

| Eigenschaftstyp | Beschreibung                                                                                                                                                                                                                                                                                                                                                |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `bool`          | Ein boolescher Wert, entweder `true` oder `false`.                                                                                                                                                                                                                                                                                                          |
| `enumeration`   | Eine Zeichenfolge, die eine Reihe von Optionen enthält. Trennen Sie beim Senden mehrerer Werte diese durch ein Semikolon. In HubSpot entspricht dieser Typ Dropdown-Auswahl-, Optionsfeld-Auswahl und „Mehrere Kontrollkästchen“-Eigenschaften.                                                                                                             |
| `date`          | Ein Wert, der einen bestimmten Tag, einen bestimmten Monat und ein bestimmtes Jahr darstellt. Werte müssen in UTC-Zeit angegeben werden und können als [ISO 8601-Zeichenfolgen](/api-reference/crm-properties-v3/guide#add-values-to-date-and-datetime-properties) oder EPOCH-Zeitstempel in Millisekunden (z. B. Mitternacht UTC) formatiert werden.       |
| `datetime`      | Ein Zeitstempel, der einen bestimmten Tag, einen bestimmten Monat, ein bestimmtes Jahr und eine bestimmte Uhrzeit darstellt. Werte müssen in UTC-Zeit angegeben werden und können als [ISO 8601-Zeichenfolgen oder UNIX-Zeitstempel in Millisekunden](/api-reference/crm-properties-v3/guide#add-values-to-date-and-datetime-properties) formatiert werden. |
| `number`        | Ein Zahlenwert mit numerischen Ziffern und höchstens einer Dezimalstelle. In HubSpot entspricht dieser Typ Zahlen- und berechneten Eigenschaften.                                                                                                                                                                                                           |
| `string`        | Eine Klartext-Zeichenfolge, die auf 65.536 Zeichen begrenzt ist. In HubSpot entspricht dieser Typ Eigenschaften Eigenschaften der Typen „Einzeiliger Text“ und „Mehrzeiliger Text“.                                                                                                                                                                         |

So zeigen Sie die verfügbaren Eigenschaften eines Events an:

* Gehen Sie in Ihrem HubSpot-Account zu **Datenmanagement** > **Benutzerdefinierte Events**.
* Klicken Sie in der Tabelle auf den **Namen** des Events.
* Klicken Sie oben auf die Registerkarte **Eigenschaften**.
* Zeigen Sie in der Eigenschaftentabelle den Eigenschaftstyp unter dem Namen der Eigenschaft an.

<Frame>
  <img src="https://www.hubspot.de/hubfs/Knowledge_Base_2021/Developer/custom-event-properties-table.png" alt="custom-event-properties-table" />
</Frame>

## Attribution-Berichterstattung

JavaScript-Events wie Events vom Typ [Angeklicktes Element](https://knowledge.hubspot.com/de/analytics-tools/create-codeless-custom-behavioral-events) und [Aufgerufene URL](https://knowledge.hubspot.com/de/analytics-tools/create-codeless-custom-behavioral-events) werden automatisch mit Ressourcentyp- und Interaktionsdaten für Attribution-Berichte ausgefüllt. Um die gleichen Daten für manuell nachverfolgte Events zu berücksichtigen, müssen Sie die Daten manuell mithilfe von Event-Eigenschaften in den Anforderungstext aufnehmen. Erfahren Sie mehr über das [Analysieren von benutzerdefinierten Events](https://knowledge.hubspot.com/de/analytics-tools/analyze-custom-behavioral-events).

Im Folgenden erfahren Sie mehr über die verfügbaren Werte für Ressourcentypen und Interaktionsquellen sowie Beispielanfragen.

### Elementtyp

Um einen bestimmten Elementtyp einer benutzerdefinierten Event-Anfrage zuzuschreiben, fügen Sie die `hs_page_content_type`-Eigenschaft in den Anforderungstext ein. Zum Beispiel:

```json theme={null}
{
  "eventName": "pe1234567_manually_tracked_event",
  "properties": {
    "hs_page_id": "53005768010",
    "hs_page_content_type": "LANDING_PAGE"
  },
  "objectId": "6091051"
}
```

<Info>
  Sie können auch die `hs_asset_type`-Eigenschaft verwenden. Wenn sowohl `hs_page_content_type` als auch `hs_asset_type` in einer Anfrage enthalten sind, überschreibt `hs_page_content_type` den `hs_asset_type`-Wert.
</Info>

Die Standardinhaltstypen von HubSpot, wie Landingpages und Blogbeiträge, können mit den folgenden Werten dargestellt werden:

| Wert                | Beschreibung                                        |
| ------------------- | --------------------------------------------------- |
| `STANDARD_PAGE`     | Eine Interaktion mit einer Website-Seite.           |
| `LANDING_PAGE`      | Eine Interaktion mit einer Landingpage.             |
| `BLOG_POST`         | Eine Interaktion mit einem Blogbeitrag.             |
| `KNOWLEDGE_ARTICLE` | Eine Interaktion mit einem Wissensdatenbankartikel. |

Verwenden Sie für alle anderen Elementtypen die folgenden Werte:

| Wert                           | Beschreibung                                                                                      |
| ------------------------------ | ------------------------------------------------------------------------------------------------- |
| `AD`                           | Eine Interaktion mit einer Anzeige, z. B. einer Facebook- oder Google-Anzeige.                    |
| `CALL`                         | Eine Interaktion mit einem Anruf.                                                                 |
| `CONTACT_IMPORT`               | Eine Interaktion über einen Kontaktimport.                                                        |
| `CONVERSATION`                 | Eine Interaktion im Zusammenhang mit einer HubSpot-Konversation.                                  |
| `CUSTOM_BEHAVIORAL_EVENT_NAME` | Der interne Name eines benutzerdefinierten Events, z. B. `pe123456_manually_tracked_event`.       |
| `EMAIL`                        | Eine Interaktion mit einer E-Mail.                                                                |
| `EXTERNAL_PAGE`                | Eine Interaktion mit einer externen Seite.                                                        |
| `INTEGRATIONS`                 | Eine Interaktion über eine Integration.                                                           |
| `MARKETING_EVENT`              | Eine Interaktion mit einem [Marketingevent](/api-reference/marketing-marketing-events-v3/guide).  |
| `MEDIA_BRIDGE`                 | Eine Interaktion über die [Media Bridge](/api-reference/cms-media-bridge-v1/guide).               |
| `MEETING`                      | Eine Interaktion mit einem Meeting.                                                               |
| `SALES_EMAIL`                  | Interaktion mit einer persönlichen Vertriebs-E-Mail.                                              |
| `SEQUENCE`                     | Eine Interaktion mit einer Sequenz.                                                               |
| `SOCIAL_POST`                  | Eine Interaktion mit einem Social-Media-Beitrag.                                                  |
| `OTHER`                        | Eine Interaktion mit einem Inhaltselement, das nicht in eine der oben genannten Kategorien fällt. |

### Elementtitel

Um ein benutzerdefiniertes Event einem Element zuzuschreiben, schließen Sie die `hs_page_title`- oder `hs_asset_title`-Eigenschaft mit einem als Zeichenfolge formatierten Namen des Elements in Ihre Anfrage ein. Zum Beispiel:

`hs_page_title:`

```json theme={null}
{
  "eventName": "pe1234567_manually_tracked_event",
  "properties": {
    "hs_page_title": "Sweepstakes Sign Up",
    "hs_page_content_type": "LANDING_PAGE"
  },
  "objectId": "6091051"
}
```

### Interaktionsquellen

Um ein benutzerdefiniertes verhaltensorientiertes Event einer bestimmten Quelle zuzuschreiben, schließen Sie die `hs_touchpoint_source`-Eigenschaft in Ihre Anfrage mit einem der folgenden Werte ein:

| Wert              | Beschreibung                                                                                         |
| ----------------- | ---------------------------------------------------------------------------------------------------- |
| `CONVERSATION`    | Die Interaktionsquelle ist eine Konversation.                                                        |
| `DIRECT_TRAFFIC`  | Die Interaktionsquelle ist direkter Traffic.                                                         |
| `EMAIL_MARKETING` | Die Interaktionsquelle ist eine Marketing-E-Mail.                                                    |
| `HUBSPOT_CRM`     | Die Interaktionsquelle ist das HubSpot-CRM.                                                          |
| `INTEGRATION`     | Die Interaktionsquelle ist eine Integration.                                                         |
| `MARKETING_EVENT` | Die Interaktionsquelle ist ein [Marketingevent](/api-reference/marketing-marketing-events-v3/guide). |
| `OFFLINE`         | Die Interaktionsquelle ist offline.                                                                  |
| `ORGANIC_SEARCH`  | Die Interaktionsquelle ist die organische Suche.                                                     |
| `OTHER_CAMPAIGNS` | Die Interaktionsquelle ist von einer nicht kategorisierten Kampagne.                                 |
| `PAID_SEARCH`     | Die Interaktionsquelle ist eine bezahlte Suchanzeige.                                                |
| `PAID_SOCIAL`     | Die Interaktionsquelle ist eine bezahlte Social-Media-Anzeige.                                       |
| `REFERRALS`       | Die Interaktionsquelle ist eine Empfehlung.                                                          |
| `SALES`           | Die Interaktionsquelle ist der Vertrieb.                                                             |
| `SOCIAL_MEDIA`    | Die Interaktionsquelle ist Social Media (keine bezahlten Social-Media-Anzeigen).                     |