Zum Inhalt springen

Funktionen

Kontakte

Kontakte sind Ihre Abonnenten, Kunden und Interessenten in Notifuse, jeweils mit Profil, benutzerdefinierten Feldern und Interaktionsverlauf.

Kontaktansicht mit der Kontakttabelle, ihren Feldern und den Optionen für benutzerdefinierte Daten

Überblick

Ein Kontakt speichert Profil, Präferenzen und Interaktionsdaten eines Abonnenten in vordefinierten und benutzerdefinierten Feldern. Er kann mehreren Verteilerlisten angehören.

Kontaktfelder

FeldTypBeschreibung
emailStringE-Mail-Adresse des Kontakts und sein eindeutiger Bezeichner (Erforderlich)
external_idStringOptionaler Verweis auf den Kontakt in Ihrem eigenen System. Nicht eindeutig (siehe Identität eines Kontakts)
first_nameStringVorname des Kontakts
last_nameStringNachname des Kontakts
phoneStringTelefonnummer
timezoneStringZeitzone des Kontakts im ISO-Format
languageStringBevorzugte Sprache
job_titleStringBerufsbezeichnung
address_line_1StringHauptadresse
address_line_2StringAdresszusatz (Wohnung, Büro usw.)
countryStringLand im ISO-Format
stateStringBundesland oder Provinz
postcodeStringPostleitzahl
custom_string_1 bis custom_string_5StringBenutzerdefinierte Textfelder
custom_number_1 bis custom_number_5NumberBenutzerdefinierte Zahlenfelder
custom_datetime_1 bis custom_datetime_5DateTimeBenutzerdefinierte Datums- und Zeitfelder
custom_json_1 bis custom_json_5JSONBenutzerdefinierte JSON-Felder
tracking_opens_consent, tracking_clicks_consentStringgranted, denied oder null (unbekannt): die Entscheidung des Kontakts zum Tracking von Öffnungen und Klicks
tracking_consent_updated_at, tracking_consent_sourceDateTime, StringWann und wo sich diese Entscheidung zuletzt geändert hat

Das Kontaktblatt

Ein Klick auf einen Kontakt in der Tabelle öffnet das Kontaktblatt über der Seite. Es hat eine eigene Adresse (die URL der Seite mit ?contact= und der E-Mail-Adresse), die Sie teilen oder erneut öffnen können. Haben Sie es aus der Tabelle geöffnet, schließt die Zurück-Schaltfläche des Browsers es wieder.

Das Kontaktblatt mit Kennzahlen, Aktivitätsverlauf und Profilfeldern
  • Durch die Tabelle blättern: mit den Pfeilen oben oder mit J (nächster) und K (vorheriger). Das Kontaktblatt folgt der Reihenfolge der Zeilen in der Ansicht, aus der Sie es geöffnet haben, und lädt weitere nach, wenn Sie die letzte erreichen.
  • Feld bearbeiten: Klicken Sie auf den Wert. Leere Felder sind unten in jedem Bereich hinter einem Link eingeklappt.
  • Kennzahlen: empfangene E-Mails, Öffnungs- und Klickrate, die letzte Aktivität und, bei aktivierter Web-Analyse, die Website-Besuche.
  • Aktivität: der Verlauf des Kontakts, filterbar nach Art (E-Mails, Listen und Segmente, Profiländerungen, Ereignisse, Web-Besuche).
  • Nachrichten: die an den Kontakt gesendeten E-Mails.
  • Web-Besuche: die Besuche des Kontakts auf Ihrer Website, wenn die Web-Analyse aktiviert ist.
  • Listen und Segmente: die Abonnements des Kontakts, die Sie ändern können, und die Segmente, denen er angehört.
Der obere Teil eines Kontaktblatts: Name, E-Mail-Adresse und Anmeldedatum, dann empfangene E-Mails, Öffnungsrate, Klickrate, letzte Aktivität und Website-Besuche

Kontaktverwaltung

Identität eines Kontakts und Verhalten beim Upsert

