Zum Inhalt springen

SQL-Segmenterweiterungen

Sie können eine Segmenterweiterung mithilfe von Snowflake-SQL-Abfragen von Snowflake-Daten erstellen. SQL kann Ihnen helfen, neue Segmentierungs-Anwendungsfälle zu erschließen, da es die Flexibilität bietet, die Beziehungen zwischen Daten auf eine Weise zu beschreiben, die mit anderen Segmentierungs-Features nicht möglich ist.

Wie bei Standard-Segmenterweiterungen können Sie in Ihrer SQL-Segmenterweiterung Ereignisse aus den letzten zwei Jahren (730 Tage) abfragen. Im Gegensatz zu Standard-Segmenterweiterungen verbrauchen SQL-Segmenterweiterungen Credits.

Voraussetzungen

Da über dieses Feature auf PII-Daten zugegriffen werden kann, benötigen Sie PII-Berechtigungen, um SQL-Segmentabfragen auszuführen.

Erstellen einer Segmenterweiterung

Schritt 1: Editor auswählen

Bei der Erstellung Ihrer SQL-Segmenterweiterung stehen zwei Arten von SQL-Editoren zur Auswahl: der SQL-Editor und der inkrementelle SQL-Editor.

  • Vollständige Aktualisierung: Bei jeder Aktualisierung Ihres Segments fragt Braze alle verfügbaren Daten ab, um Ihr Segment zu aktualisieren, was mehr Credits verbraucht als inkrementelle Aktualisierungen. Erweiterungen mit vollständiger Aktualisierung können die Mitgliedschaft täglich automatisch neu generieren, können jedoch nicht mit inkrementeller Aktualisierung aufgefrischt werden.
  • Inkrementelle Aktualisierung: Die inkrementelle Aktualisierung ist eine kosteneffizientere Methode zur Einrichtung Ihrer Abfrage, wobei die Einrichtung einige zusätzliche Schritte erfordert. Wenn Sie diese zusätzlichen Schritte bei der Erstellung Ihres Segments ausführen können, lohnt es sich, diese Option zu wählen, da Ihre Abfrage mit weniger Credits ausgeführt wird.
  • KI-SQL-Generator: Der KI-SQL-Generator ermöglicht es Ihnen, eine Eingabe in natürlicher Sprache zu verfassen, die dann in eine SQL-Abfrage für Ihr Segment umgewandelt wird. Es ist eine schnelle Möglichkeit, ohne eigenes SQL-Schreiben loszulegen.

So erstellen Sie eine SQL-Segmenterweiterung mit vollständiger Aktualisierung:

  1. Gehen Sie zu Zielgruppe > Segmenterweiterungen.
  2. Wählen Sie Neue Erweiterung erstellen und dann Vollständige Aktualisierung.

    Modal „Neue Erweiterung erstellen“ mit den Optionen „Vollständige Aktualisierung“ und „Inkrementelle Aktualisierung“.

  3. Fügen Sie einen Namen für Ihre Segmenterweiterung hinzu und geben Sie Ihr SQL ein. Anforderungen und Ressourcen finden Sie in Schritt 2.

    SQL-Editor mit einer beispielhaften SQL-Segmenterweiterung.

  4. Speichern Sie Ihre Segmenterweiterung.

