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 Events aus den letzten zwei Jahren (730 Tage) abfragen. Im Gegensatz zu Standard-Segmenterweiterungen verbrauchen SQL-Segmenterweiterungen Credits.

Voraussetzungen

Da es möglich ist, über dieses Feature auf PII-Daten zuzugreifen, müssen Sie über PII-Berechtigungen verfügen, um SQL-Segmentabfragen durchzuführen.

Erstellen einer Segmenterweiterung

1. Schritt: Wählen Sie einen Editor

Bei der Erstellung Ihrer SQL-Segmenterweiterung können Sie zwischen zwei Arten von SQL-Editoren wählen: dem SQL-Editor und dem inkrementellen SQL-Editor.

• Vollständige Aktualisierung: Jedes Mal, wenn Ihr Segment aktualisiert wird, 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 automatisch täglich erneuern, können aber nicht mit inkrementeller Aktualisierung aktualisiert werden.
• Inkrementelle Aktualisierung: Die inkrementelle Aktualisierung stellt eine kosteneffizientere Methode zur Einrichtung Ihrer Abfrage dar, erfordert jedoch einige zusätzliche Schritte. Wenn Sie diese zusätzlichen Schritte beim Erstellen Ihres Segments ausführen können, empfiehlt es sich, diese Option zu wählen, da Ihre Abfrage dann mit weniger Credits ausgeführt wird.
• KI-SQL-Generator: Mit dem KI-SQL-Generator können Sie einen Prompt in einfacher Sprache schreiben und ihn in eine SQL-Abfrage für Ihr Segment umwandeln. So können Sie schnell loslegen, ohne selbst SQL schreiben zu müssen.

Tipp

Sie können alle SQL-Segmente, die in einem der beiden SQL-Editoren erstellt wurden, manuell vollständig aktualisieren.

• full refresh
• incremental refresh
• ai sql generator

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

1. Gehen Sie zu Zielgruppe > Segmenterweiterungen.
2. Wählen Sie Neu erstellen und dann Vollständige 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.
   
   
   
   
4. Speichern Sie Ihre Segmenterweiterung.

So erstellen Sie eine SQL-Segmenterweiterung mit inkrementeller Aktualisierung:

1. Gehen Sie zu Zielgruppe > Segmenterweiterungen.
2. Wählen Sie Neu erstellen und dann 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.
   
   
   
   
4. Falls gewünscht, wählen Sie Regenerate Extension Daily.
   
   
   
   Wenn Sie diese Option auswählen, aktualisiert Braze die Segmentmitgliedschaft jeden Tag automatisch. 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 zu Ihrem Segment hinzufügt. Wenn eine Segmenterweiterung 7 Tage lang nicht verwendet wurde, pausiert Braze automatisch die tägliche Regeneration. Eine ungenutzte Segmenterweiterung ist eine, die nicht Teil einer Campaign oder eines Canvas ist (die Campaign oder das Canvas muss nicht aktiv sein, damit die Erweiterung als „genutzt“ gilt).
   
   
5. Speichern Sie Ihre Segmenterweiterung.

Hinweis

Der KI-SQL-Generator ist derzeit als Beta-Feature verfügbar. Wenden Sie sich an Ihren Customer-Success-Manager, wenn Sie an der Teilnahme an diesem Betatest interessiert sind.

Der KI-SQL-Generator nutzt GPT, powered by OpenAI, um SQL-Empfehlungen für Ihr SQL-Segment zu geben.

Um den KI-SQL-Generator zu verwenden, gehen Sie wie folgt vor:

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

Beispiel-Prompts

• 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. Wenn Sie nach Daten fragen, die in diesen Tabellen nicht vorhanden sind, kann es sein, 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. Zum Beispiel muss Ihr SQL-Code die Spalte user_id auswählen. Beginnen Sie Ihren Prompt mit „Nutzer:innen, die“, um bessere Ergebnisse zu erzielen.
• Mit dem KI-SQL-Generator können Sie bis zu 20 Prompts pro Minute 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.

Hinweis

SQL-Anfragen, die länger als 20 Minuten dauern, werden abgebrochen.

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

2. Schritt: Schreiben Sie Ihr SQL

Ihre SQL-Abfrage sollte in Snowflake-Syntax geschrieben sein. In der Tabellenreferenz finden Sie eine vollständige Liste der Tabellen und Spalten, die abgefragt werden können.

Wichtig

Beachten Sie, dass die zur Abfrage verfügbaren Tabellen nur Event-Daten enthalten. Wenn Sie nach Nutzerattributen suchen möchten, sollten Sie Ihr SQL-Segment mit angepassten Attributfiltern aus dem klassischen Segmentierer kombinieren.

