Kontaktsegmente

#Kontakt über die Schnittstelle in ein Segment eintragen

1. Sende eine POST-Anfrage an/api/v2/contact-segments/{segment}/subscribe.#

   Ersetze {segment} durch die ID des Segments. Die Anfrage muss von einem angemeldeten Benutzer kommen.

2. Gib im Feld email die E-Mail-Adresse des Kontakts an.#

   Das Feld ist Pflicht und muss eine gültige E-Mail-Adresse enthalten, zum Beispiel jane@example.com.

3. Gib bei Bedarf firstName (Vorname) und lastName (Nachname) mit.#

   Beide Angaben sind optional und dürfen höchstens 20 Zeichen lang sein.

4. Lege mit skipConfirmation fest, ob der Kontakt das Abonnement bestätigen muss.#

   Der Standardwert ist false. Dann bekommt der Kontakt eine Bestätigungs-E-Mail (Double-Opt-in). Mit true wird er ohne Bestätigungs-E-Mail eingetragen.

5. Das System sucht den Kontakt anhand der E-Mail-Adresse und trägt ihn in das Segment ein.#

   Gibt es noch keinen Kontakt mit dieser E-Mail-Adresse, wird er mit dem übergebenen Vor- und Nachnamen neu angelegt. Bei Erfolg ist die Antwort leer.

#Neues Segment erstellen

1. Öffne in den Einstellungen die Seite Segmente.#
2. Klicke oberhalb der Tabelle auf die Schaltfläche zum Anlegen eines neuen Segments.#

   Das Fenster Segment erstellen öffnet sich.

3. Gib im Feld Name einen Namen ein und wähle eine Farbe.#

   Beide Angaben sind Pflicht.

4. Aktiviere bei Bedarf Dynamisches Segment.#

   Dynamische Segmente haben keine fest zugeordneten Kontakte, sondern nutzen Regeln. Die Regeln legst du danach über „Regeln bearbeiten“ fest.

5. Aktiviere bei Bedarf Für Kommunikation verwendbar.#

   Dann können Nachrichten an dieses Segment geschrieben werden, zum Beispiel an vip@ und die Domain deiner Organisation. Die Option gibt es nur, wenn die Segment-Kommunikation für dich freigeschaltet ist.

6. Füge bei Bedarf unter Zusätzliche berechtigte Absender mit Absender hinzufügen weitere E-Mail-Adressen hinzu.#

   Das Feld erscheint nur, wenn „Für Kommunikation verwendbar“ aktiv ist. Jeder Eintrag muss eine gültige E-Mail-Adresse sein. Globale berechtigte Absender legst du unter System-Mail fest. Sie gelten für alle Kommunikationssegmente, die zusätzlichen Absender nur für dieses Segment.

7. Wähle bei Bedarf unter Dokumente ein oder mehrere Dokumente aus.#

   Das Feld erscheint nur, wenn die Dokumente-Funktion aktiv ist. Du kannst in der Auswahl nach Dokumenten suchen.

8. Bestätige das Fenster, um das Segment anzulegen.#

#Regeln eines dynamischen Segments bearbeiten

1. Öffne in den Einstellungen die Seite Segmente.#
2. Klicke in der Zeile des dynamischen Segments auf das Blitz-Symbol Regeln bearbeiten.#

   Ein breites Fenster mit dem Namen des Segments als Überschrift und dem Regeleditor öffnet sich.

3. Passe die Regeln im Regeleditor an.#
4. Klicke auf Speichern.#

#Mitglieder eines dynamischen Segments neu berechnen

1. Öffne in den Einstellungen die Seite Segmente.#
2. Klicke in der Zeile des dynamischen Segments auf das Pfeil-Symbol Neu berechnen.#

   Beim Darüberfahren erscheint der Hinweis „Dynamisches Segment aktualisieren“. Die Mitglieder werden sofort und ohne Rückfrage anhand der aktuellen Regeln neu ermittelt.

#Mitglieder eines dynamischen Segments anzeigen

1. Öffne in den Einstellungen die Seite Segmente.#
2. Klicke in der Zeile des dynamischen Segments auf das Personen-Symbol Mitglieder.#

   Beim Darüberfahren erscheint der Hinweis „Aus dynamischen Regeln berechnet — Liste anzeigen“. Ein Fenster mit dem Namen des Segments zeigt die Kontakte, die aktuell zum Segment gehören.

3. Klicke auf Schließen, wenn du fertig bist.#

#Feste und dynamische Segmente unterscheiden

• Feste Segmente: Du legst selbst fest, welche Kontakte dazugehören. Kontakte kommen außerdem über das Abonnieren per Schnittstelle hinzu. Die Mitglieder ändern sich nur, wenn jemand sie ändert.
• Dynamische Segmente: Es gibt keine fest zugeordneten Kontakte. Die Mitglieder ergeben sich aus Regeln wie „Alle Mädchen im Alter von 7 bis 12“ und ändern sich, wenn sich die Kontaktdaten ändern. Bei Regeln zu Spenden, Altersschwellen oder Zeitfenstern wird die Zuordnung erst bei der nächtlichen Neuberechnung aktualisiert. Die Mitgliederliste kannst du nur ansehen, nicht bearbeiten.

#Mitglieder eines festen Segments bearbeiten

1. Öffne in den Einstellungen die Seite Segmente.#
2. Klicke in der Zeile des festen Segments auf das Personengruppen-Symbol Mitglieder.#

   Das Fenster „Mitglieder“ öffnet sich mit einer Liste der zugeordneten Kontakte.

3. Füge Zeilen hinzu und wähle darin jeweils einen Kontakt aus, oder entferne Zeilen von Kontakten, die nicht mehr dazugehören.#

   In der Auswahl kannst du nach Kontakten suchen. In jeder Zeile muss ein Kontakt ausgewählt sein.

4. Bestätige das Fenster, um die Änderungen zu speichern.#

#Übersicht „Segmente“

Die Seite Segmente findest du in den Einstellungen. Die Tabelle listet alle Segmente außer den Newsletter-Segmenten, standardmäßig nach Name sortiert. Du kannst nach dem Namen suchen und nach Name oder Mitgliederzahl sortieren. Bei mehr als zehn Segmenten ist die Tabelle in Seiten aufgeteilt. Die Tabelle zeigt diese Spalten:

• Name: der Name des Segments.
• Mitglieder: die Anzahl der Kontakte im Segment.
• Farbe: die gewählte Farbe.
• Dynamisches Segment: ob das Segment Regeln folgt.
• Für Kommunikation verwendbar: ob Nachrichten an das Segment geschrieben werden können. Die Spalte erscheint nur, wenn die Segment-Kommunikation freigeschaltet ist.

In jeder Zeile findest du diese Schaltflächen:

• Regeln bearbeiten (Blitz-Symbol): nur bei dynamischen Segmenten.
• Neu berechnen (Pfeil-Symbol): nur bei dynamischen Segmenten und nur für interne Superadmins.
• Mitglieder: bei dynamischen Segmenten zeigt sie die Liste der Mitglieder an, bei festen Segmenten kannst du die Mitglieder damit bearbeiten (höchstens 20).
• Segment bearbeiten: öffnet dieselben Felder wie beim Erstellen, also Name, Farbe, die Optionen und bei Bedarf Absender und Dokumente.
• Segment löschen: löscht das Segment, nachdem du im Fenster „Segment löschen“ bestätigt hast.

#Häufige Fragen