So erstellen Sie eine SQL-Segmenterweiterung mit inkrementeller Aktualisierung:

  1. Gehen Sie zu Zielgruppe > Segmenterweiterungen.
  2. Wählen Sie Neue Erweiterung erstellen und dann Inkrementelle Aktualisierung.

    Modal „Neue Erweiterung erstellen“ mit den Optionen „Vollständige Aktualisierung“ und „Inkrementelle Aktualisierung“.

  3. Fügen Sie einen Namen für Ihre Segmenterweiterung hinzu und geben Sie Ihr SQL ein. Anforderungen und Ressourcen finden Sie im Abschnitt SQL schreiben.

    SQL-Editor mit einer beispielhaften inkrementellen SQL-Segmenterweiterung.

  4. Wählen Sie bei Bedarf Erweiterung täglich regenerieren.

    Kontrollkästchen zum täglichen Regenerieren der Erweiterung.

    Wenn diese Option ausgewählt ist, aktualisiert Braze die Segment-Mitgliedschaft automatisch täglich. Das bedeutet, dass Braze jeden Tag um Mitternacht in der Zeitzone Ihres Unternehmens (mit einer möglichen Verzögerung von einer Stunde) nach neuen Nutzer:innen in Ihrem Segment sucht und diese automatisch hinzufügt. Wenn eine Segmenterweiterung 7 Tage lang nicht verwendet wurde, pausiert Braze die tägliche Regenerierung automatisch. Eine nicht verwendete Segmenterweiterung ist eine, die nicht Teil einer Campaign oder eines Canvas ist (die Campaign oder der Canvas muss nicht aktiv sein, damit die Erweiterung als „verwendet“ gilt).

  5. Speichern Sie Ihre Segmenterweiterung.

Der KI-SQL-Generator nutzt GPT, betrieben von OpenAI, um SQL für Ihr SQL-Segment zu empfehlen.

KI-SQL-Generator mit der Eingabe „Users that received a notification last month“

So verwenden Sie den KI-SQL-Generator:

  1. Wählen Sie KI-SQL-Generator starten, nachdem Sie ein SQL-Segment mit vollständiger oder inkrementeller Aktualisierung erstellt haben.
  2. Geben Sie Ihre Eingabe ein und wählen Sie Generieren, um Ihre Eingabe in SQL zu übersetzen.
  3. Überprüfen Sie das generierte SQL, um sicherzustellen, dass es korrekt aussieht, und speichern Sie dann Ihr Segment.

Beispiel-Eingaben

  • Nutzer:innen, die im letzten Monat eine E-Mail erhalten haben
  • Nutzer:innen, die im letzten Jahr weniger als fünf Käufe getätigt haben

Tipps

  • Machen Sie sich mit den verfügbaren Snowflake-Datentabellen vertraut. Das Abfragen von Daten, die in diesen Tabellen nicht existieren, kann dazu führen, dass ChatGPT eine fiktive Tabelle erstellt.
  • Machen Sie sich mit den SQL-Schreibregeln für dieses Feature vertraut. Die Nichtbeachtung dieser Regeln führt zu einem Fehler. Beispielsweise muss Ihr SQL-Code die Spalte user_id auswählen. Es kann hilfreich sein, Ihre Eingabe mit „users who“ zu beginnen.
  • Sie können bis zu 20 Eingaben pro Minute mit dem KI-SQL-Generator senden.

Wie werden meine Daten verwendet und an OpenAI gesendet?

Um KI-Ausgaben über BrazeAI-Features zu generieren, die OpenAI nutzen („Output“), sendet Braze bestimmte Informationen („Input“) an OpenAI. Der Input besteht aus Ihren Eingabeaufforderungen und kann die im Dashboard angezeigten Inhalte sowie andere für Ihre Anfragen relevante Workspace-Daten umfassen. Gemäß den Verpflichtungen der API-Plattform von OpenAI werden Daten, die über Braze an die API von OpenAI gesendet werden, nicht zum Trainieren oder Verbessern von OpenAI-Modellen verwendet. OpenAI kann Daten für 30 Tage zur Missbrauchsüberwachung aufbewahren, danach werden sie gelöscht. Zwischen Ihnen und Braze ist der Output Ihr geistiges Eigentum. Braze erhebt keine Urheberrechtsansprüche auf solchen Output. Braze übernimmt keinerlei Garantie in Bezug auf KI-generierte Inhalte, einschließlich Output.

Wenn die Verarbeitung der Erweiterung abgeschlossen ist, können Sie mithilfe Ihrer Segmenterweiterung ein Segment erstellen und dieses neue Segment mit Ihren Campaigns und Canvases ansprechen.

Schritt 2: SQL schreiben

Ihr SQL sollte in Snowflake-Syntax geschrieben werden. Informationen zu allen verfügbaren Tabellen und Spalten finden Sie in der Tabellenreferenz.

