Kontakte

Ein Kontakt ist eine Person in Ihrem Workspace, identifiziert durch ihre E-Mail-Adresse. Kontakte enthalten die Namen und Werte eigener Felder, mit denen Sie Kampagnen personalisieren, und sie treten Kontaktlisten bei, also den Listen, an die Kampagnen senden. Diese Seite erklärt, wie die Teile zusammenhängen und was Sie in der Weboberfläche und per API mit Kontakten tun können.

Kontakte, Kontaktlisten und Abonnenten

Emailit trennt Personen und Listen. Eine Person existiert einmal als Kontakt, und jede Liste, auf der sie steht, ist ein eigener Abonnenten-Datensatz mit eigenem Opt-in-Status.

Workspace
├── Contacts ────────────── one per email address
│   ├── email, first_name, last_name, custom_fields
│   └── marketing status (unsubscribed: true | false)
└── Audiences ───────────── named lists, for example "Newsletter"
    └── Subscribers ─────── one per contact on the list
        └── subscribed: true | false

In der Praxis:

• Ein Kontakt kann Abonnent vieler Kontaktlisten sein, mit einem eigenen Kennzeichen Subscribed in jeder.
• Wenn Sie jemanden per E-Mail-Adresse zu einer Kontaktliste hinzufügen, wird zuerst der Kontakt angelegt, falls er noch nicht existiert.
• Namen und eigene Felder gehören zum Kontakt. Wenn Sie sie über eine Kontaktliste bearbeiten, ändert sich der Kontakt, und die Änderung erscheint überall.

Wer eine Kampagne erhält

Eine Kampagne geht an jeden Kontakt, der alle drei Bedingungen erfüllt:

1. Der Kontakt ist Abonnent mindestens einer der Kontaktlisten der Kampagne, mit aktiviertem Subscribed.
2. Der Marketing-Status des Kontakts ist Subscribed.
3. Die Adresse steht nicht auf Ihrer Sperrliste.

Ein Kontakt in mehreren der ausgewählten Kontaktlisten erhält nur ein Exemplar. Die vollständigen Regeln finden Sie unter Kampagne erstellen.

Marketing-Status

Jeder Kontakt hat außerdem einen workspaceweiten Marketing status: Subscribed oder Unsubscribed (das Feld unsubscribed in der API). Das ist ein globales Opt-out, das über dem Kennzeichen pro Kontaktliste steht.

Marketing-Status und Anmeldungen bei Kontaktlisten steuern nur Kampagnen. Sie blockieren keine E-Mails, die Sie per API oder SMTP senden, und keine E-Mails von Automatisierungen. Um alle E-Mails an eine Adresse zu stoppen, fügen Sie sie Ihren Sperrungen hinzu. Abmeldungen behandelt jeden Weg zum Opt-out.

Die Seite Contacts

Öffnen Sie Email Marketing›Contacts, um alle Kontakte im Workspace zu sehen, die neuesten zuerst.

• Spalten. Email wird immer angezeigt. Blenden Sie First name, Last name, Audiences, Created und Updated unter Display options > Edit columns ein oder aus, oder wählen Sie Show full name, um die Namen in einer Spalte Name zusammenzuführen. In der Spalte Audiences ist jedes Badge einer Kontaktliste grün, solange der Kontakt dort angemeldet ist, und rot, nachdem er sich abgemeldet hat.
• Suche findet Treffer in E-Mail-Adresse, Vorname und Nachname.
• Filtern Sie nach Email, Name, First name, Last name, Unsubscribed, Created, Updated, Audiences oder Audience sowie nach jedem eigenen Feld. Bei zwei oder mehr Filtern wählen Sie, ob alle oder nur einer zutreffen müssen.
• Sortieren Sie, indem Sie eine Spaltenüberschrift wählen.
• Import und Export übertragen Kontakte als Dateien. Siehe Kontakte importieren und exportieren.

Wählen Sie eine Zeile, um den Kontakt zu öffnen. Das Zeilenmenü enthält Edit und Delete.

Kontakt hinzufügen

Wählen Sie Add contact und geben Sie Email sowie optional First name, Last name und Audiences ein. Wählen Sie Show custom fields, um Werte eigener Felder einzutragen. Eine E-Mail-Adresse kann pro Workspace nur einmal existieren. Das Hinzufügen einer bestehenden Adresse schlägt daher fehl.

Um einen Kontakt später zu ändern, wählen Sie Edit. Sie können die Namen und eigenen Felder ändern. Die E-Mail-Adresse lässt sich in der Weboberfläche nicht ändern. Verwenden Sie stattdessen das Feld email von Kontakt aktualisieren.

Massenaktionen

Wählen Sie Kontakte über die Checkboxen aus (die Checkbox in der Kopfzeile wählt die ganze Seite) und öffnen Sie dann Actions. Jede Aktion gilt für bis zu 100 Kontakte auf einmal.

Die Kontaktseite

Die Kontaktseite zeigt alles, was Emailit über eine Person weiß. Oben finden Sie Edit und Delete.

Per API nutzen

Die API für Kontakte deckt alles ab, was Liste und Profil können, außer dem Import von Dateien:

• Kontakte erstellen, abrufen, aktualisieren, auflisten und löschen. Überall, wo eine ID erwartet wird, können Sie statt der con_-ID die E-Mail-Adresse des Kontakts übergeben.
• Übergeben Sie beim Erstellen eines Kontakts audiences (ein Array von aud_-IDs), um ihn sofort anzumelden. Beim Aktualisieren ersetzt audiences die Mitgliedschaften des Kontakts.
• Massenaktion ausführen für bis zu 100 Kontakte und bis zu 10.000 Kontakte als CSV oder XLSX exportieren.

curl https://api.emailit.com/v2/contacts \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Acme", "plan": "pro" },
    "audiences": ["aud_2kq8Vt4xLm7Rz"]
  }'

Das Erstellen eines Kontakts mit einer bereits vorhandenen E-Mail-Adresse gibt 409 mit dem bestehenden Kontakt in existing zurück. Die API für Kontakte erfordert einen API-Schlüssel mit Full Access.

Änderungen an Kontakten erzeugen die Events contact.created, contact.updated und contact.deleted, Änderungen an Mitgliedschaften die Events subscriber.*. Beide können Sie per Webhooks empfangen.

Nächste Schritte