ジャーニーのテスト testing_the_journey

このページ: シミュレートされたユーザーを使用したシミュレーションや、テストプロファイルを使用したテストモードを使用して、ジャーニーを公開前に検証し、エラーを早期に検出する方法を説明します。

テストモードが適切な方法かどうか確認する必要がありますか? 3つの検証オプションをすべて比較

ジャーニーを作成したら、公開する前にテストできます。 Adobe Journey Optimizerは、テストプロファイルをジャーニーに沿って移動する際に、アクティブ化する前に潜在的なエラーを検出する方法として、「テストモード」を提供しています。 クイックテストを実行すると、ジャーニーが正しく動作することを確認できるので、自信を持って公開できます。

テストモードでは、テストプロファイルのみがジャーニーにエントリできます。 新しいテストプロファイルを作成するか、既存のプロファイルをテストプロファイルに変換することができます。 テストプロファイルの詳細については、この節を参照してください。

Adobeのジャーニーオプティマイザーには、ジャーニーをテストおよび検証する2つの方法があります。

  • シミュレーション: ジャーニーを​ シミュレーション ​に設定し、シミュレートされたユーザー(Adobe Experience Platformで事前に作成されたプロファイルを使用せずに、その場で作成または生成できる一時的なプロファイル)を使用します。

  • テストモード:永続的なプロファイルが、Adobe Experience Platformでテストプロファイルとして明示的にフラグ付けされています。 複数のテストセッションで再利用できます。 この方法は、一貫した事前定義されたプロファイルデータを使用してテストする場合に推奨されます。 テストプロファイルの作成方法の詳細情報

NOTE
ジャーニーをテストする前に、エラーが発生した場合はすべて解決する必要があります。 テストする前にエラーを確認する方法について詳しくは、この節を参照してください。 テストモードでテストプロファイルの進行に失敗した場合は、テストモードの移行のトラブルシューティングを参照してください。

重要な注意事項 important_notes

ジャーニーでテストを実行する前に、これらのメモを確認してください。

一般的な制限事項

  • テストプロファイルのみ - リアルタイム顧客プロファイルサービスで「テストプロファイル」としてフラグ付けされた個人のみがテストモードでジャーニーにエントリできます。 テストプロファイルの作成方法の詳細情報
  • 名前空間要件 - テストモードは、名前空間を使用するドラフトジャーニーでのみ使用できます。 テストモードでは、ジャーニーにエントリするユーザーがテストプロファイルであるかどうかを確認する必要があるため、Adobe Experience Platformに到達できる必要があります。
  • プロファイル制限 - 1 回のテストセッション中に最大 100 個のテストプロファイルがジャーニーにエントリできます。
  • イベントトリガー - イベントは、インターフェイスからのみ実行できます。 API を使用して外部システムからイベントを実行できません。
  • カスタムアップロードオーディエンス - ジャーニーテストモードでは、カスタムアップロードオーディエンス属性のエンリッチメントをサポートしていません。

テスト中およびテスト後の行動

  • テストモードの無効化 - テストモードを無効にすると、現在ジャーニー内にある、または以前にエントリしたすべてのプロファイルが削除され、レポートがクリアされます。
  • 再アクティブ化の柔軟性 - テストモードは、必要であれば何回でも有効または無効にできます。
  • 自動非アクティブ化1週間以上 テスト モードで非アクティブのままのジャーニーは、自動的にテスト モードを終了し、ドラフト ステータスに戻ります。 ジャーニーコンテンツは失われません。テストモードセッションのみが終了します。
  • 編集と公開 - テストモードがアクティブな間は、ジャーニーを変更できません。 ただし、ジャーニーを直接公開できるので、事前にテストモードを非アクティブ化する必要必要はありません。
  • メッセージ配信 - テストモードでは、メッセージは実稼動環境と同じ配信パイプラインを使用して、テストプロファイルの実際の受信トレイに送信されます。 これは、メッセージを配信したり、実際のチャネルアクションをトリガーしたりせずにジャーニーを実行するジャーニードライラン ​とは異なります。 どちらのメソッドも、ライブ送信のすべての側面を複製しません。完全なエンドツーエンド検証にはステージング環境を使用します。