• sql editor
• incremental sql editor

Ihr SQL muss zusätzlich die folgenden Regeln einhalten:

• Schreiben Sie eine einzelne SQL-Anweisung. Fügen Sie keine Semikolons ein.
• Ihr SQL darf nur eine Spalte auswählen: die Spalte user_id. Das bedeutet, dass Ihr SQL Folgendes enthalten muss:

1
SELECT DISTINCT user_id FROM "INSERT TABLE NAME"

• Es ist nicht möglich, Nutzer:innen mit null Events abzufragen. Das bedeutet, dass jede Abfrage nach Nutzer:innen, die ein Event weniger als X-mal durchgeführt haben, diesen Workaround befolgen muss:
  1. Schreiben Sie eine Abfrage, um Nutzer:innen auszuwählen, die das Event MEHR als X-mal durchgeführt haben.
  2. Wenn Sie Ihre Segmenterweiterung in Ihrem Segment referenzieren, wählen Sie doesn't include, um das Ergebnis zu invertieren.

Zusätzliche Regeln

Außerdem 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 der gewünschten Tabelle auswählt.
2. Fügen Sie Schemadetails hinzu, indem Sie einen Operator, die Anzahl der Male und den Zeitraum aus den Feldern oberhalb des Editors auswählen. Die Abfrage prüft, ob die Summe der Aggregatspalte eine bestimmte Bedingung erfüllt, die durch die Platzhalter {{operator}} und {{number of times}} angegeben ist. Dies funktioniert ähnlich wie der Arbeitsablauf zur Erstellung klassischer Segmenterweiterungen.
   
   
   • Operator: Geben Sie an, ob das Event mehr als, weniger als oder gleich einer Anzahl von Vorkommen stattgefunden hat.
     
     
     
   • Anzahl der Male: Wie oft Sie das Event in Bezug auf den Operator auswerten möchten.
     
     
     
   • Zeitraum: Anzahl der Tage von 1 bis 730, in denen Sie Instanzen des Events überprüfen möchten. Dieser Zeitraum bezieht sich auf vergangene Tage relativ zum aktuellen Tag. Das folgende Beispiel zeigt die Abfrage nach Nutzer:innen, die das Event in den letzten 365 Tagen mehr als 5 Mal durchgeführt haben.
     

Im folgenden Beispiel würde das resultierende Segment Nutzer:innen enthalten, die das Event favorited mehr als 3 Mal in den letzten 30 Tagen nach einem bestimmten Datum durchgeführt haben.

Tipp

Segmente mit inkrementeller Aktualisierung berücksichtigen späte Events, d. h. Events, die mehr als 2 Tage zurückliegen (z. B. SDK-Events, die zum Zeitpunkt ihrer Erfassung noch nicht gesendet wurden).

Zusätzliche Regeln

Außerdem muss Ihre Abfrage zur inkrementellen Aktualisierung die folgenden Regeln einhalten:

• Schreiben Sie eine einzelne SQL-Anweisung. Fügen Sie keine Semikolons ein.
• Ihr inkrementelles SQL-Segment kann sich nur auf ein einziges Event beziehen. Ihre Dropdowns für Datum und Anzahl beziehen sich auf das von Ihnen gewählte Event.
• Ihr SQL muss die folgenden Spalten enthalten: user_id, $start_date und eine Aggregationsfunktion (wie COUNT). Jedes SQL, das ohne diese drei Felder gespeichert wird, führt zu einem Fehler.
• Sie können keine DECLARE-Anweisungen verwenden.

Hinweis

Wenn Sie ein SQL-Segment erstellen, das die Tabelle CATALOGS_ITEMS_SHARED verwendet, müssen Sie eine Katalog-ID angeben. Zum Beispiel:

1
2
3
SELECT * FROM CATALOGS_ITEMS_SHARED
WHERE CATALOG_ID = 'XYZ'
LIMIT 10

3. Schritt: Vorschau der Abfrage

Vor dem Speichern können Sie eine Vorschau Ihrer Abfrage ausführen. Abfragevorschauen sind automatisch auf 100 Zeilen begrenzt und werden nach 60 Sekunden abgebrochen. Die Anforderung der Spalte user_id gilt nicht, wenn Sie eine Vorschau ausführen.

Bei inkrementellen SQL-Segmenterweiterungen enthält die Vorschau nicht die zusätzlichen Kriterien aus Ihren Feldern für Operator, Anzahl der Male und Zeitraum.

4. Schritt: Prüfen Sie, ob Sie SQL invertieren müssen

