コンテンツにスキップ

キャンバスのトラブルシューティング

このページでは、キャンバスのエントリ、送信、分析の問題を診断します。定義や詳細については、キャンバスFAQを参照してください。

まずはここから：症状を確認する

症状 参照先
ユーザーがキャンバスにエントリしなかった ユーザーがキャンバスにエントリしなかった
ユーザーがエントリしたがメッセージやステップを受信しなかった ユーザーがキャンバスのメッセージやステップを受信しなかった
エントリしたユーザーがいないか、予想より少ない キャンバスのエントリ数が少ないまたはゼロ
送信数または配信数が推定オーディエンスより少ない 予想より送信数が少ない
キャンバスの分析が正しくない（コントロールグループ、コンバージョン、送信数ゼロ） キャンバスの分析の不一致
分析でエントリ数よりはるかに多い送信数、またはエントリ数より多い離脱数が表示される 日付範囲フィルタリングにより予期しない数値が表示されることがある
キャンバスが保存できない、またはエディターがフリーズする エディターと保存の問題
キャンバスのバリアントを削除できない アーカイブされたセグメントによりキャンバスのバリアントを削除できない
キャンバスを停止したがメッセージが送信された 停止したキャンバスの動作
起動時に「Too many キャンバス branches」エラーが表示される 「Too many キャンバス branches」エラー

標準的な調査パス

特定のユーザーまたは送信全体の問題を調査するには、このワークフローを使用してください。すべてのインシデントについて、ステップ1から始めてください。

  1. キャンバスがアクティブ（下書き、停止、またはアーカイブではない）であることを確認します。
  2. エントリスケジュール（スケジュールされたウィンドウ、タイムゾーン、アクションベースのトリガー、またはAPIトリガーエントリ）が、ユーザーのエントリが想定されるタイミングと一致していることを確認します。
  3. オーディエンス > ユーザー検索に移動し、プロファイルを開いてメッセージ履歴（過去30日間）を選択して、ユーザーのメッセージング記録を確認します。
  4. キャンバスの変更履歴と、ターゲティングに使用されているセグメントの変更履歴を確認します。インシデント中にオーディエンス、ステップ、または送信設定が変更されていないことを確認してください。
  5. キャンバス分析ページで集計結果を確認します。メッセージング診断ダッシュボードを開き、中止およびドロップの理由を確認してください。
  6. それでも解決しない場合は、キャンバスID、影響を受けたユーザーID、タイムスタンプ（タイムゾーン付き）、およびメッセージ履歴またはメッセージング診断のスクリーンショットを添えて、30日以内にBrazeサポートにお問い合わせください。

ローンチ前に、テストキャンバスの送信とユーザーパスのプレビューを使用して、設定を検証してください。

ユーザーがキャンバスに入らなかった

症状： 期待していたのにユーザーがキャンバスに入らなかった、またはトリガーイベントが示す数よりも少ないユーザーしか入らなかった。

ユーザーは、Brazeがエントリトリガーを評価する前にターゲットオーディエンスに一致している必要があります（属性の変更トリガーを除く）。トリガーだけでは、評価時にユーザーがオーディエンスに含まれていなかった場合、エントリは保証されません。

再適格性と再エントリはエントリコントロールの選択で別々のコントロールです：

  • 再適格性： ユーザーがキャンバスを退出した後、再度キャンバスに入ることが許可されるかどうかを決定します（時間ウィンドウとユーザーにキャンバスへの再エントリを許可する設定）。
  • 再エントリ： 現在キャンバス内にいるユーザーが並行パスに入ることができるかどうかを決定します。

ユーザーは再適格であっても、まだキャンバス内にいるためにブロックされたり、退出していても再適格性ウィンドウの外にいたりすることがあります。ユーザーがキャンバスに再エントリしない場合は、両方の設定を確認してください。

以下を確認してください：

  • エントリスケジュールとタイムゾーン： キャンバスが有効であり、ユーザーがエントリウィンドウ中にトリガーを実行したことを確認してください。
  • 評価時のターゲットオーディエンス： セグメントとフィルターの変更ログを確認してください。ユーザー検索は、一部のフィルタータイプ（例えば、文字列形式の日付属性）で偽陽性を示すことがあります。
  • エントリ上限： 最大エントリ数またはオーディエンス上限に達している可能性があります。
  • グローバルコントロールグループ： グローバルコントロールグループに含まれるユーザーは、メッセージングキャンバスに入りません。
  • キャンバスコントロールグループ： エントリ時にキャンバスコントロールグループに割り当てられたユーザーは、バリアントメッセージを受信しません。バリアントの割り当てはエントリ時に行われ、セグメントフィルターを通じて行われるわけではありません。キャンバス分析の不一致を参照してください。
  • 退出条件： ユーザーがエントリの前または最中に退出条件に一致した可能性があります。エントリと退出が同じイベントを使用する場合は、エントリ条件と退出条件のマッチングを参照してください。
  • APIトリガーエントリ： ユーザーが/canvas/trigger/sendエンドポイントで追加されたことを確認してください。キャンバスエントリフィルターを使用してセグメントを作成し、/users/export/segmentでユーザーをエクスポートできます。

