Anfragen im Abfrage-Builder erstellen

Lernen Sie, wie Sie den Abfrage-Builder verwenden, um Berichte mit Braze-Daten in Snowflake zu erstellen. Der Abfrage-Builder enthält vorgefertigte SQL-Anfragen-Templates, die Ihnen den Einstieg erleichtern. Sie können aber auch Ihre eigenen angepassten SQL-Anfragen schreiben, um noch mehr Insights zu gewinnen.

Voraussetzungen

Um den Abfrage-Builder zu verwenden, benötigen Sie die folgenden Berechtigungen:

• PII anzeigen: Der Abfrage-Builder ermöglicht den direkten Zugriff auf einige Kundendaten.
• Dashboard-Berichte anzeigen: Diese Berechtigung ist erforderlich, damit Nutzer:innen ohne Administratorrechte den Abfrage-Builder im Dashboard sehen können.

Verwendung des Abfrage-Builders

Schritt 1: SQL-Anfrage erstellen

Um eine neue Anfrage zu erstellen, gehen Sie zu Analytics > Abfrage-Builder und wählen Sie dann SQL-Anfrage erstellen aus.

Wenn Sie Inspiration oder Hilfe beim Erstellen Ihrer Anfrage benötigen, wählen Sie Abfrage-Template und ein vorgefertigtes Template. Um mit einer leeren Anfrage zu beginnen, wählen Sie SQL-Editor.

Ihr Bericht erhält automatisch einen Namen mit dem aktuellen Datum und der Uhrzeit. Fahren Sie mit der Maus über den Namen und wählen Sie , um Ihrer SQL-Anfrage einen aussagekräftigen Namen zu geben.

Schritt 2: Anfrage erstellen

Beim Erstellen Ihrer Anfrage können Sie sich von KI unterstützen lassen oder die Anfrage selbst formulieren.

• mit brazeai
• selbst erstellen

1
2
3
SELECT COUNT(*) as Purchases, SUM(price) as Revenue
FROM USERS_BEHAVIORS_PURCHASE_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('hour', -1, date_trunc('day',CURRENT_DATE()));

1
2
3
SELECT COUNT(*) as Sends
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('month', -1, date_trunc('day',CURRENT_DATE()));

1
2
3
SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100

Schritt 3: Bericht generieren

Wenn Sie Ihre Anfrage fertig erstellt haben, wählen Sie Anfrage ausführen. Wenn keine Fehler oder Berichts-Timeouts auftreten, wird aus der Anfrage eine CSV-Datei generiert.

Um den CSV-Bericht herunterzuladen, wählen Sie Exportieren.

Wichtig

Jeder Bericht kann nur einmal pro Tag Ergebnisse generieren. Wenn Sie denselben Bericht mehrmals an einem Kalendertag ausführen, werden in jedem Bericht dieselben Ergebnisse angezeigt.

Timeouts bei Berichten

Berichte, deren Ausführung länger als sechs Minuten dauert, werden durch ein Timeout abgebrochen. Wenn Sie zum ersten Mal seit längerer Zeit eine Anfrage ausführen, kann die Verarbeitung länger dauern und die Wahrscheinlichkeit eines Timeouts ist höher. Sollte dies passieren, versuchen Sie, den Bericht erneut auszuführen.

Wenn Ihr Bericht nach mehreren Versuchen weiterhin durch ein Timeout abgebrochen wird, wenden Sie sich an den Support.

Abbruchgründe abfragen

Sie können die Spalte ABORT_TYPE in jeder USERS_MESSAGES_*_ABORT_SHARED-Tabelle abfragen, um zu analysieren, warum Nachrichten nicht gesendet wurden. Das Feld ABORT_TYPE enthält einen String-Wert, der den spezifischen Grund für den Abbruch beschreibt, und das zugehörige Feld ABORT_LOG enthält zusätzliche Details (z. B. die Frequency-Capping-Regel, die ausgelöst wurde).

Um beispielsweise E-Mail-Abbrüche nach Typ in den letzten 30 Tagen zu zählen:

1
2
3
4
5
SELECT ABORT_TYPE, COUNT(*) as abort_count
FROM USERS_MESSAGES_EMAIL_ABORT_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('day', -30, CURRENT_DATE())
GROUP BY ABORT_TYPE
ORDER BY abort_count DESC

Die vollständige Liste der ABORT_TYPE-Werte und deren Beschreibungen finden Sie unter Abbruchtypen.

Daten und Ergebnisse

Alle Anfragen liefern Daten aus den letzten 60 Tagen. Wenn Sie Ihre Ergebnisse exportieren, enthält der Export nur bis zu 1.000 Zeilen. Für Berichte, die größere Datenmengen erfordern, können Sie Tools wie Currents oder den Export-API-Endpunkt verwenden.

Snowflake-Credits

Jedes Unternehmen verfügt über 5 Snowflake-Credits pro Monat, die über alle Workspaces hinweg geteilt werden. Ein kleiner Teil eines Snowflake-Credits wird jedes Mal verbraucht, wenn Sie eine Anfrage ausführen oder eine Tabelle in der Vorschau anzeigen.

Hinweis

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

Der Credit-Verbrauch korreliert mit der Laufzeit Ihrer SQL-Anfrage. Je länger die Laufzeit ist, desto größer ist der Anteil eines Snowflake-Credits, den eine Anfrage kostet. Die Laufzeit kann je nach Komplexität und Größe Ihrer Anfragen im Laufe der Zeit variieren. Je komplexer und häufiger die Anfragen sind, die Sie ausführen, desto größer wird Ihre Ressourcenzuweisung und desto schneller wird Ihre Laufzeit.

Credits werden nicht verbraucht, wenn Sie Berichte im Braze-SQL-Editor schreiben, bearbeiten oder speichern. Ihre Credits werden am Ersten jedes Monats um 12:00 Uhr UTC auf 5 zurückgesetzt. Sie können Ihren monatlichen Credit-Verbrauch oben auf der Seite des Abfrage-Builders einsehen.

Wenn Sie das Credit-Limit erreichen, können Sie keine Anfragen mehr ausführen, aber Sie können SQL-Berichte erstellen, bearbeiten und speichern. Wenn Sie zusätzliche Credits für den Abfrage-Builder erwerben möchten, wenden Sie sich bitte an Ihren Account Manager.