Abfrage-Builder

Der Abfrage-Builder erstellt Berichte aus Braze-Daten in Snowflake. Der Abfrage-Builder enthält vorgefertigte SQL-Abfrage-Templates, die Ihnen den Einstieg erleichtern, oder Sie schreiben eigene SQL-Anfragen, um noch mehr Insights zu gewinnen.

Voraussetzungen

Um den Abfrage-Builder zu verwenden, benötigen Sie diese Berechtigungen auf Workspace-Ebene:

Verfügbare Datentabellen

Der Abfrage-Builder verwendet dieselben Snowflake-SQL-Tabellen wie SQL-Segmenterweiterungen und Snowflake Data Sharing. Eine vollständige Liste der verfügbaren Tabellen und ihrer Spalten finden Sie in der SQL-Tabellenreferenz.

Ansichten der Nutzerprofil-Attribute

Der Abfrage-Builder und SQL-Segmenterweiterungen enthalten die meisten Ansichten der Nutzerprofil-Attribute, etwa regelmäßige Snapshots und den Verlauf der Standardattribute.

Zwei Ansichten für angepasste Attribute sind nur über Snowflake Data Sharing verfügbar:

• USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED
• USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED

Braze schließt diese Ansichten aus dem Abfrage-Builder und den SQL-Segmenterweiterungen aus, da Abfragen auf Workspace-Ebene langsam sind und häufig zu Zeitüberschreitungen führen. Verwenden Sie im Abfrage-Builder USER_CUSTOM_ATTRIBUTES_VIEW_SHARED für Snapshots angepasster Attribute. Wenn Sie historische Daten oder Daten zu angepassten Attributen nahezu in Realtime benötigen, fragen Sie die ausgeschlossenen Ansichten stattdessen über Snowflake Data Sharing ab.

Berichte im Abfrage-Builder ausführen

So führen Sie einen Bericht im Abfrage-Builder aus:

1. Gehen Sie zu Analytics > Query Builder.
2. Wählen Sie Create SQL Query aus. Wenn Sie Inspiration oder Hilfe beim Erstellen Ihrer Abfrage benötigen, wählen Sie Query Template und anschließend ein Template aus der Liste aus. Andernfalls wählen Sie SQL Editor, um direkt zum Editor zu gelangen.
3. 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 aus, um Ihrer SQL-Abfrage einen aussagekräftigen Namen zu geben.
4. Schreiben Sie Ihre SQL-Abfrage im Editor oder wählen Sie Ask Operator aus, um SQL mit Operator zu generieren. Wenn Sie Ihr eigenes SQL schreiben, finden Sie unter Angepasste SQL-Abfragen schreiben Anforderungen und Ressourcen.
5. Wählen Sie Run Query aus.
6. Speichern Sie Ihre Abfrage.
7. Um eine CSV-Datei Ihres Berichts herunterzuladen, wählen Sie Export aus.

Bei jeder Ausführung eines Berichts fragt der Abfrage-Builder die Daten ab, die aktuell in Snowflake verfügbar sind. Die Ergebnisse können sich zwischen einzelnen Ausführungen ändern, auch innerhalb desselben Tages, sobald neue Daten eingehen. Aufgrund von Verzögerungen bei der Aufnahme und Verarbeitung kann es etwas dauern, bis aktuelle Events angezeigt werden.

Abfrage-Templates

Sie greifen auf Abfrage-Templates zu, indem Sie beim ersten Erstellen eines Berichts Create SQL Query > Query Template auswählen.

Eine Liste der verfügbaren Templates finden Sie unter Abfrage-Templates.

Datenzeitraum

Abfragen liefern Daten der letzten 60 Tage. Wenn Sie Currents oder Snowflake Data Sharing nutzen, können Sie unter Umständen Daten von bis zu zwei Jahren abfragen. So lange werden Ihre Daten in Snowflake aufbewahrt. Weitere Informationen zur erweiterten Datenaufbewahrung erhalten Sie von Ihrem Customer-Success-Manager.

Zeitzone im Abfrage-Builder

Die Standardzeitzone für Abfragen unserer Snowflake-Datenbank ist UTC. Daher kann es zu Abweichungen zwischen den Daten auf Ihrer Seite Email Channel Engagement (die der Zeitzone Ihres Unternehmens folgt) und den Ergebnissen im Abfrage-Builder kommen.

