キャンバスでユーザーパスをプレビューする
ユーザーのために作成したキャンバスジャーニーを実際に体験できます。これには、ユーザーが受け取るメッセージとそのタイミングのプレビューが含まれます。これらのテスト実行は、キャンバスを送信する前に、メッセージが適切なオーディエンスに送信されることを確認する品質保証として機能します。
テスト実行の作成
ユーザージャーニーをプレビューするには、次の手順に従います。
- キャンバスビルダーに移動します。未保存の変更を保存し、エラーがあれば解決します。
- フッターのキャンバスをテストを選択します。
- テストユーザーを選択します。
- (オプション) テストの受信者を選択します。
- テストを実行を選択します。
キャンバスを編集する権限がない場合でもプレビューを実行できますが、未保存の変更がある場合、このプレビューはその変更を含めた状態で実行されます。
サポートされているステップ
次のステップがサポートされています。
- メッセージ
- オーディエンスパス
- 条件分岐
- 遅延
- アクションパス
- エクスペリメントパス
- エージェント
- ユーザー更新 (UI エディターのみ。JSON エディターを使用するステップはスキップされます)
このセクションに記載されていないステップタイプがテストに含まれる場合、サポートされていないステップはスキップされ、テストユーザーは次のサポートされているステップに進みます。
エージェントステップ
テスト実行がエージェントステップに到達すると、Braze は一時停止してエージェント「{agentName}」を実行しますか? と確認します。続行方法を選択してください。
- はい: 必要に応じて、テキストフィールドにコンテキストを追加します (テストユーザーのプロファイルと、ジャーニー内にすでに存在するキャンバスコンテキストに加えて)。その後、レスポンスをシミュレートを選択してエージェントを呼び出します。カートの内容や受信メッセージのテキストなど、サンプル値を平易な言葉で入力して、本番環境でエージェントが受け取るランタイムコンテキストを再現できます。
- いいえ: Braze はエージェントを呼び出しません。このステップでは、エージェントコンソールの出力セクションで設定されたエージェントのフォールバック出力が使用されます。
はいとレスポンスをシミュレートを選択すると、エージェントがプレビューユーザーに対して実行され、その出力がエージェントステップの出力変数に保存され、テストはジャーニーの先へと進みます。レスポンスをシミュレートによる呼び出しは、エージェントの1日あたりの呼び出し上限にカウントされ、エージェントのログタブに表示されます。
エージェントステップを単独でテストする (キャンバスのパス全体を実行しない) には、キャンバスビルダーのステップ内プレビューを使用します。設定の詳細については、エージェントステップのエージェントをテストするを参照してください。
エージェントステップが上流のコンテキストステップのデータに依存している場合は、キャンバスをテストを実行して、パスに沿ってコンテキスト変数が設定されるようにしてください。シードグループでは、シード受信者に対してコンテキストステップやコンテキスト変数は評価されません。
キャンバスステップの詳細
エントリー基準の詳細を表示するには、詳細を表示を選択します。セグメンテーションを含むステップでは、満たされた基準と満たされなかった基準が表示されます。メッセージでは、配信の検証とチャネルの適格性についても同様に表示されます。メッセージステップでは、どのチャネルが送信され、どのチャネルが送信されなかったかが表示されます。
Liquid
Braze は、実際のテストメッセージを送信しない場合でも、テスト実行中に Liquid ロジックを処理します。つまり、メッセージ中止ロジックやその他の Liquid ロジックが反映され、キャンバスのユーザージャーニーに影響する可能性があります。
プレビューで中止されずにユーザージャーニーの最後のステップが送信される場合、Liquid の評価時にテスト対象の時刻として、キャンバスのエントリー時刻に基づいてユーザーが実際にそのステップに到達する時刻ではなく、現在時刻が使用されている可能性があります。
タイミングのプレビュー
スケジュールされたキャンバスでは、テストユーザーは次にスケジュールされたエントリ時刻にエントリします。開始日が設定されたアクションベースのキャンバスでは、テストユーザーは開始日時にエントリします。
デフォルトの開始時刻は引き続き適用されますが、エントリ時刻はどの場合でも設定できるため、過去または未来の日付をシミュレートできます。ただし、キャンバスの開始日より前、または終了日より後をテストすることはできません。
メッセージステップと遅延ステップには、遅延を再設定しなくても、ユーザーが次に進む時刻やメッセージを受信する時刻が表示されます。なお、ステップにはインテリジェントタイミングが使用されているかどうかが示されますが、このユーザーパスのプレビューではテストユーザーの推定時刻は計算されません。
「カスタム属性値の変更」のようなアクショントリガーを持つキャンバスでは、Braze はキャンバスのテスト実行時に限り、トリガー内のユーザー属性を一時的に空白に設定して変更をシミュレートしようとします (これはユーザープロファイルには影響しません)。これは、属性が現在の値から変更されることをテストするためのものです。
ユーザーのエントリーと終了のタイミング
テストユーザーは、実際には対象外であってもプレビューにエントリーします。対象外の場合は、条件を満たさなかった理由を確認できます。テストユーザーがプレビューにエントリーすると、そのテストユーザーはターゲットオーディエンスの条件を満たし、アクションのトリガー条件を実行したものとみなされます。たとえば、エントリー条件でカスタムイベントを使用するキャンバスの場合、テストユーザーはエントリー条件で想定されるとおりにカスタムイベントを実行したものとみなされます。ただし、同じカスタムイベントをキャンバス内の別の場所 (終了条件など) でも使用している場合は、それがユーザーパスにどのような影響を与えるかを検討してください。
テストユーザーがキャンバスにエントリーできるようにするために実行されたものとみなされるイベント、API トリガー、カスタム属性、キャンバスエントリープロパティは、実際のユーザープロファイルでは更新されず、テスト実行後も保持されません。たとえば、テスト中にカスタム属性がキャンバスのトリガーとして使用されている場合、トリガー条件はユーザーのプレビューに対して、そのユーザーがカスタム属性の変更をトリガーしたかのように適用されます。
考慮事項
終了条件 (イベントプロパティを含む) に対応するアクションを含むアクションパスステップをテストすると、終了条件がトリガーされ、テスト実行が終了します。終了条件に対応するメッセージステップをテストした場合も、終了条件がトリガーされ、テスト実行が終了します。
現時点では、終了条件をトリガーするためにアクションパスステップ内の特定のイベントやプロパティを選択することはできません (選択できるのはパス全体のみです)。ユーザーが複数の終了条件を満たす可能性がある場合は、最初に処理され、かつユーザーが満たした条件が結果として表示されます。
実験パスとキャンバスのバリアント
- トップレベルのバリアントがあるキャンバスの場合は、テストの開始時にバリアントを選択します。
- 実験パスの場合は、テストユーザーがステップに到達したときにユーザーが進むバリアントを選択します。
- 勝者パスを使用する実験パスの場合、テストユーザーがメッセージステップで待機する遅延期間はプレビューに含まれません。Braze は、ユーザーが選択されたパスをすぐに進んだものと見なします。
テスト送信
テスト実行の進行中に、内部テストグループまたは個別のユーザーにテストメッセージを送信できます。この場合、テストパス上でユーザーが到達したメッセージのみが送信されます。受信者にはデフォルトで受信者自身の属性を使用したメッセージが届きますが、これをテストユーザーの属性で上書きすることもできます。
パスに関係なく、パスをプレビューせずにキャンバス内のすべてのテストメッセージを一度に送信するには、テスト送信タブですべてのテストメッセージを送信を選択します。
応答性
ユーザーパスをプレビューする際、キャンバスのステップはタイミングに応じて動作します。ユーザー更新ステップで行った更新は、フロー内の後続のステップに反映されますが、実際のユーザープロファイルには適用されません。ユーザーがバリアントに入った場合の影響は、プレビュー内の後続のステップに反映されます。
同様に、フィルターは、テストユーザーがキャンバス内の他のステップを操作した結果として発生したアクションを認識します。たとえば、このプレビューモードでは、ユーザーがキャンバス内の前の段階で「送信された」メッセージステップに遭遇したことを認識します。また、テストユーザーがアクションパスステップを進むために「アクションを実行した」ことも認識します。
応答動作の詳細については、終了条件を参照してください。
Connected Content
Connected Contentはキャンバスに含まれている場合に実行されます。つまり、Connected Contentの呼び出しやConnected Contentを含むContent Blocksを持つキャンバスをテストすると、キャンバスがConnected Contentの呼び出しを送信し、他のキャンペーンやキャンバスで参照されているデータが変更される可能性があります。

