Kontaktlisten

Eine Kontaktliste ist eine benannte Liste von Kontakten, etwa „Newsletter“ oder „Produkt-Updates“. Sie wählen eine oder mehrere Kontaktlisten als Empfänger einer Kampagne und können Personen von Hand, per Import, per API oder über eine gehostete Anmelde-URL zu einer Kontaktliste hinzufügen.

So funktionieren Kontaktlisten

Jede Person auf einer Kontaktliste ist ein Abonnent: eine Verknüpfung zwischen einem Kontakt und der Kontaktliste, mit einem eigenen Kennzeichen Subscribed. Derselbe Kontakt kann auf mehreren Kontaktlisten stehen und bei einigen angemeldet, bei anderen abgemeldet sein.

• Kampagnen senden an Abonnenten, deren Kennzeichen Subscribed gesetzt ist, deren Kontakt nicht global abgemeldet ist und deren Adresse nicht gesperrt ist. Ein Kontakt auf mehreren ausgewählten Kontaktlisten erhält nur ein Exemplar.
• Abmelden entfernt das Kennzeichen, lässt den Abonnenten aber auf der Liste, sodass der Verlauf erhalten bleibt. Siehe Abmeldungen.
• Einen Abonnenten löschen entfernt die Person von der Liste. Der Kontakt bleibt in Ihrem Workspace.

Die Seite Audiences

Öffnen Sie Email Marketing›Audiences, um Ihre Kontaktlisten mit Name, Subscribers und dem Datum Created zu sehen. Die Spalte Subscribers zeigt, wie viele Abonnenten jede Kontaktliste im Verhältnis zum Limit Ihres Tarifs hat, zum Beispiel 1.2k/10k. Über das Zeilenmenü können Sie eine Kontaktliste mit Manage subscribers verwalten, mit Rename umbenennen oder mit Delete löschen.

Um eine Kontaktliste zu erstellen, wählen Sie Create audience, geben einen Name ein und wählen Create. Namen müssen im Workspace eindeutig sein.

Die Seite einer Kontaktliste

Öffnen Sie eine Kontaktliste, um ihre Abonnenten zu verwalten. Die Kopfzeile zeigt die Zahl der Abonnenten und das Limit-Badge sowie diese Aktionen:

Darunter listet die Abonnententabelle Email, First name, Last name, Subscribed und Created auf, mit Suche, Filtern und einem Zeilenmenü, um jeden Abonnenten mit Edit zu bearbeiten oder mit Delete zu löschen. Siehe Abonnenten verwalten.

Limits

Jeder Tarif begrenzt, wie viele Abonnenten eine Kontaktliste haben kann. Die Zahl der Kontaktlisten ist nicht begrenzt.

Das Limit zählt jeden Abonnenten der Kontaktliste, auch Personen, die sich abgemeldet haben. Um Platz zu schaffen, löschen Sie Abonnenten, die Sie nicht mehr brauchen, wechseln Sie in einen höheren Tarif oder beantragen Sie mit Request Increase auf der Karte Sending Limits der Startseite der Weboberfläche ein höheres Limit.

Ist eine Kontaktliste voll, ist Add subscriber deaktiviert, und jeder Weg, Personen hinzuzufügen, einschließlich API, Importen und Anmelde-URL, wird mit 422 und einer Meldung wie „Pro includes 50,000 subscribers per audience.“ abgelehnt. Der API-Fehler enthält die aktuelle usage:

{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}

Per API nutzen

Mit der API für Kontaktlisten können Sie Kontaktlisten erstellen, abrufen, umbenennen, auflisten und löschen; die API für Abonnenten verwaltet die Personen darauf. In der URL können Sie statt der aud_-ID den Namen einer Kontaktliste verwenden. Die API erfordert einen API-Schlüssel mit Full Access.

curl https://api.emailit.com/v2/audiences \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Newsletter" }'

Antworten zu Kontaktlisten enthalten subscribers_count und ein Objekt usage mit used, limit und plan. Beim Erstellen, Abrufen und Aktualisieren einer Kontaktliste wird außerdem ihr token zurückgegeben, der geheime Teil ihrer Anmelde-URL. Ein doppelter Name gibt 409 zurück.

Events

Änderungen an Kontaktlisten und Abonnenten erzeugen Events, die Sie per Webhooks empfangen können und die Automatisierungen starten:

Importe und die Anmelde-URL senden keine Abonnenten-Events.

Nächste Schritte