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には以下が含まれている必要があります：
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を指定する必要があります。例：
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回未満のユーザー（購入回数がゼロのユーザーを含む）をターゲットにします。
イベントがゼロのユーザーをターゲットにすることを明確に目的としている場合以外は、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セグメントクレジットの追加購入やセグメントエクステンションの追加をご希望の場合は、アカウントマネージャーにお問い合わせください。