Die E-Mail-Adresse ist der eindeutige Bezeichner eines Kontakts. Sie ist der Primärschlüssel in der Datenbank, und jeder Upsert (contacts.upsert, contacts.import und der in transactional.send eingebettete Kontakt) ordnet Kontakte ausschließlich über die E-Mail-Adresse zu:

  • Neue E-Mail-Adressen: Ein neuer Kontakt wird angelegt.
  • Vorhandene E-Mail-Adressen: Der vorhandene Kontakt wird mit den übermittelten Feldern aktualisiert.
  • Null-Werte: Ein auf null gesetztes Feld wird beim Kontakt geleert.

external_id ist ein optionaler Verweis auf den Kontakt in Ihrem eigenen System (zum Beispiel die Benutzer-ID Ihrer Anwendung). Das Feld wird gespeichert, ist durchsuchbar und wird von der API zurückgegeben, ist aber kein eindeutiger Schlüssel:

  • Es wird bei Upserts nie zur Zuordnung von Kontakten verwendet.
  • Notifuse verhindert nicht, dass mehrere Kontakte dieselbe external_id haben.
  • Teilen sich mehrere Kontakte dieselbe external_id, gibt contacts.getByExternalID nur einen davon zurück (welchen, ist nicht festgelegt).

E-Mail-Adresse eines Kontakts ändern

Da die E-Mail-Adresse die Identität des Kontakts ist, legt ein Upsert mit derselben external_id und einer neuen E-Mail-Adresse einen zweiten Kontakt an. Die E-Mail-Adresse des vorhandenen Kontakts bleibt unverändert. Wenn ein Benutzer in Ihrem System seine E-Mail-Adresse ändert:

  1. Rufen Sie den alten Kontakt mit contacts.getByEmail ab, um sein Profil und seine Listenabonnements samt Status zu erhalten.
  2. Legen Sie per Upsert einen Kontakt mit der neuen E-Mail-Adresse an und senden Sie das vollständige Profil mit (Upserts führen Felder zusammen, also nehmen Sie jedes Feld auf, das erhalten bleiben soll, etwa external_id, Namen und benutzerdefinierte Felder).
  3. Legen Sie die Listenabonnements für den neuen Kontakt mit lists.subscribe neu an.
  4. Löschen Sie den Kontakt mit der alten E-Mail-Adresse über contacts.delete.

Warnung

Übernehmen Sie Abmeldungen, wenn Sie Abonnements neu anlegen. Hatte sich der alte Kontakt von einer Liste abgemeldet, wurde er dort zurückgewiesen oder hatte er sich beschwert, melden Sie die neue E-Mail-Adresse nicht erneut für diese Liste an. Der neue Kontakt beginnt ohne Vorgeschichte, und ein ungeprüftes erneutes Anmelden hebt die Abmeldung stillschweigend auf. Das ist ein Verstoß gegen die Einwilligungspflicht (DSGVO / CAN-SPAM) und kann Ihrer Absenderreputation schaden.

Beachten Sie außerdem:

  • Nachrichtenverlauf und Segmentzugehörigkeit sind an die E-Mail-Adresse gebunden. Sie bleiben bei der alten Adresse und werden nicht auf den neuen Kontakt übertragen.
  • Laufende Automatisierungen: Wird der alte Kontakt gelöscht, verlässt er jede Automatisierung, die er gerade durchläuft. Der neue Kontakt setzt nicht an derselben Stelle fort.

Einen Kontakt löschen

Wenn Sie einen Kontakt mit contacts.delete löschen, werden auch seine Listenabonnements gelöscht, einschließlich der Status abgemeldet, zurückgewiesen und Beschwerde. Notifuse weiß danach nicht mehr, dass sich die Adresse abgemeldet hatte. Ein späterer Import, ein Upsert mit subscribe_to_lists oder lists.subscribe fügt die Adresse wieder als neuen, angemeldeten Kontakt hinzu. Wenn eine Abmeldung weiter gelten soll, setzen Sie den Listenstatus des Kontakts auf abgemeldet, statt ihn zu löschen.

Ein Abmeldelink in einer E-Mail, die vor dem Löschen versendet wurde, antwortet weiterhin mit Erfolg, speichert aber nichts zu der Adresse.

