キャンバスのトラブルシューティング
このページでは、キャンバスのエントリ、送信、分析の問題を診断します。定義や詳細については、キャンバスFAQを参照してください。
ローンチ後は、キャンバスQAチェックリストのフェーズ5：ローンチ後のモニタリングから始めて、最初の1時間によくあるパターン（配信到達性のスパイク、エントリが多いのに送信が少ない、オーディエンスが空、ステップのドロップオフ）を確認してください。より詳細な調査が必要な場合は、このページに戻ってください。
まずはここから：症状を確認する
| 症状 | 参照先 |
|---|---|
| ユーザーがキャンバスに入らなかった | ユーザーがキャンバスに入らなかった |
| ユーザーが入ったがメッセージやステップを受け取らなかった | ユーザーがキャンバスメッセージまたはステップを受け取らなかった |
| 誰もエントリしなかった、または予想より少ないユーザーしかエントリしなかった | キャンバスのエントリが少ないまたはゼロ |
| 送信数または配信数が推定オーディエンスより少ない | 予想より送信数が少ない |
| キャンバスの分析が正しくない（コントロールグループ、コンバージョン、送信数ゼロ） | キャンバスの分析の不一致 |
| 分析でエントリ数より送信数がはるかに多い、またはエントリ数より離脱数が多い | 日付範囲のフィルタリングにより予期しない数値が表示される場合がある |
| キャンバスが保存できない、またはエディターがフリーズする | エディターと保存の問題 |
| キャンバスバリアントを削除できない | アーカイブ済みセグメントが原因でキャンバスバリアントを削除できない |
| キャンバスを停止したがメッセージが送信された | 停止されたキャンバスの動作 |
| 起動時に「Too many キャンバス branches」エラーが表示される | 「Too many キャンバス branches」エラー |
標準的な調査パス
このワークフローを使用して、特定のユーザーまたは集約送信の問題を調査します。すべてのインシデントについてステップ1から始めてください。
- キャンバスがアクティブであることを確認します（下書き、停止済み、またはアーカイブ済みではないこと）。
- エントリスケジュール（スケジュールされたウィンドウ、タイムゾーン、アクションベースのトリガー、またはAPIトリガーエントリ）が、ユーザーのエントリが期待されるタイミングと一致していることを確認します。
- オーディエンス > ユーザーを検索に移動し、プロファイルを開いてメッセージング履歴（過去30日間）を選択して、ユーザーのメッセージングレコードを確認します。
- 期待される送信時刻のレコードが存在しない場合、問題はメッセージではなくエントリにあります。ユーザーがキャンバスにエントリしなかったを参照してください。
- キャンバスの変更履歴と、ターゲティングに使用されているセグメントの変更履歴を確認します。インシデント中にオーディエンス、ステップ、または送信設定が変更されていないことを確認します。
- キャンバス分析ページで集約結果を確認するために、メッセージングオブザーバビリティを開き、中止およびドロップの理由を確認します。
- それでも解決しない場合は、キャンバスID、影響を受けたユーザーID、タイムスタンプ（タイムゾーン付き）、およびメッセージング履歴またはメッセージングオブザーバビリティのスクリーンショットを添えて、30日以内にBrazeサポートにお問い合わせください。
起動前に、テストキャンバスの送信とユーザーパスのプレビューを使用してセットアップを検証してください。
ユーザーがキャンバスにエントリしない
症状： 期待したタイミングでユーザーがキャンバスにエントリしない、またはトリガーイベントが示す数よりもエントリしたユーザーが少ない。
ユーザーは、Brazeがエントリトリガーを評価する前にターゲットオーディエンスに一致している必要があります（属性の変更トリガーを除く）。トリガーだけでは、評価時にユーザーがオーディエンスに含まれていなかった場合、エントリは保証されません。
再適格性と再エントリは、エントリコントロールの選択で別々の制御として管理されます。
- 再適格性： ユーザーがキャンバスを退出した後に再びエントリできるかどうかを決定します（時間ウィンドウとユーザーのキャンバスへの再エントリを許可する設定）。
- 再エントリ： 現在キャンバス内にいるユーザーが同時進行のパスにエントリできるかどうかを決定します。
ユーザーは再適格であっても、まだキャンバス内にいるためにブロックされている場合や、退出済みであっても再適格性のウィンドウ外にある場合があります。ユーザーがキャンバスに再エントリしない場合は、両方の設定を確認してください。
以下を確認してください。
- エントリスケジュールとタイムゾーン： キャンバスが有効であり、ユーザーがエントリウィンドウ中にトリガーを実行したことを確認します。
- 評価時のターゲットオーディエンス： セグメントとフィルターの変更ログを確認します。ユーザー検索は、一部のフィルタータイプ（例：文字列形式の日付属性）で偽陽性を表示する場合があります。
- エントリ上限： 最大エントリ数またはオーディエンス上限に達している可能性があります。
- グローバルコントロールグループ： グローバルコントロールグループ内のユーザーは、メッセージングキャンバスにエントリしません。
- キャンバスコントロールグループ： エントリ時にキャンバスコントロールグループに割り当てられたユーザーは、バリアントメッセージを受信しません。バリアントの割り当てはエントリ時に行われ、セグメントフィルターを通じて行われるものではありません。キャンバス分析の不一致を参照してください。
- 退出条件： ユーザーがエントリの前または途中で退出条件に一致した可能性があります。エントリと退出が同じイベントを使用する場合は、エントリ条件と退出条件の一致を参照してください。
- APIトリガーによるエントリ： ユーザーが
/canvas/trigger/sendエンドポイントで追加されたことを確認します。キャンバスエントリフィルターでセグメントを作成し、/users/export/segmentでユーザーをエクスポートできます。
トリガーイベント数がキャンバスエントリ数より多い
症状： トリガーイベントのボリュームがキャンバスエントリ数より多い。
Brazeは同じ瞬間に発生した複数のエントリ試行を重複排除するため、トリガーイベントよりもキャンバスエントリが少なく表示される場合があります。複数のエントリをテストする場合は、トリガーイベントを少なくとも1秒以上間隔を空けてください。
ユーザーが1秒以内に同じトリガーを複数回実行した場合、Brazeは1つのエントリのみを処理します。再エントリまたは再適格性のルールが適用される場合は、メッセージングオブザーバビリティでユーザーは再適格ではありませんなどの結果を確認してください。
夏時間と毎日スケジュールされたキャンバス
夏時間（DST）の切り替え日には、毎日スケジュールされたキャンバスが通常より最大1時間早くまたは遅く実行される場合があります。エントリ条件がスケジュールされたエントリ時刻の1時間以内にタイムスタンプを持つカスタム属性やイベントに依存している場合、属性やイベントがまだログに記録されていないため、DSTの日にユーザーが適格にならない可能性があります。
例えば、ユーザーが通常キャンバスのタイムゾーンの午後3時にカスタム属性の更新を受信し、キャンバスが同じタイムゾーンの午後3時30分に毎日実行されるとします。春の夏時間切り替え日には、キャンバスがその属性の更新よりも最大1時間早くユーザーを評価する場合があり、属性がログに記録される前に評価が行われます。再適格性がオフになっている場合、以前の日にエントリしたユーザーは再エントリできず、その日のエントリがゼロになります。
これを避けるために、カスタム属性やイベントの更新がキャンバスのスケジュールされたエントリ時刻の1時間以上前に行われるようにしてください。
ユーザーがキャンバスのメッセージやステップを受信しなかった
症状： ユーザーがキャンバスに入ったが、期待されるメッセージやステップを受信しなかった。
ユーザーのメッセージ履歴でキャンバスのステップとタイムスタンプを確認してください。レコードが存在しない場合は、ユーザーがキャンバスに入らなかったに戻ってください。
次に、トリガーまたはステップタイプに応じて以下を確認してください。
- カスタムイベントまたは購入トリガー： Analytics > カスタムイベントレポート（購入の場合はRevenue）にイベントが表示されていることを確認します。イベントのタイムスタンプを、キャンバスが公開された時刻およびステップに設定されたスケジュール遅延と比較してください。
- APIトリガーエントリ： ユーザーがキャンバスに入らなかったで説明されているように、キャンバスのセグメントフィルターとエクスポートでエントリを確認します。
- アクションパスまたはメッセージステップのトリガー： ユーザーが前提条件となるイベントを実行したこと、およびそのステップでイベントプロパティが利用可能であることを確認します。
- アプリ内メッセージステップ： アプリ内メッセージは、ユーザーがステップに入った後の次のセッション開始時に送信され、SDKイベントからのみ送信されます（REST APIからは送信されません）。キャンバスFAQのキャンバスのアプリ内メッセージはいつ送信されますか？を参照してください。
- キャンバスのコントロールグループ： ユーザーがエントリ時にキャンバスのコントロールグループに割り当てられていないことを確認します。
- チャネルの適格性と送信設定： 購読ステータス、プッシュの有効状態、およびステップごとの送信設定（例：購読設定がオプトイン済みユーザーのみに設定されている場合）を確認します。マルチチャネルキャンバスのターゲットオーディエンスに単一チャネルのフィルターを追加しないでください。
- 配信バリデーション： メッセージステップでメッセージ送信時にオーディエンスを検証を有効にしている場合、送信時にフィルターに一致しなくなったユーザーはメッセージを受信しません。配信バリデーションを参照してください。
- クワイエットアワー、インテリジェントタイミング、フリークエンシーキャップ、レート制限： これらは送信を延期、抑制、または中止する可能性があります。クワイエットアワーによる中止後も、ユーザーはキャンバスに残る場合があります。
- 競合： ユーザーが複数のアクションを同時にトリガーした場合は、競合を参照してください。
遅延や分岐後のアプリ内メッセージの送信タイミングについては、キャンバスFAQを参照してください。条件分岐やアクションパスでのメッセージステップの前進については、キャンバスQAチェックリストのユーザーの前進に関するメッセージステップの確認を参照してください。
アクションベースのキャンバスが予想よりも早くメッセージを送信する場合は、カスタムイベントのタイムスタンプが遡った時刻ではなく現在の時刻を使用しているか確認してください。Brazeはイベントと共に送信されたタイムスタンプから遅延を評価します。アクションベースの配信を参照してください。
キャンバスのエントリが少ない、またはゼロ
症状：キャンバスに入ったユーザーがいない、または予想よりも少ない。
まずキャンバスQAチェックリストから始め、次の点を確認してください。
- キャンバスがアクティブで、現在の時刻がスケジュールされたエントリウィンドウ内であること。
- エントリ設定（再適格性、最大エントリ数、エントリ上限）が、エントリを期待するユーザーを許可していること。
- ターゲットオーディエンスとセグメントフィルターが、起動後も期待するユーザーと一致していること。
- グローバルおよびキャンバスのコントロールグループの割合が、各パスに入るユーザーとメッセージを受け取るユーザーの比率を正しく示していること。
- ワークスペースのレート制限やエントリキューが、ユーザーが条件を満たしてからエントリするまで、またはステップに進むまでの間に遅延を加えることが想定されていること。
個別のユーザーについては、標準的な調査パスに従ってください。夏時間（DST）に関連するエントリゼロの問題については、ユーザーがキャンバスにエントリしなかったの折りたたみセクションを参照してください。
送信数が予想より少ない
症状： キャンバスステップの推定オーディエンスに比べて、送信数や配信数が少ない。
一般的な原因には、送信時のオーディエンス再評価、チャネルの適格性、コントロールグループ、サイレント時間、インテリジェントタイミング、レート制限、アプリ内メッセージの配信動作（アプリ内メッセージでは送信数がゼロでインプレッションがあるのは想定どおりです）などがあります。
メッセージステップに多くのユーザーが入ったにもかかわらず送信数が少ない場合は、Liquidのabort_message()が送信をキャンセルしていないか確認してください。中断の確認方法、不足している属性、テスト送信については、高い中断率のトラブルシューティングを参照してください。
詳細な一覧については、キャンバスFAQの送信数が推定オーディエンスサイズより少ないのはなぜですか？およびキャンペーン向けの送信数が推定オーディエンスサイズより少ないのはなぜですか？を参照してください。
メッセージングオブザーバビリティを使用して、ステップレベルでの中断やドロップの理由を確認できます。
キャンバス分析の不一致
症状： キャンバスの分析結果がおかしい（コントロールグループの分割、コンバージョン、送信数ゼロなど）。
コントロールグループとバリアントの割り当ては、ビルダーで設定したパーセンテージに基づいてキャンバスエントリ時に行われます。セグメントフィルターによるものではありません。特定のチャネルを受信できないユーザーでもバリアントにエントリする場合があります。ターゲットオーディエンスをチャネルフィルターで絞り込むのではなく、ステップごとの送信設定を使用して、各メッセージタイプを受信するユーザーを制限してください。
キャンバスのコントロールグループとグローバルコントロールグループを区別してください。フィルターの定義については、キャンバスFAQの「キャンバスバリアントにエントリしていない」と「キャンバスのコントロールグループに含まれていない」の違いは何ですか？を参照してください。
バリアントの送信数がバリアントのパーセンテージよりも少なくなる理由
以下のシナリオを考えてみましょう。
- キャンバスに1つのバリアントと1つのコントロールグループがあります。
- バリアントの最初のステップはプッシュ通知です。
- 90%のユーザーがバリアントにエントリするよう選択され、10%がコントロールグループにエントリするよう選択されました。
このシナリオでは、キャンバスにエントリしたユーザーの90%がバリアントにエントリします。
アクティブユーザーセグメントを見ると、29.8kのユーザーが含まれていますが、そのうちプッシュ通知が有効なのは64%のみであることがわかります。
つまり、90%のユーザーがバリアントにエントリするよう指定しても、そのすべてのユーザーがプッシュ通知を受信できるわけではありません。プッシュ通知を受信できないユーザーもバリアントにはエントリします。送信数はエントリ時のバリアント割り当てではなく、ステップ時点でのチャネル適格性を反映しています。
日付範囲フィルタリングで予期しない数値が表示される場合
症状： キャンバスまたはステップの分析で、エントリ数よりもはるかに多い送信数や、エントリした数よりも多くのユーザーがステップを離脱しているなど、予期しない数値や不合理な数値が表示されます。
これは、キャンバス分析ページの上部にある日付範囲カレンダーフィルターを使用した場合に発生することがあります。一部のユーザーアクションを除外する日付範囲を選択すると、表示される指標は各ユーザーのジャーニーの一部のみを反映する場合があります。
例：
- 日付範囲がほとんどのユーザーのエントリ後から始まり、メッセージ受信期間を含む場合、100件のエントリに対して8,000件の送信が表示されることがあります。
- 日付範囲が離脱のみをキャプチャし、それ以前のエントリを含まない場合、前のステップにエントリしたユーザーよりも多くのユーザーが次のステップに移動しているように表示されることがあります。
この問題を解決するには、キャンバスの開始日から現在までのすべての日付を含むように日付範囲を調整するか、必要な指標に関連する全期間をカバーする範囲を選択してください。
コンバージョン率の定義とステップレベルの分析については、キャンバスFAQの分析とコンバージョンを参照してください。
エディターと保存の問題
症状： キャンバスエディターが読み込まれない、フリーズする、または変更が保存されない。
| 症状 | 最も考えられる原因 |
|---|---|
| 保存ボタンがエラーなしで無限に回転する | キャンバスオーディエンスまたはステップフィルターに空または不完全なカスタム属性フィルターがある — フィルターを削除するか、有効な属性を選択してください |
| 編集中に「Request Timed Out」エラーが表示される | ブラウザー拡張機能の干渉、広告ブロッカー、またはセッションの期限切れ — シークレットウィンドウまたは別のブラウザーでお試しください |
| バリアントをアーカイブした後に保存できない | アーカイブされたバリアントが下流でまだ参照されている。ステップの接続を確認し、バリアントを復元するか置き換えてください |
同じキャンバスを複数のブラウザータブで開いている場合、1つのタブで保存すると、古いタブで行った変更が上書きされる可能性があります。この競合により、オーディエンスフィルターが削除されたり、意図しない変更が適用されたりする場合があります。データの損失を防ぐために、キャンバスを編集・保存する前に重複するタブをすべて閉じてください。
大規模または複雑なキャンバスでエディターがフリーズする場合は、以下をお試しください。
- ブラウザーのキャッシュと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 Observabilityのスクリーンショットまたはエクスポート
- エディターの「Request Timed Out」エラーの場合は、エディターと保存の問題に記載されている詳細情報