Überblick
Ein Kontakt speichert Profil, Präferenzen und Interaktionsdaten eines Abonnenten in vordefinierten und benutzerdefinierten Feldern. Er kann mehreren Verteilerlisten angehören.
Kontaktfelder
| Feld | Typ | Beschreibung |
|---|---|---|
email | String | E-Mail-Adresse des Kontakts und sein eindeutiger Bezeichner (Erforderlich) |
external_id | String | Optionaler Verweis auf den Kontakt in Ihrem eigenen System. Nicht eindeutig (siehe Identität eines Kontakts) |
first_name | String | Vorname des Kontakts |
last_name | String | Nachname des Kontakts |
phone | String | Telefonnummer |
timezone | String | Zeitzone des Kontakts im ISO-Format |
language | String | Bevorzugte Sprache |
job_title | String | Berufsbezeichnung |
address_line_1 | String | Hauptadresse |
address_line_2 | String | Adresszusatz (Wohnung, Büro usw.) |
country | String | Land im ISO-Format |
state | String | Bundesland oder Provinz |
postcode | String | Postleitzahl |
custom_string_1 bis custom_string_5 | String | Benutzerdefinierte Textfelder |
custom_number_1 bis custom_number_5 | Number | Benutzerdefinierte Zahlenfelder |
custom_datetime_1 bis custom_datetime_5 | DateTime | Benutzerdefinierte Datums- und Zeitfelder |
custom_json_1 bis custom_json_5 | JSON | Benutzerdefinierte JSON-Felder |
tracking_opens_consent, tracking_clicks_consent | String | granted, denied oder null (unbekannt): die Entscheidung des Kontakts zum Tracking von Öffnungen und Klicks |
tracking_consent_updated_at, tracking_consent_source | DateTime, String | Wann 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.
- 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.
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
nullgesetztes 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_idhaben. - Teilen sich mehrere Kontakte dieselbe
external_id, gibtcontacts.getByExternalIDnur 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:
- Rufen Sie den alten Kontakt mit
contacts.getByEmailab, um sein Profil und seine Listenabonnements samt Status zu erhalten. - 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). - Legen Sie die Listenabonnements für den neuen Kontakt mit
lists.subscribeneu an. - 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_listserfasst.
Segmentierung von Kontakten
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
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.
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
ccoderbcczu 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.subscribeschreibt 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
nullgesetztes Feld wird geleert.
