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

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

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

前提条件

この機能を通じて個人識別情報（PII）データにアクセスできるため、SQLセグメントクエリを実行するにはPII権限が必要だ。

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

ステップ 1: エディタを選ぶ

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

• 完全リフレッシュ：セグメントが更新されるたびに、Braze は利用可能なすべてのデータをクエリしてセグメントを更新します。これにより、増分更新よりも多くのクレジットが使用されます。完全更新エクステンションでは、メンバーシップを毎日自動的に更新できますが、増分更新を使用して更新することはできません。
• 増分更新:増分更新はクエリを設定するより費用対効果の高い方法だが、設定には少しステップが多い。セグメントを構築する際にこれらの追加ステップを完了できるなら、このオプションを選択する価値がある。クエリの実行に必要なクレジットが少なくなるからだ。
• AI SQL生成ツール：AI SQLジェネレーターは、平易な言語でプロンプトを入力すると、それを対象セグメント向けのSQLクエリに変換する。自分でSQLを書く必要なく、すぐに始められる方法だ。

• full refresh
• incremental refresh
• ai sql generator

拡張機能の処理が完了したら、セグメントエクステンションを使ってセグメントを作成できる。この新しいセグメントを、キャンペーンやキャンバスでターゲットに設定できる。

ステップ 2:SQLを記述せよ

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

• sql editor
• incremental sql editor

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を反転させる必要があるかどうかを判断する。イベントがゼロのユーザーを直接クエリすることはできないが、Invert SQL を使ってこれらのユーザーをターゲットにできる。

例えば、購入回数が3回未満のユーザーをターゲットにするには、まず購入回数が3回以上のユーザーを選択するクエリを書く。次に、SQLを反転させて、購入回数が3回未満のユーザー（購入回数が0回のユーザーを含む）を対象に選択する。

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

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

セグメントエクステンションの管理

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

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

更新設定の指定

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

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

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

リフレッシュ設定s を指定して繰り返しスケジュールを設定するには、リフレッシュ有効 を選択します。リフレッシュ設定sを指定するための選択肢は、SQL Segments、CDI Segment拡張、およびシンプルなフォームベースのSegment拡張を含む、すべてのタイプのSegment拡張で使用できます。

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

Refresh Interval Settingsパネルでは、このSegment拡張機能が更新される頻度を、毎時、毎日、毎週、または毎月から選択できます。また、リフレッシュが行われる特定の時間（あなたの会社のタイムゾーン内）を、次のように選択する必要がある：

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

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

リフレッシュによってSegmentのクエリーが再実行されるため、SQL SegmentのリフレッシュごとにSQL Segmentクレジットが消費され、CDI Segmentエクステンションのリフレッシュごとにサードパーティデータウェアハウス内で費用が発生します。

古い拡張機能を自動的に無効にする基準

セグメント拡張が古くなると、スケジュールされた更新は自動的に無効になります。セグメント拡張は、次の基準を満たす場合は古くなります。

• アクティブなキャンペーンまたはキャンバスでは使用されていない
• アクティブなキャンペーンまたはキャンバス内のセグメントでは使用されていない
• 分析 “トラッキングが有効になっているSegmentでは使用しません
• 7日以上経過しても変更されていない
• キャンペーンやキャンバス(下書きを含む)に追加されていないか、7日間以上Segmentされているか

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

古いセグメント拡張を使用する準備ができたら、更新設定を確認し、ユースケースに一致する更新スケジュールを選択して、変更を保存します。

Snowflake・クレジット

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

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

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

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

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

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

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

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