Um die Zeitzone in Ihren Abfrageergebnissen umzurechnen, fügen Sie Ihrer Abfrage das folgende SQL hinzu und passen Sie es an die Zeitzone Ihres Unternehmens an:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

SELECT
DATE_TRUNC(
'day',
CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME))
) AS send_date_sydney,
COUNT(ID) AS emails_sent
USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE
-- Apply the date range in Sydney time as well
CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME)) >= '2025-03-25 00:00:00'
AND CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME)) < '2025-03-29 00:00:00'
AND APP_GROUP_ID = 'your app group ID'
GROUP BY
send_date_sydney
ORDER BY
send_date_sydney;

Abfrageverlauf

Der Bereich Abfrageverlauf im Abfrage-Builder zeigt Ihre zuvor ausgeführten Abfragen an, damit Sie Ihre Arbeit nachverfolgen und wiederverwenden können. Der Abfrageverlauf wird sieben Tage lang aufbewahrt. Abfragen, die älter als sieben Tage sind, werden also automatisch entfernt.

Wenn Sie die Nutzung von Abfragen über längere Zeiträume prüfen oder Aufzeichnungen über sieben Tage hinaus aufbewahren müssen, empfehlen wir, wichtige Abfrageergebnisse zu exportieren oder zu speichern, bevor sie ablaufen.

Abfrage-Builder mit anderen Berichtsquellen vergleichen

Die Ergebnisse im Abfrage-Builder können von anderen Berichtstools abweichen, da diese unterschiedliche Datenquellen und Verarbeitungsmethoden verwenden.

So kann die Anzahl der Soft Bounces im Abfrage-Builder beispielsweise höher sein als in den Zustellbarkeitsberichten von SendGrid. Der Abfrage-Builder zählt alle Vorkommen von Soft Bounces ohne Deduplizierung. Wenn bei einer Nutzer:in vor der endgültigen Zustellung (oder nach längeren Wiederholungsversuchen) mehrere Soft Bounces auftreten, wird jeder Soft-Bounce-Versuch gezählt. SendGrid Deliverability verwendet eigene Daten und eigene Logik, in die Braze keinen Einblick hat. Daher stimmen die Zahlen der beiden Berichte möglicherweise nicht überein.

Weitere Informationen darüber, wie Soft Bounces in verschiedenen Berichtsquellen erfasst werden, finden Sie unter Soft Bounce im Glossar der E-Mail-Analytics.

SQL mit Operator generieren

Hinweis

Dieses Feature ist jetzt Teil von BrazeAI^TM Operator, dem einheitlichen KI-Assistenten von Braze. KI-Funktionen, die zuvor als eigenständige Assistenten verfügbar waren, sind jetzt alle über Operator zugänglich – direkt dort, wo Sie bereits im Dashboard arbeiten.

Wählen Sie im Seitenpanel des Abfrage-Builders Ask Operator aus und beschreiben Sie die gewünschten Daten. Operator schreibt SQL für die verfügbaren Braze-Datentabellen. Sie können das SQL prüfen und eine Vorschau der Ergebnisse ansehen, bevor Sie Ihren Bericht ausführen. Um Operator im Abfrage-Builder zu verwenden, benötigen Sie die Berechtigung „Edit Dashboard Reports“.

Generiertes SQL muss denselben Regeln für das Schreiben von SQL entsprechen wie Abfragen, die Sie selbst schreiben. Weitere Informationen finden Sie unter Was Sie mit Operator tun können. Wie Operator mit Ihren Daten umgeht, erfahren Sie unter Datenschutz und Sicherheit bei Operator.

Eigene SQL-Anfragen schreiben

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

So zeigen Sie Tabellendetails im Abfrage-Builder an:

1. Öffnen Sie auf der Seite Query Builder das Panel Reference und wählen Sie Available Data Tables, um die verfügbaren Datentabellen und ihre Namen anzuzeigen.
2. Wählen Sie See Details, um die Tabellenbeschreibung und Informationen zu den Tabellenspalten wie Datentypen anzuzeigen.
3. Um den Tabellennamen in Ihr SQL einzufügen, wählen Sie Copy table name to SQL editor.

Um von Braze bereitgestellte vorgefertigte Abfragen zu verwenden, wählen Sie Query Template beim Erstellen eines Berichts im Abfrage-Builder.

