ジャーニーのテスト

遍歴をテストする前に、すべてのエラーが発生した場合は、それを解決する必要があります。 この節を参照してください。

テストプロファイルを使用して、パブリケーションの前にジャーニーをテストできます。 これにより、個人が旅の途中でどのように流れるかを分析し、公開前のトラブルシューティングを行うことができます。

テストモードを使用するには、次の手順に従います。

  1. 遍歴をテストする前に、その遍歴が有効であり、エラーがないことを確認します。 エラーのある遍歴のテストを開始することはできません。 この節を参照してください。エラーがある場合は、警告記号が表示されます。

  2. テストモードをアクティブにするには、右上隅にある​テスト​トグルをクリックします。

  3. 左下隅の​Wait time in test​パラメーターを使用して、各待機アクティビティがtestモードで持続する時間を定義します。 デフォルト時間は 10 秒です。これにより、テスト結果を迅速に取得できます。 このパラメーターは、1つ以上の待機アクティビティーを遍歴にドロップした場合にのみ表示されます。

  4. 「イベントをトリガー」をクリックして、イベントを設定し、遍歴に送信します。 テストプロファイルに関連するイベントを送信してください。 イベントの実行を参照してください。

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

  6. エラーが発生した場合は、テストモードを非アクティブ化し、ジャーニーを変更して再度テストします。テストが決定的な場合は、遍歴を公開できます。 このページを参照してください。

重要な注意事項

  • テスト対象の遍歴に対してイベントを実行するためのインターフェイスが提供されますが、イベントはPostmanなどのサードパーティ製システムからも送信できます。
  • リアルタイム顧客プロファイルサービスで「テストプロファイル」としてフラグ付けされた個人のみがテスト済みの遍歴に参加できます。 この節を参照してください。
  • テストモードは、名前空間を使用するドラフトジャーニーでのみ使用できます。 テストモードでは、遍歴に入る人がテストプロファイルであるかどうかを確認する必要があります。そのため、Adobe Experience Platformに到達できる必要があります。
  • テストプロファイルの最大数は、1回のテストセッション中にジャーニーに参加できる最大数は100です。
  • テストモードを無効にすると、過去にテストモードに入った人や現在参加している人がすべてジャーニーを空にします。 また、レポートもクリアします。
  • テストモードは必要な回数だけ有効または無効にできます。
  • テストモードがアクティブになっている場合は、遍歴を変更できません。 テストモードでは、ジャーニーを直接公開できるので、以前にテストモードを非アクティブ化する必要はありません。

テストプロファイルの作成

テストプロファイルの作成プロセスは、Adobe Experience Platformでプロファイルを作成する場合と同じです。 API呼び出しを通じて実行されます。 このページを参照

「プロファイルテストの詳細」ミックスインが含まれるプロファイルスキーマを使用する必要があります。 testProfileフラグは、このmixinの一部です。

プロファイルを作成する場合は、次の値を渡す必要があります。testprofile = true。

既存のプロファイルを更新して、testProfileフラグを「true」に変更することもできます。

テストプロファイルを作成するためのAPI呼び出しの例を以下に示します。

curl -X POST \
'https://dcs.adobedc.net/collection/xxxxxxxxxxxxxx' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json' \
-H 'Postman-Token: xxxxx' \
-H 'cache-control: no-cache' \
-H 'x-api-key: xxxxx' \
-H 'x-gw-ims-org-id: xxxxx' \
-d '{
"header": {
"msgType": "xdmEntityCreate",
"msgId": "xxxxx",
"msgVersion": "xxxxx",
"xactionid":"xxxxx",
"datasetId": "xxxxx",
"imsOrgId": "xxxxx",
"source": {
"name": "Postman"
},
"schemaRef": {
"id": "https://example.adobe.com/mobile/schemas/xxxxx",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "xxxxx",
"_mobile":{
"ECID": "xxxxx"
},
"testProfile":true
}
}
}'

イベントを起動

「イベントをトリガー」ボタンを使用すると、人が旅に出るイベントを設定できます。

メモ

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

前提条件として、Adobe Experience Platformでテストプロファイルとしてフラグ付けされたプロファイルを把握する必要があります。 実際、テストモードでは、これらのプロファイルを遍歴でのみ使用でき、イベントにIDを含める必要があります。 必要なIDは、イベントの設定に応じて異なります。 例えば、ECIDを指定できます。

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

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

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

「Send」ボタンをクリックすると、テストが開始されます。 個人の進行は視覚的な流れで表されます 個々の人が旅を進むにつれて、道は次第に緑色に変わります。 エラーが発生した場合は、対応する手順に警告記号が表示されます。 カーソルをカーソルの上に置くと、エラーに関する詳細情報を表示し、（利用可能な場合は）詳細な情報にアクセスできます。

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

テストで遍歴を開くとき、表示されるパスは最後に実行されたテストに対応します。

視覚的なフローは、イベントがインターフェイスを介してトリガーされるか、外部（例えばPostmanを使用する）によってトリガーされるかに関係なく機能します。

ルールベースのジャーニーのテストモード

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

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

テストモードの使用方法の詳細については、このページを参照してください。

ログの表示

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

メモ

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

現在、遍歴に含まれる個人（技術的にはインスタンスと呼ばれます）の数が表示されます。 次に、各ユーザーに対して表示される役立つ情報を示します。

  • ID:個人の内部IDを取得します。これは、デバッグ目的で使用できます。
  • currentstep:個人が旅の中で歩いている段階ですアクティビティを識別しやすくするために、ラベルをに追加することをお勧めします。
  • currentstep >フェーズ：個人の遍歴のステータス（実行、完了、エラーまたはタイムアウト）。詳しくは、以下を参照してください。
  • currentstep > extraInfo:エラーの説明と、その他のコンテキスト情報。
  • currentstep > fetchErrors:この手順中に発生したデータ取得エラーに関する情報です。
  • externalKeys:イベントで定義されているキー数式の値。
  • enrichedData:ジャーニーがデータソースを使用している場合に取得したデータ。
  • transitionHistory:個人が従った手順のリスト。イベントの場合、ペイロードが表示されます。
  • actionExecutionErrors :発生したエラーに関する情報。

個人の遍歴の様々なステータスを次に示します。

  • 実行中:個人は現在旅行中です。
  • 完了:個人は旅の終わりだ。
  • エラー:人は誤りのために旅の途中で止まる。
  • タイムアウト:時間がかかりすぎたため、個人は旅の途中で止まる。

テストモードを使用してイベントがトリガーされると、ソースの名前を持つデータセットが自動的に生成されます。

テストモードを使用してイベントがトリガーされると、ソースの名前を持つデータセットが自動的に生成されます。

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

複数のジャーニーから複数のイベントが引き起こされた場合

複数のジャーニーから複数のイベントが送信され、異なるスキーマが発生する場合があります。 スキーマを1データセットにマップできますか。 そうでない場合は、複数のデータセットが必要になります。

宛先データセットがエクスペリエンスイベントに含まれていない場合は、これらのデータセットの自動作成と命名が実行されます。 そのため、現在、「Automatically created dataset for voyager」というメッセージが表示されています。

ソースの名前を付けることで、自動的な作成が行われます。 複数のイベントがある場合は、連結して「Journey Orchestrationテストイベント-スキーマ名」にする必要があります。 これは、自動的に「Journey Orchestrationテストイベント用に自動的に生成されるデータセット —スキーマ名」に変わります。

このページ