SQL セグメントエクステンション

Snowflake データのSnowflake SQL クエリを使用してセグメントエクステンションを生成できます。SQL では、他のセグメンテーション機能では実現できない方法でデータ間の関係を柔軟に記述できるため、新しいセグメントのユースケースを開拓するのに役立ちます。

標準のセグメントエクステンションと同様に、SQL セグメントエクステンションでも過去 2 年間 (730 日) までのイベントをクエリできます。標準のSegment Extensionsとは異なり、SQL Segment Extensions はクレジットを消費します。

前提条件

この機能を使用してPIIデータにアクセスできるため、SQL Segmentクエリーを実行するにはPII権限が必要です。

セグメントエクステンションを作成する

ステップ 1: エディタを選択する

SQL セグメントエクステンションの作成時に選択できる SQL エディターには、SQL エディターとインクリメンタル SQL エディターの2種類があります。

• フルリフレッシュ:セグメントが更新されるたびに、Braze は利用可能なすべてのデータをクエリしてセグメントを更新します。これにより、増分更新よりも多くのクレジットが使用されます。完全更新エクステンションでは、メンバーシップを毎日自動的に更新できますが、増分更新を使用して更新することはできません。
• 増分更新:増分更新では、過去2日分のデータのみが計算されるため、コスト効率がよく、毎回使用するクレジットも少なくなります。増分更新 SQL セグメントを作成する場合、メンバーシップを毎日自動的に再生成するように設定できます。これにより、メンバーシップを毎日自動的に更新するようにSegmentを設定できます。これにより、SQL Segment拡張の毎日のデータリフレッシュの費用を削減できます。
• AI SQL ジェネレータ:AI SQL ジェネレーターを使用すると、プロンプトをプレーン言語で記述し、それをSegmentのSQL クエリーに変換できます。SQL を自分で書く必要もなく、すぐに始めることができます。

• フルリフレッシュ
• 増分更新
• ai sqlジェネレーター