Listenabonnements

  • Kontakte können eine oder mehrere Verteilerlisten abonnieren.
  • Der Abonnementstatus wird pro Liste verwaltet.
  • Listenzugehörigkeiten werden über die Beziehung contact_lists erfasst.

Segmentierung von Kontakten

Segmentierungsoberfläche mit Filtern auf Kontakteigenschaften und aktivitätsbasierten Bedingungen

Notifuse segmentiert Kontakte nach ihren Eigenschaften und ihrem Verhalten. Die Zugehörigkeit wird im Hintergrund berechnet, nicht in Echtzeit. Sobald etwas im Verlauf eines Kontakts landet (eine Profiländerung, eine geöffnete E-Mail, ein benutzerdefiniertes Ereignis), kommt der Kontakt in eine Warteschlange.

Eine wiederkehrende Aufgabe arbeitet diese Warteschlange ab, sodass eine Änderung meist innerhalb einer Minute in den Segmenten des Kontakts sichtbar wird. Segmente mit relativen Datumsangaben wie „in den letzten 30 Tagen“ werden außerdem jeden Tag um 5 Uhr in der Zeitzone des Segments neu berechnet.

Segmente erstellen

Segmente werden aus den folgenden Arten von Bedingungen aufgebaut.

Bedingungen auf Kontakteigenschaften

Filtern Sie Kontakte nach ihren Profildaten:

  • Textfelder: E-Mail-Adresse, Namen, Telefon, Land, Sprache, Zeitzone, Adresse, Berufsbezeichnung, Tracking-Einwilligung und ihre Quelle, benutzerdefinierte Textfelder. Operatoren: ist gesetzt, ist nicht gesetzt, ist gleich, ist nicht gleich, enthält (einen oder mehrere Werte), enthält nicht.
  • Zahlenfelder: benutzerdefinierte Zahlenfelder. Operatoren: ist gesetzt, ist nicht gesetzt, ist gleich, ist nicht gleich, größer oder kleiner als (oder gleich).
  • Datumsfelder: Erstellungs- und Änderungsdatum, Datum der Tracking-Einwilligung, benutzerdefinierte Datumsfelder. Operatoren: ist gesetzt, ist nicht gesetzt, vor, nach, zwischen, nicht zwischen, in den letzten N Tagen, nicht in den letzten N Tagen (trifft auch auf Kontakte zu, bei denen das Datum nie gesetzt wurde).
  • JSON-Felder: benutzerdefinierte JSON-Felder, gelesen an einem Pfad aus Schlüsseln und Array-Indizes, als Text, Zahl oder Datum. Text bietet zusätzlich „ist im Array“, ein Datum bietet vor, nach, ist gleich und die Operatoren für die letzten N Tage.

Mehrere Filter in einer Bedingung müssen alle zutreffen. Jeder Filter wird direkt an Ort und Stelle bearbeitet, und eine Bedingung lässt sich nicht bestätigen, solange einer ihrer Filter unvollständig ist.

Zielbasierte Bedingungen

Bauen Sie RFM-Segmente (Recency, Frequency, Monetary) mit benutzerdefinierten Ereignissen und Zielen:

  • Monetär: Gesamtausgaben, durchschnittlicher Bestellwert
  • Häufigkeit: Anzahl der Käufe, Anzahl der Ereignisse
  • Aktualität: Aktivität innerhalb eines Zeitraums

Beispielsegmente: VIP-Kunden (Ausgaben ab 1000 $), Wiederholungskäufer (ab 3 Bestellungen), gefährdete Kunden (kein Kauf in 90 Tagen).

Aktivitätsbasierte Bedingungen

