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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
대상

작성 대상:

관리자
사용자

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

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

시작하기 getting-started

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

전제 조건 prerequisites

/sample-profiles 끝점을 사용하기 전에 다음 조건을 충족하는지 확인하십시오.

Destination SDK을 통해 만든 기존 파일 기반 대상이 있으며 대상 카탈로그에서 볼 수 있습니다.
Experience Platform UI에서 대상에 대한 활성화 흐름을 하나 이상 만들었습니다. /sample-profiles 끝점은 활성화 흐름에 정의한 소스 스키마를 기반으로 프로필을 만듭니다. 활성화 흐름을 만드는 방법을 알아보려면 활성화 자습서를 참조하세요.
API 요청을 성공적으로 수행하려면 테스트할 대상 인스턴스에 해당하는 대상 인스턴스 ID가 필요합니다. Platform UI에서 대상과의 연결을 검색할 때 API 호출에 사용해야 하는 대상 인스턴스 ID를 URL에서 가져옵니다.

URL에서 대상 인스턴스 ID를 가져오는 방법을 보여 주는

대상 테스트를 위한 샘플 프로필 생성 generate-sample-profiles

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

API 형식

GET /authoring/sample-profiles?destinationInstanceId={DESTINATION_INSTANCE_ID}&count={NUMBER_OF_GENERATED_PROFILES}

쿼리 매개변수

설명

destinationInstanceId

샘플 프로필을 생성하고 있는 대상 인스턴스의 ID입니다. 이 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을 반환합니다.

NOTE

응답에서는 대상 인스턴스에 사용된 대상 멤버십, 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"
         }
      }
   }
]

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