Ihr SQL muss außerdem die folgenden Regeln einhalten:

  • Schreiben Sie eine einzelne SQL-Anweisung. Verwenden Sie keine Semikolons.
  • Ihr SQL darf nur eine Spalte auswählen: die Spalte user_id. Das bedeutet, Ihr SQL muss Folgendes enthalten:
SELECT DISTINCT user_id FROM "INSERT TABLE NAME"
  • Es ist nicht möglich, Nutzer:innen mit null Ereignissen abzufragen. Das bedeutet, dass jede Abfrage nach Nutzer:innen, die ein Ereignis weniger als X Mal ausgeführt haben, folgenden Workaround erfordert:
    1. Schreiben Sie eine Abfrage, die Nutzer:innen auswählt, die das Ereignis MEHR als X Mal ausgeführt haben.
    2. Wenn Sie Ihre Segmenterweiterung in Ihrem Segment referenzieren, wählen Sie doesn't include, um das Ergebnis umzukehren.

Zusätzliche Regeln

Darüber hinaus muss Ihre Standard-SQL-Abfrage die folgenden Regeln einhalten:

  • Sie können keine DECLARE-Anweisungen verwenden.

Alle inkrementellen Aktualisierungsabfragen bestehen aus zwei Teilen: einer Abfrage und Schemadetails.

  1. Schreiben Sie im Editor eine Abfrage, die user_ids aus Ihrer gewünschten Tabelle auswählt.
  2. Fügen Sie Schemadetails hinzu, indem Sie einen Operator, eine Anzahl und einen Zeitraum aus den Feldern oben im Editor auswählen. Die Abfrage prüft, ob die Summe der Aggregatspalte die Bedingung erfüllt, die Sie mit diesen Feldern festgelegt haben. Dies funktioniert ähnlich wie der Workflow zur Erstellung klassischer Segmenterweiterungen.

    • Operator: Geben Sie an, ob das Ereignis mehr als, weniger als oder gleich einer bestimmten Anzahl von Vorkommen stattgefunden hat.
      Operator-Feld mit „Mehr als“ ausgewählt.

    • Anzahl: Wie oft Sie das Ereignis in Bezug auf den Operator auswerten möchten.
      Anzahl-Feld mit „5“ eingegeben.

    • Zeitraum: Anzahl der Tage von 1 bis 730, in denen Sie nach Instanzen des Ereignisses suchen möchten. Dieser Zeitraum bezieht sich auf vergangene Tage relativ zum aktuellen Tag. Das folgende Beispiel zeigt die Abfrage nach Nutzer:innen, die das Ereignis mehr als 5 Mal in den letzten 365 Tagen ausgeführt haben.
      Zeitraum-Feld mit „365“ eingegeben.

Im folgenden Beispiel würde das resultierende Segment Nutzer:innen enthalten, die das Ereignis favorited mehr als 3 Mal während der letzten 30 Tage nach einem bestimmten Datum ausgeführt haben.

SQL-Editor mit einer beispielhaften inkrementellen SQL-Segmenterweiterung.

SQL-Vorschau einer inkrementellen SQL-Segmenterweiterung.

Wie die inkrementelle Aktualisierung Nutzer:innen über die Zeit verfolgt

Bei der inkrementellen Aktualisierung speichert Braze tägliche Zählungen für alle Nutzer:innen in einer internen Zähltabelle, sodass Ihr Segment über den gesamten Zeitraum ausgewertet werden kann, ohne täglich alle historischen Daten erneut abzufragen.

Was gespeichert wird: Braze pflegt eine Zähltabelle (ähnlich einer Segment-Kohortentabelle), die tägliche Qualifikationszählungen der Nutzer:innen im Format (date, user_id, count) akkumuliert. Diese Tabelle behält historische Daten außerhalb des zweitägigen rollierenden Aktualisierungsfensters bei.