Connected Contentの再試行ロジックは、ライブ送信 (テスト送信を含む) にのみ適用され、ユーザーパスのプレビューには適用されません。ユーザーパスのプレビュー中に:retryを指定したConnected Contentの呼び出しが失敗した場合、Brazeはその呼び出しを再試行しません。詳細については、Connected Contentの再試行を参照してください。
ユーザーパスをプレビューする際は、ユーザープロファイルや他のキャンバスやキャンペーンで参照されているデータを変更するConnected Contentを削除することを検討してください。
Webhook
Webhookは、テストメッセージの送信時には実行されますが、テスト実行中には実行されません。Connected Contentと同様に、ユーザープロファイルや、ほかのキャンバスまたはキャンペーンで参照されるデータを変更するWebhookは、削除することを検討してください。
コンテキスト変数とシードグループ
メッセージングチャネルとしてメールを使用するメッセージステップでは、ユーザーがキャンバス内のこのステップに到達すると、シードグループがメールのシードコピーを送信します。これらのシードコピーは、シードグループの受信者自身のキャンバスジャーニーの一部として送信されるわけではありません。そのため、Braze はそれらの受信者に対してコンテキストステップを実行せず、コンテキスト変数も評価しません。メールコンテンツでコンテキスト変数を参照している場合、シードグループの受信者には、そのデータが入力されていないシードコピーが届きます。コンテキスト変数のデータに依存するメッセージをテストするには、シードグループではなく、キャンバスをテストプレビューでテスト送信を使用してください。
ユーザーに送信されたメッセージを表示する
ユーザーパスのプレビューはジャーニーをシミュレートするものであり、ユーザープロファイルで実際の送信を確認する代わりにはなりません。Braze が特定のユーザーに送信したメッセージを確認するには、オーディエンス > ユーザー検索からそのユーザーのプロファイルを開き、メッセージ履歴タブとエンゲージメントタブを使用します。
検索フィールド、各タブの詳細、およびメッセージ履歴の30日間の期間については、ユーザープロファイルを参照してください。
ユースケース
このシナリオでは、アプリでセッションのないユーザーをターゲットにするようにキャンバスが設定されています。このジャーニーには、ウェルカムメールを含むメッセージステップ、1日に設定された遅延ステップ、そして2つのパスに分岐するオーディエンスパスステップが含まれています。2つのパスは、セッションが1回以上あるユーザーと、それ以外のすべてのユーザーです。ユーザーがどちらのオーディエンスパスに該当するかに応じて、後続のメッセージステップが送信されます。
テストユーザーはキャンバスのエントリー基準を満たしているため、キャンバスに入り、ユーザージャーニーを進むことができます。ただし、テストユーザーは直近の1暦日にアプリを開いていないため、「Everyone else」パスに進み、次の内容のプッシュ通知を受信します。「Last chance! Complete your first task for an exclusive bonus.」
