> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudgen.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Kontakte hochladen

> CSV-Format, Validierungsregeln und Tag-Zuweisung für den Kontakt-Upload

## Was diese Seite Ihnen bietet

Laden Sie eine CSV-Datei mit Kontakten hoch, um Kampagnen zu starten. Sie erfahren hier alles über erforderliche Spalten, Validierungsregeln, Größenbeschränkungen und wie Sie beim Upload Tags hinzufügen.

## Bevor Sie beginnen

* Ein Nudgen-Konto
* Eine CSV-Datei mit mindestens einer `email`-Spalte
* Die Anzahl der Kontakte muss innerhalb Ihres Plan-Limits liegen (siehe [Abrechnung](/de/billing/overview))

## Schritt 1: Bereiten Sie Ihre CSV-Datei vor

Ihre CSV muss folgendes enthalten:

| Spalte  | Erforderlich | Beschreibung                                 |
| ------- | ------------ | -------------------------------------------- |
| `email` | Ja           | Gültige E-Mail-Adresse. Muss eindeutig sein. |
| `name`  | Nein         | Anzeigename für die Personalisierung.        |

Sie können weitere Spalten hinzufügen (z. B. `company`, `segment`). Diese werden verschlüsselt gespeichert und können in Tags oder in der Segmentierungslogik verwendet werden.

## Schritt 2: Format validieren

* **Codierung:** UTF-8 wird empfohlen.
* **Trennzeichen:** Komma (`,`).
* **Kopfzeile:** Die erste Zeile muss die Spaltennamen enthalten. `email` und `name` werden unabhängig von Groß-/Kleinschreibung erkannt.
* **Doppelte E-Mails:** Duplikate in derselben Datei werden zusammengeführt. Bestehende Kontakte mit derselben E-Mail werden aktualisiert.

<Warning>
  Ungültige E-Mails (falsches Format, fehlendes `@` usw.) werden übersprungen. Prüfen Sie die Upload-Zusammenfassung, um zu sehen, wie viele Zeilen importiert vs. übersprungen wurden.
</Warning>

## Schritt 3: In Nudgen hochladen

1. Gehen Sie in der Seitenleiste auf **Kontakte**.
2. Klicken Sie auf **Upload CSV**.
3. Wählen Sie Ihre Datei aus.
4. Wählen Sie Tags aus, die auf alle hochgeladenen Kontakte angewendet werden sollen (z. B. `inactive`, `re-engage`).
5. Prüfen Sie die Vorschau und bestätigen Sie den Vorgang.

## Größenbeschränkungen

* **Dateigröße:** Beachten Sie das Limit auf dem Bildschirm (normalerweise ein paar MB). Große Listen können länger in der Verarbeitung dauern.
* **Kontakte pro Workspace:** Hängt von Ihrem Plan ab. Die App prüft das Limit beim Upload; wird es überschritten, wird der Upload abgelehnt. Aktuelle Limits finden Sie unter [Abrechnung](/de/billing/overview) und auf der [Preisseite](https://nudgen.net/pricing).

## Nächste Schritte

* Kontakte erscheinen in der Liste mit maskierten E-Mails (`j***@g***.com`).
* Nutzen Sie Tags, um Zielgruppen in [Kampagnen](/de/campaigns/create) zu segmentieren.
* Als Account-Inhaber können Sie einzelne Kontakte [enthüllen](/de/contacts/overview).

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Einige Zeilen wurden übersprungen">
    Prüfen Sie, ob jede Zeile eine gültige Adresse in der Spalte `email` hat. Leere Zeilen oder fehlerhafte Adressen werden ignoriert.
  </Accordion>

  <Accordion title="Upload fehlgeschlagen: Plan-Limit überschritten">
    Die Anzahl Ihrer Kontakte würde Ihr Plan-Limit überschreiten. Aktualisieren Sie Ihren Plan oder löschen Sie bestehende Kontakte.
  </Accordion>

  <Accordion title="Spalte nicht erkannt">
    Stellen Sie sicher, dass die Kopfzeile `email` (oder `Email`) enthält. Andere Spalten sind optional.
  </Accordion>
</AccordionGroup>

## Verwandte Dokumente

<CardGroup cols={2}>
  <Card title="Kontakte Übersicht" icon="users" href="/de/contacts/overview">
    Verschlüsselung, Maskierung und Segmentierung.
  </Card>

  <Card title="Kampagnen erstellen" icon="paper-plane" href="/de/campaigns/create">
    Wählen Sie die Zielgruppe und starten Sie eine Kampagne.
  </Card>
</CardGroup>