ジャーニーのテスト testing_the_journey
ジャーニーを作成したら、公開する前にテストできます。 Journey Optimizerでは、ジャーニーに沿って進む際にテストプロファイルを確認し、アクティブ化の前に潜在的なエラーを検出する方法として、「テストモード」を提供しています。 クイックテストを実行すると、ジャーニーが正しく動作することを確認できるので、自信を持って公開できます。
テストモードでは、テストプロファイルのみがジャーニーにエントリできます。新しいテストプロファイルを作成するか、既存のプロファイルをテストプロファイルに変換することができます。テストプロファイルの詳細については、この節を参照してください。
テストモードを使用するには、次の手順に従います。
-
テストモードをアクティブにするには、右上隅にある「テストモード」ボタンをクリックします。
-
ジャーニーに少なくとも 1 つの 待機 アクティビティがある場合、待機時間 パラメーターを使用して、各待機アクティビティとイベントのタイムアウトがテストモードで持続する時間を定義します。待機とイベントタイムアウトのデフォルト時間は 10 秒です。これにより、テスト結果を迅速に取得できます。
note note NOTE タイムアウトのある反応イベントをジャーニーで使用する場合、待機時間のデフォルト値は最小値の 40 秒になります。この節を参照してください。 -
「イベントをトリガー」ボタンを使用してイベントを設定し、ジャーニーに送信します。
-
必要に応じて、様々なフィールドを設定します。プロファイル ID フィールドに、テストプロファイルの識別に使用するフィールドの値を入力します。これには、メールアドレスなどを使用できます。テストプロファイルに関連するイベントを送信します。この節を参照してください。
-
イベントを受け取ったら、「ログを表示」ボタンをクリックし、テスト結果を表示して確認します。この節を参照してください。
-
エラーがある場合は、テストモードを無効にし、ジャーニーを修正してから再度テストします。テストが完了したら、ジャーニーを公開できます。このページを参照してください。
重要な注意事項 important_notes
- テストモードでは、インターフェイスを使用してのみイベントを実行できます。API を使用して外部システムからイベントを実行することはできません。
- リアルタイム顧客プロファイルサービスで「テストプロファイル」としてフラグ付けされた個人のみがテストジャーニーにエントリできます。この節を参照してください。
- テストモードは、名前空間を使用するドラフトジャーニーでのみ使用できます。テストモードでは、ジャーニーにエントリする人がテストプロファイルであることを確認する必要があるため、Adobe Experience Platform にアクセスできる必要があります。
- ジャーニーにエントリできるテストプロファイルの数は、1 回のテストセッション中に最大 100 です。
- テストモードを無効にすると、過去にジャーニーにエントリしたすべての人々と、現在エントリしているすべての人々がジャーニーから削除されます。また、レポートも消去します。
- テストモードは、必要であれば何回でも有効または無効にできます。
- テストモードがアクティブになっているときは、ジャーニーを変更できません。テストモードではジャーニーを直接公開できるので、事前にテストモードを無効にしておく必要はありません。
- 分割に達すると、常に一番上の分岐を選択します。テストで別のパスを選択する場合は、分割された分岐の位置を再編成できます。
- パフォーマンスを最適化し、古くなったリソースの使用を防ぐために、1 週間トリガーされていないテストモードのジャーニーはすべて、ドラフト ステータスに戻ります。
- テストモードでトリガーされるイベントは、専用のデータセットに保存されます。これらのデータセットには、次のラベルが付けられます:
JOtestmode - <schema of your event>
- 複数のイベントを含むジャーニーをテストする場合は、各イベントを順番にトリガーする必要があります。イベントの送信が早すぎる(最初の待機ノードが終了する前)または遅すぎる(設定されたタイムアウトの後)場合、イベントは破棄され、プロファイルがタイムアウトパスに送信されます。定義したウィンドウ内にペイロードを送信して、イベントペイロードフィールドへの参照が有効なままであることを常に確認します。
イベントのトリガー firing_events
「イベントをトリガー」ボタンを使用して、ユーザーがジャーニーにエントリできるようにするイベントを設定します。
-
テストモードでイベントをトリガーすると、実際のイベントが生成されます。つまり、このイベントをリッスンしている他のジャーニーもヒットします。
-
テストモードの各イベントが正しい順序で、設定された待機ウィンドウ内でトリガーされることを確認します。例えば、60 秒の待機時間がある場合、2 番目のイベントは、その 60 秒の待機時間が経過し、タイムアウト制限が期限切れになる前にのみトリガーする必要があります。
前提条件として、Adobe Experience Platform でテストプロファイルというフラグの付いたプロファイルを把握しておく必要があります。実際、テストモードでは、ジャーニーでこれらのプロファイルのみが許可され、イベントには ID を含める必要があります。必要な ID は、イベント設定に応じて異なります。この ID には、ECID やメールアドレスなどを使用できます。このキーの値は、プロファイル識別子 フィールドに追加する必要があります。
ジャーニーに複数のイベントが含まれる場合は、ドロップダウンリストを使用してイベントを選択します。次に、各イベントに対して、渡されるフィールドと送信するイベントの実行を設定します。インターフェイスは、イベントペイロードに正しい情報を渡し、情報タイプが正しいことを確認するのに役立ちます。テストモードでは、後で使用するために、テストセッションで最後に使用したパラメーターが保存されます。
このインターフェイスを使用すると、単純なイベントパラメーターを渡すことができます。イベント内のコレクションや他の高度なオブジェクトを渡す場合は、「コードビュー」をクリックして、ペイロードのコード全体を表示し、変更することができます。例えば、技術ユーザーが作成したイベント情報をコピーして貼り付けることができます。
技術ユーザーは、このインターフェイスを使用してイベントペイロードを作成して、サードパーティのツールを使用せずにイベントをトリガーすることもできます。
「送信」ボタンをクリックすると、テストが開始されます。ジャーニー内の個人の進行状況は、視覚的なフローで表現されます。個人がジャーニー間を移動すると、パスは徐々に緑に変わります。エラーが発生した場合は、対応する手順に警告記号が表示されます。その警告記号上にカーソルを置くと、エラーに関する詳細情報が表示され、(利用可能な場合は)詳細情報にアクセスできます。
イベント設定画面で別のテストプロファイルを選択し、再びテストを実行すると、視覚的なフローが消去され、新しい個人のパスが表示されます。
テストでジャーニーを開くと、最後に実行されたテストに対応するパスが表示されします。
ルールベースのジャーニーのテストモード test-rule-based
テストモードは、ルールベースのイベントを使用するジャーニーでも使用できます。ルールベースのイベントについて詳しくは、このページを参照してください。
イベントをトリガーする際、イベント設定 画面で、テストに合格するイベントパラメーターを定義できます。イベント ID 条件を表示するには、右上隅のツールチップアイコンをクリックします。各フィールド(ルール評価の一部)の横にあるツールヒントも利用できます。
ビジネスイベントのテストモード test-business
ビジネスイベントを使用する場合、テストモードを使用して、ジャーニーに 1 つのテストプロファイルエントリをトリガーし、イベントをシミュレートして、適切なプロファイル ID を渡します。テストでは、イベントパラメーターと、ジャーニーにエントリするテストプロファイルの識別子を渡す必要があります。テストモードには、ビジネスイベントに基づくジャーニーに使用できる「コードビュー」モードはありません。
初めてビジネスイベントをトリガーするときに、同じテストセッションでビジネスイベントの定義を変更することはできません。同じ識別子または別の識別子を渡して、同じ人物または別の人物をジャーニーにエントリさせる必要があります。ビジネスイベントパラメーターを変更する場合は、テストモードを停止して再開する必要があります。
ログを表示 viewing_logs
「ログを表示」ボタンを使用すると、テスト結果を表示できます。このページには、ジャーニーの現在の情報が JSON 形式で表示されます。ボタンを使用すると、ノード全体をコピーできます。ジャーニーのテスト結果を更新するには、ページを手動で更新する必要があります。
現在、ジャーニー内にいる個人の数(技術的にはインスタンスと呼ばれます)が表示されます。各個人に表示される便利な情報を次に示します。
- ID:ジャーニー内の個人の内部 ID。デバッグ目的で使用できます。
- currentstep:個人がジャーニーにいるステップ。アクティビティを識別しやすくするために、アクティビティにラベルを追加することをお勧めします。
- currentstep > フェーズ:個人のジャーニーのステータス(実行中、完了、エラーまたはタイムアウト)。詳しくは、以下を参照してください。
- currentstep > extraInfo:エラーの説明と、その他のコンテキスト情報。
- currentstep > fetchErrors:この手順中に発生したデータ取得エラーに関する情報。
- externalKeys:イベントで定義されているキー式の値。
- enrichedData:ジャーニーがデータソースを使用している場合にジャーニーが取得したデータ。
- transitionHistory:個人が踏んだ手順のリスト。イベントの場合、ペイロードが表示されます。
- actionExecutionErrors:発生したエラーに関する情報。
個人のジャーニーには様々なステータスがあります。
- 実行中:個人は現在ジャーニーの途中にいます。
- 完了:個人はジャーニーの最後にいます。
- エラー:エラーが発生したため、個人のジャーニーは停止しました。
- タイムアウト:時間がかかり過ぎたので、個人のジャーニーは停止しました。
テストモードでイベントをトリガーすると、ソースの名前が付いたデータセットが自動的に生成されます。
テストモードでは、エクスペリエンスイベントが自動的に作成され、Adobe Experience Platform に送信されます。このエクスペリエンスイベントのソース名は、「Journey Orchestration テストイベント」です。