トリガーイベント数がキャンバスエントリ数より多い

症状： トリガーイベントのボリュームがキャンバスエントリ数より多い。

Brazeは同じ瞬間に発生した複数のエントリ試行を重複排除するため、トリガーイベントよりもキャンバスエントリが少なくなることがあります。複数のエントリをテストする場合は、トリガーイベントを少なくとも1秒間隔で送信してください。

ユーザーが1秒以内に同じトリガーを複数回実行した場合、Brazeは1回のエントリのみを処理します。再エントリまたは再適格性ルールが適用される場合は、メッセージング診断でユーザーが再適格でないなどの結果を確認してください。

夏時間と毎日スケジュールされたキャンバス

夏時間（DST）の移行日には、毎日スケジュールされたキャンバスが通常より最大1時間早くまたは遅く実行されることがあります。エントリ条件がカスタム属性またはスケジュールされたエントリ時間の1時間以内のタイムスタンプを持つイベントに依存している場合、属性やイベントがまだ記録されていないため、DST日にユーザーが適格にならない可能性があります。

例えば、通常ユーザーがキャンバスのタイムゾーンで午後3時にカスタム属性の更新を受け取り、キャンバスが同じタイムゾーンで毎日午後3時30分に実行されるとします。春の時間進みのDST日には、キャンバスがその属性更新に対して通常より最大1時間早くユーザーを評価する可能性があり、属性が記録される前に評価が行われます。再適格性がオフの場合、以前の日にエントリしたユーザーは再エントリできず、その日のエントリがゼロになります。

これを回避するには、カスタム属性またはイベントの更新がキャンバスのスケジュールされたエントリ時間より1時間以上前に行われるようにしてください。

ユーザーがキャンバスのメッセージやステップを受信しなかった

症状： ユーザーがキャンバスにエントリしたが、期待されるメッセージやステップを受信しなかった。

ユーザーのメッセージング履歴で、キャンバスのステップとタイムスタンプを確認してください。記録が存在しない場合は、ユーザーがキャンバスにエントリしなかったに戻ってください。

次に、トリガーまたはステップタイプに応じて以下を確認してください。

  • カスタムイベントまたは購入トリガー： イベントがAnalytics > カスタムイベントレポート（購入の場合は収益）に表示されていることを確認します。イベントのタイムスタンプを、キャンバスが有効になった時刻およびステップに設定されているスケジュール遅延と比較してください。
  • APIトリガーエントリ： ユーザーがキャンバスにエントリしなかったで説明されているように、キャンバスのセグメントフィルターとエクスポートでエントリを確認します。
  • アクションパスまたはメッセージステップのトリガー： ユーザーが前提条件となるイベントを実行したこと、およびイベントプロパティがそのステップで利用可能であることを確認します。
  • アプリ内メッセージステップ： アプリ内メッセージは、ユーザーがステップにエントリした後の次のセッション開始時に送信され、SDKイベントからのみ送信されます（REST APIからは送信されません）。キャンバスのアプリ内メッセージはいつ送信されますか？（キャンバスFAQ）を参照してください。
  • キャンバスのコントロールグループ： ユーザーがエントリ時にキャンバスのコントロールグループに割り当てられていないことを確認します。
  • チャネルの適格性と送信設定： 購読ステータス、プッシュ有効状態、およびステップごとの送信設定を確認します（例：購読設定がオプトインユーザーのみに設定されている場合）。マルチチャネルのキャンバスでは、シングルチャネルのフィルターをターゲットオーディエンスに追加しないでください。
  • 配信バリデーション： メッセージステップでメッセージ送信時にオーディエンスを検証を有効にしている場合、送信時にフィルター条件に一致しなくなったユーザーはメッセージを受信しません。配信バリデーションを参照してください。
  • サイレント時間、インテリジェントタイミング、フリークエンシーキャップ、レート制限： これらは送信を遅延、抑制、または中止させる可能性があります。サイレント時間による中止の後も、ユーザーはキャンバスに残る場合があります。
  • 競合： ユーザーが同時に複数のアクションをトリガーした場合は、競合を参照してください。

ステップレベルのフィルター、ブランチ間の競合、およびアプリ内メッセージの分岐動作については、キャンバスフローでの起動 — トラブルシューティングおよびキャンバスFAQを参照してください。

