Abfrage-Builder

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 bestimmte Kundendaten ermöglicht.

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 SQL-Anfrage erstellen aus.

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

Ihr Bericht erhält automatisch einen Namen mit dem aktuellen Datum und der aktuellen 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 schreiben.

• mit brazeai
• eigene erstellung

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 aus. Wenn keine Fehler oder Berichts-Zeitüberschreitungen auftreten, wird aus der Anfrage eine CSV-Datei generiert.

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

Wichtig

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

Zeitüberschreitung bei Berichten

Berichte, deren Ausführung länger als sechs Minuten dauert, werden aufgrund einer Zeitüberschreitung abgebrochen. Wenn Sie zum ersten Mal seit Längerem eine Anfrage ausführen, kann die Verarbeitung länger dauern und die Wahrscheinlichkeit einer Zeitüberschreitung ist höher. Versuchen Sie in diesem Fall, den Bericht erneut auszuführen.

Wenn bei Ihrem Bericht nach mehreren Versuchen weiterhin eine Zeitüberschreitung auftritt, 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 Tabellenvorschau anzeigen.

Hinweis

Snowflake-Credits werden nicht zwischen Features geteilt. Zum Beispiel 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, desto höher ist der Anteil eines Snowflake-Credits, den eine Anfrage kostet. Die Laufzeit kann je nach Komplexität und Größe Ihrer Anfragen variieren. Je komplexer und häufiger Ihre Anfragen sind, 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 00:00 Uhr UTC auf 5 zurückgesetzt. Sie können Ihren monatlichen Credit-Verbrauch oben auf der Seite des Abfrage-Builders überwachen.

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