Externe Segmente

Mit externen Segmenten können Sie Personen ansprechen, die bereits in Ihrer eigenen Datenbank, wie Ihrem CRM oder Data Warehouse, gespeichert sind, anstatt sie in eine CSV-Datei zu exportieren und bei jeder Änderung der Liste erneut hochzuladen. Sie geben Pushwoosh eine SQL-Abfrage, die die richtigen Benutzer-IDs zurückgibt, und Pushwoosh führt diese Abfrage wiederholt aus, um das Segment auf dem neuesten Stand zu halten. Sobald es eingerichtet ist, können Sie diese Benutzer wie jedes andere Segment verwenden.

Hilfe von Entwicklern erforderlich

Sie benötigen Hilfe von Ihrem Entwickler oder Datenbankadministrator, um die Verbindung einzurichten. Teilen Sie diese Anleitung mit ihnen, um zu beginnen.

Das Einrichten einer Verbindung berührt Ihre Produktionsdatenbank. Bevor Sie beginnen, lassen Sie Ihren Entwickler oder Datenbankadministrator:

• einen schreibgeschützten Benutzer (oder für BigQuery ein schreibgeschütztes Dienstkonto) vorbereiten
• die Abfrage bestätigen, die Sie verwenden möchten
• Wenn die Datenbank hinter einer Firewall liegt, fragen Sie den Pushwoosh-Support, welche IP-Adressen zugelassen werden sollen

Externes Segment erstellen

Segment benennen und Datenbank auswählen

1. Gehen Sie zu Zielgruppe → Externe Segmente.
2. Klicken Sie auf Externes Segment erstellen.

3. Geben Sie einen Namen für das Segment ein (bis zu 100 Zeichen).
4. Wählen Sie den Datenbanktyp: PostgreSQL, MySQL, Google BigQuery oder Microsoft SQL Server / Fabric.

Verbindungsfelder ausfüllen

PostgreSQL und MySQL

Füllen Sie für PostgreSQL und MySQL Folgendes aus:

• Host und Port: die Adresse Ihres Datenbankservers. Pushwoosh erfordert einen öffentlich erreichbaren Host und lehnt private, interne oder Loopback-Adressen ab, wenn Sie die Verbindung prüfen oder das Segment speichern.
• Datenbank: der Datenbankname.
• Benutzer und Passwort: Anmeldeinformationen für ein schreibgeschütztes Konto.
• SSL-Modus (nur PostgreSQL, da MySQL-Verbindungen kein TLS verwenden) legt fest, wie SSL/TLS, das Protokoll, das die Verbindung verschlüsselt, auf Ihre Datenbankverbindung angewendet wird. Fragen Sie Ihren Datenbankadministrator, welchen Modus Sie verwenden sollen:
  • Deaktivieren: keine Verschlüsselung.
  • Erforderlich: verschlüsselt die Verbindung, überprüft aber nicht die Identität des Datenbankservers.
  • CA überprüfen: verschlüsselt die Verbindung und prüft, ob das Zertifikat des Servers von einer vertrauenswürdigen Zertifizierungsstelle (CA) ausgestellt wurde.
  • Vollständig überprüfen: wie CA überprüfen, prüft aber zusätzlich, ob das Zertifikat mit dem Hostnamen Ihrer Datenbank übereinstimmt. Die stärkste Option.
• Für jeden anderen Modus als Deaktivieren geben Sie das CA-Zertifikat unter Zertifikatsquelle (Dateien hochladen oder PEM einfügen) sowie ein Client-Zertifikat und einen Client-Schlüssel an, falls Ihre Datenbank dies erfordert.

BigQuery

Füllen Sie für Google BigQuery Folgendes aus:

• Projekt-ID: das GCP-Projekt, das Ihr Dataset enthält.
• Dienstkonto-JSON: der Schlüssel für ein Dienstkonto mit Lesezugriff auf BigQuery.
• Standort: die Region des Datasets (zum Beispiel EU, US oder europe-west3). Lassen Sie das Feld leer, um den Standort automatisch aus dem Dataset zu ermitteln.

SQL Server / Fabric

Füllen Sie für Microsoft SQL Server / Fabric Folgendes aus:

• Host und Port: die Adresse Ihres Datenbankservers oder Ihres Fabric SQL-Analyseendpunkts. Pushwoosh erfordert einen öffentlich erreichbaren Host und lehnt private, interne oder Loopback-Adressen ab, wenn Sie die Verbindung prüfen oder das Segment speichern.
• Datenbank: der Datenbankname.
• Benutzer und Passwort: Anmeldeinformationen für ein schreibgeschütztes Konto.
• Microsoft Entra Mandanten-ID: optional. Lassen Sie das Feld für eine SQL Server-Anmeldung leer. Für Microsoft Fabric, dessen SQL-Analyseendpunkt keine SQL-Anmeldungen hat, stellen Sie es so ein, dass Sie sich stattdessen als Dienstprinzipal anmelden. Geben Sie dessen Anwendungs-(Client-)ID als Benutzer und dessen Client-Geheimnis als Passwort ein.

