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.

Da der Abfrage-Builder direkten Zugriff auf bestimmte Kundendaten ermöglicht, können Sie ihn nur nutzen, wenn Sie die Berechtigung „PII anzeigen“ besitzen.

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.

Nutzerprofil-Attribut-Views

Der Abfrage-Builder und SQL-Segmenterweiterungen enthalten die meisten Nutzerprofil-Attribut-Views, wie z. B. periodische Snapshots und den Verlauf der Standardattribute.

Zwei Views 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 Views aus dem Abfrage-Builder und den SQL-Segmenterweiterungen aus, da sie auf Workspace-Ebene langsam abgefragt werden und häufig zu Zeitüberschreitungen führen. Verwenden Sie USER_CUSTOM_ATTRIBUTES_VIEW_SHARED für Snapshots angepasster Attribute im Abfrage-Builder. Wenn Sie historische oder nahezu in Echtzeit verfügbare Daten zu angepassten Attributen benötigen, fragen Sie die ausgeschlossenen Views 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 > Abfrage-Builder.
2. Wählen Sie SQL-Abfrage erstellen aus. Wenn Sie Inspiration oder Hilfe beim Erstellen Ihrer Abfrage benötigen, wählen Sie Query Template und dann 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 Uhrzeit. Bewegen Sie den Mauszeiger über den Namen und wählen Sie , um Ihrer SQL-Abfrage einen aussagekräftigen Namen zu geben.
4. Schreiben Sie Ihre SQL-Abfrage im Editor oder lassen Sie sich von KI unterstützen über den Tab KI-Abfrage-Builder. Wenn Sie Ihre eigene SQL-Abfrage schreiben, finden Sie unter Angepasste SQL-Abfragen schreiben Anforderungen und Ressourcen.
5. Wählen Sie Abfrage ausführen aus.
6. Speichern Sie Ihre Abfrage.
7. Um eine CSV-Datei Ihres Berichts herunterzuladen, wählen Sie Exportieren aus.

Ergebnisse für jeden Bericht können einmal pro Tag generiert werden. Wenn Sie denselben Bericht mehr als einmal an einem Kalendertag ausführen, sehen Sie in beiden Berichten dieselben Ergebnisse.

Abfrage-Templates

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

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

Datenzeitraum

Abfragen liefern Daten aus den letzten 60 Tagen. Wenn Sie Currents oder Snowflake Data Sharing verwenden, können Sie möglicherweise Daten aus bis zu zwei Jahren abfragen – so lange werden Ihre Daten in Snowflake aufbewahrt. Für weitere Details zur erweiterten Datenaufbewahrung wenden Sie sich an Ihren Customer-Success-Manager.

Zeitzone im Abfrage-Builder

Die Standardzeitzone für Abfragen in unserer Snowflake-Datenbank ist UTC. Daher kann es zu Datenabweichungen zwischen Ihrer Seite E-Mail-Kanal-Engagement (die der Zeitzone Ihres Unternehmens folgt) und Ihren Abfrage-Builder-Ergebnissen 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, d. h. Abfragen, die älter als sieben Tage sind, werden automatisch entfernt.

Wenn Sie die Abfragenutzung ü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.

Vergleich des Abfrage-Builders mit anderen Berichtsquellen

Die Ergebnisse des Abfrage-Builders können von anderen Berichtstools abweichen, da sie unterschiedliche Datenquellen und Verarbeitungsmethoden verwenden.

Beispielsweise können die Soft-Bounce-Zahlen im Abfrage-Builder höher sein als in SendGrid-Zustellbarkeitsberichten. Der Abfrage-Builder zählt alle Vorkommen von Soft-Bounces ohne Deduplizierung. Wenn bei einer Nutzerin oder einem Nutzer mehrere Soft-Bounces auftreten, bevor die Zustellung schließlich erfolgt (oder nach längeren Wiederholungsversuchen), wird jeder Soft-Bounce-Versuch einzeln gezählt. SendGrid Deliverability verwendet eigene Daten und Logik, in die Braze keinen Einblick hat, sodass die Zahlen zwischen den beiden Berichten möglicherweise nicht übereinstimmen.

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

SQL mit dem KI-Abfrage-Builder generieren

Der KI-Abfrage-Builder nutzt GPT, unterstützt von OpenAI, um SQL für Ihre Abfrage vorzuschlagen.

So generieren Sie SQL mit dem KI-Abfrage-Builder:

1. Nachdem Sie einen Bericht im Abfrage-Builder erstellt haben, wählen Sie den Tab AI Query Builder aus.
2. Geben Sie Ihren Prompt ein oder wählen Sie einen Beispiel-Prompt aus und wählen Sie Generate, um Ihren Prompt in SQL zu übersetzen.
3. Überprüfen Sie das generierte SQL, um sicherzustellen, dass es korrekt aussieht, und wählen Sie dann Insert into Editor.

