ジャーニーのテスト testing_the_journey
ジャーニーを作成したら、公開する前にテストできます。 Adobe Journey Optimizerは、テストプロファイルをジャーニーに沿って移動する際に、アクティブ化する前に潜在的なエラーを検出する方法として、「テストモード」を提供しています。 クイックテストを実行すると、ジャーニーが正しく動作することを確認できるので、自信を持って公開できます。
テストモードでは、テストプロファイルのみがジャーニーにエントリできます。 新しいテストプロファイルを作成するか、既存のプロファイルをテストプロファイルに変換することができます。 テストプロファイルの詳細については、この節を参照してください。
Adobeのジャーニーオプティマイザーには、ジャーニーをテストおよび検証する2つの方法があります。
-
シミュレーション: ジャーニーを シミュレーション に設定し、シミュレートされたユーザー（Adobe Experience Platformで事前に作成されたプロファイルを使用せずに、その場で作成または生成できる一時的なプロファイル）を使用します。
-
テストモード：永続的なプロファイルが、Adobe Experience Platformでテストプロファイルとして明示的にフラグ付けされています。 複数のテストセッションで再利用できます。 この方法は、一貫した事前定義されたプロファイルデータを使用してテストする場合に推奨されます。 テストプロファイルの作成方法の詳細情報。
重要な注意事項 important_notes
ジャーニーでテストを実行する前に、これらのメモを確認してください。
一般的な制限事項
- テストプロファイルのみ - リアルタイム顧客プロファイルサービスで「テストプロファイル」としてフラグ付けされた個人のみがテストモードでジャーニーにエントリできます。 テストプロファイルの作成方法の詳細情報。
- 名前空間要件 - テストモードは、名前空間を使用するドラフトジャーニーでのみ使用できます。 テストモードでは、ジャーニーにエントリするユーザーがテストプロファイルであるかどうかを確認する必要があるため、Adobe Experience Platformに到達できる必要があります。
- プロファイル制限 - 1 回のテストセッション中に最大 100 個のテストプロファイルがジャーニーにエントリできます。
- イベントトリガー - イベントは、インターフェイスからのみ実行できます。 API を使用して外部システムからイベントを実行できません。
- カスタムアップロードオーディエンス - ジャーニーテストモードでは、カスタムアップロードオーディエンス属性のエンリッチメントをサポートしていません。
テスト中およびテスト後の行動
- テストモードの無効化 - テストモードを無効にすると、現在ジャーニー内にある、または以前にエントリしたすべてのプロファイルが削除され、レポートがクリアされます。
- 再アクティブ化の柔軟性 - テストモードは、必要であれば何回でも有効または無効にできます。
- 自動非アクティブ化 - テストモードで 1 週間以上非アクティブのままになっているジャーニーは、自動的にドラフトステータスに戻り、パフォーマンスを最適化し、古いリソースの使用を防ぎます。
- 編集と公開 - テストモードがアクティブな間は、ジャーニーを変更できません。 ただし、ジャーニーを直接公開できるので、事前にテストモードを非アクティブ化する必要必要はありません。
実行
- 分割動作 - ジャーニーが分割に到達すると、常に上位の分岐が選択されます。 別のパスをテストする場合は、分岐を並べ替えます。
- イベントタイミング - ジャーニーに複数のイベントが含まれる場合は、各イベントを順番にトリガーします。 イベントの送信が早すぎる（最初の待機ノードが終了する前）または遅すぎる（設定されたタイムアウト後）場合、イベントは破棄されます。 その後、プロファイルはタイムアウトパスに送信されます。 イベントペイロードフィールドへの参照は、定義されたウィンドウ内でペイロードを送信することで、常に有効なままであることを確認してください。
- アクティブな日付ウィンドウ - ジャーニーが設定した開始日と終了日/時間 ウィンドウに、テストモードの開始時の現在の時間が含まれていることを確認します。 それ以外の場合、トリガーしたテストイベントは通知なしで破棄されます。 この問題のトラブルシューティングについて詳しくは、このページを参照してください。
- 反応イベント - タイムアウトのある反応イベントの場合、最小待機時間およびデフォルト待機時間は 40 秒です。
- テストデータセット - テストモードでトリガーされたイベントは、
JOtestmode - <schema of your event>のようにラベル付けされた専用のデータセットに保存されます。 - 共有インフラストラクチャ - テストモードは、実稼動環境と同じインフラストラクチャで実行されます。 トラフィックが多い期間には、メールの送信やイベント処理に遅延が生じることがあります。 この場合は、プラットフォームのトラフィックダッシュボードを確認するか、ピーク以外の時間にテストを再試行します。
テストモードのアクティブ化
Adobe Experience Platformで既に作成した既存のテストプロファイルを使用してジャーニーをテストする場合は、テストモード メソッドを使用します。
-
テストモードを有効にするには、シミュレート ボタンをクリックし、テストモードを選択します。
-
ジャーニーに少なくとも 1 つの 待機 アクティビティがある場合、待機時間パラメーターを使用して、各待機アクティビティとイベントのタイムアウトがテストモードで持続する時間を定義します。 待機とイベントタイムアウトのデフォルト時間は 10 秒です。 これにより、テスト結果を迅速に取得できます。
note NOTE タイムアウトのある反応イベントをジャーニーで使用する場合、待機時間のデフォルト値は最小値の 40 秒になります。 この節を参照してください。 -
「イベントをトリガー」ボタンを使用してイベントを設定し、ジャーニーに送信します。
-
必要に応じて、様々なフィールドを設定します。 プロファイル ID フィールドに、テストプロファイルの識別に使用するフィールドの値を入力します。 これには、メールアドレスなどを使用できます。 テストプロファイルに関連するイベントを送信します。 この節を参照してください。
-
イベントを受け取ったら、「ログを表示」ボタンをクリックし、テスト結果を表示して確認します。 この節を参照してください。
-
エラーがある場合は、テストモードを無効にし、ジャーニーを修正してから再度テストします。 テストが完了したら、ジャーニーを公開できます。 詳しくは、このページを参照してください。
動作する例：単純なジャーニーの検証 test-walkthrough
次の例では、単一イベントから始まるジャーニーをテストし、電子メールを送信し、10分待ってからプッシュ通知を送信する方法を説明します。
ジャーニーをエンドツーエンドで検証するには：
-
右上隅の テストモード をクリックして、テストモードを有効にします。 キャンバスがテストモードに切り替わり、「トリガーイベント」ボタンが表示されます。
-
待機時間を 10秒 に設定して、テスト中に待機ノードが迅速に完了するようにします。
-
「イベントをトリガー」をクリックし、イベントを選択して、テストプロファイル ID （例：Adobe Experience Platformでテストプロファイルとしてフラグ付けされたプロファイルのメールアドレス）を入力します。
-
「送信」をクリックします。 プロファイルが各ステップを進むにつれて、視覚的なフローがキャンバスに表示され、緑色に変わります。
-
「ログを表示」をクリックし、JSON出力で次のことを確認します。
currentstepは、プロファイルが期待するアクティビティと一致します。- プロファイルが待機ノードにある間は
phaseがrunningを表示し、終了に達するとfinishedを表示します。 actionExecutionErrors個のエントリがありません。
-
10秒後、ログを更新します。 プロファイルが待機ノードを越えて進み、プッシュアクションをトリガーしている必要があります。
-
すべての手順で
finishedが表示され、エラーが記録されていない場合は、テストモードを無効にしてジャーニーを公開します。
- 入力したプロファイル IDは、Adobe Experience Platformでテスト プロファイルとしてフラグ付けされています。
- ジャーニーで設定された開始日と終了日には、現在の時刻が含まれます。 このウィンドウ外でトリガーされたイベントはサイレントに破棄されます。 詳細情報。
イベントのトリガー firing_events
「イベントをトリガー」ボタンを使用して、ユーザーがジャーニーにエントリできるようにするイベントを設定します。
前提条件 trigger-events-prerequisites
前提条件として、Adobe Experience Platformでどのプロファイルがテストプロファイルとしてフラグ付けされているかを知る必要があります。 実際、テストモードでは、これらのプロファイルのみがジャーニーで許可されます。
イベントには ID を含める必要があります。 必要な ID は、イベント設定に応じて異なります。 この ID には、ECID やメールアドレスなどを使用できます。 このキーの値は、プロファイル識別子フィールドに追加する必要があります。
ジャーニーでエラー ERR_MODEL_RULES_16 が発生してテストモードを有効にできない場合は、チャネルアクションを使用する際に、使用するイベントに ID 名前空間が含まれていることを確認してください。
ID 名前空間は、テストプロファイルを一意に識別するために使用されます。 例えば、メールを使用してテストプロファイルを識別する場合は、ID 名前空間の メール を選択する必要があります。 一意の識別子が電話番号の場合は、ID 名前空間の 電話 を選択する必要があります。
-
テストモードでイベントをトリガーすると、実際のイベントが生成されます。つまり、このイベントをリッスンしている他のジャーニーにもヒットします。
-
テストモードの各イベントが正しい順序で、設定された待機ウィンドウ内でトリガーされることを確認します。 例えば、60 秒の待機時間がある場合、2 番目のイベントは、その 60 秒の待機時間が経過し、タイムアウト制限が期限切れになる前にのみトリガーする必要があります。
イベント設定 trigger-events-configuration
ジャーニーに複数のイベントが含まれる場合は、ドロップダウンリストを使用してイベントを選択します。 次に、各イベントに対して、渡されるフィールドと送信するイベントの実行を設定します。 このインターフェイスは、イベントペイロードで適切な情報を渡すのに役立ち、情報タイプが正しいことを保証します。 テストモードは、後で使用するために、テストセッションで最後に使用したパラメーターを保存します。
このインターフェイスを使用すると、単純なイベントパラメーターを渡すことができます。 イベント内のコレクションや他の高度なオブジェクトを渡す場合は、「コードビュー」を選択して、ペイロードのコード全体を表示し、変更することができます。 例えば、技術ユーザーが作成したイベント情報をコピーして貼り付けることができます。
技術ユーザーは、このインターフェイスを使用してイベントペイロードを作成して、サードパーティのツールを使用せずにイベントをトリガーすることもできます。
「送信」ボタンをクリックすると、テストが開始されます。 ジャーニー内の個人の進行状況は、視覚的なフローで表現されます。 個人がジャーニー間を移動すると、パスは徐々に緑に変わります。 エラーが発生した場合は、対応する手順に警告シンボルが表示されます。 その警告記号上にカーソルを置くと、エラーに関する詳細情報が表示され、（利用可能な場合は）詳細情報にアクセスできます。
イベント設定画面で別のテストプロファイルを選択し、再びテストを実行すると、視覚的なフローが消去され、新しい個人のパスが表示されます。
テストでジャーニーを開くと、最後に実行されたテストに対応するパスが表示されします。
ルールベースのジャーニーのテストモード 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 テストイベント」です。