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-Segment-Anfragen 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 regenerieren, können jedoch nicht mit inkrementeller Aktualisierung aufgefrischt werden.
• Inkrementelle Aktualisierung: Die inkrementelle Aktualisierung ist eine kostengünstigere Methode, Ihre Abfrage einzurichten, obwohl die Einrichtung einige zusätzliche Schritte umfasst. Wenn Sie diese zusätzlichen Schritte bei der Erstellung Ihres Segments durchfü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, einen Prompt in natürlicher Sprache zu verfassen und diesen in eine SQL-Abfrage für Ihr Segment umzuwandeln. Es ist eine schnelle Möglichkeit, loszulegen, ohne selbst SQL schreiben zu müssen.

Tipp

Sie können bei allen in beiden SQL-Editoren erstellten SQL-Segments eine manuelle vollständige Aktualisierung durchführen.

• vollständige aktualisierung
• inkrementelle aktualisierung
• ki-sql-generator

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.
   
   
   
   
3. Geben Sie einen Namen für Ihre Segmenterweiterung ein und fügen Sie Ihr SQL ein. Weitere Anforderungen und Ressourcen finden Sie unter 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 Neue Erweiterung erstellen und dann Inkrementelle Aktualisierung.
   
   
   
   
3. Geben Sie einen Namen für Ihre Segmenterweiterung ein und fügen Sie Ihr SQL ein. Weitere Anforderungen und Ressourcen finden Sie im Abschnitt SQL schreiben.
   
   
   
   
4. Aktivieren Sie bei Bedarf Erweiterung täglich regenerieren.
   
   
   
   Wenn diese Option aktiviert ist, aktualisiert Braze die Segmentmitgliedschaft automatisch jeden Tag. Das bedeutet, dass Braze jeden Tag um Mitternacht in der Zeitzone Ihres Unternehmens (mit einer möglichen Verzögerung von einer Stunde) prüft, ob neue Nutzer:innen in Ihrem Segment vorhanden sind, 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.

Hinweis

Der KI-SQL-Generator ist derzeit als Beta-Feature verfügbar. Wenden Sie sich an Ihren CSM, wenn Sie an diesem Beta-Test teilnehmen möchten.

Der KI-SQL-Generator nutzt GPT, unterstützt durch OpenAI, um SQL für Ihr SQL-Segment zu empfehlen.

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 Ihren Prompt ein und wählen Sie Generieren, um Ihren Prompt in SQL umzuwandeln.
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 ChatGPT eine fiktive Tabelle erstellen.
• Machen Sie sich mit den SQL-Schreibregeln für dieses Feature vertraut. Ein Nichtbeachten dieser Regeln führt zu einem Fehler. Ihr SQL-Code muss beispielsweise die Spalte user_id auswählen. Es kann helfen, Ihren Prompt mit „users who“ zu beginnen.
• Sie können bis zu 20 Prompts 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.

Hinweis

SQL-Abfragen, deren Ausführung länger als 20 Minuten dauert, werden aufgrund einer Zeitüberschreitung abgebrochen.

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

Schritt 2: SQL schreiben

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

Wichtig

Beachten Sie, dass die abfragbaren Tabellen nur Ereignisdaten enthalten. Wenn Sie Nutzerattribute abfragen möchten, sollten Sie Ihr SQL-Segment mit Filtern für angepasste Attribute aus dem klassischen Segmentierer kombinieren.

• sql-editor
• inkrementeller sql-editor

Ihr SQL muss zusätzlich folgende 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:

1
SELECT DISTINCT user_id FROM "INSERT TABLE NAME"

• Es ist nicht möglich, nach Nutzer:innen zu suchen, die null Ereignisse haben. 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 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 folgende Regeln einhalten:

• Sie können keine DECLARE-Anweisungen verwenden.

Alle Abfragen mit inkrementeller Aktualisierung 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, eine Anzahl und einen Zeitraum aus den Feldern oben im Editor auswählen. Die Abfrage prüft, ob die Summe der Aggregationsspalte eine bestimmte Bedingung erfüllt, die durch die Platzhalter {{operator}} und {{number of times}} festgelegt wird. 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.
     
     
     
   • Anzahl: Wie oft Sie das Ereignis in Bezug auf den Operator auswerten möchten.
     
     
     
   • Zeitraum: Anzahl der Tage von 1 bis 730, in denen Sie Vorkommen des Ereignisses prüfen möchten. Dieser Zeitraum bezieht sich auf vergangene Tage relativ zum aktuellen Tag. Das folgende Beispiel zeigt eine Abfrage nach Nutzer:innen, die das Ereignis in den letzten 365 Tagen mehr als 5 Mal ausgeführt haben.
     

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

Tipp

Segmente mit inkrementeller Aktualisierung berücksichtigen verspätete Ereignisse, also Ereignisse, die vor mehr als 2 Tagen stattfanden (beispielsweise SDK-Ereignisse, die zum Zeitpunkt der Erfassung nicht gesendet wurden).

Zusätzliche Regeln

Darüber hinaus muss Ihre Abfrage mit inkrementeller Aktualisierung folgende Regeln einhalten:

• Schreiben Sie eine einzelne SQL-Anweisung. Verwenden Sie keine Semikolons.
• Ihr inkrementelles SQL-Segment kann sich nur auf ein einzelnes Ereignis beziehen. Ihre Dropdowns für Datum und Anzahl beziehen sich auf das von Ihnen gewählte Ereignis.
• 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

Schritt 3: Vorschau der Abfrage anzeigen

Bevor Sie 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 user_id-Spalte 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 Zeitraumfeldern.

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, direkt nach Nutzer:innen mit null Ereignissen zu suchen, können Sie SQL invertieren verwenden, um diese Nutzer:innen anzusprechen.

Hinweis

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

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 (einschließlich derjenigen mit null Käufen) anzusprechen.

Wichtig

Sofern Sie nicht gezielt Nutzer:innen mit null Ereignissen ansprechen möchten, müssen Sie SQL nicht invertieren. Wenn SQL invertieren ausgewählt ist, bestätigen Sie, dass das Feature benötigt wird und dass das Segment Ihrer gewünschten Zielgruppe entspricht. Wenn eine Abfrage beispielsweise Nutzer:innen mit mindestens einem Ereignis anspricht, werden bei Invertierung nur Nutzer:innen mit null Ereignissen angesprochen.

Aktualisierung der Segmentzugehörigkeit

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

Tipp

Wenn Sie ein Segment erstellt haben, in das Nutzer:innen voraussichtlich regelmäßig eintreten und wieder austreten, aktualisieren Sie die verwendete Segmenterweiterung manuell, bevor Sie dieses Segment in einer Campaign oder einem Canvas als Zielgruppe verwenden.

Verwalten Ihrer Segmenterweiterungen

Auf der Seite Segmenterweiterungen werden Segments, die mit SQL generiert wurden, mit neben ihrem Namen gekennzeichnet.

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

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.

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

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