소스 스키마를 기반으로 샘플 프로필 생성

마지막 업데이트: 2023-07-14
  • 주제:
  • Destinations
    이 항목에 대한 자세한 내용 보기
  • 작성 대상:
  • Admin
    User

파일 기반 대상을 테스트하는 첫 번째 단계는 /sample-profiles 기존 소스 스키마를 기반으로 샘플 프로필을 생성하기 위한 종단점입니다.

샘플 프로필은 프로필의 JSON 구조를 이해하는 데 도움이 될 수 있습니다. 또한 추가적인 대상 테스트를 위해 자신의 프로필 데이터로 사용자 정의할 수 있는 기본값을 제공합니다.

시작하기

계속하기 전에 다음을 검토하십시오. 시작 안내서 필수 대상 작성 권한 및 필수 헤더를 가져오는 방법을 포함하여 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보입니다.

사전 요구 사항

을(를) 사용하기 전에 /sample-profiles 엔드포인트입니다. 다음 조건을 충족하는지 확인하십시오.

  • Destination SDK을 통해 생성된 기존 파일 기반 대상이 있으며 대상 카탈로그.

  • Experience Platform UI에서 대상에 대한 활성화 흐름을 하나 이상 만들었습니다. 다음 /sample-profiles 엔드포인트는 활성화 플로우에서 정의한 소스 스키마를 기반으로 프로필을 생성합니다. 다음을 참조하십시오. 활성화 자습서 활성화 플로우를 만드는 방법을 알아봅니다.

  • API 요청을 성공적으로 수행하려면 테스트할 대상 인스턴스에 해당하는 대상 인스턴스 ID가 필요합니다. Platform UI에서 대상과의 연결을 검색할 때 API 호출에 사용해야 하는 대상 인스턴스 ID를 URL에서 가져옵니다.

    URL에서 대상 인스턴스 ID를 가져오는 방법을 보여 주는 UI 이미지입니다.

대상 테스트를 위한 샘플 프로필 생성

에 GET 요청을 하여 소스 스키마를 기반으로 샘플 프로필을 생성할 수 있습니다. /sample-profiles 테스트할 대상의 대상 인스턴스 ID가 있는 끝점입니다.

API 형식

GET /authoring/sample-profiles?destinationInstanceId={DESTINATION_INSTANCE_ID}&count={NUMBER_OF_GENERATED_PROFILES}
쿼리 매개 변수 설명
destinationInstanceId 샘플 프로필을 생성하고 있는 대상 인스턴스의 ID입니다. 다음을 참조하십시오. 전제 조건 섹션 을 참조하십시오.
count 선택 사항입니다. 생성할 샘플 프로필 수입니다. 매개 변수는 다음 범위의 값을 가질 수 있습니다. 1 - 1000. 이 속성이 정의되지 않으면 API는 단일 샘플 프로필을 생성합니다.

요청

다음 요청은 대상 인스턴스에 정의된 소스 스키마를 기반으로 샘플 프로필을 생성합니다(해당 항목 포함) destinationInstanceId.

curl -X GET 'https://platform.adobe.io/data/core/activation/authoring/sample-profiles?destinationInstanceId={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}' \

응답

성공적인 응답은 지정된 수의 샘플 프로필과 함께, 소스 XDM 스키마에 해당하는 대상 멤버십, ID 및 프로필 속성이 포함된 HTTP 상태 200을 반환합니다.

노트

응답에서는 대상 인스턴스에 사용된 대상 멤버십, ID 및 프로필 속성만 반환합니다. 소스 스키마에 다른 필드가 있더라도 무시됩니다.

[
   {
      "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"
         }
      }
   }
]

UI에서 API 응답의 필드로의 매핑을 보여 주는 이미지입니다.

속성 설명
segmentMembership 개인의 대상 멤버십을 설명하는 맵 개체입니다. 에 대한 자세한 내용 segmentMembership, 읽기 대상자 멤버십 세부 정보.
lastQualificationTime 이 프로필이 세그먼트에 대해 마지막으로 적격한 타임스탬프입니다.
status 대상자 멤버십이 현재 요청의 일부로 실현되었는지 여부를 나타내는 문자열 필드입니다. 다음 값이 허용됩니다.
  • realized: 프로필이 세그먼트의 일부입니다.
  • exited: 프로필이 현재 요청의 일부로 대상을 종료합니다.
identityMap 연관된 네임스페이스와 함께 개인에 대한 다양한 ID 값을 설명하는 맵 유형 필드입니다. 에 대한 자세한 내용 identityMap, 참조 스키마 구성 기준.

API 오류 처리

Destination SDK API 엔드포인트는 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 을(를) 참조하십시오 API 상태 코드요청 헤더 오류 플랫폼 문제 해결 안내서에서 확인할 수 있습니다.

다음 단계

이제 이 문서를 읽고 대상에서 구성한 소스 스키마를 기반으로 샘플 프로필을 생성하는 방법을 알 수 있습니다 활성화 플로우.

이제 이러한 프로필을 사용자 정의하거나 API에 의해 반환되는 대로 사용할 수 있습니다. 파일 기반 대상 구성 테스트.

이 페이지에서는