実行

  • 分割動作 - ジャーニーが分割に達すると、常にテストモードで最上位ブランチが選択されます。 これは、ライブ実行中に統計的に選択されたパスを反映しません。 別のパスをテストする場合は、分岐を並べ替えます。
  • イベントタイミング - ジャーニーに複数のイベントが含まれる場合は、各イベントを順番にトリガーします。 イベントの送信が早すぎる(最初の待機ノードが終了する前)または遅すぎる(設定されたタイムアウト後)場合、イベントは破棄されます。 その後、プロファイルはタイムアウトパスに送信されます。 イベントペイロードフィールドへの参照は、定義されたウィンドウ内でペイロードを送信することで、常に有効なままであることを確認してください。
  • アクティブな日付ウィンドウ - ジャーニーが設定した開始日と終了日/時間 ウィンドウに、テストモードの開始時の現在の時間が含まれていることを確認します。 それ以外の場合、トリガーされたテストイベントは、ログメッセージ DISPATCHER DISCARD #16 — unqualified on journey version enablementsとともにサイレントに破棄されます。 テスト中にこれを回避するには、ジャーニーの開始日を現在の瞬間より前の時間に一時的に設定してから、公開前に復元します。 この問題のトラブルシューティングについて詳しくは、このページを参照してください。
  • 反応イベント - タイムアウトのある反応イベントの場合、最小待機時間およびデフォルト待機時間は 40 秒です。
  • テストデータセット - テストモードでトリガーされたイベントは、JOtestmode - <schema of your event> のようにラベル付けされた専用のデータセットに保存されます。
  • 共有インフラストラクチャ - テストモードは、実稼動環境と同じインフラストラクチャで実行されます。 トラフィックが多い期間には、メールの送信やイベント処理に遅延が生じることがあります。 この場合は、プラットフォームのトラフィックダッシュボードを確認するか、ピーク以外の時間にテストを再試行します。

テストモードのアクティブ化

Adobe Experience Platformで既に作成した既存のテストプロファイルを使用してジャーニーをテストする場合は、テストモード メソッドを使用します。

  1. テストモードを有効にするには、シミュレート ボタンをクリックし、テストモード​を選択します。

    ジャーニーインターフェイスの「テストモード」ボタン

  2. ジャーニーに少なくとも 1 つの​ 待機 ​アクティビティがある場合、待機時間​パラメーターを使用して、各待機アクティビティとイベントのタイムアウトがテストモードで持続する時間を定義します。 待機とイベントタイムアウトのデフォルト時間は 10 秒です。 これにより、テスト結果を迅速に取得できます。

    テストモードでの待機時間パラメーターの設定

    note
    NOTE
    タイムアウトのある反応イベントをジャーニーで使用する場合、待機時間のデフォルト値は最小値の 40 秒になります。 この節を参照してください。
  3. イベントをトリガー」ボタンを使用してイベントを設定し、ジャーニーに送信します。

    テストモードの「イベントをトリガー」ボタン

  4. 必要に応じて、様々なフィールドを設定します。 プロファイル ID フィールドに、テストプロファイルの識別に使用するフィールドの値を入力します。 これには、メールアドレスなどを使用できます。 テストプロファイルに関連するイベントを送信します。 この節を参照してください。

    プロファイル識別子の入力を含むイベント設定フィールド

  5. イベントを受け取ったら、「ログを表示」ボタンをクリックし、テスト結果を表示して確認します。 この節を参照してください。

    テスト結果を表示する「ログを表示」ボタン

  6. エラーがある場合は、テストモードを無効にし、ジャーニーを修正してから再度テストします。 テストが完了したら、ジャーニーを公開できます。 詳しくは、このページを参照してください。