Erreichen Sie Kontakte danach, wie sie mit Ihren E-Mails und Ihrer Website interagieren:

  • E-Mail gesendet: Dem Kontakt wurde eine E-Mail gesendet.
  • E-Mail geöffnet: Der Kontakt hat eine E-Mail geöffnet.
  • E-Mail geklickt: Der Kontakt hat einen Link in einer E-Mail angeklickt, optional einen, dessen Adresse einen bestimmten Text enthält. Bei E-Mails ab Version 42.2 kommt der Kontakt ins Segment, sobald er diesen Link anklickt, auch wenn es nicht der erste Link ist, den er in der E-Mail angeklickt hat.
  • E-Mail zurückgewiesen: Die E-Mail an diesen Kontakt wurde zurückgewiesen.
  • Beschwerde zur E-Mail: Der Kontakt hat eine E-Mail als Spam markiert.
  • Über eine E-Mail abgemeldet: Der Kontakt hat sich über eine E-Mail abgemeldet.
  • Webseite anzeigen: Der Kontakt hat eine Seite Ihrer Website aufgerufen, filterbar nach Pfad, Verweildauer und Scrolltiefe.
  • Website besuchen: Der Kontakt hat Ihre Website besucht, filterbar nach Einstiegs- und Ausstiegsseite, aufgerufenen Seiten, Dauer, Kanal, Kampagne, Gerät und Land.

Die beiden Website-Bedingungen setzen die Web-Analyse und einen identifizierten Besucher voraus.

Aktivitätsbedingungen unterstützen zusätzliche Parameter:

  • Häufigkeit: mindestens, höchstens oder genau so oft wie angegeben
  • Zeitraum: jederzeit, zwischen zwei Datumsangaben, vor oder nach einem Datum oder in den letzten N Tagen
  • Vorlage und Kampagne (jede E-Mail-Aktivität, auch E-Mail gesendet): nur E-Mails zählen, die mit einer bestimmten Vorlage oder von einer bestimmten Kampagne gesendet wurden
  • Geklickter Link (E-Mail geklickt): nur Klicks auf Links zählen, die einen bestimmten Text enthalten, etwa /pricing

Verknüpfung von Bedingungen

Segmente verknüpfen Bedingungen mit UND oder ODER:

  • Kontakte, die allen folgenden Bedingungen entsprechen: Der Kontakt muss jede Bedingung erfüllen (UND-Verknüpfung).
  • Kontakte, die mindestens einer der folgenden Bedingungen entsprechen: Der Kontakt muss eine oder mehrere Bedingungen erfüllen (ODER-Verknüpfung).

Bedingungen lassen sich gruppieren, jede Gruppe mit ihrem eigenen „allen“ oder „mindestens einer der“, und Gruppen lassen sich verschachteln.

Anwendungsfälle

Häufige Szenarien:

  • VIP-Kunden: Kunden mit hohen Ausgaben und mehreren Käufen (mit zielbasierten Bedingungen)
  • Reaktivierung: inaktive Abonnenten erneut ansprechen, die seit 90 Tagen keine E-Mail geöffnet haben
  • Gefährdete Kunden: früher aktive Käufer ohne aktuelle Käufe
  • Geografische Ausrichtung: regionale Kampagnen nach Land oder Bundesland versenden
  • Verhaltensbasierte Auslöser: Benutzer ansprechen, die bestimmte Produktlinks angeklickt haben

Technische Details

Die Segmentierung liest den in Version 7.0 eingeführten Kontaktverlauf, der jede Interaktion eines Kontakts erfasst, darunter Nachrichten, Webhook-Ereignisse und Profiländerungen. Jedes Aktivitätsereignis hat ein kind (z. B. email.opened, email.clicked, web.pageview), auf das Bedingungen zielen können. Zeitstempel werden in UTC gespeichert, und datumsbasierte Bedingungen können sie in einer von Ihnen angegebenen Zeitzone auswerten.

Berechtigungen für Segmente

Segmente haben eine eigene Berechtigung Segmente: Gelesen listet Segmente auf und öffnet sie, Schreiben legt sie an, bearbeitet, löscht und berechnet sie neu und kann ihre Hintergrundaufgaben zur Berechnung starten, zurücksetzen oder löschen.

