キャンバスのトラブルシューティング
このページでは、キャンバスのエントリ、送信、分析の問題を診断します。定義や詳細については、キャンバス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回のエントリのみを処理します。再エントリまたは再適格性ルールが適用される場合は、Messaging Observabilityでユーザーが再適格でないなどの結果を確認してください。
夏時間と毎日スケジュールされたキャンバス
夏時間（DST）への切り替え日には、毎日スケジュールされたキャンバスが通常より最大1時間早くまたは遅く実行される場合があります。エントリ条件がスケジュールされたエントリ時間の前後1時間以内のタイムスタンプを持つカスタム属性やイベントに依存している場合、DST当日にはその属性やイベントがまだ記録されていないため、ユーザーが適格にならない可能性があります。
例えば、ユーザーが通常キャンバスのタイムゾーンで午後3時にカスタム属性の更新を受け取り、キャンバスが同じタイムゾーンで毎日午後3時30分に実行されるとします。春の時間進み（スプリングフォワード）のDST当日には、キャンバスがその属性更新に対して通常よりも最大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」エラーの場合は、エディターと保存の問題に記載されている詳細情報