動作する例:単純なジャーニーの検証 test-walkthrough

次の例では、単一イベントから始まるジャーニーをテストし、電子メールを送信し、10分待ってからプッシュ通知を送信する方法を説明します。

ジャーニーをエンドツーエンドで検証するには:

  1. 右上隅の​ テストモード ​をクリックして、テストモードを有効にします。 キャンバスがテストモードに切り替わり、「トリガーイベント」ボタンが表示されます。

  2. 待機時間​を​ 10秒 ​に設定して、テスト中に待機ノードが迅速に完了するようにします。

  3. イベントをトリガー」をクリックし、イベントを選択して、テストプロファイル ID (例:Adobe Experience Platformでテストプロファイルとしてフラグ付けされたプロファイルのメールアドレス)を入力します。

  4. 送信」をクリックします。 プロファイルが各ステップを進むにつれて、視覚的なフローがキャンバスに表示され、緑色に変わります。

  5. ログを表示」をクリックし、JSON出力で次のことを確認します。

    • currentstepは、プロファイルが期待するアクティビティと一致します。
    • プロファイルが待機ノードにある間はphaserunningを表示し、終了に達するとfinishedを表示します。
    • actionExecutionErrors個のエントリがありません。
  6. 10秒後、ログを更新します。 プロファイルが待機ノードを越えて進み、プッシュアクションをトリガーしている必要があります。

  7. すべての手順でfinishedが表示され、エラーが記録されていない場合は、テストモードを無効にしてジャーニーを公開します。

TIP
プロファイルがログにまったく表示されない場合は、次の点を確認してください。
  • 入力したプロファイル IDは、Adobe Experience Platformでテスト プロファイルとしてフラグ付けされています。
  • ジャーニーで設定された開始日と終了日には、現在の時刻が含まれます。 このウィンドウ外でトリガーされたイベントはサイレントに破棄されます。 学習を増やす

テストモードのトラブルシューティング troubleshoot-test-mode

この表は、サポートチケットを開く前に、一般的なテストモードのエラーを自己診断するために使用します。

症状
考えられる原因
解決策
イベントは正常に送信されますが、プロファイルはジャーニーログに表示されません
プロファイル識別子の名前空間が一致しません。名前空間値がイベントスキーマで定義された名前空間と一致しません
識別子の形式を確認してください:@{<EventName>.identityMap.entry('<NamespaceName>').first().id}<NamespaceName>は、イベントスキーマと正確に一致する必要があります(大文字と小文字を区別します)。 前提条件を確認してください。
イベントは受け入れられましたが(応答は200件)、ジャーニーはトリガーしません。ログにDISPATCHER DISCARD #16 — unqualified on journey version enablementsが表示されます
ジャーニー開始日は将来の日付に設定されます。テストイベントは、アクティブな日付ウィンドウの外でサイレントに破棄されます
ジャーニーの開始日を現在の時刻より前に一時的に設定します。 公開前に復元します。 ​ ジャーニーの日付を参照してください。
オーディエンスジャーニーを読み取ると、バッチセグメントの評価ログが表示されますが、プロファイルエントリはありません
バッチセグメントの評価は、個々のプロファイルのエントリとは別にログに記録されます。バッチログでは、プロファイルがジャーニーにエントリしたことが確認されません
バッチ処理ウィンドウが完了するのを待ちます。 リアルタイムのログフィードバックについては、単一イベントジャーニーでテストします。
テストモードを有効にできません。エラーERR_MODEL_RULES_16
このイベントには、ジャーニーでチャネルアクションを使用する場合に必要となるID名前空間が含まれていません
イベント設定にID名前空間を追加します。

イベントのトリガー firing_events

イベントをトリガー」ボタンを使用して、ユーザーがジャーニーにエントリできるようにするイベントを設定します。

前提条件 trigger-events-prerequisites