Für die Vorschau eines Segments während des Aufbaus und für die Liste der Kontakte, auf die ein Segment gerade zutrifft, brauchen Sie zusätzlich Lesezugriff auf Kontakte. Beide beantworten Fragen zu Ihren Kontakten und nicht zur Definition des Segments. Ein Mitglied, das nur Lesezugriff auf Segmente hat, kann mit Segmentdefinitionen arbeiten, sieht aber nicht, wer darin ist.

Die Vorschau akzeptiert jede Definition, nicht nur ein gespeichertes Segment. Wer Lesezugriff auf Segmente und auf Kontakte hat, kann also Zählfragen zu jedem Kontaktattribut, jeder Listenzugehörigkeit, jedem benutzerdefinierten Ereignis oder Verlaufseintrag stellen, eine Zählung nach der anderen.

Kontakte aus CSV importieren

CSV-Import: jede Spalte der Datei mit Beispielwerten und dem Kontaktfeld, in das sie importiert wird

Der Import läuft in drei Schritten: CSV-Datei ablegen, Spalten zuordnen, dann den Import verfolgen.

Spalten zuordnen

Die erste Zeile der Datei enthält die Spaltennamen, und eine Spalte muss E-Mail-Adressen enthalten. Jede Spalte wird mit Beispielwerten aus den ersten Zeilen angezeigt. Eine Spalte, die nach einem Kontaktfeld benannt ist, per Schlüssel (first_name) oder Bezeichnung (First Name), wird automatisch zugeordnet.

Sie können jede Spalte einem Standard- oder benutzerdefinierten Feld zuordnen oder sie auf Nicht importieren lassen. Jedes Feld nimmt eine Spalte auf, und der Import bleibt deaktiviert, bis eine Spalte dem Feld E-Mail zugeordnet ist.

Einwilligungsspalten nehmen granted oder denied auf, benutzerdefinierte JSON-Felder gültiges JSON. Ein Kontakt, der schon im Arbeitsbereich ist, wird über die E-Mail-Adresse erkannt und aktualisiert: Jedes Feld, das die Zeile enthält, überschreibt den gespeicherten Wert.

Zu Listen hinzufügen

Jeder importierte Kontakt wird für die Listen angemeldet, die Sie auswählen, eine oder mehrere.

Import verfolgen

Die Zeilen werden in Paketen zu 100 gesendet, und der Import zählt die angelegten, aktualisierten und fehlgeschlagenen Kontakte. Jede fehlgeschlagene Zeile wird mit ihrer Zeilennummer in Ihrer Datei und dem Grund aufgeführt. Fehlgeschlagene Zeilen herunterladen liefert diese Zeilen mit einer Spalte error, damit Sie sie korrigieren und erneut importieren können.

Der Import läuft in Ihrem Browser. Sie können ihn pausieren oder anhalten, und auch das Schließen der Seitenleiste oder des Tabs hält ihn an. Sein Fortschritt bleibt 7 Tage in diesem Browser gespeichert: Der Schritt Datei listet unvollständige Importe auf, und wenn Sie dieselbe Datei erneut ablegen, können Sie ab der Zeile fortfahren, an der er angehalten hat, mit derselben Spaltenzuordnung und denselben Listen.

Berechtigungen für den Import

Der Import braucht Schreibzugriff auf Kontakte. Wer beim Import eine oder mehrere Verteilerlisten auswählt, braucht außerdem Schreibzugriff auf Listen.

Jedes Feld einer Zeile überschreibt den gespeicherten Wert beim passenden Kontakt, ein einziger Import kann also Ihre gesamte Kontaktdatenbank neu schreiben. Behalten Sie das im Blick, wenn Sie Schreibzugriff auf Kontakte vergeben.

Massenaktualisierung per CSV

Massenaktualisierung (CSV) im Menü ⋯ der Seite Kontakte wendet eine Aktion auf jeden Kontakt an, dessen Adresse in einer CSV-Spalte steht:

  • Von einer Liste abmelden setzt das Abonnement der Kontakte für diese Liste auf abgemeldet. Sie bleiben im Arbeitsbereich und können sich wieder anmelden. Ein Kontakt, der nicht in der Liste ist, wird übersprungen.
  • Kontakte löschen entfernt die Kontakte und ihren Verlauf aus dem Arbeitsbereich. Das lässt sich nicht rückgängig machen.