Wenn Sie Ihre Abfrage auf einen bestimmten Zeitraum beschränken, werden Ergebnisse schneller generiert. Das folgende Beispiel zeigt eine Abfrage, die die Anzahl der Käufe und den generierten Umsatz der letzten Stunde abruft.

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()));

Diese Abfrage ruft die Anzahl der E-Mail-Versendungen im letzten Monat ab:

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()));

Wenn Sie nach CANVAS_ID, CANVAS_VARIATION_API_ID oder CAMPAIGN_ID abfragen, werden die zugehörigen Namensspalten automatisch in die Ergebnistabelle aufgenommen. Sie müssen sie nicht in die SELECT-Abfrage selbst einschließen.

Diese Abfrage ruft alle drei IDs und ihre zugehörigen Namensspalten mit maximal 100 Zeilen ab:

1
2
3

SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100

Kampagnenvarianten-Name automatisch befüllen

Wenn der Kampagnenvarianten-Name automatisch befüllt werden soll, fügen Sie den Spaltennamen MESSAGE_VARIATION_API_ID in Ihre Abfrage ein, wie in diesem Beispiel:

1
2
3

SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID, MESSAGE_VARIATION_API_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100

Fehlerbehebung

Ihre Abfrage kann aus folgenden Gründen fehlschlagen:

• Syntaxfehler in Ihrer SQL-Abfrage
• Verarbeitungs-Timeout (nach 6 Minuten)
  • Berichte, deren Ausführung länger als 6 Minuten dauert, werden abgebrochen.
  • Wenn ein Bericht ein Timeout hat, versuchen Sie, den Zeitraum der abgefragten Daten einzuschränken oder einen spezifischeren Datensatz abzufragen.

Variablen verwenden

Mit Variablen können Sie vordefinierte Variablentypen in SQL nutzen, um auf Werte zu verweisen, ohne diese manuell kopieren zu müssen. Statt beispielsweise die ID einer Campaign manuell in den SQL-Editor zu kopieren, können Sie {{campaign.${My campaign}}} verwenden und eine Campaign direkt aus einem Dropdown-Menü im Tab Variablen auswählen.

Nachdem Sie eine Variable erstellt haben, erscheint sie im Tab Variablen Ihres Abfrage-Builder-Berichts. Die Vorteile der Verwendung von SQL-Variablen umfassen:

• Sparen Sie Zeit, indem Sie eine Campaign-Variable erstellen, aus der Sie beim Erstellen Ihres Berichts auswählen können, anstatt Campaign-IDs manuell einzufügen.
• Tauschen Sie Werte aus, indem Sie Variablen hinzufügen, mit denen Sie den Bericht in Zukunft für leicht abweichende Anwendungsfälle wiederverwenden können (z. B. ein anderes angepasstes Event).
• Reduzieren Sie Fehler beim Bearbeiten Ihres SQL, indem Sie den Bearbeitungsaufwand für jeden Bericht verringern. Teammitglieder, die sich mit SQL besser auskennen, können Berichte erstellen, die weniger technisch versierte Teammitglieder dann nutzen können.

Richtlinien

Variablen müssen der folgenden Liquid-Syntax entsprechen: {{ type.${name}}}. Dabei muss type einer der akzeptierten Typen sein, und für name können Sie einen beliebigen Namen wählen. Die Labels dieser Variablen entsprechen standardmäßig dem Variablennamen.

Standardmäßig sind alle Variablen Pflichtfelder (Ihr Bericht wird erst ausgeführt, wenn Variablenwerte ausgewählt sind). Eine Ausnahme bildet der Datumsbereich: Wenn kein Wert angegeben wird, gelten standardmäßig die letzten 30 Tage.

Variablentypen

Die folgenden Variablentypen werden akzeptiert:

• Zahl
• Datumsbereich
• Messaging
• Produkte
• Angepasste Events
• Eigenschaften angepasster Events
• Workspace
• Kataloge
• Katalogfelder
• Optionen
• Segmente
• String
• Tags

Zahl

• Ersatzwert: Der angegebene Wert, z. B. 5.5
• Anwendungsbeispiel: some_number_column < {{number.${some name}}}

Datumsbereich

Wenn Sie sowohl start_date als auch end_date verwenden, müssen beide denselben Namen haben, damit Sie sie als Datumsbereich nutzen können.