前提条件として、Adobe Experience Platformでどのプロファイルがテストプロファイルとしてフラグ付けされているかを知る必要があります。 実際、テストモードでは、これらのプロファイルのみがジャーニーで許可されます。

イベントには ID を含める必要があります。 必要な ID は、イベント設定に応じて異なります。 この ID には、ECID やメールアドレスなどを使用できます。 このキーの値は、プロファイル識別子​フィールドに追加する必要があります。

プロファイル識別子​の値は、イベントスキーマに格納されているIDと正確に一致する必要があります。 イベントペイロードでIDを参照するために使用される形式は次のとおりです。

@{<EventName>.identityMap.entry('<NamespaceName>').first().id}

<NamespaceName>を、イベントスキーマで定義されたとおりの名前空間に置き換えます(例:EmailまたはPhone)。 名前空間の不一致により、サイレント ドロップ​が発生します。イベントは受け入れられ、成功応答を返しますが、プロファイルはジャーニーに入らず、エラーはUIに表示されません。 イベントをトリガーした後にテストログにプロファイルが表示されない場合は、プロファイル識別子​の名前空間がイベントスキーマ名前空間と正確に一致していることを確認してください。

ジャーニーでエラー ERR_MODEL_RULES_16 が発生してテストモードを有効にできない場合は、チャネルアクションを使用する際に、使用するイベントに ID 名前空間が含まれていることを確認してください。

ID 名前空間は、テストプロファイルを一意に識別するために使用されます。 例えば、メールを使用してテストプロファイルを識別する場合は、ID 名前空間の​ メール ​を選択する必要があります。 一意の識別子が電話番号の場合は、ID 名前空間の​ 電話 ​を選択する必要があります。

NOTE
  • テストモードでイベントをトリガーすると、実際のイベントが生成されます。つまり、このイベントをリッスンしている他のジャーニーにもヒットします。

  • テストモードの各イベントが正しい順序で、設定された待機ウィンドウ内でトリガーされることを確認します。 例えば、60 秒の待機時間がある場合、2 番目のイベントは、その 60 秒の待機時間が経過し、タイムアウト制限が期限切れになる前にのみトリガーする必要があります。

イベント設定 trigger-events-configuration

ジャーニーに複数のイベントが含まれる場合は、ドロップダウンリストを使用してイベントを選択します。 次に、各イベントに対して、渡されるフィールドと送信するイベントの実行を設定します。 このインターフェイスは、イベントペイロードで適切な情報を渡すのに役立ち、情報タイプが正しいことを保証します。 テストモードは、後で使用するために、テストセッションで最後に使用したパラメーターを保存します。

イベント選択のフィールドとドロップダウンを含むイベント設定インターフェイス

このインターフェイスを使用すると、単純なイベントパラメーターを渡すことができます。 イベント内のコレクションや他の高度なオブジェクトを渡す場合は、「コードビュー」を選択して、ペイロードのコード全体を表示し、変更することができます。 例えば、技術ユーザーが作成したイベント情報をコピーして貼り付けることができます。

高度な設定の JSON 形式でのイベントペイロードのコードビュー

技術ユーザーは、このインターフェイスを使用してイベントペイロードを作成して、サードパーティのツールを使用せずにイベントをトリガーすることもできます。

送信」ボタンをクリックすると、テストが開始されます。 ジャーニー内の個人の進行状況は、視覚的なフローで表現されます。 個人がジャーニー間を移動すると、パスは徐々に緑に変わります。 エラーが発生した場合は、対応する手順に警告シンボルが表示されます。 その警告記号上にカーソルを置くと、エラーに関する詳細情報が表示され、(利用可能な場合は)詳細情報にアクセスできます。

プロファイル進行状況とエラーを示すジャーニーテストの視覚的なフロー

イベント設定画面で別のテストプロファイルを選択し、再びテストを実行すると、視覚的なフローが消去され、新しい個人のパスが表示されます。