キャンバスへのエントリが少ない、またはゼロ

症状： キャンバスに誰もエントリしなかった、または想定よりも少ないユーザーしかエントリしなかった。

まずキャンバスフローでの起動チェックリストを確認してから、以下を確認してください：

  • キャンバスがアクティブであり、現在の時刻がスケジュールされたエントリウィンドウ内であること。
  • エントリ設定（再適格性、最大エントリ数、エントリ上限）が、想定するユーザーのエントリを許可していること。
  • ターゲットオーディエンスとセグメントフィルターが、起動後も想定するユーザーと一致していること。
  • グローバルおよびキャンバスのコントロールグループの割合が、各パスにエントリするユーザーとメッセージを受信するユーザーの比率を正しく示していること。
  • ワークスペースのレート制限やエントリキューが、ユーザーが適格になってからエントリまたはステップに進むまでの間に遅延を追加することが想定されていること。

単一のユーザーについては、標準的な調査パスに従ってください。夏時間（DST）関連のゼロエントリについては、ユーザーがキャンバスにエントリしなかったの折りたたみセクションを参照してください。

送信数が予想より少ない

症状： キャンバスステップで、送信数または配信数が推定オーディエンスより少ない。

よくある原因として、送信時のオーディエンス再評価、チャネルの適格性、コントロールグループ、サイレント時間帯、インテリジェントタイミング、レート制限、アプリ内メッセージの配信動作（アプリ内メッセージでは_送信数_がゼロでインプレッションがあるのは想定どおりの動作です）が挙げられます。

メッセージステップで多くのユーザーがエントリしたにもかかわらず送信数が少ない場合は、Liquidのabort_message()が送信をキャンセルしていないか確認してください。メッセージアクティビティログの確認、不足している属性、テスト送信については、高い中断率のトラブルシューティングを参照してください。

詳細なリストについては、キャンバスFAQの送信数が推定オーディエンスサイズより少ないのはなぜですか？と、キャンペーン向けの送信数が推定オーディエンスサイズより少ないのはなぜですか？を参照してください。

メッセージング診断ダッシュボードを使用して、ステップレベルでの中断理由やドロップ理由を確認できます。

キャンバス分析の不一致

症状: キャンバスの分析が正しくないように見える（コントロールグループの分割、コンバージョン、または送信数がゼロ）。

コントロールグループとバリアントの割り当ては、セグメントフィルターではなく、ビルダーで設定したパーセンテージに基づいてキャンバスエントリ時に行われます。特定のチャネルを受信できないユーザーでもバリアントにエントリする場合があります。チャネルフィルターでターゲットオーディエンスを絞り込むのではなく、ステップごとの送信設定を使用して、各メッセージタイプを受信するユーザーを制限してください。

キャンバスのコントロールグループとグローバルコントロールグループを区別してください。フィルターの定義については、キャンバスFAQの「キャンバスバリアントにエントリしていない」と「キャンバスコントロールグループに属していない」の違いは何ですか？を参照してください。

バリアントの送信数がバリアントのパーセンテージより低くなる理由

次のシナリオを想像してみましょう:

  • キャンバスに1つのバリアントと1つのコントロールグループがある。
  • バリアントの最初のステップはプッシュ通知である。
  • 90%のユーザーがバリアントにエントリするよう選択され、10%がコントロールグループにエントリするよう選択された。

90%のバリアントと10%のコントロールグループを持つキャンバスの例。

このシナリオでは、キャンバスにエントリするユーザーの90%がバリアントにエントリします。

アクティブユーザーのセグメントを見ると、29.8kのユーザーが含まれていますが、そのうちプッシュが有効なのは64%のみであることがわかります。

「プッシュ有効」フィルターが「true」に設定されたセグメント。推定ユーザー数は29.8k。

つまり、90%のユーザーがバリアントにエントリするよう指定していても、そのすべてのユーザーがプッシュ通知を受信できるわけではありません。プッシュを受信できないユーザーでもバリアントにはエントリします。送信数はエントリ時のバリアント割り当てではなく、ステップ時点でのチャネル適格性を反映しています。

日付範囲フィルタリングで予期しない数値が表示される

症状: キャンバスまたはステップの分析で、エントリ数よりはるかに多い送信数や、エントリしたユーザーよりも多くのユーザーがステップから退出するなど、予期しない数値や不自然な数値が表示される。

これは、キャンバス分析ページ上部の日付範囲カレンダーフィルターを使用した場合に発生することがあります。一部のユーザーアクションを除外する日付範囲を選択すると、表示される指標は各ユーザーのジャーニーの一部のみを示す場合があります。

