Skip to content

キャンバスしきい値アラート

キャンバスしきい値アラートは、キャンバス内で何かが計画通りに進んでいない場合に通知し、停止したジャーニーや予期しない離脱が顧客に影響を与える前に検知できるようにします。

ユーザーエントリまたは送信メッセージ数のボリュームまたはパーセンテージしきい値を設定すると、そのしきい値を超えた場合にBrazeがメールまたはwebhookで通知します。同じキャンバスに対して複数のアラートを作成することもできます。たとえば、ユーザーエントリ用のアラートと送信メッセージ数用のアラートを別々に設定できます。

どこから始めればよいかわからない場合は、オペレーターがキャンバスしきい値アラートの設定方法をガイドします。

ステップ1: アラートを作成する

アラートはキャンバスレベルで設定され、アクティブなキャンバスと下書きのキャンバスの両方に対して設定できます。キャンバスのアラートの管理ページを開くには、次のいずれかの方法を使用します。

  • メッセージング > キャンバスに移動し、個々のキャンバスのコンテキストメニューからアラートの管理を選択します
  • アクティブなキャンバスの場合、キャンバス分析を開き、アラートの管理を選択します。

アラートの管理ページから、アラートを設定を選択して新しいアラートを作成します。

ステップ2: アラートに名前を付けてキャンバスを選択する

アラートに名前を付け、適用するキャンバスを確認します。

アラート名とキャンバス名のフィールド、空のルールグループ、アラートルール・スケジュール・通知のサマリーサイドバーが表示されたアラート設定パネル。

ステップ3：アラートルールを設定する

アラートルールは、通知をトリガーするしきい値を定義します。2つのメトリクスを使用してルールを作成できます。

  • ユーザーエントリ： キャンバスにエントリしたユーザー数
  • 送信メッセージ数： キャンバスから送信されたメッセージ数

各ルールについて、比較条件（未満、超過、以下、以上、または等しい）、単位、およびしきい値を選択します。

  • ボリューム： 現在のチェックウィンドウにおける絶対数を比較します。たとえば、「ユーザーエントリが3,000未満」というルールは、通常数千人のユーザーにリーチしているキャンバスが突然停止した場合にフラグを立てます。これは、上流のオーディエンスやエントリに問題がある可能性を示しており、調査する価値があります。
  • パーセンテージ： 現在のカウントをこのキャンバスのベースラインと比較します。ベースラインは、過去7日間における同じ時間枠の平均です。たとえば、アラートが3時間ごとにチェックする場合、14時〜17時のチェックは過去7回分の14時〜17時のウィンドウの平均と比較されます。「送信メッセージ数が50%未満」というルールは、通常のボリュームの半分以下に低下した場合にフラグを立てます。

しきい値は整数です。未満または以下のパーセンテージルールの場合、1〜100の値を入力します。超過、以上、または等しいの場合、パーセンテージは0以上の任意の値（100を超える値を含む）を指定できるため、ベースラインに対するスパイクに関するアラートを設定できます。

複数のルールをグループにまとめることができます。ボリュームルールとパーセンテージルールを混在させることも可能で、ルールグループをANDまたはORロジックで組み合わせて、より具体的なアラート条件を構築できます。

ステップ4: アラートスケジュールを設定する

アラートルールをチェックする頻度を定義します。チェック頻度は3時間から12時間（1時間刻み）、または24時間ごとに設定できます。有効化されると、アラートとそれに関連するキャンバスがアクティブである限り、このスケジュールに従ってチェックが継続されます。

ステップ5：通知を設定する

アラートルールの条件が満たされたときに誰にどのように通知するかを設定します。

  • メール： 1つ以上の受信者メールアドレスを追加します
  • Webhook： 通知先のWebhook URLを入力し、必要に応じてWebhook送信先で必要なカスタムリクエストヘッダーを追加します

1つのアラートに対して、片方または両方の通知方法を有効にできます。

Webhookアラートは、Slackチャネルなどの外部プラットフォームに通知をルーティングする場合に便利です。詳しくは、Slackのドキュメント「Incoming Webhookを使用したメッセージの送信」を参照してください。各Webhook通知は、アラート名、評価ウィンドウ、およびアラートをトリガーした条件を含むJSONペイロードを送信します。各条件にはvolumeまたはpercentageのthreshold_unitが含まれます。パーセンテージ条件にはpercentage_metric_value（観測されたカウントをベースラインに対する整数パーセンテージで表した値）も含まれます。metric_valueは常に絶対カウントです。

Webhookペイロードの例

以下は、アラートがトリガーされたときにWebhookエンドポイントへのPOSTリクエストで送信されるJSONペイロードの例です。最初の条件はボリュームルールです。2番目はパーセンテージルールで、51,235件のメッセージが送信され、これは7日間の同一ウィンドウベースラインの57%であり、55%超のしきい値に対して判定されています。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

{
  "alert": {
    "name": "Canvas Alert - August 6, 2026",
    "target_type": "CANVAS"
  },
  "evaluation_window_start": "2026-08-06T10:28:01Z",
  "evaluation_window_end": "2026-08-06T13:28:01Z",
  "conditions": [
    {
      "subject": "user_entries",
      "operator": "lt",
      "threshold_value": 500,
      "metric_value": 0.0,
      "group_index": 0,
      "threshold_unit": "volume"
    },
    {
      "subject": "messages_sent",
      "operator": "gt",
      "threshold_value": 55,
      "metric_value": 51235.0,
      "group_index": 0,
      "threshold_unit": "percentage",
      "percentage_metric_value": 57
    }
  ]
}

ステップ6：アラートを保存する

サマリーパネルでアラートルール、スケジュール、通知設定を確認し、Save alert を選択します。

ステップ7: アラートを有効にする

アラートを保存しただけでは有効になりません。アラートをオンにするには、アラートの管理ページに移動し、アラートのステータストグルを使用します。アラートは、無効にするか、関連するキャンバスがアクティブでなくなるまで有効のままです。キャンバスページのアラート設定済み列には、少なくとも1つの保存済みアラートがあるキャンバスにベルアイコンが表示されます。

注意事項

  • 下書きのキャンバス: 下書き中のキャンバスにしきい値アラートを設定できますが、キャンバスが起動するまでアラートはルールに対するチェックを開始しません。
  • パーセンテージの基準値: パーセンテージルールには、キャンバスの起動後に同じウィンドウの完全な7日間の先行データが必要です。それらのウィンドウが存在しない場合、または基準平均がゼロの場合（先行ウィンドウにアクティビティがない場合）、パーセンテージルールは通知をトリガーしません。
New Stuff!