Canvasのトラブルシューティング
このページでは、Canvasに関する問題のトラブルシューティングを行います。
「Canvasのブランチが多すぎます」エラー
スケジュールされたCanvasを起動する際に「Too many Canvas branches」エラーが表示された場合、ステップの分岐とエントリオーディエンスのサイズの組み合わせにより、Brazeクラスターのパフォーマンスに問題が生じ、メッセージの送信が妨げられる可能性があります。
Brazeはこのメッセージを、スケジュールされたエントリのCanvasを起動するときに表示します。下書きを保存するときには表示されません。これを解決するには、以下をお試しください。
- Canvas内のステップの分岐を減らします。
- エントリオーディエンスのサイズを縮小します。
- 多数の並列パスの代わりに、オーディエンスパスを使用して分岐を統合します。
- Canvasがオリジナルエディターを使用している場合は、キャンバスフローに複製して、Canvasコンポーネントで再構築します。
変更せずにCanvasを起動する必要があり、キャンバスフローに移行できない場合は、サポートにお問い合わせください。
トリガーされたキャンバスステップをユーザーが受信しなかったのはなぜですか?
まず、カスタムイベントがBrazeに渡されていることを確認してください。Analytics > カスタムイベントレポートに移動し、該当するカスタムイベントと日付範囲を選択します。イベントが表示されない場合は、正しく設定されていること、およびユーザーが正しいアクションを実行したことを確認してください。
カスタムイベントが表示される場合は、以下の手順でさらにトラブルシューティングを行ってください。
- ユーザーのプロファイルダウンロードを確認し、イベントがトリガーされたかどうか、およびいつトリガーされたかを確認します。イベントがトリガーされた場合は、イベントがトリガーされたタイムスタンプとCanvasが公開された時刻を比較してください。Canvasが公開される前にイベントがトリガーされた可能性があります。
- Canvasおよびターゲティングに使用されているSegmentsの変更ログを確認し、カスタムイベントがトリガーされた時点でユーザーがSegmentに含まれていたかどうかを判断します。Segmentに含まれていなかった場合、そのユーザーはキャンバスステップを受信しません。
- ユーザーがCanvasのエントリ時にコントロールグループに割り当てられ、その結果キャンバスステップの受信が妨げられていないかを確認します。
- スケジュールされた遅延がある場合は、ユーザーのカスタムイベントが遅延の前にトリガーされたかどうかを確認します。遅延の前にイベントがトリガーされた場合、そのユーザーはキャンバスステップを受信しません。