テストでジャーニーを開くと、最後に実行されたテストに対応するパスが表示されします。

ルールベースのジャーニーのテストモード test-rule-based

テストモードは、ルールベースのイベントを使用するジャーニーでも使用できます。 ルールベースのイベントについて詳しくは、このページを参照してください。

イベントをトリガーする際、イベント設定​画面で、テストに合格するイベントパラメーターを定義できます。 イベント ID 条件を表示するには、右上隅のツールチップアイコンをクリックします。 各フィールド(ルール評価の一部)の横にあるツールヒントも利用できます。

ルール評価ツールチップを含むイベント設定画面

ビジネスイベントのテストモード test-business

ビジネスイベントを使用する場合、テストモードを使用して、ジャーニーに 1 つのテストプロファイルエントリをトリガーし、イベントをシミュレートして、適切なプロファイル ID を渡します。 テストでは、イベントパラメーターと、ジャーニーにエントリするテストプロファイルの識別子を渡す必要があります。 テストモードには、ビジネスイベントに基づくジャーニーに使用できる「コードビュー」モードはありません。

初めてビジネスイベントをトリガーするときに、同じテストセッションでビジネスイベントの定義を変更することはできません。 同じ識別子または別の識別子を渡して、同じ個人または別の人をジャーニーにエントリさせる必要があります。 ビジネスイベントパラメーターを変更する場合は、テストモードを停止して再開する必要があります。

ログを表示 viewing_logs

ログを表示」ボタンを使用すると、テスト結果を表示できます。 このページには、ジャーニーの現在の情報が JSON 形式で表示されます。 ボタンを使用すると、ノード全体をコピーできます。 ジャーニーのテスト結果を更新するには、ページを手動で更新する必要があります。

JSON 形式でのジャーニー実行結果を表示するテストログ

NOTE
テストログで、サードパーティシステム(データソースまたはアクション)の呼び出し時にエラーが発生した場合は、エラーコードとエラー応答が表示されます。

現在ジャーニー内にある個人(技術的に「インスタンス」と呼ばれます)の数が表示されます。 個々のユーザーに対して、次の情報が表示されます。

  • ID:ジャーニー内の個人の内部 ID。 デバッグ目的で使用できます。
  • currentstep:個人がジャーニーにいるステップ。 アクティビティを識別しやすくするために、アクティビティにラベルを追加することをお勧めします。
  • currentstep > フェーズ:個人のジャーニーのステータス(実行中、完了、エラーまたはタイムアウト)。 詳しくは、以下を参照してください。
  • currentstep > extraInfo:エラーの説明と、その他のコンテキスト情報。
  • currentstep > fetchErrors:この手順中に発生したデータ取得エラーに関する情報。
  • externalKeys:イベントで定義されているキー式の値。
  • enrichedData:ジャーニーがデータソースを使用している場合にジャーニーが取得したデータ。
  • transitionHistory:個人が踏んだ手順のリスト。 イベントの場合、ペイロードが表示されます。
  • actionExecutionErrors:発生したエラーに関する情報。
NOTE
テストログには、単一プロファイルエントリイベント​のエントリのみが表示されます。 オーディエンスの読み取りジャーニーをテストする場合、バッチセグメント評価ログは個々のプロファイルエントリログとは別になります。 バッチセグメントを評価しても、個々のプロファイルがジャーニーのステップを通過したことは確認されません。 オーディエンスの読み取りジャーニーをトリガーした後にプロファイルエントリが表示されない場合は、結論を描画する前に、バッチ処理ウィンドウが完了するのを待ちます。

個人のジャーニーには様々なステータスがあります。

  • 実行中:個人は現在ジャーニーの途中にいます。
  • 完了:個人はジャーニーの最後にいます。
  • エラー:エラーが発生したため、個人のジャーニーは停止しました。
  • タイムアウト:時間がかかり過ぎたので、個人のジャーニーは停止しました。