Was bei jeder Aktualisierung passiert: Wenn eine inkrementelle Aktualisierung ausgeführt wird, löscht Braze nur die Datensätze im zweitägigen rollierenden Aktualisierungsfenster aus der Zähltabelle. Anschließend wird Ihre SQL-Abfrage mit aktualisierten Zeitparametern (unter Verwendung von $start_date) erneut ausgeführt, um neue Zeilen für diese Daten einzufügen. Historische Zeilen außerhalb des zweitägigen rollierenden Aktualisierungsfensters bleiben in der Zähltabelle intakt.

Wie Braze entscheidet, wer zum Segment gehört: Braze wertet Ihre Segment-Mitgliedschaftskriterien anhand der gesamten akkumulierten Zähltabelle aus, nicht nur anhand der letzten zweitägigen rollierenden Aktualisierungsdaten. Das bedeutet, dass Nutzer:innen, die sich vor mehr als zwei Tagen qualifiziert haben, im Segment verbleiben, es sei denn, die aggregierten Zählungen erfüllen Ihre Kriterien nicht mehr.

SQL schreiben, das zuverlässig aktualisiert: Beim Schreiben von SQL für die inkrementelle Aktualisierung sollten Sie Abfragemuster vermeiden, die bei Teilaktualisierungen inkonsistente Ergebnisse erzeugen könnten. Beispielsweise können fensterbasierte Aggregationen wie MAX(time), die von Daten über $start_date-Grenzen hinweg abhängen, den Zeilenstatus unerwartet ändern, wenn nur eine Teilmenge von Daten neu berechnet wird. Strukturieren Sie Ihre Abfragen so, dass die Ausgabe jedes Tages nur von Ereignissen dieses Tages abhängt. Dies gewährleistet konsistente Ergebnisse, unabhängig davon, ob die Abfrage zwei oder 730 Tage an Daten verarbeitet.

Zusätzliche Regeln

Darüber hinaus muss Ihre inkrementelle Aktualisierungsabfrage die folgenden Regeln einhalten:

  • Schreiben Sie eine einzelne SQL-Anweisung. Verwenden Sie keine Semikolons.
  • Ihr inkrementelles SQL-Segment kann sich nur auf ein Ereignis beziehen. Ihre Dropdowns für Datum und Anzahl gelten für dieses Ereignis.
  • Ihr SQL muss den Alias $date() (z. B. $date(time)) enthalten, user_id und eine COUNT()-Aggregation auswählen, nach Datum und user_id gruppieren und mit $start_date auf Ihre Zeitspalte filtern (z. B. time > $start_date). Das Speichern von SQL ohne $date() oder diese Felder gibt einen Fehler zurück.
  • Sie können keine DECLARE-Anweisungen verwenden.

Schritt 3: Vorschau der Abfrage

Vor dem Speichern können Sie eine Vorschau Ihrer Abfrage ausführen. Abfragevorschauen sind automatisch auf 100 Zeilen begrenzt und haben eine Zeitüberschreitung nach 60 Sekunden. Die Anforderung der Spalte user_id gilt beim Ausführen einer Vorschau nicht.

Für inkrementelle SQL-Segmenterweiterungen enthält die Vorschau nicht die zusätzlichen Kriterien aus Ihren Operator-, Anzahl- und Zeitraum-Feldern.

Schritt 4: Bestimmen, ob SQL invertiert werden muss

Bestimmen Sie als Nächstes, ob Sie SQL invertieren müssen. Obwohl es nicht möglich ist, Nutzer:innen mit null Ereignissen direkt abzufragen, können Sie SQL invertieren verwenden, um diese Nutzer:innen anzusprechen.

Um beispielsweise Nutzer:innen mit weniger als drei Käufen anzusprechen, schreiben Sie zunächst eine Abfrage, die Nutzer:innen mit drei oder mehr Käufen auswählt. Wählen Sie dann SQL invertieren, um Nutzer:innen mit weniger als drei Käufen anzusprechen (einschließlich derjenigen mit null Käufen).

Segmenterweiterung mit dem Namen „Clicked 1-4 emails in the last 30 days“ mit der ausgewählten Option „SQL invertieren“.

Aktualisierung der Segmentzugehörigkeit

