# Eigene Felder

> Definieren Sie eigene Felder für Ihre Kontakte, setzen Sie ihre Werte in der Weboberfläche, per Import und per API und verwenden Sie sie in Filtern, Kampagnen-Platzhaltern und Automatisierungen.

Eigene Felder speichern zusätzliche Daten zu jedem Kontakt, etwa einen Firmennamen, einen Tarif oder einen Geburtstag. Sie definieren die Felder einmal für den Workspace, füllen sie dann bei den Kontakten aus und verwenden sie, um Kontakte zu filtern, Kampagnen zu personalisieren und Automatisierungen zu starten.

## Feldtypen

| Typ | Gespeicherter Wert | Beispiel | Eingabe in der Weboberfläche |
| --- | --- | --- | --- |
| **Text** | String | `"Acme"` | Textfeld |
| **Number** | Zahl | `42` | Zahlenfeld |
| **Date** | Kalenderdatum, `YYYY-MM-DD` | `"1990-04-12"` | Datumsauswahl |
| **Boolean** | `true` oder `false` | `true` | Checkbox |
| **Select** | Eine Option | `"pro"` | Dropdown |
| **Multi select** | Array von Optionen | `["news", "offers"]` | Dropdown mit Mehrfachauswahl |

Jedes Feld hat einen **Namen**, den die Weboberfläche anzeigt, und einen **Schlüssel**, den API, Importe, Filter und Platzhalter verwenden. Die Werte werden beim Kontakt als JSON-Objekt gespeichert, mit dem Feldschlüssel als Schlüssel:

```json
{
  "company": "Acme",
  "plan": "pro",
  "birthday": "1990-04-12",
  "interests": ["news", "offers"]
}
```

## Eigenes Feld erstellen

1. **Custom fields öffnen.** Öffnen Sie **Workspace → Settings → Custom fields** und wählen Sie **Add custom field**.

2. **Feld benennen.** Geben Sie einen **Name** ein, zum Beispiel `Company size`. Emailit bildet den Schlüssel automatisch aus dem Namen: in Kleinbuchstaben, wobei jede Folge anderer Zeichen durch `_` ersetzt wird. Aus `Company size` wird so `company_size`.

   Um den Schlüssel selbst zu wählen, wählen Sie **Show advanced options** und bearbeiten Sie **Key**. Schlüssel werden immer in dieser Form mit Kleinbuchstaben und Unterstrichen gespeichert, und jeder Schlüssel darf pro Workspace nur einmal vorkommen.

3. **Typ auswählen.** Wählen Sie **Text**, **Number**, **Date**, **Boolean**, **Select** oder **Multi select**.

4. **Optionen für Auswahlfelder hinzufügen.** Geben Sie für **Select** und **Multi select** mindestens eine Option ein und fügen Sie mit **Add option** weitere hinzu. Diese Werte erscheinen im Dropdown bei den Kontakten.

5. **Speichern.** Wählen Sie **Create**. Das Feld erscheint bei jedem Kontakt, in den Kontaktfiltern und als Platzhalter in den Kampagnen-Editoren.

Die Seite Custom fields listet jedes Feld mit Name, Typ und Optionen auf. Mit **Edit** benennen Sie ein Feld um, ändern seinen Typ oder Schlüssel oder bearbeiten seine Optionen.

> **Feld löschen:** Wenn Sie ein eigenes Feld löschen, wird es aus Weboberfläche, Filtern, Importen und Platzhaltern entfernt. Das lässt sich nicht rückgängig machen. Bevor Sie einen Schlüssel ändern oder löschen, aktualisieren Sie alle Kampagnen, Automatisierungen und den API-Code, die ihn verwenden.

## Werte setzen

| Wo | Wie |
| --- | --- |
| Weboberfläche | **Add contact** oder **Edit** bei einem Kontakt. Wählen Sie **Show custom fields**, um die Eingabefelder zu sehen. |
| Import | Ordnen Sie im Import-Assistenten eine Spalte der Datei dem eigenen Feld zu. Siehe [Kontakte importieren und exportieren](/de/docs/contacts/import-export/). |
| API | Senden Sie ein Objekt `custom_fields` mit den Feldschlüsseln als Schlüsseln. |

Per API übergeben Sie `custom_fields` an [Kontakt erstellen](/de/docs/api-reference/contacts/create/) oder [Kontakt aktualisieren](/de/docs/api-reference/contacts/update/):

```bash
curl https://api.emailit.com/v2/contacts/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_fields": {
      "company": "Acme",
      "plan": "pro",
      "birthday": "1990-04-12",
      "interests": ["news", "offers"]
    }
  }'
```

Wichtige Regeln:

