このページ: シミュレートされたユーザーを使用したシミュレーションや、テストプロファイルを使用したテストモードを使用して、ジャーニーを公開前に検証し、エラーを早期に検出する方法を説明します。
ジャーニーを作成したら、公開する前にテストできます。 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 テストイベント」です。
このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。
理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。
- TL;DR:このページでは、Adobe Journey Optimizerでテストモードを使用して、公開前に永続的なテストプロファイルを使用してジャーニーを検証する方法(テストモードのアクティブ化、イベントのトリガー、ログの読み取り、ビジネスイベントおよびルールベースのイベントの処理など)について説明します。
インテント:
- ドラフトジャーニーでテストモードを有効にして、既存のAEP テストプロファイルで検証します
- トリガーとイベントインターフェイスを使用して、テストプロファイルのイベントを設定およびトリガーします
- テストモードで待機アクティビティ期間を上書きして、ジャーニーの進行を加速します
- Show log JSON出力を読み取って解釈し、プロファイルの進行状況を確認し、エラーを特定します
- ルールベースのジャーニーとビジネスイベントジャーニーをテストモードでテストします
- シミュレーションと比較したテストモードの制限事項と行動上の違いを理解する
用語集:
- テストモード:永続的なAEP テストプロファイルがドラフトジャーニーを公開前にトラバースできるようにするジャーニー検証状態(製品固有)
- テストプロファイル:Adobe Experience Platform Real-time Customer Profile Serviceでテストプロファイルとして明示的にフラグ付けされたプロファイル。テストモード (製品固有)でジャーニーに参加できる唯一のプロファイルタイプ
- 視覚的なフロー: テストプロファイルがジャーニーを通過したパスを示すために緑色に変わるキャンバス表現
- ログを表示: テストプロファイルインスタンス (製品固有)ごとに、ジャーニーの実行状態をJSON形式で表示するテストモード機能
- Journey Orchestration Test Events: テストモードエクスペリエンスイベントがAdobe Experience Platformに保存されるソース名
ガードレール:
- AEPでテストプロファイルとしてフラグ付けされたプロファイルのみが、テストモードでジャーニーに参加できます
- テストモードでは、テストプロファイル IDを検証するために名前空間を使用するジャーニーが必要です
- 1回のテストセッションあたり最大100個のテストプロファイル
- イベントはテストモード UIからのみトリガーできます。外部API トリガーはサポートされていません
- カスタムアップロードオーディエンス属性のエンリッチメントは、テストモードではサポートされていません
- テストモードでトリガーされたイベントは、同じイベントをリッスンしている他のジャーニーもトリガーできる実際のエクスペリエンスイベントを生成します
- テストモードでは、待機アクティビティとほとんどのイベントタイムアウトはデフォルトで10秒に設定されます。リアクションイベントタイムアウトはデフォルトで40秒以上になります
- 自動アクティベート解除:テストモードで1週間以上非アクティブのままのジャーニーは、テストモードを自動的に終了し、ドラフトステータスに戻ります。 ジャーニーコンテンツは失われません。テストモードセッションのみが終了します。
- テストモードがアクティブの間、ジャーニーの編集はブロックされますが、直接公開は許可されます
- 分割では、常に最上位のブランチが選択されます。異なるパスをテストするためにブランチを並べ替えます
- リアクションイベントのタイムアウトの最小値とデフォルトの待機時間は40秒です
- ジャーニーの設定済みの開始日/終了日ウィンドウ以外で送信されたイベントは、サイレントに破棄されます
- テストモードを無効にすると、ジャーニーからすべてのプロファイルが削除され、レポートがクリアされます
用語:
- 正規名:テストモード – 頭字語:なし – バリアント:テストモード、ジャーニーテストモード
- 正規名:テストプロファイル —Acronym: none — バリアント:テストユーザー(シミュレーション UI ラベルのみ)
- 同義語:「ログを表示」 = テスト結果のログ、「視覚的なフロー」 = キャンバスパスの視覚化
- 混同しないでください:「テストモード」≠「シミュレーション」 – テストモードでは、永続的なAEP テストプロファイルが使用されます。シミュレーションでは、その場で生成された一時的なシミュレーションユーザーが使用されます
FAQ:
- Q: テストモードでジャーニーを入力できるのは誰ですか? — Adobe Experience Platform Real-time Customer Profile Serviceでテストプロファイルとして明示的にフラグ付けされたプロファイルのみ。
- Q: 1回のテストセッションで実行できるテストプロファイルの数は? — テストセッションごとに最大100個のテストプロファイル。
- Q: テストモードを無効にするとどうなりますか? — ジャーニーで現在または以前に入力されたすべてのプロファイルが削除され、レポートがクリアされます。
- Q: テストモードがアクティブな間、ジャーニーを編集できますか? – いいえ。 テストモードがアクティブになっている間はジャーニーを変更できませんが、最初にテストモードを非アクティブにせずに直接公開できます。
- Q: テストイベントがサイレントに破棄されるのはなぜですか? — ジャーニーの設定済みのアクティブな日時ウィンドウ外でトリガーされたイベントは、サイレントに破棄されます。 ジャーニーの開始日と終了日に現在の時間が含まれていることを確認します。
- Q: テスト ログのフェーズ フィールドの内容を教えてください。 - プロファイルの現在のステータスを表示します:実行中(ジャーニーでアクティブ)、完了(終了)、エラー(エラーにより停止)、またはタイムアウト(タイムアウトにより停止)。