스트리밍 대상 테스트 API 개요
Adobe은 Destination SDK의 일부로 대상을 구성하고 테스트하는 데 도움이 되는 개발자 도구를 제공합니다. 이 페이지에서는 대상 구성을 테스트하는 방법을 설명합니다. 메시지 변환 템플릿을 만드는 방법에 대한 자세한 내용은 메시지 변환 템플릿 만들기 및 테스트를 참조하십시오.
대상이 올바르게 구성되었는지 테스트하고 구성된 대상에 대한 데이터 흐름의 무결성을 확인하려면대상 테스트 도구 를 사용하십시오. 이 도구를 사용하면 REST API 끝점에 메시지를 전송하여 대상 구성을 테스트할 수 있습니다.
다음은 Destination SDK에서 대상을 대상 구성 워크플로에 맞게 테스트하는 방법을 보여 줍니다.
대상 테스트 도구 - 목적 및 사전 요구 사항 destination-testing-tool
대상 테스트 도구를 사용하여 서버 구성에서 제공한 파트너 끝점에 메시지를 보내 대상 구성을 테스트하십시오.
도구를 사용하기 전에 다음을 확인하십시오.
- 대상 구성 워크플로에 설명된 단계에 따라 대상을 구성합니다.
- 대상 인스턴스 ID를 가져오는 방법에 자세히 설명된 대로 대상에 대한 연결을 설정하십시오.
이 도구를 사용하여 대상을 구성한 후 다음을 수행할 수 있습니다.
- 대상이 올바르게 구성되었는지 테스트합니다.
- 구성된 대상에 대한 데이터 흐름의 무결성을 확인합니다.
사용 방법 how-to-use
요청에 프로필을 추가하거나 추가하지 않고 대상 테스트 API 끝점을 호출할 수 있습니다.
요청에 프로필을 추가하지 않으면 Adobe이 내부적으로 프로필을 생성하여 요청에 추가합니다. 이 요청에 사용할 프로필을 생성하려면 샘플 프로필 생성 API 참조를 참조하세요. API 참조에 표시된 대로 소스 XDM 스키마를 기반으로 프로필을 생성해야 합니다. 소스 스키마는 사용 중인 샌드박스의 유니온 스키마입니다.
응답에는 대상 요청 처리 결과가 포함됩니다. 이 요청에는 다음 세 가지 기본 섹션이 포함됩니다.
- 대상에 대해 Adobe이 생성한 요청입니다.
- 대상에서 받은 응답입니다.
- 요청에서 보낸 프로필 목록, 프로필이 요청에서 추가되었는지 또는 대상 테스트 요청의 본문이 비어 있는 경우 Adobe에서 생성되었는지.
maxUsersPerRequest 값이 7인 대상에 10개의 프로필을 보내는 경우 7개의 프로필이 있는 요청과 3개의 프로필이 있는 요청이 각각 있습니다.본문에 프로필 매개 변수가 있는 샘플 요청
curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/3e0ac39c-ef14-4101-9fd9-cf0909814510' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--data-raw '{
"profiles":[
{
"segmentMembership":{
"ups":{
"374a9a6c-c719-4cdb-a660-155a2838e6d6":{
"lastQualificationTime":"2021-05-13T12:16:27.248585Z",
"status":"realized"
},
"896f8776-9498-47b4-b994-51cb3f61c2c5":{
"lastQualificationTime":"2021-05-13T12:16:27.248605Z",
"status":"realized"
}
}
},
"identityMap":{
"Email":[
{
"id":"Email-iIyJc"
}
],
"IDFA":[
{
"id":"IDFA-viPAW"
}
],
"GAID":[
{
"id":"GAID-Bc6LE"
}
],
"Email_LC_SHA256":[
{
"id":"Email_LC_SHA256-gEOdj"
}
]
},
"attributes":{
"key":{
"value":"string"
}
}
}
]
}'
본문에 프로필 매개 변수가 없는 샘플 요청
curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/3e0ac39c-ef14-4101-9fd9-cf0909814510' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--data-raw ''
샘플 응답
results.httpCalls 매개 변수의 콘텐츠는 REST API에만 적용됩니다.
{
"results":[
{
"aggregationKey":{
"destinationInstanceId":"string",
"segmentId":"string",
"segmentStatus":"realized",
"identityNamespaces":[
[
"email",
"phone"
]
]
},
"httpCalls":[
{
"traceId":"a06fec2d-a886-4219-8975-4e4b7ed26539",
"request":{
"body":"{ \"attributes\": [ { \"external_id\": \"external_id-h29Fq\" , \"AdobeExperiencePlatformSegments\": { \"add\": [ \"Nirvana fans\" , \"RHCP fans\" ], \"remove\": [ ] } , \"key\": \"string\" } ] }",
"headers":[
{
"Content-Type":"application/json"
}
],
"method":"POST",
"uri":"https://api.moviestar.com/users/track"
},
"response":{
"body":"{\"status\": \"success\"}",
"code":"200",
"headers":[
{
"Connection":"keep-alive"
},
{
"Content-Type":"application/json"
},
{
"Server":"nginx"
},
{
"Vary":"Origin,Accept-Encoding"
},
{
"transfer-encoding":"chunked"
}
]
}
}
]
}
],
"inputProfiles":[
{
"segmentMembership":{
"ups":{
"03fb9938-8537-4b4c-87f9-9c4d413a0ee5":{
"lastQualificationTime":"2021-06-17T12:25:12.872039Z",
"status":"realized"
},
"27e05542-d6a3-46c7-9c8e-d59d50229530":{
"lastQualificationTime":"2021-06-17T12:25:12.872042Z",
"status":"realized"
}
}
},
"personalEmail":{
"address":"john.smith@abc.com"
},
"identityMap":{
"Email":[
{
"id":"Email-iIyJc"
}
],
"IDFA":[
{
"id":"IDFA-viPAW"
}
],
"GAID":[
{
"id":"GAID-Bc6LE"
}
],
"Email_LC_SHA256":[
{
"id":"Email_LC_SHA256-gEOdj"
}
]
},
"person":{
"name":{
"firstName":"string"
}
}
}
]
}
요청 및 응답 매개 변수에 대한 설명은 대상 테스트 API 작업을 참조하세요.