コンテンツにスキップ

カスタムキャンバスアラート

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

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

ワークスペース内のすべてのキャンバスに適用されるデフォルトのアラートについては、ワークスペースキャンバスアラートを参照してください。

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

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

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

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

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

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

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

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

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

アラートルールでは、通知をトリガーするしきい値を定義します。ルールには次の2つの指標を使用できます。

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

各ルールで、比較条件 (未満、より大きい、以下、以上、等しい)、単位、しきい値を選択します。

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

しきい値は整数で指定します。未満または以下を使用するパーセンテージルールでは、1から100までの値を入力します。より大きい、以上、等しいの場合、パーセンテージには0以上の値を指定でき、100を超える値も指定できます。これにより、ベースラインに対する急増をアラートで検知できます。

複数のルールをグループ化し (ボリュームルールとパーセンテージルールの組み合わせも可能)、ルールグループを AND または OR ロジックで組み合わせることで、より具体的なアラート条件を作成できます。

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

アラートルールをチェックする頻度を定義します。チェック頻度は3~12時間(1時間単位)、または24時間ごとに設定できます。有効化されると、アラートとそれに関連付けられたキャンバスがアクティブである限り、アラートはこのスケジュールでチェックを続けます。

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

アラートルールの条件が満たされたときに通知する相手と通知方法を選択します。

  • メール: 受信者のメールアドレスを1つ以上追加します
  • Webhook: 通知先の Webhook URL を入力し、必要に応じて Webhook の送信先で必要なカスタムリクエストヘッダーを追加します
  • Slack: Slack の Incoming Webhook URL を入力して、Slack チャネルに通知を投稿します。キャンバスアラートと Slack の連携について詳しくは、Slack のドキュメント「Sending messages using incoming webhooks」を参照してください。

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

Webhook アラートは、通知を外部プラットフォームにルーティングする場合に便利です。各 Webhook 通知では、アラート名、評価期間、アラートをトリガーした条件を含む JSON ペイロードが送信されます。各条件には、volume または percentage のいずれかの threshold_unit が含まれます。パーセンテージ条件には、percentage_metric_value(ベースラインに対する実測値を整数のパーセンテージで表したもの)も含まれます。metric_value は常に絶対数です。

Webhook ペイロードの例

以下は、アラートがトリガーされたときに Webhook エンドポイントへの POST リクエストで送信される JSON ペイロードの例です。最初の条件はボリュームルールです。2つ目はパーセンテージルールで、送信メッセージ数は51,235件です。これは7日間の同一時間帯ベースラインの57%にあたり、しきい値の「55%より大きい」を上回っています。

{
  "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: アラートを保存する

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

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

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

考慮事項

  • アラートの上限: 1つのキャンバスにつき、最大2つのカスタムアラートを作成できます。
  • 下書きのキャンバス: 下書き状態のキャンバスにもカスタムアラートを設定できますが、キャンバスが開始されるまで、アラートはルールに基づくチェックを開始しません。
  • パーセンテージのベースライン: パーセンテージルールには、キャンバスの開始後に、同じ時間枠の完全な日が7日分必要です。これらの時間枠がそろうまで、またはベースラインの平均がゼロの場合 (以前の時間枠にアクティビティがない場合)、パーセンテージルールは通知をトリガーしません。

よくある質問

カスタムアラートはWebhookの使用量にカウントされますか?

いいえ。キャンバスのカスタムアラートは、Webhookのレート制限や使用量の指標にはカウントされません。

New Stuff!