例:

  • 日付範囲がほとんどのユーザーのエントリ後から始まり、メッセージ受信時を含んでいる場合、100件のエントリに対して8,000件の送信が表示されることがあります。
  • 日付範囲が退出のみをキャプチャし、以前のエントリを含んでいない場合、前のステップにエントリしたユーザーよりも多くのユーザーが次のステップに移動しているように表示されることがあります。

これを解決するには、キャンバスの起動日から現在までのすべての日付を含むように日付範囲を調整するか、必要な指標に関連する完全な期間をカバーする範囲を選択してください。

コンバージョン率の定義とステップレベルの分析については、キャンバスFAQの分析とコンバージョンを参照してください。

エディターと保存の問題

症状： キャンバスエディターが読み込まれない、フリーズする、または変更が保存されない。

症状 最も可能性の高い原因
エラーが表示されず保存ボタンが無限に回転する キャンバスオーディエンスまたはステップフィルターに空または不完全なカスタム属性フィルターがある — フィルターを削除するか、有効な属性を選択してください
編集中に「Request Timed Out」エラーが表示される ブラウザー拡張機能の干渉、広告ブロッカー、またはセッションの期限切れ — シークレットウィンドウまたは別のブラウザーを試してください
バリアントのアーカイブ後に保存できない アーカイブされたバリアントがダウンストリームでまだ参照されている — ステップの接続を確認し、バリアントを復元または置換してください

大規模または複雑なキャンバスでエディターがフリーズする場合は、以下を試してください。

  • ブラウザーのキャッシュとCookieをクリアし、ページを再読み込みしてください。企業の広告ブロッカーやブラウザー拡張機能がBrazeプラットフォームに干渉している可能性があります。
  • キャンバスのズームコントロールを使用して、表示を25%または10%に縮小し、ブラウザーがレンダリングするUIの量を減らしてください。
  • 別のWebブラウザーを試してください。

キャンバスが読み込まれず進まない場合、以前のバージョンが正しく保存されず、無効なステップが含まれている可能性があります。ダッシュボードからキャンバスを複製してください。問題が解決しない場合は、サポートチケットを開いてください。

「Request Timed Out」のサポートチケットには、画面録画、タイムスタンプとタイムゾーン、ブラウザーとバージョン、再現手順、およびオプションでブラウザーの開発者ツールからのHARログを含めてください。詳しくは、キャンバスFAQの「Request Timed Out」エラーのサポートチケットを送信する際に何を含めるべきですか？を参照してください。

停止したキャンバスの動作

症状：キャンバスを停止したが、ユーザーがまだメッセージを受信した。

キャンバスを停止すると、ユーザーはエントリできなくなり、キャンバスフローからのメッセージ送信は行われなくなります。ただし、すでにメールサービスプロバイダーに引き渡されたメール送信は取り消すことができません。

遅延ステップやアクションパスステップで待機中のユーザーは、キャンバスを停止しても自動的にジャーニーから削除されません。スケジュールされた送信時間が経過する前にキャンバスを再度有効にした場合、保留中のステップがそのまま送信される可能性があります。

詳細については、キャンバスFAQのキャンバスを停止するとどうなりますか？を参照してください。

「キャンバスの分岐が多すぎます」エラー

症状: スケジュールされたキャンバスを起動する際に、「Too many キャンバス branches」エラーが表示されます。

このエラーは、ステップの分岐とエントリオーディエンスサイズの組み合わせにより、メッセージの送信を妨げるクラスターパフォーマンスの問題が発生する可能性がある場合に表示されます。Brazeは、スケジュールされたエントリを持つキャンバスを起動する際にこのメッセージを表示します。下書きを保存するときには表示されません。

解決するには：

  • キャンバス内のステップ分岐を減らします。
  • エントリオーディエンスのサイズを縮小します。
  • 多数の並列パスの代わりに、オーディエンスパスを使用して分岐を統合します。
  • キャンバスがオリジナルエディターを使用している場合は、キャンバスフローに複製して、キャンバスコンポーネントで再構築します。

変更せずにキャンバスを起動する必要があり、キャンバスフローに移行できない場合は、サポートにお問い合わせください。

サポートへの問い合わせが必要な場合

標準的な調査パスを完了しても問題が解決しない場合は、問題の発生から30日以内にBrazeサポートにお問い合わせください。

以下の情報を含めてください：

  • キャンバスIDと影響を受けたユーザーID（external IDまたはBraze ID）
  • タイムゾーン付きのタイムスタンプ
  • Messaging HistoryまたはMessaging Diagnosticsのスクリーンショットまたはエクスポート
  • エディターの「Request Timed Out」エラーの場合は、エディターと保存の問題に記載されている詳細情報

Brazeカスタマーエンゲージメントプラットフォームのドキュメント。

リソース
法的情報
会社情報
© 2026 Braze, Inc. All rights reserved.
Braze ステータスの確認
New Stuff!