エクステンションの処理が完了したら、セグメントエクステンションを使用して セグメントを作成[](/docs/ja/user_guide/engagement_tools/segments/segment_extension#step-5-use-your-extension-in-a-segment) し、この新しいセグメントをキャンペーンやキャンバスでターゲットにすることができます。

ステップ 2:SQL を記述する

SQL クエリは、Snowflake 構文を使用して記述する必要があります。クエリ可能なテーブルとカラムの全リストについては、テーブルリファレンスを参照してください。

• sqlエディタ
• 増分 sql エディター

1
SELECT DISTINCT user_id FROM "INSERT TABLE NAME"

1
2
3
SELECT * FROM CATALOGS_ITEMS_SHARED
WHERE CATALOG_ID = 'XYZ'
LIMIT 10

ステップ 3:クエリのプレビュー

保存する前に、クエリのプレビューを実行できます。クエリのプレビューは自動的に100行に制限され、60秒後にタイムアウトします。プレビューを実行する場合、user_id 列の要件は適用されません。

インクリメンタル SQL セグメントエクステンションの場合、プレビューには演算子からの追加条件、回数、および期間フィールドは含まれません。

ステップ 4: SQL を反転する必要があるかどうかを判別する

次に、SQL を反転する必要があるかどうかを判断します。0 個のイベントを持つユーザーs を直接クエリーすることはできませんが、SQL を反転してこれらのユーザーs をターゲットにすることができます。

たとえば、購入数が3 つ未満のユーザーを対象にするには、まずクエリーを作成して、購入数が3 つ以上のユーザーを選択します。次に、Invert SQL を選択して、購入数が3 未満のユーザー(購入数が0 のものを含む) を対象にします。

セグメントのメンバーシップの更新

SQL を使用して作成されたセグメントエクステンションのセグメントメンバーシップを更新するには、セグメントエクステンションを開いて [更新] を選択します。

セグメント拡張の管理

セグメントエクステンションページでは、SQL を使用して生成されたセグメントは名前の横の で表示されます。

SQL セグメントエクステンションを選択すると、そのエクステンションが使用されている場所を表示したり、エクステンションをアーカイブしたり、セグメントのメンバーシップを手動で更新したりできます。

更新設定の指定

エクステンションを定期的に更新する必要がない場合は、更新設定を使用せずにエクステンションを保存できます。この場合 Braze は、デフォルトでその時点のユーザーメンバーシップに基づいてセグメントエクステンションを生成します。オーディエンスを一度だけ生成し、単発のキャンペーンでターゲットにしたい場合は、デフォルトの動作を使用する。

セグメントは常に最初の保存後に処理を開始します。セグメンテーションが更新されるたびに、Brazeはセグメンテーションを再実行し、更新時のセグメント内のユーザーを反映するようにセグメントメンバーシップを更新する。これにより、定期的なキャンペーンが最も関連性の高いユーザーに届くようになる。

定期的なリフレッシュの設定

リフレッシュ設定を指定して定期的なスケジュールを設定するには、「リフレッシュをイネーブルメントにする」を選択する。リフレッシュ設定を指定するオプションは、SQLセグメント、CDIセグメントエクステンション、シンプルなフォームベースのセグメントエクステンションなど、すべてのタイプのセグメントエクステンションで利用できる。

リフレッシュ設定を選択する

更新間隔設定パネルで、セグメントエクステンションが更新される頻度を選択できる：1時間ごと、毎日、毎週、毎月。また、リフレッシュが行われる特定の時間（あなたの会社のタイムゾーン内）を、次のように選択する必要がある：

• 毎週月曜日の午前11時（会社時間）に配信されるメールキャンペーンで、配信直前にセグメンテーションを確実に更新したい場合は、毎週月曜日の午前10時に更新するスケジュールを選択する。
• セグメンテーションを毎日更新したい場合は、毎日の更新頻度を選択し、更新する時間帯を選択する。

クレジット消費量と追加のコスト

リフレッシュはセグメントのクエリを再実行するため、SQL セグメントのリフレッシュは SQL セグメントクレジットを消費し、CDI セグメントエクステンションのリフレッシュはサードパーティデータウェアハウス内でコストが発生する。

古くなった拡張機能を自動的に無効にする基準

セグメントエクステンションが古くなると、スケジュールされたリフレッシュは自動的に無効になる。セグメントエクステンションは、以下の条件を満たす場合、古くなる：

• アクティブなキャンペーンまたはキャンバスでは使用されていない
• アクティブなキャンペーンまたはキャンバス内のセグメントでは使用されていない
• 分析トラッキングがオンになっているセグメンテーションでは使用しない。
• 7日以上変更されていない
• キャンペーン、キャンバス（下書きを含む）、セグメンテーションに7日以上追加されていない。

セグメントエクステンションでスケジュールされたリフレッシュが無効になっている場合、そのエクステンションにはその旨の通知が表示される。

古くなったセグメントエクステンションを使用する準備ができたら、リフレッシュ設定を確認し、ユースケースに合ったリフレッシュスケジュールを選択し、変更を保存する。

Snowflake単位

各 Braze ワークスペースには、1か月あたり5つのSnowflake クレジットが利用可能です。さらにクレジットが必要な場合は、アカウントマネージャーにお問い合わせください。クレジットは、SQL Segment のメンバーシップを更新または保存して更新するたびに使用されます。SQL セグメント内でプレビューを実行したり、従来のセグメントエクステンションを保存または更新したりする場合、クレジットは使用されません。

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

クレジットを節約するには、SQL セグメントエクステンションを保存する前に、クエリをプレビューして正しいことを確認してください。

クレジットは、毎月1日午前12 時 (UTC) に5にリセットされます。クレジット使用状況パネルで、その月のクレジット使用状況を監視できます。[セグメントエクステンション] ページから、[SQL クレジット使用状況を表示] をクリックします。

![SQL セグメントエクステンションページの SQL クレジット使用状況パネル]/docs/ja/assets/img_archive/sql_segments_credits.png?e7eb7d7c1c900f6947960dbefc963b43{: style=”max-width:60%”}

クレジットがゼロになると、次のことが起こります。

• 自動的に更新するように設定された SQL セグメントエクステンションは更新を停止し、これらのセグメントのメンバーシップ、およびこれらのセグメントをターゲットとするキャンペーンやキャンバスに影響します。
• その月の残りの期間は、新しい SQL セグメントエクステンションをドラフトとして保存することしかできません。

クレジットの50％、80％、100％を使い切ると、SQLセグメントを作成したすべての企業ユーザーと会社の管理者に通知メールが届きます。翌月の初めにクレジットがリセットされたら、SQL セグメントをさらに作成でき、自動更新が再開されます。

SQL Segment クレジットをさらに購入したり、セグメントエクステンションを追加購入したい場合は、アカウントマネージャーにお問い合わせください。