Als Nächstes sollten Sie feststellen, ob Sie SQL invertieren müssen. Es ist zwar nicht möglich, direkt nach Nutzer:innen mit null Events zu suchen, jedoch können Sie Invert SQL verwenden, um diese Nutzer:innen anzusprechen.

Hinweis

Standardmäßig ist Invert SQL nicht aktiviert. Wenn Sie jedoch den KI-SQL-Generator verwenden, um eine SQL-Anweisung zu generieren, die negiert werden muss, könnte ChatGPT eine Ausgabe zurückgeben, die dieses Feature automatisch aktiviert.

Um beispielsweise Nutzer:innen anzusprechen, die weniger als drei Käufe getätigt haben, erstellen Sie zunächst eine Abfrage, um Nutzer:innen auszuwählen, die drei oder mehr Käufe getätigt haben. Wählen Sie anschließend Invert SQL, um Nutzer:innen mit weniger als drei Käufen (einschließlich derjenigen mit null Käufen) anzusprechen.

Wichtig

Sofern Sie nicht gezielt Nutzer:innen mit null Events ansprechen möchten, ist es nicht erforderlich, SQL zu invertieren. Wenn Invert SQL ausgewählt ist, vergewissern Sie sich, dass das Feature erforderlich ist und dass das Segment Ihrer gewünschten Zielgruppe entspricht. Wenn eine Abfrage beispielsweise auf Nutzer:innen mit mindestens einem Event abzielt, wird sie bei einer Invertierung nur auf Nutzer:innen mit null Events angewendet.

Segmentmitgliedschaft aktualisieren

Um die Segmentmitgliedschaft einer mit SQL erstellten Segmenterweiterung zu aktualisieren, öffnen Sie die Segmenterweiterung und wählen Sie Refresh.

Tipp

Wenn Sie ein Segment erstellt haben, bei dem Sie erwarten, dass Nutzer:innen regelmäßig ein- und austreten, aktualisieren Sie die verwendete Segmenterweiterung manuell, bevor Sie dieses Segment in einer Campaign oder einem Canvas ansprechen.

Verwalten Ihrer Segmenterweiterungen

Auf der Seite Segmenterweiterungen sind Segmente, die mit SQL generiert wurden, mit neben ihrem Namen gekennzeichnet.

Wählen Sie eine SQL-Segmenterweiterung aus, um zu sehen, wo die Erweiterung verwendet wird, die Erweiterung zu archivieren oder die Segmentmitgliedschaft manuell zu aktualisieren.

Festlegen der Aktualisierungseinstellungen

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.

Wichtig

Um Ihre Datenverwaltung zu optimieren, werden die Aktualisierungseinstellungen für nicht verwendete Segmenterweiterungen automatisch deaktiviert. Segmenterweiterungen gelten als ungenutzt, wenn sie:

• In keinen aktiven oder inaktiven (Entwurf, gestoppt, archiviert) Campaigns, Canvases oder Segmenten verwendet werden; oder
• Seit mehr als 7 Tagen nicht geändert wurden

Braze benachrichtigt den Unternehmenskontakt und die erstellende Person der Erweiterung, wenn diese Einstellung deaktiviert wird. Die Option, Erweiterungen täglich zu regenerieren, kann jederzeit wieder aktiviert werden.

Auswählen Ihrer Aktualisierungseinstellungen

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.

Hinweis

Die Möglichkeit, einen stündlichen Aktualisierungszeitplan festzulegen, ist für formularbasierte Segmenterweiterungen nicht verfügbar (Sie können jedoch tägliche, wöchentliche oder monatliche Zeitpläne festlegen).

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.

Hinweis

Segmente können aufgrund von Datenverarbeitungszeiten bis zu 60 Minuten für die Aktualisierung benötigen. Segmente, die gerade aktualisiert werden, haben in Ihrer Segmenterweiterungsliste den Status „In Bearbeitung“. Dies hat einige Auswirkungen:

• Um die Verarbeitung Ihres Segments vor einer bestimmten Zeit abzuschließen, wählen Sie eine Aktualisierungszeit, die 60 Minuten früher liegt.
• Für eine bestimmte Segmenterweiterung kann jeweils nur eine Aktualisierung gleichzeitig erfolgen. Wenn ein Konflikt auftritt, bei dem eine neue Aktualisierung gestartet wird, während eine bestehende Aktualisierung bereits verarbeitet wird, bricht Braze die neue Aktualisierungsanfrage ab und setzt die laufende Verarbeitung fort.

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.

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. 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.

Hinweis

Snowflake-Credits werden nicht zwischen Features geteilt. So sind beispielsweise Credits für SQL-Segmenterweiterungen und den Abfrage-Builder unabhängig voneinander.

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.

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.