Um die Segmentzugehörigkeit einer mit SQL erstellten Segmenterweiterung zu aktualisieren, öffnen Sie die Segmenterweiterung und wählen Sie Aktualisieren aus.

Verwalten Ihrer Segmenterweiterungen

Auf der Seite Segmenterweiterungen werden mit SQL generierte Segmente durch neben ihrem Namen gekennzeichnet.

Wählen Sie eine SQL-Segmenterweiterung aus, um anzuzeigen, wo die Erweiterung verwendet wird, die Erweiterung zu archivieren oder die Segmentzugehörigkeit manuell zu aktualisieren.

Abschnitt „Messaging-Nutzung“ des SQL-Editors, der anzeigt, wo das SQL-Segment verwendet wird.

Aktualisierungseinstellungen festlegen

Wenn Sie Ihre Erweiterung nicht regelmäßig aktualisieren müssen, können Sie sie ohne Aktualisierungseinstellungen speichern. Braze generiert Ihre Segmenterweiterung dann standardmäßig auf Grundlage der aktuellen Nutzerzugehörigkeit zu diesem Zeitpunkt. Verwenden Sie das Standardverhalten, wenn Sie die Zielgruppe nur einmal generieren und sie dann mit einer einmaligen Campaign ansprechen möchten.

Die Verarbeitung Ihres Segments beginnt immer nach dem ersten Speichern. Jedes Mal, wenn Ihr Segment aktualisiert wird, führt Braze das Segment erneut aus und aktualisiert die Segmentmitgliedschaft, um die Nutzer:innen in Ihrem Segment zum Zeitpunkt der Aktualisierung widerzuspiegeln. So können Ihre wiederkehrenden Campaigns die relevantesten Nutzer:innen erreichen.

Einrichten einer wiederkehrenden Aktualisierung

Um einen wiederkehrenden Zeitplan einzurichten, wählen Sie Aktualisierung aktivieren. Die Option zur Festlegung von Aktualisierungseinstellungen ist für alle Arten von Segmenterweiterungen verfügbar, einschließlich SQL-Segmente, CDI-Segmenterweiterungen und einfache formularbasierte Segmenterweiterungen.

Auswählen Ihrer Aktualisierungseinstellungen

Aktualisierungsintervall-Einstellungen mit einer wöchentlichen Aktualisierungsfrequenz, einer Startzeit von 10 Uhr und Montag als ausgewähltem Tag.

Im Panel Aktualisierungsintervall-Einstellungen können Sie die Häufigkeit auswählen, mit der diese Segmenterweiterung aktualisiert wird: stündlich, täglich, wöchentlich oder monatlich. Sie müssen außerdem die genaue Uhrzeit (in der Zeitzone Ihres Unternehmens) für die Aktualisierung angeben, z. B.:

  • Wenn Sie eine E-Mail-Campaign haben, die jeden Montag um 11 Uhr Unternehmenszeit versendet wird, und Sie sicherstellen möchten, dass Ihr Segment kurz vor dem Versand aktualisiert wird, sollten Sie einen wöchentlichen Aktualisierungszeitplan montags um 10 Uhr wählen.
  • Wenn Sie möchten, dass Ihr Segment jeden Tag aktualisiert wird, wählen Sie die tägliche Aktualisierungshäufigkeit und dann die Tageszeit für die Aktualisierung aus.

Credit-Verbrauch und zusätzliche Kosten

Da bei Aktualisierungen die Abfrage Ihres Segments erneut ausgeführt wird, verbraucht jede Aktualisierung für SQL-Segmente SQL-Segment-Credits, und jede Aktualisierung für CDI-Segmenterweiterungen verursacht Kosten in Ihrem Drittanbieter-Data-Warehouse.

Kriterien zur automatischen Deaktivierung veralteter Erweiterungen

