ドキュメント Journey Orchestration Journey Orchestration

ジャーニーのテスト testing_the_journey

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

中級
ユーザー

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

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

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

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

ジャーニーをテストする前に、ジャーニーが有効であり、エラーがないことを確認します。ジャーニーにエラーがある場合は、テストを開始できません。この節を参照してください。エラーがある場合は、警告記号が表示されます。
テストモードをアクティブにするには、右上隅にある「テスト」トグルをクリックします。

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

note note
NOTE
タイムアウトのある反応イベントをジャーニーで使用する場合、待機時間のデフォルト値は最小値の 40 秒になります。この節を参照してください。

「イベントをトリガー」をクリックしてイベントを設定し、ジャーニーに送信します。
必要に応じて、様々なフィールドを設定します。プロファイル ID フィールドに、テストプロファイルの識別に使用するフィールドの値を入力します。これには、メールアドレスなどを使用できます。テストプロファイルに関連するイベントを送信します。イベントの実行を参照してください。
イベントを受け取ったら、「ログの表示」ボタンをクリックし、テスト結果を表示して確認します。ログの表示を参照してください。
エラーがある場合は、テストモードを無効にし、ジャーニーを修正してから再度テストします。テストが終了すれば、ジャーニーを公開できます。このページを参照してください。

重要な注意事項 important_notes

イベントを実行できるインターフェイスがテストしたジャーニーに提供されますが、イベントは Postman などのサードパーティシステムからも送信できます。
リアルタイム顧客プロファイルサービスで「テストプロファイル」としてフラグ付けされた個人のみがテストジャーニーにエントリできます。この節を参照してください。
テストモードは、名前空間を使用するドラフトジャーニーでのみ使用できます。テストモードでは、ジャーニーにエントリするユーザーがテストプロファイルであることを確認する必要があるため、Adobe Experience Platformにアクセスできる必要があります。
ジャーニーにエントリできるテストプロファイルの数は、1 回のテストセッション中に最大 100 です。
テストモードを無効にすると、過去にジャーニーにエントリしたすべての人々と、現在エントリしているすべての人々がジャーニーから削除されます。また、レポートも消去します。
テストモードは、必要であれば何回でも有効または無効にできます。
テストモードがアクティブになっているときは、ジャーニーを変更できません。テストモードではジャーニーを直接公開できるので、事前にテストモードを無効にしておく必要はありません。
分割に達すると、常に一番上の分岐を選択します。テストで別のパスを選択する場合は、分割された分岐の位置を再編成できます。
パフォーマンスを最適化し、古くなったリソースの使用を防ぐために、1 週間トリガーされていないテストモードのジャーニーはすべて、ドラフトステータスに戻ります。

プロファイルからテストプロファイルへの変換 turning-profile-into-test

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

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

テストプロファイルの作成 create-test-profile

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

「プロファイルテストの詳細」 Mixin を含むプロファイルスキーマを使用する必要があります。 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
}
}
}'

イベントの実行 firing_events

「イベントをトリガー」ボタンを使用すると、イベントを設定して、人がジャーニーにエントリできるようにできます。

NOTE

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

前提条件として、Adobe Experience Platformでテストプロファイルというフラグの付いたプロファイルを把握しておく必要があります。実際、テストモードでは、ジャーニーでこれらのプロファイルのみが許可され、イベントには ID を含める必要があります。必要な ID は、イベント設定に応じて異なります。この ID には、ECID やメールアドレスなどを使用できます。このキーの値は、プロファイル識別子 フィールドに追加する必要があります。

NOTE

定義済みリストのフィールドにドロップダウンが表示されます。使用可能な値の 1 つを選択するだけです。

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

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

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

「送信」ボタンをクリックすると、テストが開始されます。ジャーニー内の個人の進行状況は、視覚的なフローで表現されます。個人がジャーニー間を移動すると、パスは徐々に緑に変わります。エラーが発生した場合は、対応する手順に警告記号が表示されます。その警告記号上にカーソルを置くと、エラーに関する詳細情報が表示され、（利用可能な場合は）詳細情報にアクセスできます。