サンプルプロファイルを使用したファイルベースの宛先のテスト
概要 overview
このページでは、/testing/destinationInstance
API エンドポイントを使用して、ファイルベースの宛先が正しく設定されているかどうかをテストしたり、設定された宛先に対するデータフローの整合性を検証したりする方法を説明します。
呼び出しにサンプルプロファイルを追加してもしなくても、エンドポイントをテストするためのリクエストを行うことができます。リクエスト時に任意のプロファイルを送信しない場合、API は、サンプルプロファイルを自動的に生成して、リクエストに追加します。
自動生成されたサンプルプロファイルには、汎用データが含まれます。カスタムの、より直感的なプロファイルデータで宛先をテストしたい場合、サンプルプロファイル生成 API を使用して、サンプルプロファイルを生成してから、その応答をカスタマイズして、/testing/destinationInstance
エンドポイントに対するリクエストに含めます。
はじめに getting-started
続行する前に、「はじめる前に」を参照し、API の呼び出しを正常に行うために必要となる重要な情報(必要な宛先オーサリング権限および必要なヘッダーの取得方法など)を確認してください。
前提条件 prerequisites
/testing/destinationInstance
エンドポイントを使用する前に、以下の条件を満たしていることを確認してください。
-
Destination SDK で作成した既存のファイルベースの宛先があり、宛先カタログで確認できる。
-
Experience Platform UI で、宛先に対して少なくとも 1 つのアクティベーションフローを作成している。
-
API リクエストを成功させるには、テストする宛先インスタンスに対応する宛先インスタンス ID が必要です。Platform UI で宛先との接続を参照する際に、URL から、API 呼び出しで使用する必要がある宛先インスタンス ID を取得します。
-
オプション:API 呼び出しに追加したサンプルプロファイルで宛先設定をテストしたい場合は、/sample-profiles エンドポイントを使用して、既存のソーススキーマに基づいてサンプルプロファイルを生成します。サンプルプロファイルを提供しない場合、API がサンプルプロファイルを生成して、応答で返します。
呼び出しにプロファイルを追加しないで宛先設定をテスト test-without-adding-profiles
API 形式
POST /authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}
リクエスト
curl -X POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
{DESTINATION_INSTANCE_ID}
応答
応答が成功すると、HTTP ステータス 200 が、応答ペイロードと共に返されます。
{
"activations":[
{
"segment":"6fa55d3a-18e1-4f65-95ed-ac8fdb03b45b",
"flowRun":"81150d76-7909-46b6-83f4-fc855a92de07"
},
{
"segment":"5fa55d3a-18e1-4f65-95ed-ac8fdb03b45b",
"flowRun":"4706780a-2ab3-4d33-8c76-7c87fd318cd8"
}
],
"results":"/authoring/testing/destinationInstance/fd3449fb-b929-45c8-9f3d-06b9d6aac328/results?flowRunIds=4706780a-2ab3-4d33-8c76-7c87fd318cd8,81150d76-7909-46b6-83f4-fc855a92de07",
"inputProfiles":[
{
"segmentMembership":{
"ups":{
"fea8d394-5a8c-4cea-bebc-df020ce37f5c":{
"lastQualificationTime":"2022-01-13T11:33:28.211895Z",
"status":"realized"
},
"5fa55d3a-18e1-4f65-95ed-ac8fdb03b45b":{
"lastQualificationTime":"2022-01-13T11:33:28.211893Z",
"status":"realized"
}
}
},
"personalEmail":{
"address":"john.smith@abc.com"
},
"identityMap":{
"crmid":[
{
"id":"crmid-P1A7l"
}
]
},
"person":{
"name":{
"firstName":"string",
"lastName":"string"
}
}
}
]
}
activations
例:2 つのオーディエンスを宛先インスタンスにマッピングした場合、
activations
配列には、2 つのエントリが含まれます。アクティブ化された各オーディエンスは、1 つの書き出されたファイルに対応します。results
inputProfiles
呼び出しにプロファイルを追加して宛先設定をテスト test-with-added-profiles
カスタムの、より直感的なプロファイルデータで宛先をテストするには、/sample-profiles エンドポイントから取得した応答を自分で選択した値でカスタマイズして、/testing/destinationInstance
エンドポイントに対するリクエストにカスタムプロファイルを含めることができます。
API 形式
POST /testing/destinationInstance/{DESTINATION_INSTANCE_ID}
リクエスト
curl -X POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}'
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"profiles":[
{
"segmentMembership":{
"ups":{
"fea8d394-5a8c-4cea-bebc-df020ce37f5c":{
"lastQualificationTime":"2022-01-13T11:33:28.211895Z",
"status":"realized"
},
"5fa55d3a-18e1-4f65-95ed-ac8fdb03b45b":{
"lastQualificationTime":"2022-01-13T11:33:28.211893Z",
"status":"realized"
}
}
},
"personalEmail":{
"address":"michaelsmith@example.com"
},
"identityMap":{
"crmid":[
{
"id":"Custom CRM ID"
}
]
},
"person":{
"name":{
"firstName":"Michael",
"lastName":"Smith"
}
}
}
]
}'
{DESTINATION_INSTANCE_ID}
profiles
応答
応答が成功すると、HTTP ステータス 200 が、応答ペイロードと共に返されます。
{
"activations":[
{
"segment":"6fa55d3a-18e1-4f65-95ed-ac8fdb03b45b",
"flowRun":"81150d76-7909-46b6-83f4-fc855a92de07"
},
{
"segment":"5fa55d3a-18e1-4f65-95ed-ac8fdb03b45b",
"flowRun":"4706780a-2ab3-4d33-8c76-7c87fd318cd8"
}
],
"results":"/authoring/testing/destinationInstance/fd3449fb-b929-45c8-9f3d-06b9d6aac328/results?flowRunIds=4706780a-2ab3-4d33-8c76-7c87fd318cd8,81150d76-7909-46b6-83f4-fc855a92de07",
"inputProfiles":[
{
"segmentMembership":{
"ups":{
"fea8d394-5a8c-4cea-bebc-df020ce37f5c":{
"lastQualificationTime":"2022-01-13T11:33:28.211895Z",
"status":"realized"
},
"5fa55d3a-18e1-4f65-95ed-ac8fdb03b45b":{
"lastQualificationTime":"2022-01-13T11:33:28.211893Z",
"status":"realized"
}
}
},
"personalEmail":{
"address":"michaelsmith@example.com"
},
"identityMap":{
"crmid":[
{
"id":"Custom CRM ID"
}
]
},
"person":{
"name":{
"firstName":"Michael",
"lastName":"Smith"
}
}
}
]
}
activations
例:2 つのオーディエンスを宛先インスタンスにマッピングした場合、
activations
配列には、2 つのエントリが含まれます。アクティブ化された各オーディエンスは、1 つの書き出されたファイルに対応します。results
inputProfiles
API エラー処理 api-error-handling
Destination SDK API エンドポイントは、一般的な Experience Platform API エラーメッセージの原則に従います。Platform トラブルシューティングガイドの API ステータスコードおよびリクエストヘッダーエラーを参照してください。
次の手順
このドキュメントでは、ファイルベースの宛先設定をテストする方法を確認しました。
有効な API 応答を受信している場合、宛先は正しく機能しています。アクティベーションフローに関するさらに詳細な情報を確認したい場合は、応答から results
プロパティを使用して、詳細なアクティベーション結果を表示できます。
公開されている宛先を作成している場合、これで、レビュー用にアドビに宛先設定を送信できるようになりました。