アプリ内メッセージは、SDKを通じて送信されたイベントによってのみトリガーでき、REST APIではトリガーできません。
Canvasが期待どおりに送信されないのはなぜですか?
Canvasは堅牢で複雑であり、作成に時間と注意を費やしていることを理解しています。Canvasが期待どおりに送信されない場合は、Canvasのスケジュール、エントリオーディエンス、エントリ設定を確認し、Canvasの作成手順を見直すことをお勧めします。
スケジュール
- Canvasは正しくスケジュールされていますか?
- 正しい日付と時刻を選択しましたか?
- アクションベースの配信の場合、Canvasを起動してからユーザーは指定されたアクションを実行しましたか?
エントリ設定
エントリ設定は、Canvasがどのように送信されているかを理解するために重要です。Canvasに入る可能性のある人数を制限していないか確認してください。
また、メッセージを受信する資格がなくなった場合、ユーザーはCanvasから退出することがあります。たとえば、Canvasにプッシュ通知のみが含まれていて、ユーザーが最初のステップを受信した後にプッシュをオプトアウトした場合、そのユーザーはCanvasから脱落します。さまざまなキャンバスステップを使用して、代替のユーザージャーニーを追加することを検討してください。
オーディエンスのセグメンテーション
ターゲットオーディエンスについて、以下の質問を検討してください。
- 正しいSegmentを選択しましたか?
- Segmentはどのように設定されていますか?
- Segmentにユーザーが含まれていることを確認しましたか?
- Canvasに入るユーザー数を制限する追加のフィルターを設定しましたか?
- ユーザーはバリアントの最初のステップを受信する資格がありますか?たとえば、Canvasの最初のステップがプッシュ通知であるにもかかわらず、エントリオーディエンスがすべてプッシュ無効の場合、メッセージを受信するユーザーはいません。
送信数や配信数がターゲットオーディエンスのサイズより少ないのはなぜですか?
送信または配信されたメッセージ数は、推定オーディエンスや受信者数と異なることがよくあります。一般的な理由は以下のとおりです。
- オーディエンスの再評価: ユーザーがステップに入ってからメッセージが送信されるまでの間に、Segmentから外れることがあります。
- チャネルの適格性: メールアドレス、プッシュトークン、またはそのステップのチャネルに必要なサブスクリプションステータスが不足している場合があります。
- コントロールグループ: グローバルまたはCanvasのコントロールグループにより、ユーザーがメッセージングから除外されることがあります。
- サイレント時間帯、インテリジェントタイミング、レート制限: これらの設定により、送信が延期または抑制されることがあります。
- アプリ内メッセージステップ: アプリ内メッセージでは、インプレッションが存在するにもかかわらず送信数がゼロと表示されることがあります。これはアプリ内メッセージの配信がプッシュ通知やメールとは異なる仕組みで動作するため、想定どおりの動作です。詳しくは、Canvas FAQのインプレッションが記録されているのにCanvasの送信数がゼロと表示されるのはなぜですか?を参照してください。
メールやその他のチャネルについても、Campaignsと同様の要因が多く当てはまります。詳細なリストについては、推定オーディエンスサイズより送信数が少ないのはなぜですか?を参照してください。
夏時間の日に、毎日スケジュールされたCanvasにユーザーが入らなかったのはなぜですか?
夏時間(DST)の切り替え日には、毎日スケジュールされたCanvasが通常より最大1時間早くまたは遅く実行されることがあります。エントリ条件がカスタム属性やタイムスタンプ付きのイベントに依存しており、それがスケジュールされたエントリ時刻の1時間以内に該当する場合、属性やイベントがまだ記録されていないため、DSTの日にユーザーが資格を満たさない可能性があります。
たとえば、ユーザーが通常Canvasのタイムゾーンで午後3時にカスタム属性の更新を受け取り、Canvasが同じタイムゾーンで毎日午後3時30分に実行されるとします。春の時計を進めるDSTの日には、Canvasがその属性更新に対して通常より最大1時間早くユーザーを評価する可能性があり、属性がまだ記録されていない状態で評価されます。再適格性がオフになっている場合、前日までに入ったユーザーは再入場できず、その日のエントリがゼロになります。
これを回避するには、カスタム属性またはイベントの更新がCanvasのスケジュールされたエントリ時刻の1時間以上前に行われるようにしてください。
コントロールグループとバリアントグループの間でオーディエンスが均等に分割されなかったのはなぜですか?
Canvasを作成する際、以下のユースケースのように、コントロールグループとバリアントグループの間でオーディエンスが均等に分割されることを期待していたかもしれません。その理由と修正方法について説明します。
コントロールグループとバリアントの割り当ては、Segmentフィルターではなく、ビルダーで設定した割合に基づいてCanvasのエントリ時に行われます。ユーザーは、エントリステップで定義されたすべての条件に適合した場合にCanvasに入ります。
ユーザーがバリアントに入ったものの、チャネルの適格性がないためにメッセージを受信しない場合は、ターゲットオーディエンスにチャネルフィルターを追加するのではなく、各ステップの送信設定を使用してください(たとえば、サブスクリプション設定をオプトインユーザーのみに設定するなど)。マルチチャネルCanvasの場合、エントリオーディエンスを単一のチャネル(フォアグラウンドプッシュが有効など)に限定しないでください。
特定のチャネルを受信できないユーザーでも、バリアントに入ることがあります。各メッセージタイプの受信者を制限するには、エントリオーディエンスフィルターではなく、ステップごとの送信設定を使用してください。
ユースケース
以下のシナリオを想像してみましょう。
- Canvasには単一のバリアントとコントロールグループがあります。
- バリアントの最初のステップはプッシュ通知です。
- 90%のユーザーがバリアントに入るように選択され、10%がコントロールグループに入るように選択されました。

このシナリオでは、Canvasに入るユーザーの90%がバリアントに入ります。
アクティブユーザーを振り返ると、29.8kのユーザーが含まれているにもかかわらず、プッシュが有効なのはそのうち64%のみであることがわかります。

つまり、90%のユーザーがバリアントに入るように指定しても、それらのユーザー全員が実際にプッシュ通知を受信できるわけではありません。プッシュ通知を受信できないユーザーも、バリアントには入ります。
Canvasエディターがフリーズしたり読み込まれないのはなぜですか?
多くのブランチやバリアント、多数のステップ、または非常に幅広いフローを持つ大規模で複雑なCanvasを編集している場合、エディターが読み込みに失敗したりフリーズしたりすることがあります。この場合、以下をお勧めします。
- ブラウザのキャッシュとCookieをクリアしてから、ページを再読み込みしてください。会社の広告ブロッカーやブラウザ拡張機能を使用している場合、Brazeプラットフォームに干渉する可能性があります。
- Canvasのズームコントロールを使用して、表示を25%または10%に縮小してください。これにより、ブラウザが一度にレンダリングするUIの量が減ります。
- 別のWebブラウザを試してください。