SQL セグメントエクステンション
SnowflakeデータのSnowflake SQLクエリを使用してセグメントエクステンションを生成できます。SQLでは、他のセグメンテーション機能では実現できない方法でデータ間の関係を柔軟に記述できるため、新しいセグメントのユースケースを開拓するのに役立ちます。
標準のセグメントエクステンションと同様に、SQLセグメントエクステンションでも過去2年間（730日）までのイベントをクエリできます。標準のセグメントエクステンションとは異なり、SQLセグメントエクステンションはクレジットを消費します。
前提条件
この機能を通じてPIIデータにアクセスできるため、SQLセグメントクエリを実行するにはPII権限が必要です。
セグメントエクステンションの作成
ステップ1：エディターを選択する
SQLセグメントエクステンションを作成する際に選択できるSQLエディターは2種類あります：SQLエディターと増分SQLエディターです。
- フルリフレッシュ： セグメントが更新されるたびに、Brazeは利用可能なすべてのデータをクエリしてセグメントを更新します。そのため、増分リフレッシュよりも多くのクレジットを消費します。フルリフレッシュのエクステンションは毎日自動的にメンバーシップを再生成できますが、増分リフレッシュを使用してリフレッシュすることはできません。
- 増分リフレッシュ： 増分リフレッシュはクエリをよりコスト効率よく設定する方法ですが、セットアップにはいくつかの追加ステップが必要です。セグメントの構築時にこれらの追加ステップを完了できる場合は、クエリが少ないクレジットで実行されるため、このオプションを選択する価値があります。
- AI SQLジェネレーター： AI SQLジェネレーターを使用すると、自然言語でプロンプトを記述し、それをセグメント用のSQLクエリに変換できます。SQLを自分で記述する必要がなく、すぐに始める方法です。
どちらのSQLエディターで作成したSQLセグメントでも、手動でフルリフレッシュを実行できます。
フルリフレッシュのSQLセグメントエクステンションを作成するには：
- オーディエンス > セグメントエクステンションに移動します。
- 新しいエクステンションを作成を選択し、フルリフレッシュを選択します。
- セグメントエクステンションの名前を追加し、SQLを入力します。要件とリソースについてはステップ2を参照してください。
- セグメントエクステンションを保存します。
増分リフレッシュのSQLセグメントエクステンションを作成するには：
- オーディエンス > セグメントエクステンションに移動します。
- 新しいエクステンションを作成を選択し、増分リフレッシュを選択します。
- セグメントエクステンションの名前を追加し、SQLを入力します。要件とリソースについてはSQLの記述セクションを参照してください。
- 必要に応じて、エクステンションを毎日再生成を選択します。
選択すると、Brazeは毎日自動的にセグメントメンバーシップを更新します。つまり、会社のタイムゾーンの毎日深夜0時（最大1時間の遅延の可能性あり）に、Brazeがセグメント内の新しいユーザーを確認し、自動的にセグメントに追加します。セグメントエクステンションが7日間使用されていない場合、Brazeは自動的に毎日の再生成を一時停止します。未使用のセグメントエクステンションとは、キャンペーンやキャンバスの一部ではないもの（エクステンションが「使用中」と見なされるために、キャンペーンやキャンバスがアクティブである必要はありません）を指します。 - セグメントエクステンションを保存します。
AI SQLジェネレーターは現在ベータ機能として利用可能です。このベータトライアルへの参加にご興味がある場合は、カスタマーサクセスマネージャーにお問い合わせください。
AI SQLジェネレーターは、OpenAIを搭載したGPTを活用して、SQLセグメント用のSQLを推奨します。
AI SQLジェネレーターを使用するには、以下の手順を実行してください：
- フルリフレッシュまたは増分リフレッシュを使用してSQLセグメントを作成した後、AI SQLジェネレーターを起動を選択します。
- プロンプトを入力し、生成を選択してプロンプトをSQLに変換します。
- 生成されたSQLを確認して正しいことを確かめた後、セグメントを保存します。
プロンプトの例
- 先月メールを受け取ったユーザー
- 過去1年間に購入が5回未満のユーザー
ヒント
- 利用可能なSnowflakeデータテーブルを把握してください。これらのテーブルに存在しないデータをリクエストすると、ChatGPTが架空のテーブルを作成する場合があります。
- この機能のSQL記述ルールを把握してください。これらのルールに従わないとエラーが発生します。例えば、SQLコードは
user_idカラムを選択する必要があります。プロンプトを「〜のユーザー」で始めると効果的です。 - AI SQLジェネレーターでは、1分間に最大20個のプロンプトを送信できます。
私のデータはどのように使用され、OpenAIに送られますか？
OpenAIを活用するBrazeAI機能を通じてAI出力（以下「出力」）を生成するために、Brazeは特定の情報（以下「入力」）をOpenAIに送信します。入力はお客様のプロンプトで構成され、該当する場合にはダッシュボードに表示されるコンテンツやお客様のクエリに関連するその他のワークスペースデータが含まれることがあります。OpenAIのAPIプラットフォームのコミットメントに基づき、Braze経由でOpenAIのAPIに送信されたデータは、OpenAIモデルのトレーニングや改善には使用されません。OpenAIは不正利用の監視を目的として最大30日間データを保持し、その後削除します。お客様とBrazeの間において、出力はお客様の知的財産です。Brazeは、かかる出力に対する著作権の所有権を主張しません。Brazeは、出力を含め、AIが生成したコンテンツに関していかなる種類の保証も行いません。
実行に20分以上かかるSQLクエリはタイムアウトします。
エクステンションの処理が完了したら、セグメントエクステンションを使用してセグメントを作成し、この新しいセグメントをキャンペーンやキャンバスでターゲットに設定できます。
ステップ2：SQLを記述する
SQLクエリはSnowflake構文を使用して記述する必要があります。クエリ可能なテーブルとカラムの完全なリストについては、テーブルリファレンスを参照してください。
クエリ可能なテーブルにはイベントデータのみが含まれている点にご注意ください。ユーザー属性をクエリする場合は、SQLセグメントとクラシックセグメンターのカスタム属性フィルターを組み合わせる必要があります。
SQLは以下のルールにも従う必要があります：
- 単一のSQLステートメントを記述してください。セミコロンは含めないでください。
- SQLは
user_idカラムの1つのカラムのみを選択する必要があります。つまり、SQLには以下が含まれている必要があります：
1
SELECT DISTINCT user_id FROM "INSERT TABLE NAME"
- イベントがゼロ回のユーザーをクエリすることはできません。そのため、イベントの実行回数がX回未満のユーザーをクエリするには、以下の回避策に従う必要があります：
- イベントの実行回数がX回を超えるユーザーを選択するクエリを記述します。
- セグメント内でセグメントエクステンションを参照する際に、
doesn't includeを選択して結果を反転させます。
追加ルール
さらに、標準SQLクエリは以下のルールに従う必要があります：
DECLAREステートメントは使用できません。
すべての増分リフレッシュクエリは、クエリとスキーマの詳細の2つの部分で構成されます。
- エディターで、目的のテーブルから
user_idを選択するクエリを記述します。 - エディターの上部にあるフィールドから演算子、回数、期間を選択してスキーマの詳細を追加します。クエリは、集計カラムの合計がこれらのフィールドで設定した条件を満たしているかどうかを確認します。これは、クラシックセグメントエクステンションの作成ワークフローと同様に機能します。
- 演算子： イベントが発生回数よりも多いか、少ないか、等しいかを示します。
- 回数： 演算子との関連でイベントを評価する回数です。
- 期間： イベントのインスタンスを確認する1〜730日の日数です。この期間は、現在の日からの過去の日数を指します。以下の例では、過去365日間にイベントを5回以上実行したユーザーをクエリしています。
- 演算子： イベントが発生回数よりも多いか、少ないか、等しいかを示します。
以下の例では、結果のセグメントには、指定された日付以降、過去30日間にfavoritedイベントを3回以上実行したユーザーが含まれます。
増分リフレッシュは遅延イベント（毎日のリフレッシュウィンドウの後に到着するイベント、例えばキャプチャ時に送信されなかったSDKイベントなど）を考慮します。セグメントがリフレッシュされると、Brazeはそれらの遅延イベントが属する日付を再処理します。
増分リフレッシュがユーザーを経時的に追跡する方法
増分リフレッシュを使用すると、Brazeは内部のカウントテーブルに各ユーザーの日次カウントを保存し、毎日すべての過去データを再クエリすることなく、全期間にわたってセグメントを評価できるようにします。
保存される内容： Brazeは、(date, user_id, count)の形式で日次のユーザー資格カウントを蓄積するカウントテーブル（セグメントコホートテーブルに類似）を管理します。このテーブルは、2日間のローリングリフレッシュウィンドウの外の過去データを保持します。
各リフレッシュで発生する処理： 増分リフレッシュが実行されると、Brazeはカウントテーブルから2日間のローリングリフレッシュウィンドウ内のレコードのみをクリアします。次に、更新された時間パラメーター（$start_dateを使用）でSQLクエリを再実行し、それらの日付の新しい行を挿入します。2日間のローリングリフレッシュウィンドウ外の過去の行は、カウントテーブルにそのまま残ります。
Brazeがセグメントメンバーを決定する方法： Brazeは、最新の2日間のローリングリフレッシュペイロードだけでなく、蓄積されたカウントテーブル全体に対してセグメントメンバーシップ基準を評価します。つまり、2日以上前に資格を得たユーザーは、集計カウントが基準を満たさなくなるまでセグメントに残り続けます。
信頼性の高いリフレッシュを行うためのSQL記述方法： 増分リフレッシュ用のSQLを記述する際は、部分リフレッシュ時に一貫性のない結果を生成する可能性のあるクエリパターンを避けてください。例えば、$start_dateの境界をまたぐデータに依存するMAX(time)のようなウィンドウ集計は、日付のサブセットのみが再計算される際に行の状態を予期せず変更する場合があります。各日付の出力がその日のイベントのみに依存するようにクエリを構造化することで、クエリが2日分のデータを処理する場合でも730日分のデータを処理する場合でも、一貫した結果が維持されます。
追加ルール
さらに、増分リフレッシュクエリは以下のルールに従う必要があります：
- 単一のSQLステートメントを記述してください。セミコロンは含めないでください。
- 増分SQLセグメントは1つのイベントのみを参照できます。日付とカウントのドロップダウンはそのイベントに適用されます。
- SQLには
$date()エイリアス（例：$date(time)）を含め、user_idとCOUNT()集計を選択し、日付とuser_idでグループ化し、時間カラムに$start_dateでフィルター（例：time > $start_date）する必要があります。$date()やこれらのフィールドなしでSQLを保存するとエラーが返されます。 DECLAREステートメントは使用できません。
CATALOGS_ITEMS_SHAREDテーブルを使用するSQLセグメントを作成する場合は、カタログIDを指定する必要があります。例えば：
1
2
3
SELECT * FROM CATALOGS_ITEMS_SHARED
WHERE CATALOG_ID = 'XYZ'
LIMIT 10
ステップ3：クエリをプレビューする
保存する前に、クエリのプレビューを実行できます。クエリプレビューは自動的に100行に制限され、60秒後にタイムアウトします。プレビューの実行時にはuser_idカラムの要件は適用されません。
増分SQLセグメントエクステンションの場合、プレビューには演算子、回数、期間フィールドからの追加条件は含まれません。
ステップ4：SQLの反転が必要かどうかを判断する
次に、SQLの反転が必要かどうかを判断します。イベントがゼロ回のユーザーを直接クエリすることはできませんが、SQLを反転を使用してこれらのユーザーをターゲットにすることができます。
デフォルトでは、SQLを反転はオンになっていません。ただし、AI SQLジェネレーターを使用して否定する必要があるSQLステートメントを生成した場合、ChatGPTがこの機能を自動的にオンにする出力を返すことがあります。
例えば、購入回数が3回未満のユーザーをターゲットにするには、まず購入回数が3回以上のユーザーを選択するクエリを記述します。次に、SQLを反転を選択して、購入回数が3回未満のユーザー（0回のユーザーを含む）をターゲットにします。
イベントがゼロ回のユーザーを特にターゲットにする目的でない限り、SQLを反転する必要はありません。SQLを反転が選択されている場合は、その機能が必要であり、セグメントが目的のオーディエンスと一致していることを確認してください。例えば、クエリがイベントが1回以上のユーザーをターゲットにしている場合、反転するとイベントがゼロ回のユーザーのみをターゲットにします。
セグメントメンバーシップの更新
SQLを使用して作成したセグメントエクステンションのセグメントメンバーシップを更新するには、セグメントエクステンションを開き、更新を選択します。
ユーザーが定期的に出入りすることが予想されるセグメントを作成した場合は、そのセグメントをキャンペーンやキャンバスでターゲティングする前に、使用しているセグメントエクステンションを手動で更新してください。
セグメントエクステンションの管理
セグメントエクステンションページでは、SQLを使用して生成されたセグメントは、名前の横に が表示されます。
SQLセグメントエクステンションを選択すると、エクステンションが使用されている場所の確認、エクステンションのアーカイブ、または手動でのセグメントメンバーシップの更新が行えます。
更新設定の指定
エクステンションを定期的に更新する必要がない場合は、更新設定を使用せずに保存できます。Brazeはデフォルトで、その時点のユーザーメンバーシップに基づいてセグメントエクステンションを生成します。オーディエンスを一度だけ生成し、単発のキャンペーンでターゲットにしたい場合は、デフォルトの動作を使用してください。
セグメントは常に最初の保存後に処理を開始します。セグメントが更新されるたびに、Brazeはセグメントを再実行し、更新時点のセグメント内のユーザーを反映するようにセグメントメンバーシップを更新します。これにより、定期的なキャンペーンが最も関連性の高いユーザーに届くようになります。
定期的な更新の設定
更新設定を指定して定期的なスケジュールを設定するには、更新を有効にするを選択します。更新設定を指定するオプションは、SQLセグメント、CDIセグメントエクステンション、シンプルなフォームベースのセグメントエクステンションを含む、すべてのタイプのセグメントエクステンションで使用できます。
データ管理を最適化するため、使用されていないセグメントエクステンションの更新設定は自動的にオフになります。セグメントエクステンションは、以下の場合に未使用とみなされます。
- アクティブまたは非アクティブ（下書き、停止、アーカイブ）のキャンペーン、キャンバス、またはセグメントで使用されていない
- 7日以上変更されていない
この設定がオフになると、Brazeは会社の連絡先とエクステンションの作成者に通知します。エクステンションを毎日再生成するオプションはいつでも再度有効にできます。
更新設定の選択
更新間隔設定パネルでは、このセグメントエクステンションが更新される頻度を、毎時、毎日、毎週、または毎月から選択できます。また、更新が行われる特定の時刻（会社のタイムゾーン）を選択する必要があります。例えば以下のようになります。
- 毎週月曜日の午前11時（会社時間）に送信されるメールキャンペーンがあり、送信直前にセグメントを確実に更新したい場合は、毎週月曜日の午前10時に更新するスケジュールを選択してください。
- セグメントを毎日更新したい場合は、毎日の更新頻度を選択し、更新する時刻を選択してください。
フォームベースのセグメントエクステンションでは、毎時の更新スケジュールを設定することはできません（ただし、毎日、毎週、毎月のスケジュールは設定できます）。
クレジット消費と追加コスト
更新によってセグメントのクエリが再実行されるため、SQLセグメントの更新ごとにSQLセグメントクレジットが消費され、CDIセグメントエクステンションの更新ごとにサードパーティのデータウェアハウスでコストが発生します。
データ処理時間のため、セグメントの更新には最大60分かかることがあります。現在更新処理中のセグメントには、セグメントエクステンションリストで「Processing」ステータスが表示されます。これにはいくつかの影響があります。
- 特定の時刻までにセグメントの処理を完了させるには、60分前の更新時刻を選択してください。
- 特定のセグメントエクステンションの更新は一度に1回のみ実行できます。既存の更新がすでに処理を開始している状態で新しい更新が開始される競合が発生した場合、Brazeは新しい更新リクエストをキャンセルし、進行中の処理を続行します。
古いエクステンションを自動的に無効にする基準
セグメントエクステンションが古くなると、スケジュールされた更新は自動的に無効になります。セグメントエクステンションは、以下の基準を満たす場合に古いとみなされます。
- アクティブなキャンペーンまたはキャンバスで使用されていない
- アクティブなキャンペーンまたはキャンバス内のセグメントで使用されていない
- 分析トラッキングが有効になっているセグメントで使用されていない
- 7日以上変更されていない
- 7日以上、キャンペーンやキャンバス（下書きを含む）、またはセグメントに追加されていない
セグメントエクステンションのスケジュールされた更新が無効になっている場合、そのエクステンションにはその旨を示す通知が表示されます。
古いセグメントエクステンションを使用する準備ができたら、更新設定を確認し、ユースケースに合った更新スケジュールを選択して、変更を保存してください。
Snowflakeクレジット
各Brazeワークスペースには、1か月あたり5つのSnowflakeクレジットが利用可能です。さらにクレジットが必要な場合は、アカウントマネージャーにお問い合わせください。クレジットは、SQLセグメントのメンバーシップを更新、または保存して更新するたびに使用されます。SQLセグメント内でプレビューを実行したり、従来のセグメントエクステンションを保存または更新したりする場合、クレジットは使用されません。
Snowflakeクレジットは機能間で共有されません。たとえば、SQLセグメントエクステンションとクエリビルダーのクレジットは互いに独立しています。
クレジット使用量はSQLクエリの実行時間と相関しています。実行時間が長くなるほど、クエリにかかるクレジット数は多くなります。実行時間は、時間の経過に伴うクエリの複雑さとサイズによって異なる場合があります。実行するクエリが複雑で頻繁になればなるほど、リソースの割り当てが大きくなり、実行時間が短縮されます。
クレジットを節約するには、SQLセグメントエクステンションを保存する前に、クエリをプレビューして正しいことを確認してください。
クレジットは、毎月1日午前12時（UTC）に5にリセットされます。クレジット使用状況パネルで、その月のクレジット使用状況を監視できます。セグメントエクステンションページから、 SQLクレジット使用状況を表示をクリックします。
クレジットがゼロになると、次のことが起こります。
- 自動更新が設定されたSQLセグメントエクステンションは更新を停止し、これらのセグメントのメンバーシップ、およびこれらのセグメントをターゲットとするキャンペーンやキャンバスに影響します。
- その月の残りの期間は、新しいSQLセグメントエクステンションを下書きとしてのみ保存できます。
SQLセグメントを作成したすべての会社ユーザーと会社の管理者には、クレジットの50%、80%、100%を使い切った時点で通知メールが届きます。翌月の初めにクレジットがリセットされたら、SQLセグメントをさらに作成でき、自動更新が再開されます。
SQLセグメントクレジットの追加購入やセグメントエクステンションの追加をご希望の場合は、アカウントマネージャーにお問い合わせください。