템플릿화된 고객 필드의 유효성 검사

개요 overview

/authoring/testing/template/render 끝점은 대상 구성에 정의된 템플릿화된 고객 데이터 필드의 모양을 시각화하는 데 도움이 됩니다.

끝점은 고객 데이터 필드에 대한 무작위 값을 생성하고 응답에서 반환합니다. 버킷 이름 또는 폴더 경로와 같은 고객 데이터 필드의 의미 체계 구조를 확인하는 데 도움이 됩니다.

시작하기 getting-started

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

전제 조건 prerequisites

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

  • Destination SDK을 통해 만든 기존 파일 기반 대상이 있으며 대상 카탈로그에서 볼 수 있습니다.

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

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

템플릿화된 고객 필드 렌더링 render-customer-fields

API 형식

POST /authoring/testing/template/render/destination

이 API 끝점의 동작을 설명하기 위해 다음 고객 데이터 필드 구성이 있는 파일 기반 대상을 생각해 보겠습니다.

"fileBasedS3Destination":{
   "bucket":{
      "templatingStrategy":"PEBBLE_V1",
      "value":"{{customerData.bucket}}"
   },
   "path":{
      "templatingStrategy":"PEBBLE_V1",
      "value":"{{customerData.path}}"
   }
}

요청

아래 요청은 /authoring/testing/template/render 끝점을 호출하며, 이 끝점은 위에 언급된 두 고객 데이터 필드에 대해 임의로 생성된 값이 있는 응답을 반환합니다.

curl -X POST 'https://platform.adobe.io/data/core/activation/authoring/testing/template/render/destination' \
 -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 '
 {
    "destinationId": "{DESTINATION_CONFIGURATION_ID}",
    "templates": {
        "bucket": "{{customerData.bucket}}",
        "path": "{{customerData.bucket}}/{{customerData.path}}"
    }
}'
매개 변수
설명
destinationId
테스트 중인 대상 구성의 ID입니다.
templates
대상 서버 구성에 정의된 서식 있는 필드 이름입니다.

응답

성공한 응답은 HTTP 200 OK 상태를 반환하며 본문에는 템플릿화된 필드에 대해 임의로 생성된 값이 포함됩니다.

이 응답은 버킷 이름 또는 폴더 경로와 같은 고객 데이터 필드의 올바른 구조를 확인하는 데 도움이 됩니다.

{
    "results": {
        "bucket": "hfWpE-bucket",
        "path": "hfWpE-bucket/ceC"
    }
}

API 오류 처리 api-error-handling

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

다음 단계 next-steps

이 문서를 읽고 나면 이제 대상 서버에 정의된 고객 데이터 필드 구성을 확인하는 방법을 알 수 있습니다.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6