Adobe Target API에 대한 인증 구성

Adobe Admin Console에서 Adobe 사용자 계정에 Target에 대한 제품 관리자 및 개발자 수준 액세스 권한이 모두 부여되었는지 확인하십시오.

Adobe Developer Console에서 이 통합을 만들 Experience Cloud Organization을(를) 선택합니다. (단일 Experience Cloud Organization에 대한 액세스 권한만 있을 수 있습니다.)

Create new project 아이콘을 클릭합니다.

Adobe 서비스 및 제품에 액세스하기 위해 프로젝트에 REST API를 추가하려면 Add API ​을(를) 클릭하십시오.

Adobe Target ​을(를) 통합할 Adobe 서비스로 선택합니다. 표시되는 Next 단추를 클릭합니다.

공개 및 개인 키를 Target에 대해 만들고 있는 서비스 계정 통합과 연결하는 옵션을 선택하십시오. 이 예제에서는 Option 1: Generate a key pair ​을(를) 선택하고 Generate keypair ​을(를) 클릭합니다.

지침에 따라 개인 키가 포함된 자동 다운로드된 구성 파일(config)을 메모하십시오. Next 아이콘을 클릭합니다.

파일 시스템에서 이전 단계에서 만든 압축 구성 파일인 config의 위치를 확인합니다. 이 config 파일에는 나중에 필요할 개인 키가 포함되어 있습니다. 파일 시스템 내의 정확한 위치는 여기에 표시된 위치와 다를 수 있습니다.

Adobe Developer Console으로 돌아가서 Adobe Recommendations을 사용 중인 속성에 해당하는 제품 프로필을 선택합니다. 속성을 사용하지 않는 경우 기본 Workspace 옵션을 선택합니다. Save configured API 아이콘을 클릭합니다.

Create Integration ​을(를) 클릭합니다. API가 성공적으로 구성되었음을 나타내는 임시 메시지를 수신해야 합니다.

마지막 단계로 프로젝트 이름을 원래 Project 1보다 의미 있는 이름으로 바꾸십시오. 이렇게 하려면 탐색 경로를 표시로 사용하여 프로젝트로 이동하고 Edit project ​을(를) 클릭하여 Edit Project 모달에 액세스한 다음 프로젝트 이름을 변경합니다.

Adobe Developer Console에서 새 프로젝트의 Service Account (JWT) 자격 증명을 보려면 이동하십시오. 표시된 대로 왼쪽 탐색 또는 Credentials 섹션을 사용합니다.

Credential details ​에서 Public key(s), Client ID 및 서비스 계정과 관련된 기타 정보를 볼 수 있습니다.

Adobe Target API에 대한 정보로 이동하려면 클릭하십시오. 표시된 대로 왼쪽 탐색 또는 연결된 제품 및 서비스 섹션을 사용합니다.

Postman 환경에 대한 인증 정보를 캡처하는 JSON 파일을 만들려면 Download for Postman > Service Account (JWT) ​을(를) 클릭합니다.

파일 시스템의 JSON 파일을 확인합니다.

Postman에서 톱니바퀴 아이콘을 클릭하여 환경을 관리한 다음 Import ​을(를) 클릭하여 JSON 파일(환경)을 가져옵니다.

파일을 선택하고 Open ​을(를) 클릭합니다.

Postman 환경 관리 모달에서 새로 가져온 환경의 이름을 클릭하여 검사합니다. (환경 이름은 여기에 표시된 이름과 다를 수 있습니다. 원하는 대로 이름을 편집합니다. Adobe 프로젝트의 이름과 일치할 필요는 없습니다.

참고 CLIENT_SECRET 및 API_KEY(다른 변수와 함께)에는 Adobe Developer Console에 정의된 대로 통합에서 가져온 값이 미리 채워져 있습니다. (Postman CLIENT_SECRET 변수는 Developer Console에 표시된 CLIENT SECRET Adobe 자격 증명과 일치해야 하며 Postman의 API_KEY도 Developer Console의 CLIENT ID과(와) 일치해야 합니다.) 반대로 메모 PRIVATE_KEY, JWT_TOKEN 및 ACCESS_TOKEN은(는) 비어 있습니다. 먼저 PRIVATE_KEY 값을 제공하겠습니다.

파일 시스템에서 config 파일을 열고 private 키 파일을 엽니다.

private 키 파일의 전체 내용을 선택하고 복사합니다.

Postman에서 개인 키 값을 INITIAL VALUE 및 CURRENT VALUE 필드에 붙여 넣습니다.

Update ​을(를) 클릭하고 환경 모달을 닫습니다.

Adobe Identity Management 서비스 API 샘플 호출(으)로 이동합니다.

Adobe I/O Access Token Generation Postman collection ​을(를) 클릭합니다.

Raw ​을(를) 클릭한 다음 결과 JSON을 클립보드에 복사하여 이 컬렉션에 대한 원시 JSON을 가져옵니다. (또는 원시 JSON을 .json 파일로 저장할 수 있습니다.)

Postman에서 클립보드에서 원시 JSON을 붙여 넣고 제출하여 컬렉션을 가져옵니다. (또는 저장한 .json 파일을 업로드할 수 있습니다.) Continue 아이콘을 클릭합니다.

Adobe I/O 액세스 토큰 생성 Postman 컬렉션에서 IMS: JWT Generate + Auth via User Token 요청을 선택하고 환경이 선택되어 있는지 확인한 다음 Send ​을(를) 클릭하여 토큰을 생성합니다.

환경 관리 모달을 다시 열고 환경을 선택합니다.

이제 ACCESS_TOKEN 및 JWT_TOKEN 값이 채워집니다.

Adobe Target 관리 API Postman 컬렉션을(를) 가져옵니다. Postman에서 컬렉션을 가져올 때까지 모든 프롬프트를 따릅니다.

컬렉션을 확장하고 List activities 요청을 확인합니다.

{{access_token}}과(와) 같은 변수는 처음에 확인되지 않습니다. 여러 가지 방법으로 해결할 수 있습니다. 예를 들어 {{access_token}}이라는 새 컬렉션 변수를 정의할 수 있지만, 이 안내서에서는 이전에 사용 중이던 Postman 환경을 활용하도록 API 요청을 대신 변경합니다. 이렇게 하면 환경이 Adobe API에서 공통되는 모든 변수를 일관되게 단일 통합으로 계속 사용할 수 있습니다.

{{access_token}}을(를) {{ACCESS_TOKEN}}(으)로 바꾸려면 입력하세요.

{{api_key}}을(를) {{API_KEY}}(으)로 바꾸려면 입력하세요.

{{tenant}}을(를) {{TENANT_ID}}(으)로 바꾸려면 입력하세요. 메모 {{TENANT_ID}}을(를) 아직 인식할 수 없습니다.

환경 관리 모달을 열고 환경을 선택합니다.

새 {{TENANT_ID}} 환경 변수를 추가하려면 입력하십시오. 테넌트 ID 값을 복사하여 새 TENANT_ID 환경 변수의 INITIAL VALUE 및 CURRENT VALUE 필드에 붙여넣으십시오.

올바른 환경을 선택했는지 확인한 후 요청을 보냅니다. 활동 목록이 포함된 응답을 수신해야 합니다.