テストモードでイベントをトリガーすると、ソースの名前が付いたデータセットが自動的に生成されます。

テストモードは、エクスペリエンスイベントを自動的に作成し、Adobe Experience Platformに送信します。 このエクスペリエンスイベントのソース名は、「Journey Orchestration テストイベント」です。

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to use Test mode in Adobe Journey Optimizer to validate a journey with persistent test profiles before publishing, including activating test mode, triggering events, reading logs, and handling business and rule-based events.

Intents:

  • Activate Test mode on a draft journey to validate it with pre-existing AEP test profiles
  • Configure and trigger events for test profiles using the Trigger an event interface
  • Override Wait activity durations in test mode to accelerate journey progression
  • Read and interpret the Show log JSON output to verify profile progression and identify errors
  • Test rule-based journeys and business event journeys in test mode
  • Understand the limitations and behavioral differences of Test mode compared to Simulation

Glossary:

  • Test mode: A journey validation state that allows persistent AEP test profiles to traverse a draft journey before it is published (product-specific)
  • Test profiles: Profiles explicitly flagged as test profiles in the Adobe Experience Platform Real-time Customer Profile Service; the only profile type permitted to enter a journey in test mode (product-specific)
  • Visual flow: The canvas representation that turns green to show the path a test profile has followed through the journey
  • Show log: A test mode feature that displays journey execution state in JSON format for each test profile instance (product-specific)
  • Journey Orchestration Test Events: The source name under which test mode experience events are stored in Adobe Experience Platform

Guardrails:

  • Only profiles flagged as test profiles in AEP can enter a journey in test mode
  • Test mode requires the journey to use a namespace to verify test profile identity
  • Maximum 100 test profiles per single test session
  • Events can only be triggered from the test mode UI; external API triggering is not supported
  • Custom upload audience attribute enrichment is not supported in test mode
  • Events triggered in Test mode generate real experience events that can also trigger other journeys listening to the same event
  • In Test mode, Wait activities and most event timeouts default to 10 seconds; Reaction event timeouts default to a minimum of 40 seconds
  • Automatic deactivation — Journeys that remain inactive in test mode for over a week automatically exit test mode and return to Draft status. No journey content is lost; only the test mode session ends.
  • Journey edits are blocked while test mode is active, but direct publishing is allowed
  • At a split, the top branch is always selected; reorder branches to test different paths
  • Reaction event timeout minimum and default wait time is 40 seconds
  • Events sent outside the journey’s configured start/end date window are silently discarded
  • Disabling test mode removes all profiles from the journey and clears reporting

Terminology:

  • Canonical name: Test mode — Acronym: none — variants: test mode, journey test mode
  • Canonical name: Test profiles — Acronym: none — variants: test users (Simulation UI label only)
  • Synonyms: “Show log” = test results log; “visual flow” = canvas path visualization
  • Do not confuse: “Test mode” ≠ “Simulation” — Test mode uses persistent AEP test profiles; Simulation uses temporary simulated users generated on the fly

FAQ:

  • Q: Who can enter a journey in test mode? — Only profiles explicitly flagged as test profiles in the Adobe Experience Platform Real-time Customer Profile Service.
  • Q: How many test profiles can run in a single test session? — A maximum of 100 test profiles per test session.
  • Q: What happens when I disable test mode? — All profiles currently in or previously entered in the journey are removed and reporting is cleared.
  • Q: Can I edit a journey while test mode is active? — No. The journey cannot be modified while test mode is active, but you can publish it directly without deactivating test mode first.
  • Q: Why are my test events being silently discarded? — Events triggered outside the journey’s configured active date/time window are silently discarded. Verify the journey start and end dates include the current time.
  • Q: What does the phase field in the test log indicate? — It shows the profile’s current status: running (active in journey), finished (reached end), error (stopped due to error), or timed out (stopped due to timeout).
recommendation-more-help
journey-optimizer-help