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

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

つまり、90% のユーザーがバリアントに入るように指定しても、それらのユーザー全員が実際にプッシュ通知を受信できるわけではありません。プッシュ通知を受信できないユーザーも、バリアントには入ります。