- **`custom_fields` ersetzt das gesamte Objekt.** Geben Sie beim Aktualisieren jeden Wert an, den Sie behalten möchten, nicht nur die geänderten.
- **Verwenden Sie Feldschlüssel, keine Namen.** Werte für Schlüssel, die unter **Custom fields** nicht definiert sind, werden gespeichert, erscheinen aber nicht in der Weboberfläche.
- **Datumsangaben müssen das Format `YYYY-MM-DD` haben.** Emailit wandelt ISO-Datums- und Zeitangaben sowie Datumszellen aus Excel in ein Datum um. Alles andere gibt `400` mit „Custom field "Birthday" must be a date in YYYY-MM-DD format“ zurück. Datumsangaben haben keine Uhrzeit und keine Zeitzone.
- **Auswahlwerte werden nicht gegen die Optionen geprüft.** Ein Wert, der nicht in der Optionsliste steht, wird trotzdem gespeichert, und die Weboberfläche zeigt ihn weiterhin an.

## Kontakte nach einem eigenen Feld filtern

Öffnen Sie in der Weboberfläche **Email Marketing → Contacts**, wählen Sie **Filter** und dann das eigene Feld anhand seines Namens. Filter für eigene Felder vergleichen den gespeicherten Wert als Text. Verwenden Sie daher **equals**, **does not equal**, **contains**, **does not contain**, **starts with**, **ends with**, **is empty** oder **is not empty**.

Per API verwenden Sie `custom_fields.<key>.<condition>` bei [Kontakte auflisten](/de/docs/api-reference/contacts/list/) und [Kontakte exportieren](/de/docs/api-reference/contacts/export/), mit denselben Textbedingungen (`exact`, `not_exact`, `contains`, `not_contains`, `starts_with`, `ends_with`, `empty`, `not_empty`):

```bash
curl "https://api.emailit.com/v2/contacts?custom_fields.plan.exact=pro&custom_fields.company.contains=acme" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

Für einen Bereich, etwa Geburtstage in den 1990er-Jahren, verwenden Sie die Parameter `filter[custom_fields.<key>][gte]` und `[lte]`. Sie vergleichen den gespeicherten Text, der bei Datumsangaben im Format `YYYY-MM-DD` richtig sortiert:

```bash
curl -G "https://api.emailit.com/v2/contacts" \
  --data-urlencode "filter[custom_fields.birthday][gte]=1990-01-01" \
  --data-urlencode "filter[custom_fields.birthday][lte]=1999-12-31" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

Wie Filter kombiniert werden, erfahren Sie unter [Filtern](/de/docs/api-reference/filtering/).

## Eigene Felder in Kampagnen verwenden

Fügen Sie in Inhalte und Betreffzeilen von Kampagnen ein eigenes Feld mit dem Platzhalter `{{cf.<key>}}` ein, zum Beispiel `{{cf.company}}`. Der Rich-Text-Editor und Dragit listen Ihre eigenen Felder bei ihren Variablen auf, sodass Sie den Schlüssel nicht tippen müssen.

```html
<p>Hi {{first_name}}, here's what's new for {{cf.company}}.</p>
```

Hat ein Kontakt keinen Wert, wird der Platzhalter durch nichts ersetzt. Werte von Mehrfachauswahlfeldern werden als kommagetrennte Liste ausgegeben. Siehe [Platzhalter](/de/docs/campaigns/merge-tags/).

## Eigene Felder in Automatisierungen verwenden

- **Trigger Date anniversary.** Wählen Sie ein Feld vom Typ **Date**, um jedes Jahr an dem darin gespeicherten Monat und Tag einen Durchlauf zu starten, etwa an einem Geburtstag. Siehe [Trigger](/de/docs/automations/triggers/#date-anniversary).
- **Trigger Contact updated.** Filtern Sie nach einem eigenen Feld oder nach seinem vorherigen Wert, um auf Änderungen zu reagieren.
- **Schritt Condition.** Verzweigen Sie anhand des Werts eines eigenen Felds.
- **Schritt Edit contact.** Setzen Sie ein eigenes Feld, indem Sie seinen Schlüssel eingeben.

## API-Referenz

Die Definitionen eigener Felder werden nur in der Weboberfläche verwaltet. Die Werte von Kontakten verwenden das Objekt `custom_fields` der [API für Kontakte](/de/docs/api-reference/contacts/), und dasselbe Objekt wird akzeptiert, wenn Sie einer Kontaktliste [einen Abonnenten hinzufügen](/de/docs/api-reference/audiences/subscribers/add/).

## Siehe auch

  - [Kontakte](/de/docs/contacts/): Wie Kontakte, Kontaktlisten und Abonnenten zusammenhängen.
  - [Platzhalter](/de/docs/campaigns/merge-tags/): Kampagnen mit Kontaktdaten personalisieren.

---
Quelle: https://emailit.com/de/docs/contacts/custom-fields/