ジャーニーのテスト

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

テストプロファイルを使用して、ジャーニーが公開される前にテストを行うことができます。 これにより、公開前に、個人がジャーニー内をどのように移動しているかを分析し、トラブルシューティングをおこなうことができます。

テストモードでジャーニーを入力できるのはテストプロファイルだけです。 新しいテストプロファイルを作成するか、既存のプロファイルをテストプロファイルに変換することができます。 こちらを参照してください。

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

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

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

   

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

   

   メモ

   ジャーニーでリアクションイベントを使用する場合、待機時間のデフォルト値は40秒です。 この節を参照してください。

4. トリガーとイベント​をクリックして、イベントを設定し、ジャーニーに送信します。

   

5. 必要に応じて、様々なフィールドを設定します。 「プロファイルID」フィールドに、テストプロファイルの識別に使用するフィールドの値を入力します。 例えば、電子メールアドレスを指定できます。 テストプロファイルに関連するイベントを送信してください。 イベントの実行を参照してください。

   

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

   

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

重要な注意事項

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

プロファイルをテストプロファイルに変換

既存のプロファイルをテストプロファイルに変換できます。 Adobe Experience Platformでは、API呼び出しを使用してプロファイル属性を更新できますが、インターフェイスを使用して行うことはできません。

これを行う最も簡単な方法は、プロファイル​の更新アクティビティを使用し、テストプロファイルのブール値フィールドをfalseからtrueに変更することです。 この節を参照してください。

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

新しいテストプロファイルを作成する場合は、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テストイベント用に自動的に生成されるデータセット —スキーマ名」に変わります。