Massenaktualisierung per CSV: Von einer Liste abmelden mit der Liste Newsletter, die Datei und ihre E-Mail-Spalte, die ersten Adressen und eine Zusammenfassung mit 49 Zeilen, 2 entfernten Duplikaten und 1 Zeile ohne gültige E-Mail-Adresse, also 46 Kontakten

Die Spalte, deren Name „mail“ enthält, wird automatisch gewählt, und Sie können eine andere auswählen. Adressen werden in Kleinbuchstaben umgewandelt und jede wird einmal verarbeitet. Bevor etwas beginnt, zählt die Zusammenfassung die Zeilen der Datei, die entfernten Duplikate und die Zeilen ohne gültige Adresse.

Die Aktualisierung läuft in Ihrem Browser, ein Kontakt nach dem anderen. Jede Adresse wird als erledigt, übersprungen oder fehlgeschlagen aufgeführt. Sie können die Ergebnisse als CSV herunterladen und fehlgeschlagene Adressen erneut versuchen. Eine angehaltene Aktualisierung lässt sich mit derselben Datei fortsetzen.

Das Abmelden braucht Schreibzugriff auf Listen und auf Kontakte, das Löschen Schreibzugriff auf Kontakte.

Berechtigungen

Kontaktdaten unterliegen der Berechtigung Kontakte:

  • Gelesen umfasst Kontaktdatensätze mit ihren vollständigen Profilen, den Kontaktverlauf und die zu Kontakten erfassten benutzerdefinierten Ereignisse. Zusammen mit der passenden Berechtigung für Listen oder Segmente ist sie auch nötig, um die Adressen in einer Liste oder einem Segment aufzulisten. Sie wird außerdem gebraucht, um bei einem Transaktionsversand cc oder bcc zu setzen.
  • Schreiben umfasst das Anlegen und Aktualisieren von Kontakten, ihr endgültiges Löschen, ihr massenhaftes Überschreiben per CSV- oder API-Import und das Erfassen benutzerdefinierter Ereignisse. Den Abonnementstatus eines Kontakts in einer Liste zu ändern, braucht zusätzlich Schreibzugriff auf Listen.

Auf dem Kontaktblatt braucht jeder Teil seine eigene Berechtigung: Nachrichten braucht Lesezugriff auf den Nachrichtenverlauf, Web-Besuche Lesezugriff auf die Web-Analyse (bei aktivierter Web-Analyse), und die Bereiche für Listen und Segmente brauchen Lesezugriff auf Listen und auf Segmente. Ohne Schreibzugriff auf Kontakte lassen sich die Felder nicht bearbeiten.

Drei Berechtigungen erlauben Zugriff auf Kontaktdaten, auch ohne Schreibzugriff auf Kontakte. Prüfen Sie sie, bevor Sie eine davon vergeben:

  • Schreibzugriff auf Listen allein legt einen vollständigen Kontaktdatensatz an oder überschreibt ihn: /api/lists.subscribe schreibt jedes Feld, das die Anfrage enthält, und kann jemanden für eine nicht öffentliche Liste anmelden.
  • Schreibzugriff auf Automatisierungen sendet den vollständigen Kontaktdatensatz an jede URL, die ein Webhook-Knoten angibt, und während eine Automatisierung läuft, prüft nichts die Berechtigungen.
  • Schreibzugriff auf Transaktionales legt den Empfängerkontakt beim Versand an. Ohne Schreibzugriff auf Kontakte wird nur die E-Mail-Adresse gespeichert, und ein vorhandener Kontakt wird nie verändert (siehe Transaktions-API).

Wichtige Funktionen

  • Vordefinierte Felder decken die meisten Anforderungen ab, benutzerdefinierte Felder den Rest.
  • Upserts ordnen über die E-Mail-Adresse zu, dieselbe Adresse legt also nie zwei Kontakte an.
  • Ein Kontakt kann mehreren Verteilerlisten angehören.
  • Ein auf null gesetztes Feld wird geleert.