Geplante Aktualisierungen werden automatisch deaktiviert, sobald eine Segmenterweiterung veraltet ist. Eine Segmenterweiterung gilt als veraltet, wenn sie die folgenden Kriterien erfüllt:

  • Nicht in aktiven Campaigns oder Canvases verwendet
  • In keinem Segment verwendet, das in einer aktiven Campaign oder einem Canvas eingesetzt wird
  • In keinem Segment verwendet, für das Analytics-Tracking aktiviert ist
  • Seit mehr als sieben Tagen nicht geändert wurde
  • Seit mehr als sieben Tagen nicht zu einer Campaign, einem Canvas (einschließlich Entwürfen) oder einem Segment hinzugefügt wurde

Wenn die geplante Aktualisierung für eine Segmenterweiterung deaktiviert wird, erhält diese Erweiterung eine entsprechende Benachrichtigung.

Eine Benachrichtigung mit dem Hinweis: „Geplante Aktualisierungen wurden für diese Erweiterung deaktiviert, da sie in keinen aktiven Campaigns, Canvases oder Segmenten verwendet wird. Die Segmenterweiterung wurde am 23. Februar 2025 um 00:00 Uhr deaktiviert.“

Wenn Sie bereit sind, eine veraltete Segmenterweiterung zu verwenden, überprüfen Sie die Aktualisierungseinstellungen, wählen Sie den Aktualisierungszeitplan, der zu Ihrem Anwendungsfall passt, und speichern Sie dann alle Änderungen.

Snowflake-Credits

Jeder Braze Workspace verfügt über 5 Snowflake-Credits pro Monat. Wenn Sie mehr Credits benötigen, wenden Sie sich an Ihren Account Manager:in. Credits werden immer dann verbraucht, wenn Sie die Mitgliedschaft eines SQL-Segments aktualisieren oder speichern und aktualisieren. Credits werden nicht verbraucht, wenn Sie Vorschauen innerhalb eines SQL-Segments ausführen oder eine klassische Segmenterweiterung speichern oder aktualisieren.

Der Credit-Verbrauch hängt von der Laufzeit Ihrer SQL-Anfrage ab. Je länger die Laufzeit ist, desto mehr Credits kostet eine Abfrage. Die Laufzeit kann je nach Komplexität und Umfang Ihrer Abfragen im Laufe der Zeit variieren. Je komplexer und häufiger Sie Abfragen durchführen, desto größer ist Ihre Ressourcenzuweisung und desto schneller wird Ihre Laufzeit.

Um Credits zu sparen, sollten Sie eine Vorschau Ihrer Abfrage anzeigen, um sicherzustellen, dass sie korrekt ist, bevor Sie die SQL-Segmenterweiterung speichern.

Ihre Credits werden am ersten eines jeden Monats um 12 Uhr UTC auf 5 zurückgesetzt. Sie können Ihren Credit-Verbrauch im Laufe des Monats im Panel für die Credit-Nutzung überwachen. Klicken Sie auf der Seite Segmenterweiterungen auf View SQL Credit Usage.

Panel für die SQL-Credit-Nutzung auf der Seite „SQL-Segmenterweiterungen“

Wenn Ihre Credits null erreichen, geschieht Folgendes:

  • Alle SQL-Segmenterweiterungen, die für automatische Aktualisierung eingerichtet sind, werden nicht mehr aktualisiert, was sich auf die Mitgliedschaft in diesen Segmenten und auf alle Campaigns oder Canvases auswirkt, die auf diese Segmente abzielen.
  • Sie können neue SQL-Segmenterweiterungen nur noch für den Rest des Monats als Entwurf speichern.

Alle Unternehmensnutzer:innen, die ein SQL-Segment erstellt haben, und Ihre Unternehmensadministrator:innen erhalten eine Benachrichtigungs-E-Mail, wenn Sie 50 %, 80 % und 100 % Ihrer Credits verbraucht haben. Nachdem Ihre Credits zu Beginn des nächsten Monats zurückgesetzt wurden, können Sie weitere SQL-Segmente erstellen, und die automatischen Aktualisierungen werden wieder aufgenommen.

Wenn Sie mehr SQL-Segment-Credits oder zusätzliche Segmenterweiterungen erwerben möchten, wenden Sie sich bitte an Ihren Account Manager:in.

New Stuff!