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

Sie benötigen die Berechtigung „PII anzeigen“, um den Abfrage-Builder zu verwenden, da er direkten Zugriff auf einige Kundendaten erlaubt.

Verwenden des Abfrage-Builders

1. Schritt: Erstellen Sie eine SQL-Anfrage

Um eine neue Anfrage zu erstellen, gehen Sie zu Analytics > Query Builder und wählen Sie dann Create SQL Query.

Wenn Sie Inspiration oder Hilfe bei der Gestaltung Ihrer Anfrage benötigen, wählen Sie Query Template und wählen Sie ein vorgefertigtes Template aus. 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. Bewegen Sie den Mauszeiger über den Namen und wählen Sie , um Ihrer SQL-Anfrage einen aussagekräftigen Namen zu geben.

2. Schritt: Erstellen Sie Ihre Anfrage

Bei der Erstellung Ihrer Anfrage können Sie sich von der KI helfen lassen oder sie selbst erstellen.

• using brazeai
• on my own

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

3. Schritt: Generieren Sie Ihren Bericht

Wenn Sie mit der Erstellung Ihrer Anfrage fertig sind, wählen Sie Run Query. Wenn keine Fehler oder Zeitüberschreitungen auftreten, wird aus der Anfrage eine CSV-Datei erstellt.

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

Wichtig

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

Zeitüberschreitungen bei Berichten

Bei Berichten, deren Ausführung länger als sechs Minuten dauert, tritt ein Timeout ein. Wenn dies die erste Anfrage seit längerer Zeit ist, kann die Verarbeitung etwas länger dauern und die Wahrscheinlichkeit eines Timeouts ist daher höher. Versuchen Sie in diesem Fall, den Bericht erneut auszuführen.

Wenn Ihr Bericht auch nach mehreren Versuchen weiterhin ein Timeout verursacht, kontaktieren Sie 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 getriggert 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 ihrer Beschreibungen finden Sie unter Abbruchtypen.

Daten und Ergebnisse

Alle Anfragen beziehen sich auf die Daten der letzten 60 Tage. Wenn Sie Ihre Ergebnisse exportieren, werden nur bis zu 1.000 Zeilen enthalten sein. Für Berichte, die größere Datenmengen erfordern, können Sie Tools wie Currents oder den Export-API-Endpunkt verwenden.

Snowflake Credits

Jedem Unternehmen stehen 5 Snowflake Credits pro Monat zur Verfügung, die auf alle Workspaces aufgeteilt werden. Ein kleiner Teil eines Snowflake Credits wird immer dann verbraucht, wenn Sie eine Anfrage ausführen oder eine Vorschau einer Tabelle anzeigen.

Hinweis

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

Der Verbrauch hängt von der Laufzeit Ihrer SQL-Anfrage ab. Je länger die Laufzeit, desto mehr Snowflake Credits werden verbraucht. Die Laufzeit kann sich je nach Komplexität und Umfang Ihrer Anfragen unterscheiden. Je komplexere und häufigere Anfragen Sie ausführen, desto mehr Ressourcen werden Ihnen zugewiesen und desto schneller wird die Laufzeit.

Credits werden beim Schreiben, Bearbeiten oder Speichern von Berichten im Braze SQL-Editor nicht verbraucht. Ihr Guthaben wird am ersten eines jeden Monats um 12 Uhr UTC auf 5 zurückgesetzt. Sie können den Verbrauch Ihres monatlichen Guthabens oben auf der Seite des Abfrage-Builders einsehen.

Wenn Sie Ihr Guthaben aufgebraucht haben, können Sie keine Anfragen mehr ausführen, aber weiterhin SQL-Berichte erstellen, bearbeiten und speichern. Wenn Sie weitere Abfrage-Builder-Credits erwerben möchten, wenden Sie sich bitte an Ihren Account Manager.