Abfrage eingeben

1. Geben Sie die Abfrage ein. Sie muss eine einzelne Spalte mit dem Namen user_id zurückgeben, mit einer Zeile pro Benutzer, den Sie im Segment haben möchten. Zum Beispiel:

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

Hinweis

Die user_id-Werte müssen mit den Pushwoosh-Benutzer-IDs übereinstimmen, die Sie für Ihre Benutzer festgelegt haben (derselbe Bezeichner, der von Segmente nach Benutzer-ID erstellen verwendet wird). Eine Abfrage, die IDs zurückgibt, die Pushwoosh nicht erkennt, wird keinen Geräten zugeordnet.

2. Klicken Sie auf Verbindung prüfen, um zu bestätigen, dass Pushwoosh die Datenbank erreichen kann (Zeitüberschreitung nach 30 Sekunden).
3. Klicken Sie auf Abfrage prüfen, um zu bestätigen, dass die Abfrage ausgeführt wird und die richtige Spalte zurückgibt (ebenfalls Zeitüberschreitung nach 30 Sekunden).

Überprüfen und erstellen

Wenn beide Prüfungen erfolgreich sind, klicken Sie auf Erstellen. Pushwoosh speichert das Segment und fügt es sofort zur Liste der Externen Segmente hinzu.

Wie das Segment aktuell bleibt

Pushwoosh führt Ihre Abfrage nicht nach einem festen Zeitplan aus. Stattdessen wird das Segment basierend darauf aktualisiert, wie kürzlich es zuletzt verwendet wurde:

• Wenn die Daten des Segments weniger als eine Stunde alt sind, verwendet Pushwoosh die aktuellen Daten unverändert.
• Wenn sie älter als eine Stunde sind, verwendet Pushwoosh weiterhin die aktuellen Daten, während im Hintergrund eine Aktualisierung stattfindet.
• Wenn sie älter als drei Stunden sind, wartet Pushwoosh auf eine neue Aktualisierung, bevor das Segment verwendet wird.

In der Praxis bedeutet dies, dass ein Segment, das Sie regelmäßig verwenden (zum Beispiel in einer wiederkehrenden Journey), aktuell bleibt, während ein Segment, das Sie selten verwenden, beim ersten erneuten Gebrauch einen Moment zur Aktualisierung benötigen kann.

Wenn eine Aktualisierung fehlschlägt (zum Beispiel, weil die Datenbank nicht erreichbar ist oder die Abfrage Fehler verursacht), zeichnet Pushwoosh den Fehler auf, aber der Status des Segments in der Liste Externe Segmente ändert sich nicht von selbst. Nachdem Sie das Problem auf Ihrer Seite behoben haben, öffnen Sie das Segment und klicken Sie auf Verbindung prüfen, um die Behebung zu bestätigen. Der Fehler wird automatisch gelöscht, wenn die Daten des Segments das nächste Mal erfolgreich aktualisiert werden.

Externes Segment verwenden

Sobald Sie es erstellt haben, erscheint das externe Segment automatisch unter Zielgruppe → Segmente unter demselben Namen und ist bereit, wie jedes andere Segment verwendet zu werden, zum Beispiel als Zielgruppe für eine Kampagne oder Journey.

Um es mit anderen Bedingungen zu kombinieren, fügen Sie es als Filter hinzu:

1. Gehen Sie zu Zielgruppe → Segmente → Segment erstellen.
2. Klicken Sie auf Filter hinzufügen nach → Segment.
3. Wählen Sie Ihr externes Segment nach Namen aus.

Derselbe Segment-Filter ist in zusammengesetzten Filtern und bei der Auswahl der Zielgruppe im Zielgruppenbasierten Eintritt verfügbar. Weitere Informationen zum Kombinieren von Segmenten finden Sie unter Segmente nach vorhandenen Segmenten erstellen.

Überprüfen, wie viele Personen im Segment sind

Die Liste Externe Segmente zeigt keine Mitgliederzahl an. Öffnen Sie den Wrapper des Segments unter Zielgruppe → Segmente (siehe Externes Segment verwenden) und berechnen Sie dort dessen Größe.

Externe Segmente verwalten

In der Liste Externe Segmente zeigt jede Zeile den Namen des Segments, den Code (der Bezeichner, der zur Referenzierung des Segments in API-Aufrufen verwendet wird), den Datenbanktyp, den Host und den Status (gültig oder ungültig).

• Klicken Sie auf Bearbeiten, um die Verbindung oder die Abfrage zu ändern. Der Datenbanktyp kann nach der Erstellung nicht mehr geändert werden. Erstellen Sie stattdessen ein neues Segment.
• Klicken Sie auf Löschen, um ein Segment zu entfernen. Pushwoosh blockiert die Löschung, solange das Segment von einer Kampagne, Journey, einem Filter oder einem Popup-Formular verwendet wird. Entfernen Sie zuerst diese Referenzen und löschen Sie dann das Segment. Dies kann nicht rückgängig gemacht werden.