Beispielwerte

Der Datumsbereichstyp kann relativ, Startdatum, Enddatum oder Datumsbereich sein.

Alle vier Typen werden angezeigt, wenn sowohl start_date als auch end_date mit demselben Namen verwendet werden. Wenn nur eine der beiden Variablen verwendet wird, werden nur die relevanten Typen angezeigt.

• Ersatzwert: Ersetzt start_date und end_date durch einen Unix-Zeitstempel in Sekunden für ein bestimmtes Datum in UTC, z. B. 1696517353.
• Anwendungsbeispiel: Für alle Variablen vom Typ relativ, Startdatum, Enddatum und Datumsbereich:
  • time > {{start_date.${some name}}} AND time < {{end_date.${some name}}}
    • Wenn Sie keinen Datumsbereich benötigen, können Sie entweder start_date oder end_date verwenden.

Messaging

Alle Messaging-Variablen müssen denselben Bezeichner verwenden, wenn Sie ihren Status in einer Gruppe zusammenführen möchten.

Canvas

Zur Auswahl eines einzelnen Canvas. Wenn Sie denselben Namen wie für eine Campaign verwenden, erscheint im Tab Variablen ein Radiobutton, mit dem Sie entweder Canvas oder Campaign auswählen können.

• Ersatzwert: Canvas-BSON-ID
• Anwendungsbeispiel: canvas_id = ‘{{canvas.${some name}}}’

Canvases

Zur Auswahl mehrerer Canvases. Wenn Sie denselben Namen wie für eine Campaign verwenden, erscheint im Tab Variablen ein Radiobutton, mit dem Sie entweder Canvas oder Campaign auswählen können.

• Ersatzwert: BSON-IDs der Canvases
• Anwendungsbeispiel: canvas_id IN ({{canvases.${some name}}})

Campaign

Zur Auswahl einer einzelnen Campaign. Wenn Sie denselben Namen wie für ein Canvas verwenden, erscheint im Tab Variablen ein Radiobutton, mit dem Sie entweder Canvas oder Campaign auswählen können.

• Ersatzwert: Campaign-BSON-ID
• Anwendungsbeispiel: campaign_id = ‘{{campaign.${some name}}}’

Campaigns

Zur Mehrfachauswahl von Campaigns. Wenn Sie denselben Namen wie für ein Canvas verwenden, erscheint im Tab Variablen ein Radiobutton, mit dem Sie entweder Canvas oder Campaign auswählen können.

• Ersatzwert: BSON-IDs der Campaigns
• Anwendungsbeispiel: campaign_id IN ({{campaigns.${some name}}})

Kampagnenvarianten

Zur Auswahl von Kampagnenvarianten, die zur ausgewählten Campaign gehören. Diese Variable muss zusammen mit einer Campaign- oder Campaigns-Variable verwendet werden.

• Ersatzwert: API-IDs der Kampagnenvarianten als kommagetrennte Strings, z. B. api-id1, api-id2.
• Anwendungsbeispiel: message_variation_api_id IN ({{campaign_variants.${some name}}})

Canvas-Varianten

Zur Auswahl von Canvas-Varianten, die zu einem ausgewählten Canvas gehören. Diese Variable muss zusammen mit einer Canvas- oder Canvases-Variable verwendet werden.

• Ersatzwert: API-IDs der Canvas-Varianten als kommagetrennte Strings, z. B. api-id1, api-id2.
• Anwendungsbeispiel: canvas_variation_api_id IN ({{canvas_variants.${some name}}})

Canvas-Schritt

Zur Auswahl eines Canvas-Schritts, der zu einem ausgewählten Canvas gehört. Diese Variable muss zusammen mit einer Canvas-Variable verwendet werden.

• Ersatzwert: API-ID des Canvas-Schritts
• Anwendungsbeispiel: canvas_step_api_id = ‘{{canvas_step.${some name}}}’

Canvas-Schritte

Zur Auswahl von Canvas-Schritten, die zu ausgewählten Canvases gehören. Diese Variable muss zusammen mit einer Canvas- oder Canvases-Variable verwendet werden.

• Ersatzwert: API-IDs der Canvas-Schritte
• Anwendungsbeispiel: canvas_step_api_id IN ({{canvas_steps.${some name}}})