Tipps

• Machen Sie sich mit den verfügbaren Tabellen und Spalten in der SQL-Tabellenreferenz vertraut. Wenn Sie nach Daten fragen, die in diesen Tabellen nicht vorhanden sind, kann es vorkommen, dass ChatGPT eine fiktive Tabelle erfindet.
• Machen Sie sich mit den SQL-Schreibregeln für dieses Feature vertraut. Die Nichteinhaltung dieser Regeln führt zu einem Fehler.
• Sie können mit dem KI-Abfrage-Builder bis zu 20 Prompts pro Minute 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.

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

Verwenden Sie Variablen, um vordefinierte Variablentypen in SQL zu nutzen und Werte zu referenzieren, ohne sie manuell kopieren zu müssen. Anstatt beispielsweise die ID einer Campaign manuell in den SQL-Editor zu kopieren, können Sie {{campaign.${My campaign}}} verwenden, um eine Campaign direkt aus einem Dropdown im Tab Variablen auszuwählen.

Nachdem eine Variable erstellt wurde, 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}}}, wobei type einer der akzeptierten Typen sein muss und name frei wählbar ist. Die Labels für diese Variablen entsprechen standardmäßig dem Variablennamen.

Standardmäßig sind alle Variablen Pflichtfelder (und Ihr Bericht wird nicht ausgeführt, wenn keine Variablenwerte ausgewählt sind), mit Ausnahme des Datumsbereichs, der standardmäßig die letzten 30 Tage umfasst, wenn kein Wert angegeben wird.

Variablentypen

Die folgenden Variablentypen werden akzeptiert:

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

Zahl

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

Datumsbereich

Wenn sowohl start_date als auch end_date verwendet werden, müssen sie denselben Namen haben, damit sie als Datumsbereich verwendet werden 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 einer verwendet wird, werden nur die relevanten Typen angezeigt.

• Ersetzungswert: Ersetzt start_date und end_date durch einen Unix-Zeitstempel in Sekunden für ein angegebenes Datum in UTC, z. B. 1696517353.
• Verwendungsbeispiel: Für alle Variablentypen – relativ, Startdatum, Enddatum und Datumsbereich:
  • time > {{start_date.${some name}}} AND time < {{end_date.${some name}}}
    • Sie können entweder start_date oder end_date verwenden, wenn Sie keinen Datumsbereich benötigen.

Messaging

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

Canvas

Zur Auswahl eines Canvas. Wenn derselbe Name wie bei einer Campaign verwendet wird, erscheint im Tab Variablen ein Optionsfeld zur Auswahl von entweder Canvas oder Campaign.

• Ersetzungswert: Canvas-BSON-ID
• Verwendungsbeispiel: canvas_id = '{{canvas.${some name}}}'

Canvases

Zur Auswahl mehrerer Canvases. Wenn derselbe Name wie bei einer Campaign verwendet wird, erscheint im Tab Variablen ein Optionsfeld zur Auswahl von entweder Canvas oder Campaign.

• Ersetzungswert: Canvases-BSON-IDs
• Verwendungsbeispiel: canvas_id IN ({{canvases.${some name}}})

Campaign

Zur Auswahl einer Campaign. Wenn derselbe Name wie bei einem Canvas verwendet wird, erscheint im Tab Variablen ein Optionsfeld zur Auswahl von entweder Canvas oder Campaign.

• Ersetzungswert: Campaign-BSON-ID
• Verwendungsbeispiel: campaign_id = '{{campaign.${some name}}}'

Campaigns

Zur Mehrfachauswahl von Campaigns. Wenn derselbe Name wie bei einem Canvas verwendet wird, erscheint im Tab Variablen ein Optionsfeld zur Auswahl von entweder Canvas oder Campaign.

• Ersetzungswert: Campaigns-BSON-IDs
• Verwendungsbeispiel: campaign_id IN ({{campaigns.${some name}}})

Kampagnenvarianten

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

• Ersetzungswert: API-IDs der Kampagnenvarianten, durch Kommas getrennte Strings wie api-id1, api-id2.
• Verwendungsbeispiel: 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 mit einer Canvas- oder Canvases-Variable verwendet werden.

• Ersetzungswert: API-IDs der Canvas-Varianten, durch Kommas getrennte Strings wie api-id1, api-id2.
• Verwendungsbeispiel: 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 mit einer Canvas-Variable verwendet werden.

• Ersetzungswert: API-ID des Canvas-Schritts
• Verwendungsbeispiel: 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 mit einer Canvas- oder Canvases-Variable verwendet werden.

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