クエリビルダー

クエリビルダーの使用方法について説明します。Snowflake で Braze データを使用してレポートを生成できます。クエリビルダーには、すぐに使える SQL クエリテンプレートが付属しているので、すぐに始めることができます。また、独自のカスタム SQL クエリを作成して、より多くのインサイトを得ることもできます。

前提条件

クエリビルダーを使用するには、“View PII” 権限が必要です。これにより、一部の顧客データに直接アクセスできるようになります。

クエリビルダーの使用

ステップ 1:SQL クエリの作成

新しいクエリを作成するには、分析 > クエリビルダーに移動し、Create SQL Query を選択します。

インスピレーションが必要な場合やクエリの作成にヘルプが必要な場合は、Query Template を選択し、事前作成テンプレートを選択します。空のクエリで開始するには、SQL Editor を選択します。

レポートには、現在の日時からなる名前が自動的に付けられます。名前の上にカーソルを合わせ、 を選択して、SQL クエリにわかりやすい名前を付けます。

ステップ 2:クエリを作成する

クエリを作成する際に、AI のサポートを受けるか、自分で作成するかを選択できます。

• 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:レポートの生成

クエリの構築が完了したら、Run Query を選択します。エラーやレポートタイムアウトがない場合、クエリからCSVファイルが生成されます。

CSVレポートをダウンロードするには、エクスポートを選択します。

レポートのタイムアウト

実行に 6 分以上かかるレポートはタイムアウトになります。これがしばらくぶりに実行する最初のクエリである場合、処理に時間がかかるため、タイムアウトする可能性が高くなります。タイムアウトした場合は、レポートをもう一度実行してみてください。

複数回試行してもレポートのタイムアウトが続く場合は、サポートにお問い合わせください。

中止理由のクエリ

任意の USERS_MESSAGES_*_ABORT_SHARED テーブルの ABORT_TYPE 列をクエリして、メッセージが送信されなかった理由を分析できます。ABORT_TYPE フィールドには中止の具体的な理由を示す文字列値が含まれ、関連する ABORT_LOG フィールドには追加の詳細（トリガーされたフリークエンシーキャップルールなど）が含まれます。

たとえば、過去 30 日間のメール中止をタイプ別にカウントするには、次のようにします。

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

ABORT_TYPE の値とその説明の全リストについては、中止タイプを参照してください。

データと結果

すべてのクエリは過去 60 日間のデータを表示します。結果をエクスポートすると、最大 1,000 行のみが含まれます。大量のデータを必要とするレポートの場合は、Currents やエクスポート API エンドポイントなどのツールを使用できます。

Snowflake クレジット

各会社は、すべてのワークスペースで共有される月 5 つの Snowflake クレジットを使用できます。Snowflake クレジットのごく一部が、クエリを実行したりテーブルをプレビューしたりするたびに使用されます。

クレジット使用量は SQL クエリの実行時間と相関しています。実行時間が長いほど、クエリで消費される Snowflake クレジットの量が多くなります。実行時間は、時間の経過に伴うクエリの複雑さとサイズによって異なります。実行するクエリが複雑で頻繁になるほど、リソースの割り当てが大きくなり、実行時間が短縮されます。

Braze の SQL エディターでレポートの作成、編集、保存を行う場合、クレジットは使用されません。クレジットは、毎月 1 日午前 12 時 (UTC) に 5 にリセットされます。クエリビルダーページの上部で、月次クレジット使用量を監視できます。

クレジット上限に達すると、クエリの実行はできませんが、SQL レポートの作成、編集、および保存はできます。クエリビルダーのクレジットをさらに購入する場合は、アカウントマネージャーにお問い合わせください。