Canvasのトラブルシューティング
このページでは、Canvases に関する問題のトラブルシューティングを支援します。
トリガーされたキャンバスステップをユーザーが受信しなかったのはなぜですか?
まず、カスタムイベントがBrazeに渡されていることを確認してください。Analytics > カスタムイベントレポートに移動し、該当するカスタムイベントと日付範囲を選択します。イベントが表示されない場合は、正しく設定されていること、およびユーザーが正しいアクションを実行したことを確認してください。
カスタムイベントが表示される場合は、以下の手順でさらにトラブルシューティングを行ってください。
- ユーザーのプロファイルダウンロードを確認し、イベントがトリガーされたかどうか、およびいつトリガーされたかを確認します。イベントがトリガーされた場合は、イベントがトリガーされたタイムスタンプとCanvasが公開された時刻を比較してください。Canvasが公開される前にイベントがトリガーされた可能性があります。
- Canvasおよびターゲティングに使用されているSegmentsの変更ログを確認し、カスタムイベントがトリガーされた時点でユーザーがSegmentに含まれていたかどうかを判断します。Segmentに含まれていなかった場合、そのユーザーはキャンバスステップを受信しません。
- セグメンテーションによってユーザーがコントロールグループに入り、その結果キャンバスステップの受信が妨げられていないかを確認します。
- スケジュールされた遅延がある場合は、ユーザーのカスタムイベントが遅延の前にトリガーされたかどうかを確認します。遅延の前にイベントがトリガーされた場合、そのユーザーはキャンバスステップを受信しません。

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

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

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