기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon Connect Customer Profiles 사용 에이전트가 더 효율적이고 개인화된 고객 서비스를 제공할 수 있도록 Amazon Connect는 Salesforce, Zendesk, ServiceNow 또는 기타 고객 관계 관리(CRM) 제품과 같은 외부 애플리케이션의 정보를 Amazon Connect의 고객 응대 레코드와 결합할 수 있습니다. 이렇게 하면 고객과 상호 작용하는 동안 에이전트가 필요로 하는 모든 정보를 한 곳에서 확인할 수 있는 고객 프로필이 만들어집니다. 에이전트는 제품, 사례, 고객 응대 레코드를 포함한 고객 정보를 한눈에 볼 수 있어 고객의 신원을 신속하게 확인하고 통화 또는 채팅의 이유를 파악할 수 있습니다. 현재 Amazon Connect Customer Profiles는 [GDPR](https://aws.amazon.com/compliance/gdpr-center)을 준수하여 사용할 수 있으며 Amazon Connect에서 보유한 추가 인증을 받기 위해 대기 중입니다. 다음 이미지는 에이전트 작업 공간을 보여 줍니다. 이 설명서에는 Amazon Connect 고객 프로필 이미지가 포함되어 있습니다. 에이전트 Workspace는 효율적인 멀티태스킹을 위해 설계되어 통화, 채팅, 작업을 동시에 처리하면서도 동일한 브라우저 창에서 고객 프로필 정보에 빠르게 액세스할 수 있습니다. ![\[에이전트 애플리케이션의 고객 프로필 탭.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-concepts-intro3.png) 1. **사례**: Amazon Connect Cases를 사용하여 생성 및 관리되는 사례와 더불어 Zendesk 및 ServiceNow와 같은 타사 애플리케이션에서 수집한 사례와 관련된 상태, 참조 ID, 제목, 소스, 업데이트 날짜 및 추가 정보입니다. 1. **추가 정보**: [프로필](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html)의 고객 정의 *속성* 필드에 포함된 추가 정보 및 휴대폰 번호, 배송지 주소와 같은 추가 프로필 정보입니다. 이 정보는 에이전트가 필요한 정보를 빠르게 찾을 수 있도록 알파벳순으로 정렬됩니다. 1. **고객 응대 기록**: 이 고객이 과거에 고객 센터에 연락한 날짜, 시간 및 기간. 1. **제품 구매 내역**: 고객이 구매한 모든 자산이 여기에 입력될 수 있습니다. 데이터는 Customer Profiles에 [통합한](integrate-external-apps-customer-profiles.md) Salesforce 또는 Zendesk와 같은 외부 앱에서 수집됩니다. # Amazon Connect의 고객 프로필이란 무엇인가요? 고객 프로필은 고객 관련 정보(예: 계좌번호, 추가 정보, 생년월일, 이메일, 여러 개의 주소, 이름, 당사자 유형)와 결합된 고객 응대 기록을 저장하는 레코드입니다.** *계정 기반 프로필*에는 기본 하위 프로필이 있어야 합니다. Amazon Connect Customer Profiles를 활성화하면 모든 고객 응대에 대해 고유한 고객 프로필이 생성됩니다. 이렇게 하면 에이전트가 고객과 상호 작용하는 동안 필요한 모든 정보를 한곳에서 무료로 확인할 수 있는 고객 프로필이 만들어집니다. 흐름에서 고객 프로필에 액세스하려면 [고객 프로필](customer-profiles-block.md) 블록을 사용하세요. 에이전트는 에이전트 Workspace에서 [고객 프로필에 액세스](customer-profile-access.md)합니다. Customer Profiles의 유료 기능을 사용하면 [외부 애플리케이션의 데이터를 수집](integrate-external-apps-customer-profiles.md)하여 고객 프로필을 강화할 수 있습니다. 자세한 내용은 [요금](https://aws.amazon.com/connect/pricing/)을 참조하세요. [Amazon Connect Customer Profiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html)를 사용하여 고객 프로필에 사용자 지정 필드와 객체를 추가할 수도 있습니다. ## 고객 프로필 데이터는 어떻게 저장되나요? Amazon Connect는 고객 응대 기록을 고유한 고객 프로필에 저장합니다. 외부 애플리케이션에서 수집한 데이터를 파싱하여 고객 프로필 속성으로 저장합니다. Amazon Connect는 외부 애플리케이션의 데이터를 교체하거나 업데이트하지 않습니다. 데이터 소스가 제거되면 모든 음성 고객 응대의 고객 프로필에서 외부 애플리케이션의 데이터를 더 이상 사용할 수 없습니다. 고객 프로필 데이터를 보호하는 방법에 대한 자세한 내용은 [Amazon Connect의 데이터 보호](data-protection.md) 섹션을 참조하세요. 고객 프로필에 저장된 데이터에 액세스하는 방법에 대한 자세한 내용은 [에이전트 Workspace에서 Customer Profiles 액세스](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profile-access.html) 또는 [Customer Profiles API 사용](https://docs.aws.amazon.com/connect/latest/adminguide/use-customerprofiles-api.html)을 참조하세요. # Amazon Connect 인스턴스에 Customer Profiles 활성화 Amazon Connect는 사전 구축된 통합 기능을 제공하므로 여러 외부 애플리케이션의 고객 정보를 Amazon Connect의 고객 응대 기록과 신속하게 결합할 수 있습니다. 이렇게 하면 에이전트가 고객과 상호 작용하는 동안 필요한 모든 정보를 한곳에서 확인할 수 있는 고객 프로필이 만들어집니다. ## 시작하기 전 준비 사항 다음은 주요 개념과 설정 프로세스 중에 입력해야 하는 정보에 대한 개요입니다. ### 고객 프로필 도메인 정보 Amazon Connect Customer Profiles를 활성화하면 고객 프로필 도메인이 생성됩니다. 이 도메인은 고객 프로필, 객체 유형, 프로필 키 및 암호화 키와 같은 모든 데이터를 위한 컨테이너입니다. 다음은 Customer Profile 도메인을 생성하기 위한 지침입니다. + 각 Amazon Connect 인스턴스는 한 도메인과만 연결할 수 있습니다. + 여러 도메인을 생성할 수 있지만, 도메인이 외부 애플리케이션 통합 또는 고객 데이터를 서로 공유하지는 않습니다. + 생성하는 모든 외부 애플리케이션 통합은 도메인 수준에서 이루어집니다. 도메인과 연결된 모든 Amazon Connect 인스턴스는 도메인의 통합을 상속합니다. + 언제든지 다른 도메인을 선택하여 Amazon Connect 인스턴스의 연결을 현재 도메인에서 새 도메인으로 변경할 수 있습니다. 하지만 이전 도메인의 고객 프로필은 새 도메인으로 이동되지 않으므로 이는 권장하지 않습니다. ### 데이터 스토어 데이터 스토어는 Customer Profiles 데이터의 장기 데이터 스토어입니다. 지난 10년 동안 업데이트된 Customer Profiles 데이터를 저장합니다. Spark SQL 및 예측 인사이트로 구동되는 세분화에 사용되는 데이터이므로 이러한 기능을 사용하려면 활성화해야 합니다. 계산된 속성을 계산하거나 에이전트 Workspace를 채우는 데는 사용되지 않습니다. ### 고객 프로필 도메인의 이름을 어떻게 지정하시겠어요? 고객 프로필을 활성화하면 조직 이름과 같이 의미 있고 기억하기 쉬운 도메인 이름을 입력하라는 메시지가 표시됩니다(예: CustomerProfiles-ExampleCorp).** API를 사용하여 언제든지 기억하기 쉬운 이름을 변경할 수 있습니다. ### 데이터 스토어 데이터 스토어는 Spark SQL 및 예측 인사이트로 구동되는 세분화에 필요한 서비스 관리형 데이터 스토어이며 이러한 기능을 사용하려면 활성화해야 합니다. 계산된 속성을 계산하거나 에이전트 Workspace를 채우는 데는 사용되지 않습니다. 데이터 스토어를 활성화하면 자동으로 Customer Profiles에 수집됩니다. 데이터 스토어를 활성화한 후에는이 기능을 비활성화할 수 없습니다. 데이터 스토어에서 데이터를 삭제하려면 DeleteProfile API를 사용하거나 객체 유형 또는 Customer Profile 도메인을 삭제할 수 있습니다. ### DLQ(Dead Letter Queue)를 사용하시겠어요? DLQ(Dead Letter Queue)는 외부 애플리케이션의 데이터 처리와 관련된 오류를 보고하는 데 사용됩니다. Amazon AppFlow는 외부 애플리케이션에 연결하고 외부 애플리케이션에서 Amazon Connect Customer Profiles로 데이터를 이동하는 작업을 처리합니다. 그러면 Amazon Connect가 파일을 처리합니다. + 연결 중에 또는 Amazon Connect로 데이터를 전송하는 중에 오류가 발생하는 경우 Amazon AppFlow는 오류를 표시하지만 DLQ(Dead Letter Queue)에 오류를 기록하지는 않습니다. 예를 들어 외부 데이터가 지정된 스키마와 일치하지 않거나 외부 데이터 형식이 올바르지 않은 경우 처리 오류가 발생할 수 있습니다(현재는 JSON만 지원됨). + Amazon Connect는 파일을 처리하는 동안 오류가 발생하는 경우 DLQ(Dead Letter Queue)에 오류를 기록합니다. 나중에 대기열을 살펴보고 오류를 재처리해 볼 수 있습니다. + 객체와 함께 오류 메시지가 포함된 SQS 메시지는 도메인으로 정의된 Dead Letter Queue(DLQ)에서 찾을 수 있습니다. | **오류 메시지** | **권장 사항** | | --- | --- | | 프로필 객체에 UNIQUE 키 또는 PROFILE 키가 없음 | 데이터 매핑 또는 객체를 수정하고 데이터 매핑에서 UNIQUE 및 PROFILE로 표시된 키가 객체에 있는지 확인합니다. 설정 방법은 [**데이터 매핑 페이지**](customer-profiles-object-type-mapping.md)를 참조하세요. | | 초당 프로필에 수집된 객체가 너무 많음 | 짧은 시간 내에 동일한 프로필에 할당된 객체가 너무 많습니다. 객체를 다시 수집하거나 PutProfileObject API를 직접적으로 호출하는 사이에 대기 시간을 추가할 수 있습니다. | | EncryptionKey가 리전에 없거나, EncryptionKey에 Customer Profiles를 사용할 수 있는 권한이 없거나, EncryptionKey에 GenerateDataKey 권한이 없기 때문에 Customer Profiles가 객체를 수집할 수 없습니다. | KMS 권한을 확인하고 Customer Profiles에 필요한 액세스 권한이 있는지 확인합니다. [**Enable Customer Profiles, and specify a dead-letter queue and KMS key**](#enable-customer-profiles-step1) 섹션을 따르세요. | | KMS 키가 유효하지 않움 | KMS 권한을 확인하고 Customer Profiles에 필요한 액세스 권한이 있는지 확인합니다. [**Enable Customer Profiles, and specify a dead-letter queue and KMS key**](#enable-customer-profiles-step1) 섹션을 따르세요. | | 잘못된 KMS 키로 인해 Customer Profiles가 객체를 수집할 수 없음 | KMS 권한을 확인하고 Customer Profiles에 필요한 액세스 권한이 있는지 확인합니다. [**Enable Customer Profiles, and specify a dead-letter queue and KMS key**](#enable-customer-profiles-step1) 섹션을 따르세요. | | 데이터에 \$1바이트보다 큰 프로필 객체가 포함되어 있음 | 불필요한 필드를 제거하고 오류 메시지에 언급된 지정된 한도 미만으로 떨어질 때까지 데이터 크기를 줄입니다. | | 이 객체의 모든 키가 둘 이상의 프로필에 바인딩됨 | 데이터 매핑 또는 객체를 수정하고 객체의 PROFILE 키가 1개 이하의 기존 프로필에 바인딩되는지 확인합니다. | Customer Profiles를 활성화하면 Amazon SQS 대기열을 DLQ(Dead Letter Queue)로 지정할 수 있습니다. 이 옵션을 선택하는 경우 Amazon SQS에 다음 리소스 정책을 추가하여 Customer Profiles가 해당 대기열에 메시지를 전송할 권한을 갖도록 하세요. ``` { "Sid": "Customer Profiles SQS policy", "Effect": "Allow", "Principal": { "Service": "profile.amazonaws.com" }, "Action": "SQS:SendMessage", "Resource": "arn:aws:sqs:region:accountID:YourQueueName" } ``` 혼동된 대리자 보안 문제를 방지하려면 [Amazon Connect Customer Profiles에 서비스 혼동된 대리자 예방](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service)에서 적용할 정책 예시를 참조하세요. DLQ(Dead Letter Queue)를 만드는 방법에 대한 단계별 지침은 이 주제의 뒷부분인 [Customer Profiles를 활성화하고 DLQ(Dead Letter Queue) 및 KMS 키 지정](#enable-customer-profiles-step1)에서 제공됩니다. ### Customer Profiles에서 데이터를 암호화하는 데 사용할 KMS 키 생성(필수) **참고** Customer Profiles API에 대한 액세스를 유지하려면 Customer Profiles `profile` API를 사용하는 엔터티가 IAM 정책에서 명시적인 `kms:Decrypt` 및 `kms:GenerateDataKey` 권한을 가지고 있어야 합니다. 이를 통해 Customer Profiles와 관련된 API에서 검색된 리소스와 연결된 KMS 키에 `kms:Decrypt` 및 `kms:GenerateDataKey`를 활용할 수 있습니다. Customer Profiles를 활성화하면 AWS Key Management Service [KMS 키를](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys) 생성하거나 제공하라는 메시지가 표시됩니다. KMS 키를 만드는 방법에 대한 단계별 지침은 이 주제의 뒷부분인 [Customer Profiles를 활성화하고 DLQ(Dead Letter Queue) 및 KMS 키 지정](#enable-customer-profiles-step1)에서 제공됩니다. Customer Profiles에 저장된 모든 데이터는 선택한 KMS 키로 암호화됩니다. 고객 관리형 키는 사용자가 생성, 소유, 관리합니다. KMS 키를 완전히 제어할 수 있습니다(AWS KMS 요금 적용). 다른 사람이 관리자인 KMS 키를 설정하려면 Customer Profiles 서비스 보안 주체에 대한 `kms:GenerateDataKey`, `kms:CreateGrant` 및 `kms:Decrypt` 권한을 허용하는 정책이 있어야 합니다. 키 정책을 변경하는 방법에 대한 자세한 내용은 AWS Key Management Service 개발자 안내서의 [키 정책 변경을](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) 참조하세요. 또한 교차 서비스 가장을 방지하려면 [의 교차 서비스 혼동된 대리자 방지 AWS](cross-service-confused-deputy-prevention.md)에서 적용해야 하는 샘플 정책을 참조하세요. ## Customer Profiles를 활성화하고 DLQ(Dead Letter Queue) 및 KMS 키 지정 **데이터 스토어** 데이터 스토어를 활성화할지 여부를 선택합니다. Spark SQL 및 예측 인사이트로 구동되는 세분화를 사용해야 합니다. 도메인을 생성할 때 데이터 스토어를 활성화하지 않도록 선택한 경우 도메인을 생성하고 사용한 후 활성화할 수 있습니다. 데이터 스토어를 활성화한 후에는 끌 수 없습니다. Customer Profiles 페이지(왼쪽 패널 > **Customer Profiles)의 파란색 배너에 있는 활성화 버튼을 클릭하여 데이터 스토어를 활성화할 수 있습니다**. 도메인을 생성한 후이 파란색 배너가 표시됩니다. 데이터 스토어에는 고객 관리형 키(CMK)가 필요하며 도메인에 아직 활성화하지 않은 경우 고객 관리형 키(CMK)를 생성하라는 메시지가 표시됩니다. **중요** Data Vault를 사용하는 경우 Customer Profiles는 객체 유형별로 데이터를 저장하고 AWS KMS 키를 사용하여 암호화합니다. Customer Profiles는 다음을 통해 객체 유형 이름을 정규화합니다. 이름을 소문자로 변환 하이픈 변환 - 밑줄 \$1로 Customer Profiles 표준 객체 유형에 "표준" 추가 Customer Profiles 도메인 객체 유형에 “도메인” 추가 Customer Profiles 표준 도메인 객체 유형에 “domain\$1standard” 추가 Customer Profiles가 이름 충돌을 감지하면 데이터 스토어를 활성화할 수 없습니다. 데이터 스토어를 활성화한 후에는 이러한 정규화 규칙에 따라 기존 객체 유형 이름과 충돌하는 객체 유형을 생성할 수 없습니다. 1. [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)에서 Amazon Connect 콘솔을 엽니다. 1. 인스턴스 페이지에서 인스턴스 별칭을 선택합니다. 인스턴스 별칭은 Amazon Connect URL에 표시되는 **인스턴스 이름**이기도 합니다. 다음 이미지는 **Amazon Connect 가상 고객 센터 인스턴스** 페이지를 보여 주며, 인스턴스 별칭을 둘러싼 상자가 있습니다. ![\[Amazon Connect 가상 고객 센터 인스턴스 페이지, 인스턴스 별칭.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/instance.png) 1. 탐색 창에서 **고객 프로필**을 선택합니다. **고객 프로필 도메인** 페이지에는 통합에 사용할 수 있는 애플리케이션이 나열되어 있습니다. 다음 이미지에서 페이지는 활성화된 고객 프로필 도메인이 없음을 보여 줍니다. ![\[고객 프로필 페이지, 고객 프로필 활성화 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-domains-page.png) 1. 시작하려면 **고객 프로필 활성화**를 선택합니다. 1. **고객 프로필 활성화** 페이지에서 **새 도메인 생성**을 선택합니다. **도메인 지정**에서 조직 이름과 같이 의미 있는 이름을 입력합니다(예: *CustomerProfiles-ExampleCorp*). ![\[고객 프로필 활성화 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-domain.png) 1. **DLQ(Dead Letter Queue) 지정**에서 실패한 이벤트를 DLQ(Dead Letter Queue)로 보낼지 여부를 선택합니다. 이는 수집에 실패한 데이터에 대한 가시성을 확보하려는 경우에 유용합니다. 또한 이러한 실패한 데이터 통합을 나중에 다시 시도할 수 있는 옵션도 제공합니다. DLQ(Dead Letter Queue)를 생성하는 단계는 다음과 같습니다. + **고객 프로필 활성화** 페이지에서 **새 SQS 대기열 생성 또는 기존 SQS 대기열 선택**을 선택한 다음 **새 DLQ(Dead Letter Queue) 생성**을 선택합니다. ![\[새 SQS 대기열 생성 또는 기존 SQS 대기열 선택 옵션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-create-dlq-choose.png) + 브라우저에 Amazon SQS 콘솔을 위한 새 탭이 열립니다. **대기열 생성**을 선택합니다. + **대기열 생성** 페이지에서 **표준**을 선택한 다음 대기열에 이름을 지정합니다. ![\[대기열 생성 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-create-dlq-name.png) + **액세스 정책** 섹션에서 **고급**을 선택합니다. 버전 이름, 정책 ID 및 문이 표시됩니다. 필요한 경우 적절한 역할에만 액세스할 수 있도록 이 섹션을 업데이트하세요. + 문 섹션 끝(다음 이미지의 15행)에서 \$1 뒤에 쉼표를 추가하고 `Enter` 키를 누릅니다. ![\[액세스 정책 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-create-dlq-statement.png) + 다음 코드를 복사하여 붙여 넣습니다. ``` { "Sid": "Customer Profiles SQS policy", "Effect": "Allow", "Principal": { "Service": "profile.amazonaws.com" }, "Action": "SQS:SendMessage", "Resource": "arn:aws:sqs:region:accountID:YourQueueName" } ``` + *리전*, *accountID* 및 *YourQueueName*을 사용자 정보로 바꾸려면 14행의 `Resource` 정보를 복사하여 붙여넣습니다. ![\[액세스 정책 섹션, 리소스 정보.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-create-dlq-copyandpaste.png) + **대기열 생성**을 선택합니다. + 브라우저에서 Amazon Connect 콘솔의 **고객 프로필 활성화** 페이지로 돌아갑니다. **기존 SQS 대기열 선택** 상자를 클릭하거나 탭하여 드롭다운 목록에서 방금 생성한 대기열을 선택합니다. ![\[드롭다운 목록의 SQS 대기열입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-create-dlq-final.png) 1. **KMS 키 지정**에서 암호화를 위한 AWS KMS key 를 생성하거나 입력합니다. 다음은 AWS KMS key를 생성하는 단계입니다. + **고객 프로필 활성화** 페이지에서 ** AWS KMS key생성**을 선택합니다. ![\[고객 프로필 활성화 페이지에서 AWS KMS key 버튼을 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-create-kms-key.png) + 브라우저에 Key Management Service(KMS) 콘솔을 위한 새 탭이 열립니다. **키 구성** 페이지에서 **대칭**을 선택한 후 **다음**을 선택합니다. ![\[키 구성 페이지, 대칭 옵션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png) + **레이블 추가** 페이지에서 키의 이름과 설명을 추가하고 **다음**을 선택합니다. ![\[레이블 추가 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-create-kms-key-add-labels.png) + **키 관리 권한 정의** 페이지에서 **다음**을 선택합니다. + **키 사용 권한 정의** 페이지에서 **다음**을 선택합니다. + **키 정책 검토 및 편집** 페이지에서 **마침**을 선택합니다. 다음 예제에서 키 이름은 **bcb6fdd**로 시작합니다. ![\[고객 관리형 키 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-create-kms-key-note-key.png) + 브라우저에서 Amazon Connect 콘솔의 **고객 프로필 활성화** 페이지로 돌아갑니다. **KMS 키 지정** 상자를 클릭하거나 탭하면 생성한 키가 드롭다운 목록에 표시됩니다. 생성한 키를 선택합니다. ![\[KMS 키 지정 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-create-kms-key-choose-key.png) 1. **데이터 스토어**에서 데이터 스토어를 활성화할지 여부를 선택합니다. Spark SQL 및 예측 인사이트로 구동되는 세분화를 사용해야 합니다. 도메인을 생성할 때 데이터 스토어를 활성화하지 않도록 선택한 경우 도메인을 생성하고 사용한 후 활성화할 수 있습니다. 데이터 스토어를 활성화한 후에는 끌 수 없습니다. 데이터 스토어가 없는 기존 도메인이 있는 경우 Customer Profiles 페이지(왼쪽 패널 > Customer Profiles)의 파란색 배너에 있는 활성화 버튼을 클릭하여 활성화할 수 있습니다. 데이터 스토어에는 고객 관리형 키(CMK)가 필요하며 도메인에 대해 아직 활성화하지 않은 경우 고객 관리형 키(CMK)를 생성하라는 메시지가 표시됩니다. 1. **제출**을 선택합니다. 완료된 페이지는 다음 이미지와 유사합니다. 여기에는 고객 프로필 도메인의 이름, DLQ(Dead Letter Queue), KMS 키가 표시됩니다. ![\[완성된 고객 프로필 도메인 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-final.png) 이제 완료되었습니다. Amazon Connect Customer Profiles가 활성화되었습니다. 이제 Amazon Connect는 새 고객 응대가 들어올 때마다 고객 프로필 레코드를 생성합니다. 그런 다음 해당 전화번호(음성) 또는 이메일 주소(채팅)에 대한 고객 응대 기록을 추적합니다. 에이전트는 [새 고객 프로필을 생성](ag-cp-create.md)하고 고객의 고객 응대 레코드를 볼 수 있습니다. ## 다음 단계 1. [에이전트 애플리케이션을 통해 Customer Profiles를 사용할 수 있게 합니다](customer-profile-access.md). 1. [에이전트에게 에이전트 애플리케이션에서 Customer Profiles에 액세스할 수 있는 권한을 할당합니다](assign-security-profile-customer-profile.md). 1. [고객 프로필 데이터를 프로파일링하는 외부 애플리케이션과 통합합니다(선택 사항)](integrate-external-apps-customer-profiles.md). 1. [자격 증명 확인을 사용하여 두 개 이상의 유사한 프로필을 식별하고 통합합니다](use-identity-resolution.md). # 업계 리소스 템플릿 시작하기 Amazon Connect Customer Profiles는 특정 산업에 맞게 계산된 속성, 세그먼트 및 프로필 탐색기 레이아웃을 사용하여 도메인을 빠르게 설정하는 데 도움이 되는 산업 리소스 템플릿을 제공합니다. ## 시작하기 전 준비 사항 업계 리소스 템플릿을 활성화하기 전에 다음을 갖추어야 합니다. + Customer Profiles가 활성화된 Amazon Connect 인스턴스 + Customer Profiles 도메인에서 리소스를 생성할 수 있는 적절한 권한 ## 업계 리소스 템플릿 정보 산업 템플릿을 활성화하면 Customer Profiles가 도메인에 다음 리소스를 자동으로 생성합니다. + 계산된 속성 정의 - 고객 데이터에서 파생된 사전 정의된 속성 + 세그먼트 정의 - 공통 특성에 따른 고객 그룹화 + 프로필 탐색기 레이아웃 - 고객 정보를 시각화하기 위한 사용자 지정 대시보드 보기 이러한 리소스는 각 리소스를 수동으로 생성할 필요 없이 고객 데이터에서 가치를 빠르게 도출할 수 있도록 설계되었습니다. ## 업계 리소스 템플릿 활성화 1. Customer Profiles 홈페이지에서 산업 템플릿 섹션을 찾습니다. + Customer Profiles를 처음 설정하는 경우 페이지 상단에 공지가 표시됩니다. ![\[고객 프로필을 처음 사용하는 경우 템플릿을 활성화하는 배너가 나타납니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/enable-industry-resource-templates-1.png) + 도메인에 리소스가 이미 있는 경우 활성화된 템플릿 목록이 산업 템플릿 섹션에 나타납니다. ![\[이전에 고객 프로필을 사용한 적이 있는 경우 활성화된 템플릿 목록이 업계 템플릿 섹션에 나타납니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/enable-industry-resource-templates-2.png) 1. 템플릿을 활성화하려면 **템플릿 활성화**를 선택합니다. 1. **템플릿 선택** 드롭다운에서 비즈니스에 가장 적합한 산업을 선택합니다. + **항공사** - 항공 여행 기업용 + **호텔** - 호텔 비즈니스용 1. **리소스 검토** 섹션에서 생성될 리소스를 검토합니다. ![\[생성될 리소스를 검토합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/enable-industry-resource-templates-3.png) 1. **템플릿 활성화**를 선택합니다. 1. 리소스가 생성될 때까지 기다립니다. 리소스 생성이 진행되는 동안 브라우저 탭을 열어 두어야 합니다. 1. 완료되면 확인 메시지가 표시되고 생성된 리소스 수와 함께 템플릿이 산업 템플릿 섹션에 표시됩니다. ![\[성공적인 생성 배너가 나타납니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/enable-industry-resource-templates-4.png) ## 업계 템플릿에서 생성한 리소스 ### 항공사 업계 템플릿 #### 계산된 속성 항공사 템플릿은 여러 범주에 걸쳐 계산된 속성을 생성합니다. **항공사 계산된 속성** | 계산된 속성 이름 | 표시 이름 | 설명 | 객체 유형 | | --- | --- | --- | --- | | air\$1airPreference\$1departure\$1airport\$1last\$1occurrence | 선호하는 출발 공항 | 고객이 가장 최근에 구성한 선호하는 출발 공항을 반환합니다. | \$1airPreference | | air\$1airPreference\$1arrival\$1airport\$1last\$1occurrence | 선호하는 도착 공항 | 고객이 가장 최근에 구성한 선호하는 도착 공항을 반환합니다. | \$1airPreference | | air\$1airPreference\$1travel\$1type\$1last\$1occurrence | 선호하는 여행 유형 | 고객이 가장 최근에 구성한 선호하는 여행 유형을 반환합니다. | \$1airPreference | | air\$1airPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | 마케팅 옵트인 기본 설정 | 고객이 가장 최근에 구성한 마케팅 옵트인 설정을 반환합니다. | \$1airPreference | | air\$1airPreference\$1language\$1in\$1person\$1language\$1last\$1occurrence | 선호하는 대면 언어 | 대면 상담을 위해 고객이 가장 최근에 구성한 선호하는 언어를 반환합니다. | \$1airPreference | | air\$1airPreference\$1seat\$1location\$1last\$1occurrence | 선호하는 좌석 위치 | 고객이 가장 최근에 선택한 좌석 위치 기본 설정을 반환합니다. | \$1airPreference | | air\$1airPreference\$1home\$1airport\$1last\$1occurrence | 선호하는 홈 공항 | 고객이 가장 최근에 지정한 홈 공항을 반환합니다. | \$1airPreference | | air\$1airPreference\$1dining\$1dietary\$1restriction\$1last\$1occurrence | 선호하는 식이 제한 | 고객이 가장 최근에 지정한 식이 제한을 반환합니다. | \$1airPreference | | air\$1airBookings\$1number\$1of\$1passengers\$1average | 예약당 평균 승객 수 | 고객의 예약에서 평균 승객 수를 반환합니다. | \$1airBooking | | air\$1airBookings\$1price\$1total\$1price\$1average | 평균 예약 가격 | 모든 고객의 예약에 대한 평균 비용을 반환합니다. | \$1airBooking | | air\$1airBookings\$1count | 예약 수 | 고객의 예약 수를 반환합니다. | \$1airBooking | | air\$1airSegments\$1flight\$1delay\$1time\$1sum | 총 비행 지연 기간 | 고객이 경험하는 총 비행 지연 시간을 반환합니다. | \$1airSegment | | air\$1airSegments\$1cancelled\$1flights\$1count\$130\$1days | 지난 30일 이내에 취소된 항공편 | 지난 30일 이내에 취소된 고객 항공편 수를 반환합니다. | \$1airSegment | | air\$1airSegments\$1delayed\$1flights\$1count\$130\$1days | 지난 30일 동안 지연된 항공편 | 지난 30일 이내에 지연된 고객 항공편 수를 반환합니다. | \$1airSegment | | air\$1airSegments\$1completed\$1flights\$1count\$130\$1days | 지난 30일 이내에 완료된 항공편 | 지난 30일 이내에 완료된 고객 항공편 수를 반환합니다. | \$1airSegment | | air\$1airSegments\$1completed\$1flights\$1count\$11\$1year | 작년에 완료된 항공편 | 작년에 완료된 고객 항공편 수를 반환합니다. | \$1airSegment | | air\$1airSegment\$1departure\$1date\$1last\$1occurrence | 마지막 항공편 출발 날짜 | 고객의 가장 최근 항공편 출발 날짜를 반환합니다. | \$1airSegment | | air\$1airSegments\$1miles\$1to\$1earn\$1sum | 총 비행 마일 | 고객의 모든 비행 거리의 합계를 마일 단위로 반환합니다. | \$1airSegment | | air\$1airSegments\$1miles\$1to\$1earn\$1sum\$11\$1year | 작년의 비행 마일 | 작년에 고객이 비행한 비행 마일의 합계를 반환합니다. | \$1airSegment | | air\$1airSegments\$1business\$1first\$1class\$1count | 프리미엄 클래스 항공편 수 | 비즈니스 클래스 또는 퍼스트 클래스로 예약된 고객 항공 세그먼트 수를 반환합니다. | \$1airSegment | | air\$1loyalties\$1points\$1redeemed\$1sum | 사용한 총 충성도 포인트 | 모든 고객 충성도 프로그램에서 사용한 포인트의 총 합계를 반환합니다. | \$1loyalty | | air\$1loyalties\$1count | 충성도 멤버십 수 | 고객이 보유한 충성도 프로그램 멤버십 수를 반환합니다. | \$1loyalty | | air\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | 다음 티어까지 남은 포인트 | 다음 충성도 티어에 도달하는 데 필요한 고객의 최근 포인트 기록을 반환합니다. | \$1loyalty | | air\$1loyalty\$1points\$1balance\$1last\$1occurrence | 현재 충성도 포인트 잔액 | 고객의 최근 충성도 포인트 잔액을 반환합니다. | \$1loyalty | | air\$1loyalty\$1membership\$1id\$1last\$1occurrence | 현재 충성도 멤버십 ID | 고객의 최신 충성도 멤버십 식별자를 반환합니다. | \$1loyalty | | air\$1loyalty\$1program\$1name\$1last\$1occurrence | 현재 충성도 프로그램 이름 | 고객의 최신 충성도 프로그램 이름을 반환합니다. | \$1loyalty | | air\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | 가장 최근 충성도 등록 날짜 | 고객의 최신 충성도 프로그램 등록 날짜를 반환합니다. | \$1loyalty | | air\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | 현재 충성도 티어 | 고객의 최신 충성도 프로그램 티어 상태를 반환합니다. | \$1loyalty | | air\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | 프리미엄 티어 멤버십 수 | Silver를 사용하여 고객 충성도 프로그램 수를 반환합니다. | \$1loyalty | | air\$1loyaltyPromotions\$1count | 충성도 프로모션 수 | 고객이 받은 충성도 프로모션의 총 수를 반환합니다. | \$1loyaltyPromotion | #### Segments 항공사 템플릿은 다음 세그먼트를 생성합니다. + [항공사] 마케팅 구독자 + [항공사] 지난 30일 이내에 항공편이 취소된 고객 + [항공사] 지난 30일 이내에 지연된 항공편이 있는 고객 + [항공사] 지난 30일 이내에 항공편을 완료한 고객 + [항공사] 휴면 멤버 #### 프로파일 탐색기 레이아웃 데모 프로파일 탐색기 레이아웃은 다음 위젯으로 `DEMO-Airline-Layout` 구성된 레이아웃 이름으로 생성됩니다. + 고객 세부 정보 및 연락처 정보 + 충성도 프로그램 상태 및 포인트 + 최근 예약 및 항공편 + 고객 기본 설정 + 고객 가치 지표 + 고객 만족도 지표 ### 호텔 산업 템플릿 #### 계산된 속성 호텔 템플릿은 여러 범주에 걸쳐 계산된 속성을 생성합니다. **계산된 호텔 속성** | 계산된 속성 이름 | 표시 이름 | 설명 | 객체 유형 | | --- | --- | --- | --- | | hotel\$1hotelPreference\$1location\$1room\$1type\$1last\$1occurrence | 선호하는 객실 유형 | 고객이 가장 최근에 구성한 선호하는 여행 유형을 반환합니다. | \$1hotelPreference | | hotel\$1hotelPreference\$1cleaning\$1time\$1last\$1occurrence | 선호하는 청소 시간 | 고객이 가장 최근에 구성한 객실 청소 시간 기본 설정을 반환합니다. | \$1hotelPreference | | hotel\$1hotelPreference\$1location\$1view\$1last\$1occurrence | 선호하는 객실 뷰 | 고객이 가장 최근에 구성한 객실 뷰 기본 설정을 반환합니다. | \$1hotelPreference | | hotel\$1hotelPreference\$1check\$1in\$1type\$1last\$1occurrence | 선호하는 체크인 방법 | 고객이 가장 최근에 구성한 체크인 방법 기본 설정을 반환합니다. | \$1hotelPreference | | hotel\$1hotelPreference\$1check\$1out\$1type\$1last\$1occurrence | 선호하는 체크아웃 방법 | 고객이 가장 최근에 구성한 체크아웃 방법 기본 설정을 반환합니다. | \$1hotelPreference | | hotel\$1hotelPreference\$1special\$1request\$1last\$1occurrence | 마지막 특별 요청 유형 | 고객이 가장 최근에 요청한 특별 숙박 유형을 반환합니다. | \$1hotelPreference | | hotel\$1hotelPreference\$1interest\$1name\$1of\$1interest\$1max\$1occurrence | 가장 빈번한 관심 | 고객의 가장 자주 표현되는 관심 또는 편의 기본 설정를 반환합니다. | \$1hotelPreference | | hotel\$1hotelPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | 마케팅 옵트인 기본 설정 | 고객이 가장 최근에 구성한 마케팅 옵트인 설정을 반환합니다. | \$1hotelPreference | | hotel\$1hotelReservations\$1number\$1of\$1nights\$1average | 평균 숙박 기간 | 모든 고객 호텔 예약의 평균 숙박 기간을 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum\$11\$1year | 작년의 총 숙박 일수 | 모든 고객 예약에서 작년에 숙박한 총 숙박 일수를 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum | 총 숙박 일수 | 모든 고객 호텔 예약에서 숙박한 총 숙박 일수를 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservation\$1room\$1type\$1name\$1last\$1occurrence | 마지막으로 예약한 방 유형 | 고객이 가장 최근에 예약한 객실 유형을 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservation\$1channel\$1method\$1last\$1occurrence | 사용된 마지막 예약 채널 | 호텔 예약에 사용된 고객의 최신 채널을 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservations\$1count | 예약 수 | 고객의 호텔 예약 수를 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1average | 평균 예약 지출 | 세금 부과 후 호텔 예약당 지출된 평균 금액을 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1sum | 총 호텔 지출 | 세금 부과 후 모든 고객 호텔 예약에 사용된 총 금액을 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservation\$1number\$1of\$1guests\$1max\$1occurrence | 가장 일반적인 그룹 크기 | 모든 숙박 기간 동안 고객이 가장 자주 예약한 게스트 수를 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservations\$1business\$1travel\$1count | 출장 횟수 | 출장으로 표시된 고객 예약 수를 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservations\$1missed\$1checkin\$1count | 누락된 체크인 수 | 고객이 체크인을 놓친 예약 수를 반환합니다. | \$1hotelReservation | | hotel\$1hotelReservation\$1cancelled\$1count | 취소된 예약 수 | 고객이 취소한 호텔 예약 수를 반환합니다. | \$1hotelReservation | | hotel\$1hotelStayRevenues\$1amount\$1sum | 생성된 총 수익 | 모든 고객 호텔 숙박에서 발생한 총 수익을 반환합니다. | \$1hotelStayRevenue | | hotel\$1hotelStayRevenues\$1amount\$1average | 숙박당 평균 수익 | 모든 고객 숙박에 대해 계산된 평균 수익 금액을 반환합니다. | \$1hotelStayRevenue | | hotel\$1hotelStayRevenues\$1amount\$1maximum | 최고 수익 금액 | 모든 고객 숙박에서 생성된 최대 단일 수익 금액을 반환합니다. | \$1hotelStayRevenue | | hotel\$1hotelStayRevenue\$1revenue\$1type\$1max\$1occurrence | 가장 일반적인 수익원 | 고객 호텔 숙박 기간 동안 가장 자주 발생하는 수익 유형을 반환합니다. | \$1hotelStayRevenue | | hotel\$1loyalties\$1points\$1redeemed\$1sum | 사용한 총 충성도 포인트 | 모든 고객 충성도 프로그램에서 사용한 포인트의 총 합계를 반환합니다. | \$1loyalty | | hotel\$1loyalties\$1count | 충성도 멤버십 수 | 고객이 보유한 충성도 프로그램 멤버십 수를 반환합니다. | \$1loyalty | | hotel\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | 다음 티어까지 남은 포인트 | 다음 충성도 티어에 도달하는 데 필요한 고객의 최근 포인트 기록을 반환합니다. | \$1loyalty | | hotel\$1loyalty\$1points\$1balance\$1last\$1occurrence | 현재 충성도 포인트 잔액 | 고객의 최근 충성도 포인트 잔액을 반환합니다. | \$1loyalty | | hotel\$1loyalty\$1membership\$1id\$1last\$1occurrence | 현재 충성도 멤버십 ID | 고객의 최신 충성도 멤버십 식별자를 반환합니다. | \$1loyalty | | hotel\$1loyalty\$1program\$1name\$1last\$1occurrence | 현재 충성도 프로그램 이름 | 고객의 최신 충성도 프로그램 이름을 반환합니다. | \$1loyalty | | hotel\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | 가장 최근 충성도 등록 날짜 | 고객의 최신 충성도 프로그램 등록 날짜를 반환합니다. | \$1loyalty | | hotel\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | 현재 충성도 티어 | 고객의 최신 충성도 프로그램 티어 상태를 반환합니다. | \$1loyalty | | hotel\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | 프리미엄 티어 멤버십 수 | Silver를 사용하여 고객 충성도 프로그램 수를 반환합니다. | \$1loyalty | | hotel\$1loyaltyPromotions\$1count | 충성도 프로모션 수 | 고객이 받은 충성도 프로모션의 총 수를 반환합니다. | \$1loyaltyPromotion | #### Segments 호텔 템플릿은 다음과 같은 세그먼트를 생성합니다. + [호텔] 기본 설정 마케팅 구독자 + [호텔] 1인 여행객 + [호텔] 커플 또는 2인 여행객 + [호텔] 가족 또는 단체 여행객 + [호텔] 30일 이내에 예약 예정인 고객 #### 프로파일 탐색기 레이아웃 다음을 표시하는 사용자 지정 레이아웃입니다. + 고객 세부 정보 및 연락처 정보 + 객실 기본 설정 + 숙박 기록 + 수익 정보 + 충성도 상태 ## 산업 템플릿 비활성화 산업 템플릿을 비활성화하여 도메인에서 생성한 리소스를 제거할 수 있습니다. 템플릿을 비활성화하려면 다음을 수행하세요. 1. Customer Profiles 홈페이지에서 산업 템플릿 섹션을 찾습니다. 1. 비활성화하려는 템플릿을 찾아 작업 **비활성화**를 선택합니다. 1. 확인 메시지를 검토하고 **확인**을 선택하여 템플릿을 비활성화합니다. **중요** 템플릿을 비활성화하면 해당 템플릿으로 생성된 모든 리소스가 도메인에서 삭제됩니다. 이러한 리소스가 고객 세그먼트, 아웃바운드 캠페인 또는 고객 응대 흐름에 사용되는 경우 템플릿을 비활성화하면 해당 리소스에 영향을 미칠 수 있습니다. 템플릿을 비활성화하기 전에 사용 중인 리소스를 검토하여 잠재적 영향을 이해합니다. ## 문제 해결 **산업 템플릿 문제 해결** | 오류 | 권장 사항 | | --- | --- | | 템플릿 리소스를 생성하지 못했습니다. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/getting-started-industry-resource-templates.html) | | 생성된 리소스는 프로필 탐색기에 표시되지 않습니다. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/getting-started-industry-resource-templates.html) | | 여러 템플릿을 활성화할 수 없음 | 각 도메인에는 여러 산업 템플릿이 활성화되어 있을 수 있습니다. 문제가 발생하는 경우 도메인의 리소스 제한에 도달하지 않았는지 확인합니다. | | 템플릿 리소스를 삭제해야 함 | 현재 시작하기 기능은 템플릿으로 생성된 모든 리소스를 자동으로 삭제하는 방법을 제공하지 않습니다. 각 관리 페이지를 통해 개별 리소스를 수동으로 삭제할 수 있습니다. | ## 다음 단계 산업 템플릿을 활성화한 후 다음을 수행할 수 있습니다. + 프로파일 탐색기로 이동하여 새 레이아웃이 실행 중인지 확인합니다. + 특정 요구 사항에 더 잘 맞게 계산된 속성 보기 및 편집 + Amazon Connect에서 고객 세그먼트 관리 + 비즈니스 요구 사항에 따라 프로필 탐색기 레이아웃 편집 + 외부 애플리케이션을 Amazon Connect Customer Profiles과 통합하여 프로필 생성 시작 # 에이전트 워크스페이스에서 Amazon Connect Customer Profiles 액세스 Amazon Connect Customer Profiles를 활성화하면 에이전트가 고객과 상호 작용을 시작하고 [고객 정보에](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles.html) 액세스하여 맞춤형 서비스를 제공할 수 있습니다. 이 주제에서는 Amazon Connect 에이전트 워크스페이스에 액세스하는 방법을 설명합니다. **작은 정보** 에이전트가 Customer Profiles에 액세스할 수 있도록 해당 보안 프로필에 **고객 프로필** 권한이 있는지 확인하세요. 자세한 내용은 [Amazon Connect Customer Profiles에 대한 보안 프로필 권한](assign-security-profile-customer-profile.md) 섹션을 참조하세요. ## 옵션 1: CCP에서 기본 제공되는 Customer Profiles 사용 Customer Profiles는 이미 고객 응대 제어판(CCP)에 포함되어 있습니다. 에이전트는 Amazon Connect 인스턴스에 로그인하고 다음 이미지와 같이 오른쪽 상단에 있는 **에이전트 Workspace** 버튼을 선택하여 동일한 브라우저 창에서 CCP, Customer Profiles 및 Amazon Connect의 사례 관리에 모두 액세스할 수 있습니다. ![\[Customer Profiles 페이지와 에이전트 Workspace를 여는 강조 표시된 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-agent-workspace-open.png) **참고** 다음 URL을 사용하여 에이전트 Workspace에 액세스할 수도 있습니다. **https://*인스턴스 이름*.my.connect.aws/agent-app-v2/** **awsapps.com** 도메인을 사용하여 인스턴스에 액세스하는 경우 다음 URL을 사용하세요. **https://*인스턴스 이름*.awsapps.com/connect/agent-app-v2/** 인스턴스 이름을 찾는 데 도움이 필요하면 [Amazon Connect 인스턴스 이름 찾기](find-instance-name.md)섹션을 참조하세요. 다음은 에이전트 Workspace 에서 Customer Profiles가 어떻게 보이는지 보여 주는 예시입니다. ![\[에이전트 Workspace의 Customer Profiles 탭과 CCP\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-agent-app.png) ## 옵션 2: 맞춤형 에이전트 Workspace에 Customer Profiles 포함 고객 응대 제어판(CCP)을 포함하면 사전 구축된 CCP 사용자 인터페이스를 표시하거나 숨길 수 있습니다. 예를 들어 통화를 수락하고 거부하기 위한 사용자 지정 버튼으로 직접 디자인한 사용자 인터페이스를 갖춘 사용자 지정 에이전트 Workspace를 개발할 수 있습니다. 또는 Amazon Connect에 포함된 사전 구축된 CCP를 다른 사용자 지정 앱에 포함하고 싶을 수도 있습니다. 사전 구축된 CCP 사용자 인터페이스를 표시하든 이를 숨기고 직접 구축하든 관계없이 [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) 라이브러리를 사용하여 CCP 및 Customer Profiles를 에이전트 Workspace에 포함할 수 있습니다. 이렇게 하면 Amazon Connect Streams가 초기화되고 에이전트는 Amazon Connect 및 Customer Profiles에 연결하고 인증할 수 있습니다. Customer Profiles 포함에 대한 자세한 내용은 [CCP, Customer Profiles 및 Wisdom 초기화](https://github.com/amazon-connect/amazon-connect-streams/blob/master/Documentation.md#initialization-for-ccp-customer-profiles-and-wisdom)를 참조하세요. Customer Profiles의 원시 데이터를 사용하면서 자체 위젯을 구축하려면 CustomerProfilesJS 오픈 소스 라이브러리 사용 방법에 대한 [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles) 설명서를 참조하세요. **작은 정보** 에이전트 Workspace를 사용자 지정할 때 에이전트가 에이전트 Workspace에 액세스하는 데 사용할 URL을 결정하는데, 이는 Amazon Connect에서 제공하는 URL과 매우 다를 수 있습니다. 예를 들어 URL은 https://example-corp.com/agent-support-app일 수 있습니다. # 고객 프로필 자동 채우기 기본적으로 Amazon Connect Customer Profiles는 다음 값을 사용하여 사용자 인터페이스에서 고객 프로필을 검색하고 자동으로 채웁니다. + 음성 고객 응대의 경우: 전화번호 + 채팅 고객 응대의 경우: 이메일 Customer Profiles 흐름 블록을 사용하여 고객 프로필을 자동으로 채웁니다. 이 동작을 사용자 지정하려면 다음 연락처 속성에 대해 [연락처 속성 설정](set-contact-attributes.md) 블록(아래 참조) 사용 | 속성 | 설명 | 형식 | JSONPath 참조 | | --- | --- | --- | --- | | profileSearchKey | 프로필을 검색하는 데 사용하려는 속성의 이름. | 사용자 정의 | 해당 사항 없음 | | profileSearchValue | 검색하려는 키의 값 (예: 고객 이름 또는 계좌번호). | 사용자 정의 | 해당 사항 없음 | 예를 들어 이메일로 채팅 고객 응대를 검색하려면 `profileSearchKey` 속성을 `_email` 검색 키로 설정하고 이메일 값을 `profileSearchValue`로 제공할 수 있습니다. 프로필 객체에 사용자 지정 키를 정의한 경우 해당 검색 키로도 검색할 수 있습니다. 사용자 지정 키를 검색할 수 있는지 확인하려면 [키 정의 세부 정보](object-type-mapping-definition-details.md#key-definition-details)을 참조하세요. 다음 이미지는 [연락처 속성 설정](set-contact-attributes.md) 블록에서 이러한 속성을 사용할 수 있는 방법을 보여 줍니다. ![\[고객 응대 속성 설정 블록의 속성 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-attributes1.png) ## 고객 프로필을 고객 응대와 자동으로 연결 기본적으로 에이전트는 고객의 신원을 확인한 후 고객 프로필을 고객 응대에 수동으로 연결해야 합니다. 전화번호를 기반으로 고객 응대를 프로필과 자동으로 연결하도록 이 동작을 변경하려면 [Customer Profiles에서 \$1phone 키를 사용하여 찾은 하나의 프로필과 연락처 레코드 연결](auto-associate-profile-using-phone-profile-key.md) 섹션을 참조하세요. 여러 프로필이 고객 응대의 전화번호와 매칭되는 경우 매칭되는 여러 프로필이 에이전트에게 표시됩니다. 에이전트는 고객 응대와 연결할 프로필을 선택해야 합니다. # Amazon Connect Customer Profiles에 대한 보안 프로필 권한 에이전트의 보안 프로필에 대한 권한을 할당하여 에이전트가 프로필 검색 및 고객 세부 정보 보기, 프로필에 연락처 레코드 연결, 프로필 편집, 새 프로필 생성 및 저장과 같은 작업을 수행할 수 있도록 합니다. 섹션의 주제는 에이전트, 흐름 및 계산된 속성에 대한 권한을 업데이트하여 권한을 할당하는 데 도움이 됩니다. 또한 권한을 업데이트하는 동안 오류가 발생할 경우 문제를 해결하는 데 도움이 되는 정보도 있습니다. **Topics** + [에이전트에 대한 Customer Profiles 권한 업데이트](security-profile-customer-profile-agent.md) + [흐름에 대한 Customer Profiles 권한 업데이트](security-profile-customer-profile-contact-flows.md) + [계산된 속성의 권한 업데이트](security-profile-customer-profile-calc-attribs.md) + [고객 세그먼트에 대한 보안 프로필 권한](security-profile-customer-profile-segmentation.md) + [오류가 발생할 경우 새 Customer Profiles 권한 할당](security-profile-customer-profile-issues.md) # 에이전트에 대한 Customer Profiles 권한 업데이트 필요에 따라 에이전트의 보안 프로필에 다음 **고객 프로필** 권한을 할당하세요. + **보기**: 에이전트가 고객 프로필 애플리케이션을 볼 수 있습니다. 다음과 같은 작업이 가능합니다. + 에이전트 앱에 자동으로 채워지는 프로필을 봅니다. + 프로필을 검색합니다. + 고객 프로필에 저장된 세부 정보(예: 이름, 주소)를 볼 수 있습니다. + 다음 이미지와 같이 고객 응대 레코드를 프로필에 연결합니다. ![\[에이전트 Workspace의 고객 프로필 탭, 연결 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-associate.png) + **편집**: 에이전트가 고객 프로필의 세부 정보를 편집할 수 있습니다(예: 주소 변경). 이들은 기본적으로 **보기** 권한을 상속합니다. + **생성**: 에이전트가 새 프로필을 생성하고 저장할 수 있습니다. 기본적으로 **보기** 권한은 상속되지만 **편집** 권한은 상속되지 않습니다. 기존 보안 프로필에 권한을 추가하는 방법에 대한 자세한 내용은 [Amazon Connect에서 보안 프로필 업데이트](update-security-profiles.md) 섹션을 참조하세요. 기본적으로 **관리자** 보안 프로필에는 모든 고객 프로필 활동을 수행할 수 있는 권한이 이미 있습니다. # 흐름에 대한 Customer Profiles 권한 업데이트 1. 보안 프로필 페이지로 이동하여 편집하려는 보안 프로필을 선택하거나 **새 보안 프로필 추가**를 선택합니다. ![\[보안 프로필 페이지입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png) 1. Customer Profiles에 대한 **보기** 권한을 선택합니다. ![\[보안 프로필 페이지에서 보기 권한을 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-2.png) 1. **저장**을 선택합니다. 이제 **사용자 관리** 섹션으로 이동하여 원하는 사용자에게 이 보안 프로필을 제공할 수 있습니다. # Amazon Connect Customer Profiles에서 계산된 속성에 대한 권한 업데이트 1. 보안 프로필 페이지로 이동하여 편집하려는 보안 프로필을 선택하거나 **새 보안 프로필 추가**를 선택합니다. ![\[보안 프로필 페이지입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png) 1. 계산된 속성에 대해 **모두** 또는 **보기**, **편집**, **생성** 및 **삭제** 권한을 선택합니다. ![\[보안 프로필 콘솔에서 보기, 편집, 생성, 삭제 권한을 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/security-profile-customer-profile-calc-attribs-2.png) 1. **저장**을 선택합니다. 이제 **사용자 관리** 섹션으로 이동하여 원하는 사용자에게 이 보안 프로필을 제공할 수 있습니다. # 보안 프로필 권한을 할당하여 고객 세그먼트 관리 사용자의 보안 프로필에 필요한 경우 다음 고객 세그먼트 권한을 할당합니다. 보안 프로필에 대한 자세한 내용은 [Amazon Connect 및 연락 제어판(CCP) 액세스를 위한 보안 프로필](connect-security-profiles.md) 섹션을 참조하세요. 1. 보안 프로필 페이지로 이동하여 편집하려는 보안 프로필을 선택하거나 **새 보안 프로필 추가**를 선택합니다. ![\[보안 프로필 페이지, Customer Profiles 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-1.png) 1. 고객 세그먼트에 대한 **모든** 또는 **보기**, **생성**, **삭제** 및 **내보내기** 권한을 선택합니다. ![\[고객 세그먼트 권한은 모두로 설정됩니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-2.png) 1. **저장**을 선택합니다. 이제 **사용자 관리** 섹션으로 이동하여 원하는 사용자에게 이 보안 프로필을 제공할 수 있습니다. # 오류가 발생할 경우 새 Customer Profiles 권한 할당 1. 백엔드 APIs에 대해 403 금지 호출 오류가 발생하는 경우 권한을 업데이트하려면 Amazon Connect Customer Profiles 콘솔의 도메인 섹션으로 이동하여 **세부 정보 보기를** 선택합니다. ![\[Amazon Connect Customer Profiles 콘솔의 도메인 섹션입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-1.png) 1. 도메인 세부 정보 보기 섹션에서 **권한 업데이트**를 선택합니다. ![\[업데이트해야 하는 권한이 있는 경우 여기에 권한 업데이트 버튼이 표시됩니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-2.png) 1. 이 작업이 완료된 후에는 권한이 성공적으로 업데이트되며 도메인 세부 정보 섹션에 **권한 업데이트** 버튼이 더 이상 표시되지 않습니다. 이렇게 하면 403 금지 오류 문제가 완화되고 API 직접 호출을 성공적으로 수행할 수 있습니다. ![\[작업이 성공적으로 완료된 후에는 권한 업데이트 버튼이 사라집니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-3.png) # Amazon Connect Customer Profiles 데이터 만료 지정된 시간 내에 프로필이 업데이트되지 않은 경우 프로필이 만료됩니다. 이렇게 하면 프로파일이 정리되고 Customer Profiles 도메인에서 제거됩니다. Customer Profiles 데이터 만료 시간은 두 가지 범주로 나눌 수 있습니다. ## CreateProfile을 통해 생성된 프로필 `CreateProfile` API를 사용하여 생성된 프로필은 Customer Profiles 도메인에서 **DefaultExpirationDays**가 할당한 타임스탬프에 따라 만료됩니다. 만료가 구성되지 않은 경우 기본값은 365일입니다. ## PutProfileObject를 통해 생성되거나 업데이트된 프로필 를 사용하여 생성하거나 업데이트한 프로필`PutProfileObject`은 항상 연결된 객체 유형에 정의된 **ExpirationDays**를 준수합니다. 객체 유형에 만료가 정의되지 않은 경우 Customer Profiles 도메인 만료 날짜가 사용됩니다. 마지막으로 둘 다 제공되지 않으면 프로필 또는 프로필 객체가 기본 365일로 만료됩니다. ## 시각화된 정신 모델 ![\[Customer Profiles의 만료 로직을 보여 주는 흐름도입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-expiration-model.png) ## 프로필 만료 가져오기 세그먼트 가져오기를 사용하여 프로파일을 Customer Profile 도메인으로 가져온 경우 만료는 두 가지 시나리오로 나뉩니다. 1. **CreateUploadJob을 직접적으로 호출할 때 만료에 대한 명시적 정의** 기본적으로 세그먼트 가져오기를 사용하여 가져온 프로필은 업데이트가 수행되지 않은 경우 14일 후에 만료됩니다. 이 번호는 API를 사용하거나 가져오기 생성 중에 Amazon Connect 관리자 웹 사이트 내에서 최대 90일로 [정의할 수 있습니다](customer-segments-imported-files.md#set-profile-expiry). 1. **이전 가져오기 작업에서 Customer Profiles 도메인 내에 이미 있는 프로파일 가져오기** 두 개의 가져오기 작업이 실행되었고 중복 프로필이 발견된 경우 고객 프로필은 항상 가장 긴 만료 시간을 준수합니다. # Amazon Connect에서 Identity Resolution을 사용하여 유사한 프로필 통합 비슷한 프로필이란 두 개 이상의 프로필이 동일한 고객에 대한 것으로 확인되는 경우를 말합니다.** 동일한 고객에 대해 여러 채널 및 애플리케이션에서 고객 레코드가 캡처되고, 이러한 고객 레코드가 공통된 고유 식별자를 공유하지 않는 경우 프로필이 여러 개 있을 수 있습니다. 자격 증명 확인은 유사한 프로필을 자동으로 찾아 통합할 수 있도록 도와줍니다. 매주 자격 증명 확인 작업을 실행하여 다음 단계를 수행합니다. 1. [자동 프로필 매칭](how-identity-resolution-works.md#auto-profile-matching) 1. 통합 기준에 따라 [유사한 프로필을 자동으로 병합](how-identity-resolution-works.md#auto-profile-merging) 자격 증명 확인 작업이 실행될 때마다 **Customer Profiles** 페이지에 지표가 표시됩니다. 지표에는 검토한 프로필 수, 찾은 매칭 그룹 수, 통합된 프로필 수가 표시됩니다. 자격 증명 확인을 활성화하는 경우 추가 요금이 적용될 수 있습니다. 자세한 내용은 [Amazon Connect 요금](https://aws.amazon.com/connect/pricing/)을 참조하세요. ![\[Amazon Connect Customer Profiles 페이지, 자격 증명 확인 활성화 버튼\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-ir.png) # Amazon Connect Customer Profiles 도메인의 Identity Resolution 활성화 **중요** Amazon Connect 에이전트 Workspace를 사용할 때 사례는 Amazon Connect Customer Profiles 자격 증명 확인과 완전히 호환되지 않습니다. 프로필이 병합될 때 기존 사례는 다음과 같습니다. 병합 후에도 사례는 원래 프로필 ID에 연결된 상태로 유지됩니다. 사례는 병합된 프로필 간에 자동으로 통합되지 않습니다. 기존 사례를 다른 프로필에 다시 연결하는 지원되는 방법은 없습니다. 사례를 수동으로 통합해야 하는 경우 [CreateCase](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html) 및 [CreateRelatedItem](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateRelatedItem.html)을 해결 방법으로 사용합니다. 자격 증명 확인을 활성화하는 경우 다음 정보를 지정할 수 있습니다. + 먜주 자격 증명 확인 작업이 실행되어야 하는 시점. 자격 증명 확인은 기본적으로 토요일 오전 12시(UTC)에 실행됩니다. + 자격 증명 확인 작업이 자동 프로필 매칭 프로세스의 결과를 기록해야 하는 Amazon S3 버킷. S3 버킷이 없는 경우 활성화 프로세스 중에 S3 버킷을 생성할 수 있습니다. Amazon S3 버킷을 쿼리하거나 [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html) API를 사용하여 [신뢰도 점수](how-identity-resolution-works.md#confidence-score)를 기준으로 결과를 필터링할 수 있습니다. 자격 증명 확인을 활성화하면 선택 사항인 자동 병합 프로세스에 대한 [통합 기준을 생성](create-consolidation-criteria.md)하는 옵션이 표시됩니다. **자격 증명 확인을 활성화하려면** 1. 인스턴스에서 Customer Profiles 도메인이 활성화되어 있어야 합니다. 지침은 [Amazon Connect 인스턴스에 Customer Profiles 활성화](enable-customer-profiles.md) 섹션을 참조하세요. 1. 탐색 창에서 **고객 프로필**을 선택합니다. 1. **자격 증명 확인** 섹션에서 **자격 증명 확인 활성화**를 선택합니다. ![\[Amazon Connect Customer Profiles 페이지, 자격 증명 확인 활성화 버튼\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-ir.png) 1. **자격 증명 확인** 팝업 상자에서 **자격 증명 확인 활성화**를 선택합니다. ![\[Amazon Connect Customer Profiles 페이지, 자격 증명 확인 활성화 버튼\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-ir-2.png) 1. **자격 증명 확인 활성화** 페이지에서 자격 증명 확인 작업을 실행할 날짜 및 시간을 지정합니다. 1. Amazon S3 버킷에서 매칭되는 프로필 ID를 검토하려면 **Amazon S3에 매칭되는 프로필 ID 작성**을 선택합니다. 그렇지 않으면 [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html) API를 사용하여 매칭되는 프로필을 검토할 수 있습니다. **참고** 병합을 자동 활성화하면 일치하는 프로필 ID가 수신되지 않습니다. 1. 자격 증명 확인 작업이 프로필 매칭을 작성해야 하는 Amazon S3 버킷을 지정합니다. 혼동된 대리자 보안 문제를 방지하기 위해 정책을 적용하는 것이 좋습니다. 자세한 내용과 샘플 정책은 [Amazon Connect Customer Profiles에 서비스 혼동된 대리자 예방](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service) 섹션을 참조하세요. 1. 완료되면 **자격 증명 확인 활성화**를 선택합니다. 자격 증명 확인을 활성화한 후에는 규칙 기반 매칭과 ML 기반 매칭이 모두 활성화됩니다. 자격 증명 확인 페이지에서 둘 중 하나 또는 둘 다를 비활성화할 수 있습니다. 자세한 내용은 [Amazon Connect Customer Profiles에서 Identity Resolution 확인 비활성화](disable-identity-resolution.md) 섹션을 참조하세요. 1. 자격 증명 확인을 위한 규칙 기반 매칭: 1. 새 도메인과의 규칙 기반 매칭을 활성화한 후 통합을 설정하고 통합이 실행되면 매칭이 즉시 시작됩니다. 1. 기존 도메인과의 규칙 기반 매칭을 활성화하면 1시간 이내에 매칭 프로세스가 시작됩니다. 1. 자격 증명 확인을 위한 ML 기반 매칭: 1. 자격 증명 확인을 활성화하면 24시간 내에 자격 증명 확인 작업이 처음으로 실행됩니다. **참고** 새 Customer Profiles 도메인에서 처음으로 자격 증명 확인 작업을 실행하기 전에 프로필 지표를 확인하여 프로필이 생성되었는지 확인하는 것이 좋습니다. 그렇지 않으면 매칭되는 결과가 없을 것입니다. 1. 매칭 프로필을 자동 병합하기 위한 통합 기준을 설정할 수 있습니다. 그렇다면 [Amazon Connect에서 Identity Resoultion을 위한 통합 기준 설정](create-consolidation-criteria.md) 섹션을 참조하세요. # Amazon Connect에서 Identity Resoultion을 위한 통합 기준 설정 **참고** Amazon Connect 관리 콘솔을 사용하여 통합 기준을 생성하는 옵션에 액세스하려면 [자격 증명 확인을 활성화](#create-consolidation-criteria)해야 합니다. 자격 증명 확인 작업에서 유사한 프로필이 발견되면 프로세스는 사용자가 지정한 통합 기준에 따라 해당 프로필을 통합 프로필로 자동 병합할 수 있습니다. 선택한 속성을 매칭 그룹에 있는 모든 유사한 프로필에서 비교하여 정확히 매칭되는지 확인합니다. 예를 들어, 기준의 속성으로 `email`을 지정하는 경우 매칭 그룹에서 `email address` 값이 정확히 같은 모든 유사 프로필이 통합 프로필로 병합됩니다. **작은 정보** 자체 병합 로직을 설정하려면 [MergeProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MergeProfiles.html) API를 사용하세요. ## 한도 [표준 프로필](standard-profile-definition.md)에서 원하는 속성을 선택하여 유사한 프로필을 비교할 수 있습니다. 예를 들어 전화번호, 이메일 주소, 이름은 물론 사용자 지정 속성도 선택할 수 있습니다. 최대로 지정할 수 있는 값은 다음과 같습니다. + 통합 기준 10개 + 기준당 속성 20개 ## 강력한 기준을 만들기 위한 팁 고유 프로필의 대상 지정을 개선하고 중복이 아닌 프로필을 통합하지 않으려면 다음 단계를 따르는 것이 좋습니다. + 고객을 고유하게 식별할 수 있지만 고객 간에 동일하지 않을 가능성이 높은 속성(예: 계좌번호 또는 정부 발급 ID의 한 형태)을 선택합니다. + 단일 속성 기준을 사용하지 않습니다. 여러 속성을 선택하여 속성 조합을 만듦으로써 대상 지정을 개선합니다. 예제: + **전화번호**와 함께 **이름**, **중간 이름**, **성**이 포함된 기준이 더 강력합니다. 비교 대상: + **전화번호**만 포함 또는 + **이름, 중간 이름, 성**의 조합만 포함 + 해당하는 경우 특정 속성 그룹 내의 모든 속성을 선택합니다. 예를 들어 이름을 사용하려면 관련 이름 속성(**이름, 중간 이름, 성**)을 모두 선택합니다. 회사 주소를 사용하려면 관련된 회사 주소 속성을 모두 선택합니다. + 고객을 고유하게 식별할 가능성이 높은 다음 속성 중 하나를 다른 속성과 조합하여 기준에 포함합니다. + 계좌 번호 + 전화번호 + 이메일 ## 자동 병합 기준 설정 방법 자동 병합에 대한 통합 기준을 설정하기 전에 [자동 병합 프로세스 작동 방식](how-identity-resolution-works.md#consolidation-criteria-how-it-works)을 검토하는 것이 좋습니다. 1. 자격 증명 확인을 활성화하면 **자격 증명 확인** 페이지에서 자동 병합 기준을 설정할 수 있는 옵션이 나타납니다. **통합 기준 생성**을 선택합니다. 1. **타임스탬프 누락** 대화 상자가 표시되는 경우 계속하기 전에 사용자 지정 객체 유형에 새 타임스탬프 속성을 추가하는 것이 좋습니다. [프로필 충돌의 타임스탬프 누락](#missing-timestamp-for-profile-conflicts)을(를) 참조하세요. 1. **프로필 충돌** 섹션에서 둘 이상의 레코드가 충돌하는 경우 프로필 충돌을 해결하는 방법을 선택합니다. 1. **통합 기준** 섹션에서 하나 이상의 기준을 생성합니다. 기준당 두 개 이상의 속성을 포함하는 것이 좋습니다. ## 프로필 충돌의 타임스탬프 누락 사용자 지정 객체 유형 매핑이 있는 경우 **타임스탬프 누락** 메시지가 표시됩니다. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) API를 사용하여 사용자 정의 객체 유형에 다음과 같은 새 속성을 추가합니다. + `Fields.sourceLastUpdatedTimestamp` + `sourceLastUpdatedTimestampFormat` 타임스탬프 속성을 지정하지 않은 경우 통합 기준을 계속 생성할 수 있지만, 레코드가 Customer Profiles에 수집된 시점의 기본 타임스탬프가 사용됩니다. 통합 기준을 생성하기 전에 새 속성을 추가하는 것이 좋습니다. 사용자 정의 객체 유형을 이미 정의한 상태에서 사용자 정의 객체 유형을 업데이트하려는 경우, 매주 예약된 채우기가 실행되어 기존 프로필이 `Fields.sourceLastUpdatedTimestamp`로 업데이트됩니다. 예약된 채우기에 옵트인하려면 1. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) API를 사용하여 사용자 지정 프로필 객체 유형을 업데이트합니다. 1. 사용자 지정 프로필 객체 유형을 업데이트한 후 [지원 티켓](https://console.aws.amazon.com/support/home)을 열면 채우기 일정이 예약됩니다. 예약된 채우기는 2022년 2월 말까지 실행됩니다. 또는 사용자 지정 객체 유형을 사용하는 도메인에 대해 가지고 있는 수집/커넥터를 삭제한 다음 다시 생성할 수 있습니다. 모든 데이터는 업데이트된 객체 유형을 사용하여 다시 수집되고, 여기에서 `Fields.sourceLastUpdatedTimestamp`가 구문 분석됩니다. ## 예: 샘플 기준이 적용되는 방법 이 예에는 다음과 같은 세 가지 기준이 있습니다. + **프로필 충돌 문제 해결**은 **마지막으로 업데이트된 타임스탬프 사용**으로 설정되어 있습니다. 즉, 두 필드의 값이 충돌하는 경우 자격 증명 확인은 마지막으로 업데이트된 타임스탬프를 사용하여 사용할 값을 결정합니다. + 기준 1: + 이름, 성 + 이메일 + 기준 2: + 전화번호 이러한 기준은 다음 프로필에 적용됩니다. + 프로필 A + John Doe[오전 **05:00**에 마지막으로 업데이트됨] + doefamily@anyemail.com[오전 **05:00**에 마지막으로 업데이트됨] + 555-555-5555[오전 **07:00**에 마지막으로 업데이트됨] + 프로필 B + John Doe[오전 **04:00**에 마지막으로 업데이트됨] + doefamily@anyemail.com[오전 **06:00**에 마지막으로 업데이트됨] + 555-555-555**6**[오전 *04:00*에 마지막으로 업데이트됨] + 프로필 C + **Jane** Doe[오전 **06:00**에 마지막으로 업데이트됨] + doefamily@anyemail.com[오전 **07:00**에 마지막으로 업데이트됨] + 555-555-5555[오전 **06:00**에 마지막으로 업데이트됨] 기준 1이 적용된 경우의 결과는 다음과 같습니다. + 프로필 A와 B가 병합됨 = 프로필 AB 그 결과 다음과 같은 프로필 AB가 생성됩니다. + John Doe[오전 **05:00**에 마지막으로 업데이트됨] + doefamily@anyemail.com[오전 **07:00**에 마지막으로 업데이트됨] + 555-555-555**5**[오전 **06:00**에 마지막으로 업데이트됨] 전화번호 간에 충돌이 있기 때문에 자격 증명 확인은 마지막 타임스탬프를 사용하여 555-555-555 번호를 선택합니다. 다음으로 기준 2가 적용됩니다. 결과는 다음과 같습니다. + 프로필 AB와 C가 병합됨 = 프로필 ABC 그 결과 다음과 같은 프로필 ABC가 생성됩니다. + **Jane** Doe[오전 **06:00**에 마지막으로 업데이트됨] + doefamily@anyemail.com[오전 **07:00**에 마지막으로 업데이트됨] + 555-555-555**5**[오전 **07:00**에 마지막으로 업데이트됨] 자격 증명 확인은 프로필 C의 이름, 성, 이메일을 사용합니다. 여기에 가장 최근의 타임스탬프가 있기 때문입니다. # Amazon Connect에서 Identity Resolution을 위한 기계 학습 Amazon Connect에서 Identity Resolution은 유사한 프로필을 자동으로 찾아 통합할 수 있도록 도와줍니다. 이 섹션의 주제는 자동 병합 프로세스의 일부로 중복된 프로필을 통합하도록 기계 학습 매칭을 설정하는 방법을 다룹니다. **Topics** + [기계 학습 자격 증명 확인의 작동 방식](how-identity-resolution-works.md) + [자격 증명 확인을 위한 기계 학습 설정](setup-machine-learning-matching.md) # Amazon Connect에서 기계 학습 Identity Resolution 작동 방식 이 주제에서는 자격 증명 확인이 자동 프로필 매칭을 수행하는 방법과 설정된 경우 유사한 프로필을 자동으로 병합하는 방법에 대해 설명합니다. ## 자동 프로필 매칭 자격 증명 확인은 유사한 프로필을 식별하기 위해 기계 학습을 사용하여 각 프로필의 다음과 같은 개인 식별 정보(PII) 속성을 검토합니다. + 이름: 이름, 중간 이름, 성을 포함하여 모든 이름의 유사성을 검토합니다. + 이메일: 개인 이메일과 비즈니스 이메일을 포함한 모든 이메일 주소의 유사성을 검토합니다. 이메일은 대소문자를 구분하지 않습니다. + 전화번호: 집 전화, 휴대폰, 업무용 전화 등 모든 전화번호 및 형식이 유사한지 검토합니다. + 주소: 회사 주소, 우편 주소, 배송 주소, 청구서 수신 주소 등 모든 주소 유형 및 형식이 유사한지 검토합니다. + 생년월일: 모든 생년월일 및 형식이 유사한지 검토합니다. 이 정보를 사용하여 비슷한 프로필로 구성된 매칭 그룹을 생성합니다. ### 매칭 그룹 매칭 그룹은 고객을 나타내는 모든 유사한 프로필로 구성됩니다. 각 매칭 그룹에는 다음 정보가 포함되어 있습니다. + 고객 응대를 나타내는 두 개 이상의 유사한 프로필로 구성된 그룹을 고유하게 식별하는 매칭 ID + 매칭 그룹의 프로필 ID 수 + 매칭 그룹과 관련된 신뢰도 점수 ### 신뢰도 점수 자동 매칭 프로세스가 실행된 후 S3 버킷을 쿼리하거나 [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html) API를 사용하여 신뢰도 점수를 기준으로 결과를 필터링할 수 있습니다. 예를 들어, 추가 검토를 위해 신뢰도가 높은 매칭 항목을 필터링할 수 있습니다. 신뢰도 점수는 0에서 1 사이의 숫자로, 매칭 그룹에 프로필을 할당할 때의 신뢰 수준을 나타냅니다. 점수가 1이면 정확히 매칭된다는 의미일 수 있습니다. ## 유사한 프로필 자동 병합 프로필이 매칭되면 자격 증명 확인 작업에서 기준에 따라 유사한 프로필을 선택적으로 병합할 수 있습니다. 기준을 삭제하거나 업데이트하면 업데이트된 기준이 다음 실행 시 유사한 프로필에 적용됩니다. **중요** 통합 프로세스는 취소할 수 없습니다. 자격 증명 확인 작업을 실행하기 전에 [GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html) API를 사용하여 자동 병합 프로세스를 시험적으로 실행하는 것이 좋습니다. **참고** 두 프로필을 병합할 때 API 직접 호출을 통해 수동으로 채워진 프로필 필드 또는 에이전트 Workspace는 통합 또는 사용자 지정 객체 유형 매핑에서 자동으로 수집되는 프로필 필드로 덮어쓰지 않습니다. 예를 들어, 에이전트 Workspace의 에이전트가 FirstName ‘John’으로 프로필을 수동으로 생성한다고 가정해 보겠습니다. FirstName ‘Peter’와의 S3 통합을 사용하여 다른 프로필이 생성됩니다. 이러한 프로필이 자동으로 병합되면 FirstName ‘John’이 보존됩니다. ### 자동 병합 프로세스 작동 방식 + **통합 기준에서 선택한 모든 속성은 병합 전에 정확한 값 비교를 통해 `AND` 기준으로 연결됩니다**. + 예를 들어, `email address` 및 `phone number`와 같이 기준에 여러 속성을 지정하면 매칭 그룹에서 동일한 `email address` 값과 `phone number` 값을 가진 모든 유사한 프로필이 병합됩니다. + 매칭 그룹에서 하나 이상의 유사 프로필에 기준에 있는 하나 이상의 속성에 대해 값이 다르거나 누락된 경우 유사한 프로필이 병합됩니다. 예를 들어, 한 매칭 그룹에 다섯 개의 유사한 프로필이 있는데 그중 세 개의 프로필이 기준을 충족하기 때문에 통합될 수 있습니다. 나머지 두 프로필은 기준을 충족하지 않으므로 병합되지 않습니다. + **여러 기준은 기준 1부터 우선 순위에 따라 평가됩니다**. + 통합 기준이 적용되는 순서입니다. 우선 순위가 가장 높은 기준 1부터 시작하여 기준 10이 가장 낮은 우선 순위를 갖습니다. + 자격 증명 확인 작업은 한 가지 기준을 적용한 후 통합 프로필과 매칭 그룹의 나머지 유사 프로필에 다음 기준을 적용합니다. + 최대 10개의 통합 기준을 설정할 수 있습니다. + **각 기준은 독립적으로 실행되며 다른 기준과 `OR`로 작동됩니다.**. + 기준이 여러 개인 경우 자격 증명 확인이 다음 기준으로 넘어가기 전에 각 기준이 개별적으로 우선 순위에 따라 적용됩니다. + 모든 기준은 나열한 순서대로 적용됩니다. 기준이 실패했든, 매칭 그룹에서 유사한 프로필을 성공적으로 통합했든 상관없습니다. + **기본적으로 프로필 충돌은 최신성을 기준으로 관리됩니다**. + 매칭 그룹에 있는 두 개 이상의 유사한 프로필이 통합 기준을 충족하는 경우, 유사한 프로필을 구성하는 프로필 속성의 각 값을 비교하여 통합 프로필이 생성됩니다. + 각 속성의 값이 정확히 일치할 수 있습니다. 이 경우 해당 속성에 대해 임의의 값을 선택할 수 있습니다. + 두 개 이상의 구성 유사 프로필의 값이 충돌하는 경우 가장 최근에 업데이트된 속성이 선택됩니다. 예를 들어 Jane Doe가 유사한 프로필을 구성하는 `Address` 속성에 서로 다른 세 가지 값을 가지고 있는 경우, 자격 증명 확인은 가장 최근 주소를 선택하여 통합 프로필을 생성합니다. + 기본적으로 **최근 업데이트된 타임스탬프**는 가장 최근에 업데이트된 레코드를 확인하는 데 사용됩니다. + **프로필 충돌은 소스 객체 유형 및 최신성에 따라 관리됩니다**. + 특정 소스를 충돌 해결에 반영하기 위한 정보원으로 하여 구성이 비슷한 프로필을 선택하도록 충돌 해결의 기본 동작을 변경할 수도 있습니다. + 프로필 충돌에 사용할 데이터 소스를 지정하려는 경우, **마지막으로 업데이트된 타임스탬프가 있는 소스**를 선택하면 객체 유형 중 하나를 데이터 소스로 선택할 수 있습니다. + 지정된 객체 유형에서 가장 최근에 업데이트된 레코드가 프로필 충돌을 해결하는 데 사용됩니다. + **마지막으로 업데이트된 타임스탬프는 가장 최근에 업데이트된 레코드를 식별합니다**. + 소스 레코드의 객체 유형과 관련된 타임스탬프 속성은 가장 최근에 업데이트된 레코드를 식별하는 데 사용됩니다. + 객체 유형에 타임스탬프 속성을 사용할 수 없는 경우 Customer Profiles 도메인에 레코드가 수집된 타임스탬프가 사용됩니다. + 사용자 지정 객체 유형이 있는 경우 타임스탬프를 추가해야 합니다. 자세한 정보는 [프로필 충돌의 타임스탬프 누락](create-consolidation-criteria.md#missing-timestamp-for-profile-conflicts)을 참조하세요. + **통합은 단방향 프로세스이므로 취소할 수 없습니다**. + 통합 프로세스를 시작하기 전에 기준을 신중하게 선택하세요. 자세한 내용은 [강력한 기준을 만들기 위한 팁](create-consolidation-criteria.md#tips-for-creating-consolidation-criteria) 섹션을 참조하세요. + [GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html) API를 사용하면 데이터를 병합하지 않고도 자격 증명 확인의 자동 병합 설정을 테스트할 수 있습니다. 기준 적용 방법을 보여 주는 예제는 [예: 샘플 기준이 적용되는 방법](create-consolidation-criteria.md#criteria-examples) 섹션을 참조하세요. # Amazon Connect에서 Identity Resoultion을 위한 기계 학습 설정 ## 기계 학습 매칭 실행 일정 편집 ![\[기계 학습 매칭 실행 일정을 편집합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/machine-learning-ir-edit-run-schedule.png) ## 기계 학습 병합 매칭 편집 ![\[기계 학습 병합 매칭을 편집합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/machine-learning-ir-edit-merge-matches.png) ## 기계 학습 매칭 위치 편집 ![\[기계 학습 매칭 위치를 편집합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/machine-learning-ir-edit-match-location.png) # Amazon Connect에서 Identity Resoultion을 위한 규칙 기반 매칭 Amazon Connect에서 Identity Resoultion은 유사한 프로필을 자동으로 찾아 통합할 수 있도록 도와줍니다. 이 섹션의 주제에서는 자동 병합 프로세스의 일부로 중복 프로필을 통합하도록 규칙 기반 Identity Resoultion을 설정하는 방법을 설명합니다. **Topics** + [규칙 기반 자격 증명 확인의 작동 방식](how-rule-based-identity-resolution-works.md) + [자격 증명 확인을 위한 규칙 기반 매칭 설정](setup-rule-based-matching.md) + [규칙 기반 자격 증명 확인을 위한 매칭 규칙 설정](setup-matching-rule-examples.md) # Amazon Connect에서 규칙 기반 Identity Resoultion의 작동 방식 이 주제에서는 규칙 기반 자격 증명 확인이 자동 프로필 매칭을 수행하는 방법과 유사한 프로필을 자동으로 병합하는 방법에 대해 설명합니다. ## 자동 프로필 매칭 유사한 프로필을 식별하기 위해 규칙 기반 자격 증명 확인은 [매칭 규칙 속성](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html) 목록을 사용하여 각 프로필을 매칭합니다. [MatchingRules](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html#customerprofiles-Type-RuleBasedMatchingRequest-MatchingRules)에서는 최대 15개의 MatchingRule 속성이 지원됩니다. ### 매칭 규칙 다음은 사용할 수 있는 [MatchingRule](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html) 속성 목록입니다. 최대 15개의 매칭 규칙 수준을 구성할 수 있습니다. 각 매칭 규칙에서 각 프로필의 다음과 같은 개인 식별 정보(PII) 속성을 사용할 수 있습니다. + **AccountNumber** + **Address.Address**: Address, BusinessAddress, MaillingAddress 및 ShippingAddress 등 [속성 유형 선택기](#rule-based-attribute-type-selector)에 명시된 모든 주소가 유사한지 검토합니다. + **Address.City**: Address, BusinessAddress, MaillingAddress 및 ShippingAddress 등 [속성 유형 선택기](#rule-based-attribute-type-selector)에 명시된 모든 주소가 유사한지 검토합니다. + **Address.Country**: Address, BusinessAddress, MaillingAddress 및 ShippingAddress 등 [속성 유형 선택기](#rule-based-attribute-type-selector)에 명시된 모든 주소가 유사한지 검토합니다. + **Address.Country**: Address, BusinessAddress, MaillingAddress 및 ShippingAddress 등 [속성 유형 선택기](#rule-based-attribute-type-selector)에 명시된 모든 주소가 유사한지 검토합니다. + **Address.PostalCode**: Address, BusinessAddress, MaillingAddress 및 ShippingAddress 등 [속성 유형 선택기](#rule-based-attribute-type-selector)에 명시된 모든 주소가 유사한지 검토합니다. + **Address.State**: Address, BusinessAddress, MaillingAddress 및 ShippingAddress 등 [속성 유형 선택기](#rule-based-attribute-type-selector)에 명시된 모든 주소가 유사한지 검토합니다. + **Address.Province**: Address, BusinessAddress, MaillingAddress 및 ShippingAddress 등 [속성 유형 선택기](#rule-based-attribute-type-selector)에 명시된 모든 주소가 유사한지 검토합니다. + **PhoneNumber**: PhoneNumber, HomePhoneNumber 및 MobilePhoneNumber 등 [속성 유형 선택기](#rule-based-attribute-type-selector)에 명시된 모든 전화번호가 유사한지 검토합니다. + **EmailAddress**: EmailAddress, BusinessEmailAddress, and PersonalEmailAddress 등 [속성 유형 선택기](#rule-based-attribute-type-selector)에 명시된 모든 이메일 주소가 유사한지 검토합니다. + **BirthDate** + **BusinessName** + **FirstName** + **LastName** + **MiddleName** + **Gender** + ***Attributes* 접두사가 있는 모든 사용자 지정 프로필 속성** 매칭 규칙은 우선 순위에 따라 처리됩니다. 예를 들어 첫 번째 규칙은 정의하려는 규칙 중 가장 최적화된 규칙이어야 하며 가장 정확한 결과를 얻기 위해 사용해야 합니다. ### 속성 유형 선택기 속성 유형 선택기에는 규칙 기반 자격 증명 확인에 필요한 중요한 구성 정보가 들어 있어 프로필 매칭을 용이하게 합니다. 이를 통해 속성 유형 간의 프로필 비교를 세밀하게 조정하고 각 유형 내에서 매칭할 주요 속성을 선택할 수 있습니다. 이 기능 내에서 세 가지 고유한 속성 유형을 유연하게 구성할 수 있으므로 매칭 프로세스를 정밀하게 제어할 수 있습니다. + **Email 유형** + EmailAddress, BusinessEmailAddress 및 PersonalEmailAddress 중에서 선택할 수 있습니다. + **PhoneNumber 유형** + PhoneNumberNumber, HomePhoneNumber 및 MobilePhoneNumber 중에서 선택할 수 있습니다. + **Address 유형** + Address, BusinessAddress, MaillingAddress 및 ShippingAddress 중에서 선택할 수 있습니다. AttributeMatchingModel로 `ONE_TO_ONE` 또는 `MANY_TO_MANY`를 선택할 수 있습니다. `MANY_TO_MANY`를 선택하면 시스템은 속성 유형의 하위 유형 전반에서 속성을 매칭할 수 있습니다. 예를 들어 프로필 A의 EmailAddress 필드 값과 프로필 B의 BusinessEmailAddress 필드 값이 매칭되면 EmailAddress 유형에서 두 프로필이 매칭됩니다. `ONE_TO_ONE`을 선택하면 시스템은 하위 유형이 정확히 매칭되는 경우에만 매칭할 수 있습니다. 예를 들어 프로필 A의 EmailAddress 필드 값과 프로필 B의 EmailAddress 필드 값이 매칭될 때만 EmailAddress 유형에서 두 프로필이 매칭됩니다. **매칭에 허용되는 최대 규칙 수준** 유사한 프로필을 매칭하는 데 사용할 최대 규칙 수준을 구성할 수 있습니다. 예를 들어 매칭에 허용되는 최대 규칙 수준이 5인 경우 시스템은 규칙 수준 6을 사용하여 유사한 프로필을 찾지 못합니다. ### 매칭 그룹 매칭 그룹은 고객을 나타내는 모든 유사한 프로필로 구성됩니다. 각 매칭 그룹에는 다음 정보가 포함되어 있습니다. + 고객 응대를 나타내는 두 개 이상의 유사한 프로필로 구성된 그룹을 고유하게 식별하는 매칭 ID + 매칭 그룹의 프로필 ID 수 ### 매칭 상태 + **PENDING** 규칙 기반 매칭 규칙을 구성한 후의 첫 번째 상태입니다. 기존 도메인인 경우 규칙 기반 자격 증명 확인은 1시간 정도 기다린 후 매칭 규칙을 생성합니다. 새 도메인인 경우 시스템은 **PENDING** 단계를 건너뛰게 됩니다. + **IN\$1PROGRESS** 시스템에서 규칙 기반 매칭 규칙을 만들고 있습니다. 이 상태에서는 시스템이 기존 데이터를 평가하고 있으므로 규칙 기반 매칭 구성을 더 이상 변경할 수 없습니다. + **ACTIVE** 규칙을 사용할 준비가 되었습니다. 상태가 **ACTIVE** 상태가 된 후 하루 후에 규칙을 변경할 수 있습니다. ### 자동 매칭 프로세스 작동 방식 규칙 기반 매칭 규칙을 사용하여 새 Amazon Connect Customer Profiles 도메인을 생성하고 나면, 규칙 기반 자격 증명 확인은 프로필을 수집하는 동안 지정한 규칙을 기반으로 유사한 프로필을 매칭합니다. 규칙 기반 매칭의 구성을 업데이트하면 한 시간 내에 Customer Profiles가 새 구성을 사용하여 도메인의 프로필을 재평가하기 시작합니다. 기존 도메인과의 규칙 기반 매칭을 활성화하면 시스템이 **PENDING** 상태로 전환되고 한 시간 내에 새 구성을 사용하여 도메인의 기존 프로필을 평가하기 시작합니다. 프로필 평가를 완료하는 데 걸리는 시간은 존재하는 프로필 수에 따라 달라집니다. + **사용자 지정 규칙을 지정하지 않은 경우 기본적으로 기본 규칙이 적용됩니다.** + 사용자 지정 매칭 규칙을 제공하지 않는 경우 Amazon Connect Customer Profiles는 기본 매칭 규칙을 제공합니다. 여기에서 사용자 지정 매칭 규칙을 확인할 수 있습니다. + **모든 레코드는 규칙 기반 매칭 규칙을 거칩니다.** + 시스템은 매칭 항목이 식별될 때까지 또는 매칭에 허용되는 최대 규칙 수준에 도달할 때까지 각 일치 규칙 수준을 평가합니다. 평가 프로세스는 레코드가 분석되는 규칙 수준 1에서 시작됩니다. 매칭 그룹이 발견되지 않은 경우 시스템은 매칭 항목이 발견되거나 매칭에 대해 허용된 최대 규칙 수준에 도달할 때까지 매칭 그룹을 검색하여 후속 규칙 수준을 평가합니다. + **단일 매칭 규칙 수준의 모든 속성은 *AND* 관계를 사용하여 연결됩니다.** + 단일 규칙 수준 내에 여러 속성이 있는 경우 이들 속성은 AND 관계로 상호 연결됩니다. 프로필 매칭 중에 프로필이 동일한 매칭 그룹에 할당되려면 모든 속성 값이 일치해야 합니다. 예를 들어, 모든 속성의 값이 동일한 경우에만 프로필이 매칭되는 것으로 간주되고 추가 처리를 위해 함께 그룹화됩니다. + **속성 유형 선택기의 모든 속성은 *OR* 관계로 연결됩니다.** + 속성 유형 선택기 내에서 속성을 지정하는 경우 동일한 유형의 속성이 OR 관계를 통해 연결됩니다. 예를 들어, HomePhoneNumber 및 BusinessPhoneNumber가 사용되는 PhoneNumber 유형을 생각해 보세요. 이 시나리오에서는 두 프로필의 HomePhoneNumber 또는 BusinessPhoneNumber가 일치하면 두 프로필이 매칭될 수 있습니다. 따라서 매칭 프로세스를 통해 집 또는 회사 전화번호를 기반으로 유연하게 매칭할 수 있습니다. + **매칭 결과는 최종적으로 최적화됩니다.** + 시스템의 프로필 매칭은 거의 실시간에 가깝기 때문에 프로필의 매칭 그룹이 더 낮은(덜 최적화된) 규칙 수준에서 검색될 수 있습니다. 하지만 더 높은(더 최적화된) 규칙 수준에 매칭 항목이 있는 경우 시스템은 해당 특정 그룹에 프로필을 할당합니다. **참고** 자격 증명 확인이 규칙 기반 매칭을 수행할 때 구성한 규칙이 처리되는 순서는 데이터 수집 방식에 따라 달라집니다. 예를 들어 규칙 1과 2를 구성하면 규칙 2가 규칙 1보다 먼저 처리될 수 있습니다. 처리 순서는 변경될 수 있지만 최종 결과는 항상 같습니다. ## 유사한 프로필 자동 병합 프로필이 매칭되면 자격 증명 확인 작업은 규칙 기반 매칭 구성에서 지정한 [MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html)를 기반으로 유사한 프로필을 선택적으로 병합할 수 있습니다. **중요** 통합 프로세스는 취소할 수 없습니다. ListMatches 및 GetSimiliarProfiles API를 사용하여 매칭 결과를 평가하려면 먼저 매칭만을 켜는 것이 좋습니다. [UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html) API를 사용하여 [MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html)을 설정하면 병합을 켤 수 있습니다. **참고** 두 프로필을 병합할 때 API 직접 호출을 통해 수동으로 채워진 프로필 필드 또는 에이전트 Workspace는 통합 또는 사용자 지정 객체 유형 매핑에서 자동으로 수집되는 프로필 필드로 덮어쓰지 않습니다. 예를 들어, 에이전트 Workspace의 에이전트가 FirstName ‘John’으로 프로필을 수동으로 생성한다고 가정해 보겠습니다. FirstName ‘Peter’와의 S3 통합을 사용하여 다른 프로필이 생성됩니다. 이러한 프로필이 자동으로 병합되면 FirstName ‘John’이 보존됩니다. # Amazon Connect에서 Identity Resolution을 위한 규칙 기반 매칭 설정 이 주제에서는 규칙 기반 매칭 속성 유형, 규칙 기반 매칭 규칙, 규칙 기반 매칭 병합 규칙 및 규칙 기반 매칭 위치를 편집하는 데 사용하는 단계를 설명하는 설명을 제공합니다. 또한 규칙 기반 매칭 규칙을 재설정하는 방법도 보여 줍니다. ## 규칙 기반 매칭 속성 유형 편집 ![\[규칙 기반 매칭 속성 유형을 편집합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/rule-based-edit-attribute-types.png) ## 규칙 기반 매칭 규칙 편집 ![\[규칙 기반 매칭 규칙을 편집합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/rule-based-edit-matching-rules.png) ## 규칙 기반 매칭 규칙 재설정 ![\[규칙 기반 매칭 규칙을 재설정합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/rule-based-edit-reset-rules.png) ## 규칙 기반 매칭 병합 규칙 편집 ![\[규칙 기반 매칭 병합 규칙 편집\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/rule-based-edit-merge-rules.png) ## 규칙 기반 매칭 위치 편집 ![\[규칙 기반 매칭 위치를 편집합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/rule-based-match-location.png) # Amazon Connect에서 규칙 기반 Identity Resolution을 위한 매칭 설정 ## 한도 표준 프로필에서 원하는 속성을 선택하여 유사한 프로필을 비교할 수 있습니다. 예를 들어 전화번호, 이메일 주소, 이름은 물론 사용자 지정 속성도 선택할 수 있습니다. 다음과 같은 제한이 있는 규칙 기반 매칭 규칙을 생성할 수 있습니다. + 규칙 수준 15개 + 각 규칙 수준은 최대 15개의 프로필 속성을 포함할 수 있습니다. ## 팁 고유 프로필의 대상 지정을 개선하고 중복이 아닌 프로필을 통합하지 않으려면 다음 팁을 따르는 것이 좋습니다. + 전화번호, 이메일 주소 또는 계좌번호와 같이 고객을 고유하게 식별할 수 있으며 고객 간에 동일하지 않을 가능성이 높은 속성, 즉 카디널리티가 높은 특성을 하나 이상 포함합니다. + 카디널리티 가 높은 속성 없이 서로 다른 자격 증명에 속할 수 있는 프로필 속성은 사용하지 않습니다. + **이름**, **성**의 조합만 포함된 규칙보다 **전화번호**와 함께 **이름**, **성**이 포함된 규칙이 더 강력합니다. + 한 규칙 수준에서 해당 규칙의 모든 프로필 속성이 낮은 카디널리티 속성(500개 이상의 서로 다른 프로필에 속할 수 있는 속성)인 경우 Customer Profiles는 프로필 매칭을 시도하지 않습니다. 도메인 생성 중에 이러한 규칙 수준을 설정하면 DLQ에 다음과 같은 SQS 메시지를 받게 됩니다. + 규칙 수준 x의 모든 속성이 500개 이상의 레코드와 연결됩니다. + 항상 **매칭만**을 먼저 활성화하고, 매칭 결과를 확인하고, 매칭 결과에 만족하는 경우에만 **MaxAllowedRuleLevelForMerging**을 설정하여 병합을 활성화하세요. ## 프로필 병합을 위한 프로필 충돌 문제 해결 두 개 이상의 유사한 프로필의 속성 값이 서로 다른 경우(예: 주소 레코드 충돌) 사용할 레코드를 정의할 수 있습니다. **마지막으로 업데이트된 타임스탬프** 기본적으로 프로필 충돌은 최신성을 기준으로 관리됩니다. 두 개 이상의 유사 프로필의 값이 충돌하는 경우 가장 최근에 업데이트된 속성이 선택됩니다. **마지막으로 업데이트된 타임스탬프가 있는 소스** 프로필 충돌 관리를 위한 데이터 소스로 특정 객체 유형의 레코드에 우선 순위를 지정할 수 있습니다. 두 개 이상의 유사 프로필의 값이 충돌하는 경우 지정된 객체 유형에서 가장 최근에 업데이트된 속성이 선택됩니다. 객체 유형에 타임스탬프가 지정되지 않은 경우 레코드가 Customer Profiles에 수집된 날짜가 사용됩니다. 통합을 설정하지 않은 경우 마지막으로 업데이트된 타임스탬프가 있는 소스를 사용할 수 없습니다. 통합을 추가하면 객체 유형을 이 옵션의 소스로 사용할 수 있습니다. ## 프로필 충돌의 타임스탬프 누락 사용자 지정 객체 유형 매핑이 있는 경우 타임스탬프 누락 메시지가 표시됩니다. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) API를 사용하여 사용자 정의 객체 유형에 다음과 같은 새 속성을 추가합니다. + `Fields.sourceLastUpdatedTimestamp` + `sourceLastUpdatedTimestampFormat` 타임스탬프 속성을 지정하지 않은 경우 통합 기준을 계속 생성할 수 있지만, 레코드가 Customer Profiles에 수집된 시점의 기본 타임스탬프가 사용됩니다. 통합 기준을 생성하기 전에 새 속성을 추가하는 것이 좋습니다. 사용자 정의 객체 유형을 이미 정의한 상태에서 사용자 정의 객체 유형을 업데이트하려는 경우, 매주 예약된 채우기가 실행되어 기존 프로필이 `Fields.sourceLastUpdatedTimestamp`로 업데이트됩니다. 예약된 채우기를 옵트인하려면 다음 단계를 사용하세요. 1. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) API를 사용하여 사용자 지정 프로필 객체 유형을 업데이트합니다. 1. 사용자 지정 프로필 객체 유형을 업데이트한 후 [AWS Support 티켓](https://console.aws.amazon.com/support/home)을 엽니다. 1. AWS 는 사용자를 대신하여 채우기를 예약합니다. 예약된 채우기는 2022년 2월 말까지 실행됩니다. 또는 사용자 지정 객체 유형을 사용하는 도메인에 대해 가지고 있는 수집/커넥터를 삭제한 다음 다시 생성할 수 있습니다. 모든 데이터는 업데이트된 객체 유형을 사용하여 다시 수집되고, 여기에서 `Fields.sourceLastUpdatedTimestamp`가 구문 분석됩니다. ## 예: 매칭 작동 방식 ### ONE\$1TO\$1ONE의 예 `AttributeMatchingModel`로 `ONE_TO_ONE`을 선택할 수 있습니다. `ONE_TO_ONE`을 선택하면 시스템은 하위 유형이 정확히 매칭되는 경우에만 매칭할 수 있습니다. **예**: `EmailAddress` 및 `BusinessEmailAddress`를 사용하여 `EmailAddress` 유형을 나타냅니다. `AttributeMatchingModel`은 `ONE_TO_ONE`입니다. **매칭 규칙은 다음과 같습니다.** ``` Rule Level 1: EmailAddress, LastName, FirstName Rule Level 2: AccountNumber ``` ``` Profile A: EmailAddress: 1@email.com BusinessEmailAddress: john@company.com LastName: Doe FirstName: John AccountNumber: account1234 ``` ``` Profile B: EmailAddress: 2@email.com BusinessEmailAddress: john@company.com LastName: Doe FirstName: John AccountNumber: account1234 ``` `EmailAddress` 유형, `LastName` 및 `FirstName`이 매칭되므로 프로필 A와 프로필 B는 규칙 수준 1에서 매칭됩니다. ### MANT\$1TO\$1MANY의 예 `AttributeMatchingModel`로 `MANY_TO_MANY`를 선택할 수 있습니다. `MANY_TO_MANY`를 선택하면 시스템은 속성 유형의 하위 유형 전반에서 속성을 매칭할 수 있습니다. **예**: `EmailAddress` 및 `BusinessEmailAddress`를 사용하여 `EmailAddress` 유형을 나타냅니다. `AttributeMatchingModel`은 `MANY_TO_MANY`입니다. **매칭 규칙은 다음과 같습니다.** ``` Rule Level 1: EmailAddress, LastName, FirstName Rule Level 2: AccountNumber ``` ``` Profile A: EmailAddress: 1@email.com (match with Profile B’s BusinessEmailAddress) BusinessEmailAddress: john@company.com LastName: Doe FirstName: John AccountNumber: account1234 ``` ``` Profile B: EmailAddress: 2@email.com BusinessEmailAddress: 1@email.com (match with Profile A's EmailAddress) LastName: Doe FirstName: John AccountNumber: account1234 ``` `EmailAddress` 유형, `LastName` 및 `FirstName`이 매칭되므로 프로필 A와 프로필 B는 규칙 수준 1에서 매칭됩니다. # Amazon Connect Customer Profiles에서 Identity Resolution 지표 보기 자격 증명 확인이 프로필을 매칭하거나 병합할 때마다 프로세스에 대한 지표가 Customer Profiles 대시보드에 표시됩니다. **자격 증명 확인** 요약 페이지에서 지난주의 지표를 검토할 수 있습니다. 자격 증명 확인 작업이 실행될 때마다 다음과 같은 지표가 생성됩니다. + **찾은 매칭 그룹**: 검색된 매칭 그룹의 수입니다. + ML 기반 자격 증명 확인과 규칙 기반 자격 증명 확인 모두에 사용할 수 있습니다. + **병합된 프로필**: 병합된 프로필 수입니다. + ML 기반 자격 증명 확인과 규칙 기반 자격 증명 확인 모두에 사용할 수 있습니다. + **규칙별 매칭 그룹**: 각 규칙 수준에서 생성된 매칭 그룹 수입니다. + 규칙 기반 자격 증명 확인에만 사용할 수 있습니다. ![\[Amazon Connect Customer Profiles 페이지, 자격 증명 확인 활성화 버튼\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/ir-metrics-example-1.png) ![\[Amazon Connect Customer Profiles 페이지, 자격 증명 확인 활성화 버튼\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-ir.png) # Amazon Connect Customer Profiles에서 Identity Resolution 확인 비활성화 ## 기계 학습 기반 비활성화 유사한 프로필을 자동으로 찾지 않도록 하고 싶은 경우 기계 학습 기반 매칭을 비활성화할 수 있습니다. 통합 기준이 있는 경우 모든 기준이 삭제되고 프로필이 더 이상 자동으로 통합되지 않습니다. 이미 통합된 프로필은 통합된 상태로 유지됩니다. ## 규칙 기반 매칭 비활성화 유사한 프로필을 자동으로 찾지 않도록 하고 싶은 경우 규칙 기반 매칭을 비활성화할 수 있습니다. 사용자 지정 일치 규칙이 있는 경우 일치 규칙이 삭제되고 프로필이 더 이상 자동으로 통합되지 않습니다. 이미 통합된 프로필은 통합된 상태로 유지됩니다. # AWS Entity Resolution을 사용한 해결 Amazon Connect Customer Profiles는 AWS Entity Resolution에서 일치하는 결과를 직접 가져올 수 있는 *관리형 커넥터를* 제공합니다. 이 통합을 통해 Amazon Connect에서 고객 프로필을 유지하면서 AWS Entity Resolution의 강력한 매칭 기능을 활용할 수 있습니다. AWS Entity Resolution을 사용하면 규칙, 기계 학습 또는 타사 데이터 공급자를 비롯한 유연한 매칭 기술을 사용하여 다양한 데이터 소스에서 관련 레코드를 매칭하고 연결할 수 있습니다. 개체 확인 결과를 Customer Profiles에 연결하면 다음을 수행할 수 있습니다. + 여러 시스템의 고객 레코드를 보다 정확하게 통합 + 특정 비즈니스 요구 사항에 따라 정교한 매칭 로직 적용 + 다양한 애플리케이션 및 채널의 연결된 데이터로 고객 프로필 향상 + 조직 전체에서 일관된 고객 관점 유지 Customer Profiles에서 AWS Entity Resolution 사용을 시작하려면 먼저 AWS Entity Resolution 콘솔에서 일치하는 워크플로를 설정해야 합니다. [AWS Entity Resolution에 대해 자세히 알아봅니다](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-matching-workflow.html). 이를 설정하려면 다음 사전 조건이 필요합니다. + Customer Profiles가 활성화된 활성 Amazon Connect 인스턴스 + Amazon S3에 저장된 고객 데이터 + AWS Entity Resolution에 액세스할 수 있는 적절한 IAM 권한 **를 설정하려면 다음 단계를 따릅니다.** 1. Customer Profiles 도메인 생성 + 아직 생성하지 않은 경우 Connect 인스턴스에서 Customer Profiles 도메인을 생성합니다. + Amazon Connect 콘솔에서 Customer Profiles 섹션으로 이동합니다. + 참고: 도메인 생성 후 AWS Entity Resolution에 대한 새 섹션이 표시됩니다. 1. AWS 개체 확인 구성 + Customer Profiles 도메인에서 AWS Entity Resolution 섹션을 찾습니다. + "AWS Entity Resolution 설정"을 클릭합니다. + AWS Entity Resolution 콘솔로 리디렉션됩니다. + 일치하는 워크플로 생성 + S3 데이터 소스 구성 + 일치 기준 정의 + 일치하는 워크플로 검토 및 활성화 1. 개체 확인 결과를 Customer Profiles에 연결 + Customer Profiles 도메인으로 돌아가기 + Entity Resolution 워크플로 선택 + 일치하는 레코드를 통합하는 방법 구성 + 통합 활성화 # 외부 애플리케이션을 Amazon Connect Customer Profiles와 통합 Amazon Connect는 Amazon AppFlow와 Amazon EventBridge를 기반으로 하는 사전 구축된 통합 세트를 제공합니다. Amazon Connect Customer Profiles를 활성화한 후에는 이러한 통합을 사용하여 Salesforce 또는 Zendesk와 같은 외부 애플리케이션의 정보를 Amazon Connect의 고객 응대 기록과 결합할 수 있습니다. 이렇게 하면 에이전트가 고객과 상호 작용하는 동안 필요한 모든 정보를 한곳에서 확인할 수 있는 고객 프로필이 만들어집니다. Amazon AppFlow에서 Customer Profiles를 사용할 수도 있습니다. Amazon AppFlow는 `CustomerProfiles`를 대상으로 지원합니다. Amazon AppFlow API를 통해 `CustomerProfiles`를 대상 이름으로 사용해 Customer Profiles로 데이터를 전송할 수 있습니다. 시작하기 전에 먼저 고객 관리 키를 사용하고 있는지 확인하세요. KMS 키 구성에 대한 자세한 내용은 [Customer Profiles에서 데이터를 암호화하는 데 사용할 KMS 키 생성(필수)](enable-customer-profiles.md#enable-customer-profiles-awsmanagedkey) 섹션을 참조하세요. ## 통합 설정 아래에서 사용 사례에 가장 적합한 방법을 선택하여 Amazon Connect의 주요 애플리케이션 또는 Amazon AppFlow를 사용하는 외부 애플리케이션을 사용하여 통합을 설정할 수 있습니다. ServiceNow와 Slack 통합에 대한 자세한 내용은 [Amazon AppFlow를 사용하여 여러 소스의 데이터를 결합하고 고객 센터 에이전트를 위한 통합된 Amazon Connect 고객 프로필 구축](https://aws.amazon.com/blogs/contact-center/unified-customer-data/) 블로그 게시물을 참조하세요. **Topics** + [통합 설정](#setup-integrations-title-menu) + [Amazon Connect에서 추천 애플리케이션을 위한 통합 설정](integrate-customer-profiles-appflow.md) + [Amazon AppFlow를 사용하여 외부 애플리케이션에 대한 통합 설정](integrate-external-applications-appflow.md) + [Customer Profiles 삭제 또는 통합 중지](delete-customer-profile-connection.md) # Amazon Connect에서 추천 애플리케이션을 위한 통합 설정 이러한 통합은 Amazon Connect 추천 애플리케이션을 사용하여 Amazon Connect Customer Profiles에 정기적인 업데이트를 제공합니다. ## 시작하기 전에 ### 데이터 대량 수집 통합을 설정할 때 얼마나 오래된 날짜의 데이터까지 수집할 것인지 입력하라는 메시지가 표시됩니다. 2개월 이상 지난 날짜를 선택하면 Customer Profiles는 여러 흐름을 생성하여 대량 수집을 자동으로 활성화합니다. 이렇게 하면 데이터를 수집하는 데 필요한 흐름 수를 계산할 필요가 없습니다. 자동 대량 수집이 활성화된 경우 Customer Profiles는 다음을 수행합니다. + 배치 크기를 2개월로 설정합니다. + 일시적 실패 시 최대 3회 재시도한 후 실패합니다. [CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html) API를 사용하여 원하는 배치 크기를 정할 수 있습니다. ### IAM 역할을 선택하거나 생성하라는 메시지가 표시되는 이유는 무엇인가요? Salesforce, Marketo 및 ServiceNow의 경우 Customer Profiles는 IAM 역할을 사용하여 데이터를 빠르고 효율적으로 수집할 수 있는 여러 워크플로를 생성함으로써 이러한 소스의 과거 수집을 개선할 수 있습니다. 이러한 소스의 경우 **레코드 가져오기 날짜** 날짜 선택기에서 60일 이상 과거를 선택하면 새 IAM 역할을 생성하거나 기존 역할을 선택하라는 메시지가 표시됩니다. Customer Profiles는 이 역할을 통해 통합을 관리할 수 있습니다. 역할은 Customer Profiles가 데이터를 수집하기 위한 워크플로를 업데이트하고 생성하는 데 필요한 권한을 제공합니다. 워크플로가 완료되면 Customer Profiles는 소스에서 새 데이터가 업데이트되는 대로 수집하는 표준적이고 지속적인 통합을 생성합니다. 콘솔에서 생성된 역할은 해당 역할이 생성된 도메인에서만 사용할 수 있습니다. 이는 Amazon Connect가 도메인에서 사용되는 KMS 키로만 역할 액세스를 제한하기 때문입니다. 자세한 내용은 [Customer Profiles 실행 역할에 최소 권한 액세스 부여](#grant-least-privilege-cp) 섹션을 참조하세요. ## Customer Profiles 실행 역할에 최소 권한 액세스 부여 IAM 역할을 직접 생성하려는 경우 다음 코드에 표시된 권한을 사용하여 역할을 필요한 최소 권한으로 제한하는 것이 좋습니다. 아래 스니펫을 사용하여 역할을 수동으로 생성합니다. 자체 KMS 키를 사용하고 필요한 경우 리전을 지정합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Condition": { "ForAnyValue:StringEquals": { "aws:RequestTag/awsOwningService": "customer-profiles-integration-workflow" } }, "Action": [ "appflow:CreateFlow", "appflow:TagResource", "profile:TagResource", "profile:PutIntegration" ], "Resource": "*", "Effect": "Allow", "Sid": "CreateFlowResources" }, { "Action": [ "appflow:UseConnectorProfile" ], "Resource": "*", "Effect": "Allow", "Sid": "UseConnectorResources" }, { "Condition": { "ForAnyValue:StringEquals": { "aws:ResourceTag/awsOwningService": "customer-profiles-integration-workflow" } }, "Action": [ "appflow:DescribeFlow", "appflow:DescribeFlowExecutionRecords", "appflow:DeleteFlow", "appflow:StartFlow", "appflow:StopFlow", "appflow:UpdateFlow", "profile:DeleteIntegration" ], "Resource": "*", "Effect": "Allow", "Sid": "AccessFlowResources" }, { "Action": [ "kms:CreateGrant", "kms:ListGrants" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KeyId" ], "Condition": { "StringEquals": { "kms:ViaService": [ "appflow.us-east-1.amazonaws.com" ] } }, "Effect": "Allow", "Sid": "KMSAppflow" }, { "Action": [ "kms:CreateGrant" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KeyId" ], "Condition": { "StringEquals": { "kms:ViaService": [ "profile.us-east-1.amazonaws.com" ] }, "ForAllValues:StringEquals": { "kms:GrantOperations": [ "Decrypt" ] } }, "Effect": "Allow", "Sid": "KMSCustomerProfiles" } ] } ``` ------ ## Customer Profiles 통합 모니터링 연결이 설정된 후 작동이 중지되면 통합을 삭제한 다음 다시 설정하세요. ## 객체가 전송되지 않는 경우 취해야 할 조치 객체 전송에 실패한 경우 **흐름 세부 정보**를 선택하여 무엇이 잘못되었는지 자세히 알아보세요. 구성을 삭제하고 외부 애플리케이션에 다시 연결해야 할 수 있습니다. # Amazon Connect Cases 통합 설정 Amazon Connect Customer Profiles에서 Amazon Connect 사례 데이터를 업데이트하고 계산된 속성과 같은 기능을 사용하려면 Amazon AppIntegrations를 사용하여를 통합할 수 있습니다. 먼저 EventBridge 버스로 시스템 필드를 전송하도록 Cases Event Stream을 설정한 다음 Amazon AppIntegrations를 사용하여 이러한 이벤트를 Customer Profiles로 전달합니다. ## Amazon Connect Cases에서 Event Bridge로 데이터 스트리밍 1. [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)에서 Amazon Connect 콘솔을 엽니다. 1. 인스턴스 페이지에서 인스턴스 별칭을 선택합니다. 인스턴스 별칭은 Amazon Connect URL에 표시되는 **인스턴스 이름**이기도 합니다. 다음 이미지는 **Amazon Connect 가상 고객 센터 인스턴스** 페이지를 보여 주며, 인스턴스 별칭을 둘러싼 상자가 있습니다. ![\[인스턴스 별칭입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png) 1. 탐색 창의 **도메인 세부 정보** 섹션에서 **사례**를 선택하고 사례 도메인 ID를 기록해 둡니다. ![\[사례 페이지, 도메인 세부 정보 섹션, 도메인 ID를 가리키는 화살표.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png) 1. 를 사용하여 사례 이벤트 구성을 AWS CLI생성하여 Amazon Connect 사례 이벤트를 AWS 계정기본 Event Bridge 버스로 전송합니다. ``` // set up Case Event Configuration including all system fields aws connectcases put-case-event-configuration --domain-id  --region  --event-bridge "{                          \"enabled\": true,     \"includedData\": {        \"caseData\": {           \"fields\": [           {           \"id\": \"status\"           },           {           \"id\": \"title\"           },           {           \"id\": \"summary\"           },           {           \"id\": \"reference_number\"           },           {           \"id\": \"created_datetime\"           },           {           \"id\": \"last_updated_datetime\"           },           {           \"id\": \"last_closed_datetime\"           },                 {           \"id\": \"customer_id\"           }         ]       }     }   }" ``` 1. 해당 AWS 리전의 Event Bridge 콘솔을 엽니다. 예: [https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2\$1/eventbuses](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses) 1. **Create event bus(이벤트 버스 생성)**를 선택하세요. ![\[Amazon EventBridge 콘솔의 이벤트 버스 페이지, 이벤트 버스 생성 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png) 1. 이름이 `connect-cases-to-customer-profiles`인 이벤트 버스를 생성합니다. ![\[이벤트 버스 생성 페이지, 이름 상자.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png) 1. **기본 이벤트 버스**로 돌아가서 이름이 `connect-cases-to-customer-profiles-rule`인 규칙을 생성합니다. ![\[기본 이벤트 버스, 규칙 생성 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png) ![\[이벤트 패턴 빌드 단계입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png) + 이벤트 패턴 스니펫: ``` {   "source": ["aws.cases"],   "detail": {     "eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]   } } ``` ![\[생성 방법 섹션, 사용자 지정 패턴(JSON 편집기) 옵션, 이벤트 패턴 코드.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png) + **검토 및 생성으로 건너뛰기**를 선택한 후 **규칙 생성**을 선택합니다. ![\[검토 및 생성으로 건너뛰기 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png) ## AppIntegrations를 사용하여 Event Bridge 사례 데이터를 Customer Profiles에 삽입 1. 를 사용하여 AppIntegrations와의 이벤트 통합을 AWS CLI생성하고 ARN 출력을 기록합니다.   이는 Amazon Connect 인스턴스가 사용할 수 있는 소스 데이터를 나타냅니다. ``` aws appintegrations create-event-integration --region  --name Connect-Cases-Event-Integration --event-bridge-bus connect-cases-to-customer-profiles --event-filter "{\"Source\": \"aws.cases\" }" --description "Event Integration for Cases Event Bus" ``` 1. 를 사용하여 put-integration API를 사용하여 Customer Profiles와의 통합을 AWS CLI생성합니다. 이렇게 하면 Customer Profiles로의 데이터 흐름이 시작되어 자리 표시자 값이 이벤트 통합 ARN 및 Customer Profiles 도메인 이름으로 바뀝니다. ``` aws customer-profiles put-integration --region  --domain-name   --uri  --object-type-name Connect-case ``` ## Cases 통합 확인 1. Amazon Connect Cases에서 사례를 생성합니다. 1. 이벤트 전송은 거의 즉각적으로 이루지지만, 전송될 때까지 1분 정도 기다린 후 고객 프로필을 연결합니다. 1. 를 사용하여 프로파일에서 Connect-case 객체를 AWS CLI찾아 자리 표시자를 올바른 값으로 바꿉니다. ``` aws customer-profiles list-profile-objects --domain-name  --region --object-type-name Connect-case --profile-id ``` 1. 위의 API 직접 호출 응답에서 항목을 찾지 못하면 통합에 문제가 있는 것입니다. 문제를 해결하려면 1. Amazon EventBridge 콘솔로 이동합니다. 1. EventSource가 활성 상태이며 매칭되는 EventBus가 존재하고 실행 중인지 확인합니다. 1. 사례 이벤트 구성이 올바르게 구성되었는지 확인합니다. 1. 작동 중인 경우 지원 에 문의하여 문제를 조사하는 데 도움을 받으세요. # Salesforce, ServiceNow, Marketo 또는 Zendesk에 대한 Amazon Connect 통합 설정 Amazon Connect Customer Profiles를 정기적으로 업데이트하려면 Amazon AppFlow를 사용하여 Salesforce, ServiceNow, Marketo 또는 Zendesk와 통합할 수 있습니다. 먼저 Amazon Connect와 선택한 애플리케이션에서 연결을 설정한 다음 통합을 확인합니다. ## Amazon Connect 및 Salesforce, ServiceNow, Marketo 또는 Zendesk에서 연결을 설정합니다. 1. [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)에서 Amazon Connect 콘솔을 엽니다. 1. 인스턴스 페이지에서 인스턴스 별칭을 선택합니다. 인스턴스 별칭은 Amazon Connect URL에 표시되는 **인스턴스 이름**이기도 합니다. 다음 이미지는 **Amazon Connect 가상 고객 센터 인스턴스** 페이지를 보여 주며, 인스턴스 별칭을 둘러싼 상자가 있습니다. ![\[Amazon Connect 가상 고객 센터 인스턴스 페이지, 인스턴스 별칭.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/instance.png) 1. 탐색 창에서 **고객 프로필**을 선택합니다. 1. **고객 프로필 구성** 페이지에서 다음 이미지와 같이 **통합 추가**를 선택합니다. ![\[고객 프로필 구성 페이지, 통합 추가 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png) 1. **데이터 소스 선택** 페이지에서 고객 프로필 데이터를 가져올 외부 애플리케이션을 선택합니다. [통합 요구 사항](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html)을 확인하여 애플리케이션에 필요한 연결 요구 사항을 더 잘 이해할 수 있습니다. ![\[데이터 소스 선택 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png) 1. **연결 설정** 페이지에서 다음 중 하나를 선택합니다. + **기존 연결 사용**: 이렇게 하면 AWS 계정에서 생성한 기존 Amazon AppFlow 리소스를 재사용할 수 있습니다. + **새 연결 생성**: 외부 애플리케이션에 필요한 정보를 입력합니다. ![\[연결 설정 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png) 1. **통합 옵션** 페이지에서 수집하려는 소스 객체를 선택하고 해당 객체 유형을 선택합니다. 객체 유형은 수집된 데이터를 저장합니다. 또한 통합의 객체를 수집할 때 프로필에 매핑하는 방법을 정의합니다. Customer Profiles는 소스 객체의 속성을 Customer Profiles의 표준 객체에 매핑하는 방법을 정의하는 데 사용할 수 있는 기본 객체 유형 템플릿을 제공합니다. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)에서 생성한 객체 매핑을 사용할 수도 있습니다. 사용자가 생성한 데이터 매핑을 위한 Salesforce 통합을 추가하거나 생성할 때는 특정 데이터 매핑을 지정해야 합니다. 그러지 않으면 객체 유형에 대해 Salesforce 기본 데이터 매핑이 선택됩니다. 데이터 매핑을 생성하여 추천 데이터 커넥터를 설정할 때 사용할 수 있습니다. ![\[통합 옵션 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-integration-options.png) 1. **수집 시작 날짜**의 경우 Customer Profiles는 이 날짜 이후에 생성된 레코드를 수집하기 시작합니다. 기본적으로 레코드 가져오기 날짜는 30일 전으로 설정됩니다. 1. **검토 및 통합** 페이지에서 **연결 상태**가 **연결됨**으로 표시되는지 확인한 다음 **통합 생성**을 선택합니다. ![\[검토 및 통합 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png) 1. 통합이 설정되면 **고객 프로필 구성** 페이지로 돌아가서 **객체 보기**를 선택하여 어떤 데이터가 배치 처리되고 전송되는지 확인합니다. 현재 이 프로세스는 지난 30일 동안 생성되거나 수정된 레코드를 수집합니다. ![\[고객 프로필 구성 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-objects.png) # Amazon Connect Customer Profiles에 대한 정기 업데이트를 제공하도록 Segment 통합 설정 Amazon Connect Customer Profiles를 정기적으로 업데이트하려면 Amazon AppFlow를 사용하여 Segment와 통합할 수 있습니다. 먼저 Amazon Connect 및 Segment에서 연결을 설정한 다음 Segment 통합을 확인합니다. ## Amazon Connect 및 Segment에서 연결을 설정합니다. 1. [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)에서 Amazon Connect 콘솔을 엽니다. 1. 인스턴스 페이지에서 인스턴스 별칭을 선택합니다. 인스턴스 별칭은 Amazon Connect URL에 표시되는 **인스턴스 이름**이기도 합니다. 다음 이미지는 **Amazon Connect 가상 고객 센터 인스턴스** 페이지를 보여 주며, 인스턴스 별칭을 둘러싼 상자가 있습니다. ![\[Amazon Connect 가상 고객 센터 인스턴스 페이지, 인스턴스 별칭.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/instance.png) 1. 탐색 창에서 **고객 프로필**을 선택합니다. 1. **고객 프로필 구성** 페이지에서 **통합 추가**를 선택합니다. ![\[고객 프로필 구성 페이지, 통합 추가 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png) 1. **데이터 소스 선택** 페이지에서 **Segment**를 선택합니다. **애플리케이션 선택** 페이지에 나열된 애플리케이션 요구 사항을 검토하세요. ![\[데이터 소스 선택 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png) 1. **연결 설정** 페이지에서 다음 중 하나를 선택합니다. + **기존 연결 사용**: 이를 통해에서 생성했을 수 있는 기존 Amazon EventBridge 리소스를 재사용할 수 있습니다 AWS 계정. + **새 연결 생성**: 외부 애플리케이션에 필요한 정보를 입력합니다. ![\[연결 설정 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png) + **연결 이름**: 연결 이름을 입력합니다. 연결 이름은 이 연결을 사용하는 통합에서 참조됩니다. + **연결 URL**: 애플리케이션 연결 URL을 입력합니다. 이 URL은 외부 애플리케이션에서 생성된 객체에 딥 링크하는 데 사용됩니다. 연결 URL은 애플리케이션 웹 사이트에서 사용할 수 있는 Segment 작업 영역 URL입니다. 작업 영역 URL을 찾으려면 1. segment.com 계정에 로그인합니다. 1. **설정**, **일반 설정**으로 이동합니다. 1. 브라우저에서 URL을 복사합니다. 1. Customer Profiles는 Segment와의 통합을 위해 Amazon EventBridge를 사용합니다. **소스 설정** 페이지에서 AWS 계정 ID를 클립보드에 복사한 다음 **세그먼트에 로그인을** 선택하여 Amazon EventBridge를 구성합니다. 1. 다음 지침을 사용하여 Segment를 설정하세요. 1. Segment에 로그인합니다. 1. 애플리케이션에서 소스를 선택하여 대상을 Amazon EventBridge로 설정합니다. 1. AWS 계정 ID를 붙여넣고 AWS 리전을 선택합니다. 1. 토글을 **켜기**로 전환하여 파트너 이벤트 소스를 활성화합니다. 1. **이벤트 테스터**로 이동하고 테스트 이벤트를 전송하여 파트너 이벤트 소스 활성화를 완료합니다. 1. **클라이언트 ID**: 외부 애플리케이션에서 클라이언트를 고유하게 구분하는 문자열입니다. 이 클라이언트 ID는 애플리케이션 웹 사이트에서 사용할 수 있는 소스 이름입니다. 지정한 ID를 사용하여 Customer Profiles에서 객체를 수집하려는 클라이언트를 식별합니다. 소스 ID를 찾으려면 1. **소스**로 이동하여 소스를 선택합니다. 1. **설정**, **API 키**로 이동합니다. 1. **소스 ID**를 복사합니다. 이벤트 소스 대상을 설정한 후 Customer Profiles 콘솔로 돌아가서 클라이언트 ID를 붙여넣습니다. 1. Amazon Connect가 Segment와 성공적으로 연결되었음을 나타내는 알림이 표시됩니다. 1. **통합 옵션** 페이지에서 수집하려는 소스 객체를 선택하고 해당 객체 유형을 선택합니다. 객체 유형은 수집된 데이터를 저장합니다. 또한 통합의 객체를 수집할 때 프로필에 매핑하는 방법을 정의합니다. Customer Profiles는 소스 객체의 속성을 Customer Profiles의 표준 객체에 매핑하는 방법을 정의하는 데 사용할 수 있는 기본 객체 유형 템플릿을 제공합니다. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)에서 생성한 객체 매핑을 사용할 수도 있습니다. ![\[통합 옵션 페이지, 객체 유형 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png) 1. **수집 시작 날짜**의 경우 Customer Profiles는 통합이 추가된 후에 생성된 레코드를 수집하기 시작합니다. **참고** 기록 레코드가 필요한 경우 [Amazon S3를 통합 소스로 사용하여 해당 기록을 가져올 수 있습니다](customer-profiles-object-type-mappings.md). 1. **검토 및 통합** 페이지에서 **연결 상태**가 **연결됨**으로 표시되는지 확인한 다음 **통합 추가**를 선택합니다. 1. 통합을 설정한 후 **고객 프로필 구성** 페이지로 돌아가면 **통합** 페이지에 현재 설정된 통합이 표시됩니다. 이 유형의 통합에는 현재 **마지막 실행** 및 **통합 상태**를 사용할 수 없습니다. ![\[고객 프로필 구성 페이지, 통합 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png) 전송되는 데이터를 확인하려면 통합을 선택하고 \$1 기호를 선택한 다음 **객체 보기**를 선택합니다. ## Segment 통합 확인 이 단계를 수행하려면 다음 사전 조건이 필요합니다. + Segment 작업 영역에 대한 액세스. + [Amazon Connect 고객 응대 제어판에 대한 액세스](amazon-connect-contact-control-panel.md). **Segment 통합을 확인하려면** 1. Segment 작업 영역 대시보드로 이동하여 **대상**을 선택합니다. ![\[Segment 개요 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png) 1. Segment가 데이터를 보내는 대상 목록이 표시됩니다. Customer Profiles의 EventBridge 대상을 선택합니다. ![\[대상 목록 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png) 1. **이벤트 테스터** 탭을 선택합니다. 이 페이지에서 Customer Profiles로 테스트 이벤트를 보낼 수 있습니다. 이벤트는 수집되어 Amazon Connect 에이전트 애플리케이션에서 볼 수 있는 고객 프로필로 전환됩니다. ![\[이벤트 테스터 탭.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png) 1. 이벤트 유형으로 **식별**을 선택하고 입력 방법으로 **Event Builder**를 선택합니다. 1. **사용자 ID**와 일부 특성을 지정할 수 있습니다. 에이전트는 에이전트 애플리케이션에서 이러한 특성을 검색할 수 있습니다. 1. **이벤트 전송**을 선택합니다. 1. 이벤트 전송은 거의 즉각적으로 이루지지만, 전송될 때까지 1분 정도 기다린 후 고객 프로필을 생성하세요. 1. Amazon Connect 에이전트 애플리케이션을 엽니다. **Event Builder**에 입력한 사용자 ID를 검색합니다. 입력한 사용자 ID 및 특성이 포함된 고객 프로필을 확인할 수 있어야 합니다. 1. 고객 프로필이 보이지 않으면 통합에 문제가 있는 것입니다. 문제를 해결하려면 1. Amazon EventBridge 콘솔로 이동합니다. 1. EventSource가 활성 상태이며 매칭되는 EventBus가 존재하고 실행 중인지 확인합니다. 작동 중인 경우 지원 에 문의하여 문제를 조사하는 데 도움을 받으세요. ## Customer Profiles 통합 모니터링 연결이 설정된 후 작동이 중지되면 통합을 삭제한 다음 다시 설정하세요. ## 객체가 전송되지 않는 경우 취해야 할 조치 객체 전송에 실패한 경우 **흐름 세부 정보**를 선택하여 무엇이 잘못되었는지 자세히 알아보세요. 구성을 삭제하고 외부 애플리케이션에 다시 연결해야 할 수 있습니다. # Amazon Connect Customer Profiles에 대한 정기 업데이트를 제공하도록 Shopify 통합 설정 Amazon Connect Customer Profiles를 정기적으로 업데이트하려면 Amazon AppIntegrations를 사용하여 Shopify와 통합할 수 있습니다. 먼저 Amazon Connect 및 Shopify에서 연결을 설정한 다음 Shopify 통합을 확인합니다. ## Amazon Connect 및 Shopify에서 연결을 설정합니다. 1. [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)에서 Amazon Connect 콘솔을 엽니다. 1. 인스턴스 페이지에서 인스턴스 별칭을 선택합니다. 인스턴스 별칭은 Amazon Connect URL에 표시되는 **인스턴스 이름**이기도 합니다. 다음 이미지는 **Amazon Connect 가상 고객 센터 인스턴스** 페이지를 보여 주며, 인스턴스 별칭을 둘러싼 상자가 있습니다. ![\[Amazon Connect 가상 고객 센터 인스턴스 페이지, 인스턴스 별칭.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/instance.png) 1. 탐색 창에서 **고객 프로필**을 선택합니다. 1. **고객 프로필 구성** 페이지에서 **통합 추가**를 선택합니다. ![\[고객 프로필 구성 페이지, 통합 추가 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png) 1. **소스 선택** 페이지에서 **Shopify**를 선택합니다. **애플리케이션 선택** 페이지에 나열된 애플리케이션 요구 사항을 검토하세요. ![\[소스 선택 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png) 1. **연결 설정** 페이지에서 다음 중 하나를 선택합니다. + **기존 연결 사용**: 이를 통해에서 생성했을 수 있는 기존 Amazon EventBridge 리소스를 재사용할 수 있습니다 AWS 계정. + **새 연결 생성**: 외부 애플리케이션에 필요한 정보를 입력합니다. ![\[연결 설정 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png) + **연결 이름**: 연결 이름을 입력합니다. 연결 이름은 이 연결을 사용하는 통합에서 참조됩니다. + **연결 URL**: 애플리케이션 연결 URL을 입력합니다. 이 URL은 외부 애플리케이션에서 생성된 객체에 딥 링크하는 데 사용됩니다. 연결 URL은 애플리케이션 웹 사이트에서 사용할 수 있는 Shopify 파트너 앱 URL입니다. Shopify 파트너 앱 URL을 찾으려면 + partners.shopify.com 계정에 로그인합니다. + 앱으로 이동합니다. + 브라우저에서 URL을 복사합니다. + **클라이언트 ID**: 애플리케이션 클라이언트 ID를 입력합니다. 외부 애플리케이션에서 클라이언트를 고유하게 구분하는 문자열입니다. 이 클라이언트 ID는 애플리케이션 웹 사이트에서 사용할 수 있는 소스 이름입니다. 여기에서 지정한 ID를 사용하여 Customer Profiles에서 객체를 수집하려는 클라이언트를 식별합니다. 소스 설정 단계를 수행한 후 클라이언트 ID를 사용할 수 있습니다. 소스 이름을 찾으려면 + partners.shopify.com 계정에 로그인합니다. + 앱으로 이동합니다. + Amazon EventBridge 이벤트 소스에서 소스 이름을 복사합니다. 1. **소스 설정** 페이지에서 AWS 계정 ID를 클립보드에 복사한 다음 **Shopify에 로그인을** 선택합니다. 1. 다음 지침에 따라 Shopify를 설정합니다. 1. partners.shopify.com에 로그인합니다. 1. Amazon EventBridge에서 **소스 생성**을 선택합니다. 1. AWS 계정 ID를 붙여넣고 AWS 리전을 선택합니다. 1. 이벤트 소스 대상을 설정한 후 Customer Profiles로 돌아갑니다. Amazon Connect가 Shopify와 성공적으로 연결되었음을 나타내는 알림이 표시됩니다. 1. **통합 옵션** 페이지에서 수집하려는 소스 객체를 선택하고 해당 객체 유형을 선택합니다. 객체 유형은 수집된 데이터를 저장합니다. 또한 통합의 객체를 수집할 때 프로필에 매핑하는 방법을 정의합니다. Customer Profiles는 소스 객체의 속성을 Customer Profiles의 표준 객체에 매핑하는 방법을 정의하는 데 사용할 수 있는 기본 객체 유형 템플릿을 제공합니다. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)에서 생성한 객체 매핑을 사용할 수도 있습니다. ![\[통합 옵션 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png) 1. **수집 시작 날짜**의 경우 Customer Profiles는 통합이 추가된 후에 생성된 레코드를 수집하기 시작합니다. **참고** 기록 레코드가 필요한 경우 [Amazon S3를 통합 소스로 사용하여 해당 기록을 가져올 수 있습니다](customer-profiles-object-type-mappings.md). 1. **검토 및 통합** 페이지에서 **연결 상태**가 **연결됨**으로 표시되는지 확인한 다음 **통합 추가**를 선택합니다. **참고** 이 통합을 추가한 후에는 이벤트가 이 통합으로 유입되기 시작할 수 있도록 [Webhook 구독을 설정](#shopify-webhook-subscriptions)해야 합니다. ![\[검토 및 통합 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png) 1. 통합을 설정한 후 **고객 프로필 구성** 페이지로 돌아가면 **통합** 섹션에 현재 설정된 통합이 표시됩니다. 이 유형의 통합에는 현재 **마지막 실행** 및 **통합 상태**를 사용할 수 없습니다. ![\[통합 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png) 전송되는 데이터를 확인하려면 통합을 선택하고 **객체 보기**를 선택합니다. 1. 이벤트가 이 통합으로 유입되기 시작할 수 있도록 다음 단계에서 API를 사용하여 **Webhook 구독**을 설정합니다. ## Webhook 구독 설정 1. 다음 URL을 사용하여 앱에 필요한 권한이 있는지 확인합니다. ``` https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce} ``` 위치: + `shop`은 Shopify 스토어 이름입니다. + `api_key`는 Shopify 앱의 API 키입니다. Shopify **앱** 세부 정보 페이지에서 확인할 수 있습니다. + `scopes`에는 `read_customers,read_orders,read_draft_orders` 값이 있어야 합니다. + `redirect_uri`는 앱을 만들 때 지정한 리디렉션 URI입니다. 여기서는 모든 유효한 URL이 될 수 있습니다. + `nonce`는 다른 사람의 특정 승인 요청을 식별하기 위한 임의의 고유한 값일 수 있습니다. 타임스탬프를 사용하는 것이 좋습니다. URL을 구성한 후 브라우저에 붙여넣으면 됩니다. 다음 이미지와 비슷한 설치/승인 페이지가 표시되어 스토어 소유자에게 정의된 범위에 대한 권한을 부여하도록 요청합니다. ![\[앱 설치 및 권한 부여를 위한 Shopify 페이지 예제입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png) 1. **미등록 앱 설치**를 선택하여 스토어 대신 앱을 설치하고 승인합니다. 입력한 리디렉션 URI에 승인 코드가 쿼리 파라미터로 추가된 주소로 이동됩니다. 예제: ``` https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}×tamp=1409617544&state={nonce}&shop={shop_origin}&host={host} ``` 1. 이 URI에서 `authorization_code`를 복사합니다. 다음 단계에서 이를 사용하여 영구 액세스 토큰을 받을 것입니다. 1. API 호출에 사용할 도구로 이동합니다. 예를 들어 [CURL](https://curl.se/) 또는 [POSTMAN](https://www.postman.com/)입니다. 1. 영구 액세스 토큰을 받으려면 Shopify `Admin` API에 이 엔드포인트에 대한 POST 요청을 보냅니다. ``` https://{shop}.myshopify.com/admin/oauth/access_token ``` 요청 본문은 다음과 같습니다. ``` { "code": "authorization_code_received_from_redirect_uri", "client_id": "your_app_api_key", "client_secret": "your_app_api_secret" } ``` 이 요청은 다음과 같은 응답을 반환합니다. ``` { "access_token": "permanent_access_token", "scope": "read_customers,read_orders,read_draft_orders" } ``` 1. `access_token`을 기록합니다. 이 토큰은 이전 단계에서 지정한 범위를 가진 영구 토큰입니다. 이제 Webhook 구독을 생성할 준비가 되었습니다. 1. 다음 API 호출의 경우 HTTP 헤더 키 `X-Shopify-Access-Token`을 이전 호출 응답에서 수신한 `access_token`으로 설정해야 합니다. 1. Webhook 구독을 설정하려면 다음 단계에 나열된 각 `topic` 값에 대해 다음과 같은 POST 요청을 수행합니다. 엔드포인트: `https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json` 요청 본문: ``` { "webhook": { "topic": "replace_this_with_one_of_the_topics_in_the_list_below", "address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration", "format": "json" } } ``` 1. 각 구독에 대해 `topic`의 값을 다음 값으로 바꿉니다. + `customers/create` + `customers/enable` + `customers/update` + `draft_orders/create` + `draft_orders/update` + `orders/cancelled` + `orders/create` + `orders/fulfilled` + `orders/paid` + `orders/partially_fulfilled` + `orders/updated` 이제 Shopify 스토어에서 이벤트를 수신할 준비가 모두 완료되었습니다. 다음으로 Shopify 통합을 확인합니다. ## Shopify 통합 확인 1. Shopify 스토어에 관리자로 로그인합니다. 1. 왼쪽 탐색 메뉴에서 **고객**을 선택합니다. 1. **고객 추가**를 선택합니다. 1. 고객 세부 정보를 입력합니다. 전화번호와 이메일을 반드시 입력하세요. 실제 고객의 소유일 필요는 없습니다. 통합을 확인한 후 이 고객 항목을 삭제하게 됩니다. 1. 고객 객체를 저장합니다. 1. 이벤트 전송은 거의 즉각적으로 이루지지만, 전송될 때까지 1분 정도 기다린 후 고객 프로필을 생성하세요. 1. Amazon Connect 에이전트 환경을 열고 Shopify 스토어에 입력한 이메일 또는 전화번호로 사용자를 검색합니다. 이메일 또는 전화번호가 동일한 고객 프로필을 볼 수 있어야 합니다. 1. 고객 프로필이 보이지 않으면 통합에 문제가 있는 것입니다. 문제를 해결하려면 1. Amazon EventBridge 콘솔로 이동합니다. 1. EventSource가 활성 상태이며 매칭되는 EventBus가 존재하고 실행 중인지 확인합니다. 작동 중인 경우 지원 에 문의하여 문제를 조사하는 데 도움을 받으세요. ## Customer Profiles 통합 모니터링 연결이 설정된 후 작동이 중지되면 통합을 삭제한 다음 다시 설정하세요. ## 객체가 전송되지 않는 경우 취해야 할 조치 객체 전송에 실패한 경우 **흐름 세부 정보**를 선택하여 무엇이 잘못되었는지 자세히 알아보세요. 구성을 삭제하고 외부 애플리케이션에 다시 연결해야 할 수 있습니다. # Amazon AppFlow를 사용하여 외부 애플리케이션에 대한 통합 설정 이러한 통합은 Amazon AppFlow를 사용하여 Amazon Connect Customer Profiles를 정기적으로 업데이트합니다. 아래 단계는 Amazon AppFlow를 사용하여 선택한 커넥터를 구성하고, 데이터 매핑을 구성하고, 고객 데이터를 수집하기 위한 통합을 구성하는 방법에 대한 지침을 제공합니다. Amazon AppFlow 요금에 대한 자세한 내용은 Amazon AppFlow [요금](https://aws.amazon.com/appflow/pricing/)을 참조하세요. Amazon AppFlow 지원 커넥터에 대한 자세한 내용은 [지원되는 소스 및 대상 애플리케이션](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html)을 참조하세요. ## 시작하기 전에 Amazon Connect Customer Profiles를 활성화하면 고객 프로필, 객체 유형, 프로필 키 및 암호화 키와 같은 모든 데이터를 저장하는 컨테이너인 Customer Profiles 도메인이 생성됩니다. 다음은 Customer Profile 도메인을 생성하기 위한 지침입니다. + 각 Amazon Connect 인스턴스는 한 도메인과만 연결할 수 있습니다. + 여러 도메인을 생성할 수 있지만, 도메인이 외부 애플리케이션 통합 또는 고객 데이터를 서로 공유하지는 않습니다. + 생성하는 모든 외부 애플리케이션 통합은 도메인 수준에서 이루어집니다. 도메인과 연결된 모든 Amazon Connect 인스턴스는 도메인의 통합을 상속합니다. **전제 조건: Amazon Connect 인스턴스에서 고객 프로필 활성화** 1. [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)에서 Amazon Connect 콘솔을 엽니다. 1. 인스턴스 페이지에서 인스턴스 별칭을 선택합니다. 인스턴스 별칭은 Amazon Connect URL에 표시되는 **인스턴스 이름**이기도 합니다. 다음 이미지는 **Amazon Connect 가상 고객 센터 인스턴스** 페이지를 보여 주며, 인스턴스 별칭을 둘러싼 상자가 있습니다. 1. 탐색 창에서 **고객 프로필**을 선택합니다. 1. Customer Profiles 활성화를 선택합니다. Customer Profiles 도메인을 생성하려면 양식에서 아래 단계에 따라 필수 필드를 모두 작성해야 합니다. 1. **도메인 설정**. 새 도메인을 만들고 이름을 제공할 수 있습니다. 1. **암호화**. KMS 키 지정에서 기존 AWS KMS 키를 선택하거나, 새 AWS KMS 키를 생성하거나, **기존 도메인 선택**을 선택하여 암호화를 활성화할 수 있습니다. 1. **오류 보고** 고객 프로필 오류를 처리하기 위한 SQS 대기열인 DLQ(Dead Letter Queue)를 제공할 수 있습니다. 1. **제출**을 선택하면 인스턴스의 고객 응대 기록 정보를 사용하여 Customer Profiles가 생성됩니다. ### Amazon AppFlow를 사용하여 외부 애플리케이션 설정 아래 단계에 따라 Amazon AppFlow를 사용하여 Amazon Connect Customer Profiles 도메인에 외부 애플리케이션 통합을 추가할 수 있습니다. Customer Profiles 콘솔에서 계속하려면 먼저 Amazon AppFlow 콘솔에서 데이터 소스에 대한 흐름을 생성하고 Amazon Connect Customer Profiles를 대상으로 설정해야 합니다. 흐름을 생성한 지 14일이 넘었다면 흐름이 만료되었으므로 통합을 위해 새 흐름을 생성해야 합니다. 수집 전에 `AWS::AppFlow::Flow Task` 리소스를 사용할 `Validate` 때 `Arithmetic`, `Filter`, , `Map`, `Map_all`, `Mask``Merge``Truncate`, 등의 데이터 변환을 CloudFormation 선택적으로 수행할 수 있습니다. 1. AWS Management Console에 로그인하고 Amazon AppFlow를 선택한 다음 **흐름 생성을** 선택합니다. ![\[Amazon AppFlow 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step1.png) 1. 흐름 이름 및 흐름 설명(선택 사항)을 입력합니다. ![\[흐름 세부 정보 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step2.png) 1. Amazon Connect Customer Profiles 도메인에이 흐름에 사용할 기존 AWS KMS 키가 이미 있으므로 **데이터 암호화** 섹션을 그대로 둘 수 있습니다. 선택적으로 태그를 생성한 후 **다음**을 선택할 수 있습니다. ![\[데이터 암호화 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step3.png) 1. **소스 이름** 드롭다운에서 원하는 외부 애플리케이션을 선택한 다음 다음 관련 필드를 선택합니다. 예를 들어 Slack을 구성하려면 **소스이름** 드롭다운에서 Slack을 선택합니다. 그런 다음 기존 Slack 흐름을 선택하거나 새 연결을 만들 수 있습니다. ![\[흐름 구성 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step4.png) 1. 새 연결을 생성하기로 선택한 경우 사용자 이름, 암호 및 하위 도메인과 같은 외부 애플리케이션의 세부 정보를 입력할 수 있습니다. 데이터 암호화를 위한 AWS KMS 키를 선택하고 연결 이름을 입력하여이 연결을 식별할 수도 있습니다. ![\[Slack에 연결 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step5.png) 1. 기존 연결을 사용하기로 선택한 경우 드롭다운에서 특정 외부 애플리케이션 객체를 선택할 수 있습니다. 예를 들어 기존 Slack 연결을 선택하는 경우 **대화**를 객체로 선택한 다음 사용할 특정 Slack 채널을 선택할 수 있습니다. ![\[소스 세부 정보 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step6.png) 1. **목적지 세부 정보** 섹션의 드롭다운에서 Amazon Connect를 대상 이름으로 선택하고 이전 전제 조건 단계에서 생성한 고객 프로필 도메인을 선택합니다. ![\[대상 세부 정보 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step7.png) 1. **온디맨드 실행** 또는 **일정에 따라 흐름 실행**을 선택하여 흐름 트리거를 선택합니다. **다음**을 선택합니다. + **온디맨드 실행**은 흐름을 트리거할 때만 흐름을 실행합니다. + **일정에 따라 흐름 실행**은 일정을 사용하여 특정 시간에 흐름을 실행합니다. 일정 간격은 5분, 15분 또는 1시간으로 제한됩니다. ![\[흐름 트리거 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step8.png) 1. **매핑 방법**에서 **수동으로 필드 매핑**을 선택합니다. 외부 애플리케이션에서 소스 필드를 선택한 다음 **필드 직접 매핑**을 선택합니다. ![\[매핑 방법 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step9.png) 1. **흐름 생성**을 검토하고 선택합니다. Amazon AppFlow 콘솔에서 흐름을 생성하는 방법에 대한 자세한 내용은 [Amazon AppFlow에서 흐름 생성](https://docs.aws.amazon.com/appflow/latest/userguide/create-flow.html)을 참조하세요. Amazon AppFlow에서 외부 애플리케이션 및 기타 지원되는 여러 애플리케이션을 설정하는 방법에 대한 자세한 내용은 [지원되는 Amazon AppFlow 소스 및 대상 애플리케이션](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html)을 참조하세요. ### 데이터 매핑을 설정하여 외부 애플리케이션 데이터가 Customer Profiles에 매핑되는 방법 정의 Amazon AppFlow 통합이 설정되면 Customer Profiles에서 데이터 매핑을 설정하여 외부 애플리케이션의 데이터가 Customer Profiles에 매핑되는 방법을 정의해야 합니다. 이를 통해 통합 고객 프로필을 구축하는 데 사용할 데이터를 사용자 지정할 수 있습니다. 통합을 생성한 후에는 다른 매핑을 선택할 수 없으므로 매핑을 신중하게 선택하세요. 데이터 매핑에 대한 자세한 내용은 [객체 유형 매핑](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-object-type-mapping.html)을 참조하세요. 1. AWS Management Console에 로그인하고 **Amazon Connect**를 선택한 다음 연결 인스턴스 별칭에서 Customer Profiles를 선택합니다. ![\[Amazon Connect Customer Profiles 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step1.png) 1. **데이터 매핑**을 선택한 다음 **데이터 매핑 생성**을 선택합니다. 데이터 매핑 이름과 설명을 입력합니다. ![\[데이터 매핑 탭, 데이터 매핑 생성 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2.png) ![\[세트 데이터 매핑 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2_2.png) 1. **매핑 옵션**에서 **데이터 소스**를 외부 애플리케이션으로 선택하고, 이전 섹션에서 만든 **흐름 이름**을 선택하고, **데이터 정의 방법**을 *매핑 대상*으로 선택할 수 있습니다. **매핑 대상**에서 통합 고객 프로필에 대해 정의하려는 고객 데이터 유형을 선택할 수 있습니다. **다음**을 선택합니다. ![\[매핑 옵션 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step3.png) 1. 소스, 대상, 콘텐츠 유형과 함께 고객, 제품, 사례 및 주문 속성을 추가한 후 **다음을** 선택합니다. ![\[맵 주문 속성 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step4.png) 1. **식별자 지정**에서 데이터를 다른 데이터 소스 객체와 구분하는 데 도움이 되는 데이터 소스 객체의 다양한 속성을 선택할 수 있습니다. 고유, 고객, 제품, 사례 및 주문 식별자 중에 속성을 선택할 수 있습니다. 식별자에 대한 자세한 내용은 [Customer Profiles의 키에 속성을 설정하기 위한 표준 식별자](standard-identifiers.md) 섹션을 참조하세요. ![\[표준 식별자 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step5.png) 1. 검토 후 **데이터 매핑 생성**을 선택합니다. 데이터 매핑 상태가 *활성*으로 표시됩니다. ![\[6단계: 식별자 지정 페이지의 식별자.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step6.png) ### 외부 애플리케이션에서 고객 데이터를 수집하도록 통합 설정 외부 애플리케이션에 대한 데이터 매핑 설정이 완료되면 고객 데이터를 수집하기 위한 데이터 소스 통합을 설정합니다. 1. AWS 관리 콘솔에 로그인하고 **Amazon Connect**를 선택한 다음 연결 인스턴스 별칭에서 Customer Profiles를 선택합니다. 1. **데이터 소스 통합** 섹션에서 **데이터 소스 통합 추가**를 선택합니다. ![\[데이터 소스 통합 탭, 데이터 소스 통합 추가 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step2.png) 1. **데이터 소스** 드롭다운에서 외부 애플리케이션을 선택하고 **다음**을 선택합니다. **새 흐름 생성**을 선택하여 새 탭에서 Amazon AppFlow 콘솔을 열 수도 있습니다. ![\[데이터 소스 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step3.png) 1. **흐름 이름** 드롭다운에서 데이터 소스에서 사용할 흐름을 선택하고 **다음**을 선택합니다. ![\[연결을 설정할 흐름 이름을 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step4.png) 1. **데이터 매핑** 드롭다운에서 객체의 외부 애플리케이션 데이터 매핑을 선택하여 데이터 소스가 프로필에 매핑되는 방식을 정의합니다. **다음**을 선택합니다. ![\[데이터 매핑 선택 페이지, 매핑 드롭다운 상자.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step5.png) 1. 검토하고 **데이터 소스 통합 추가**를 선택합니다. 외부 애플리케이션의 데이터 소스 통합은 활성 상태로 전환되기 전에 처음에는 보류 중으로 표시됩니다. ![\[검토 및 통합 페이지, 데이터 소스 통합 추가 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step6.png) ### Amazon Connect Customer Profiles 에이전트 CCP에서 통합 고객 프로필 보기 이제 에이전트는 Amazon Connect Agent CCP에 로그인하여 외부 애플리케이션에서 가져온 고객 데이터를 볼 수 있습니다. Amazon Connect 에이전트 CCP에 연결하는 방법에 대한 자세한 내용은 [에이전트 애플리케이션: 모든 것을 한곳에서](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-contact-control-panel.html#use-agent-application)를 참조하세요. 에이전트가 Customer Profiles를 보려면 적절한 보안 프로필 권한이 있어야 하며 프로필 검색 창에서 키 이름과 값을 사용하여 검색을 수행할 수 있습니다. 보안 프로필 권한에 대한 자세한 내용은 [보안 프로필](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html)을 참조하세요. 고유한 사용자 지정 에이전트 애플리케이션과 포함된 고객 프로필을 구축하려는 고급 사용자는 에이전트 애플리케이션보다 더 세부적으로 사용자 지정할 수 있는 [StreamsJS](https://github.com/amazon-connect/amazon-connect-customer-profiles)를 사용할 수 있습니다. # Customer Profiles 삭제 또는 통합 중지 **참고** 매핑을 삭제하면 해당 매핑과 관련된 객체 및 데이터만 삭제됩니다. 프로필과 연결된 객체가 여러 개 있는 경우 특정 매핑을 삭제해도 프로필 데이터가 지워지지 않을 수 있습니다. 특정 데이터를 삭제하려면 매핑을 삭제해야 하지만 다른 매핑의 데이터가 포함된 프로필은 여전히 존재할 수 있습니다. 이로 인해 기존 프로필에 대한 추가 요금이 부과될 수 있습니다. [Amazon Connect 콘솔](delete-customer-profiles-domain.md) 또는 [DeleteDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_DeleteDomain.html) API를 사용하여 Customer Profiles에서 도메인과 모든 데이터(모든 프로필 포함)를 삭제할 수 있습니다. **콘솔 방식** + 고객 프로필 데이터 수집을 중지하려면 언제든지 통합/매핑을 선택한 다음 **삭제**를 선택합니다. + Amazon Connect 콘솔에서 고객 프로필 도메인을 삭제하여 통합, 고객 프로필 및 모든 고객 프로필 데이터를 삭제할 수 있습니다. 자세한 내용은 [Amazon Connect Customer Profiles 도메인 삭제](delete-customer-profiles-domain.md) 단원을 참조하십시오. **API 방식** + 특정 통합의 고객 프로필 데이터를 삭제하려면 `DeleteProfileObjectType` API를 사용하세요. + 통합, 고객 프로필 및 모든 고객 프로필 데이터를 삭제하려면 `DeleteDomain` API를 사용하세요. 고객 프로필 데이터 수집을 다시 활성화하려면 설정 단계를 다시 진행하세요. # Amazon Connect Customer Profiles 객체 유형 매핑입니다. 객체 유형 매핑은 Customer Profiles에 특정 유형의 데이터를 수집하는 방법을 알려 줍니다. Customer Profiles에 다음과 같은 필수 정보를 제공합니다. + 데이터를 객체로부터 채워지고 표준 프로필 객체에 수집되는 방법. + 객체에서 인덱싱되어야 하는 필드와 이 유형의 객체를 특정 프로필에 할당하는 데 이러한 필드가 사용되는 방법. 이 섹션의 주제에서는 객체 유형 매핑, 매핑 정의 세부 정보, 주요 개념 및 용어를 생성하는 방법을 포함하여 객체 유형 매핑을 설정하는 데 도움이 되는 정보와 단계를 제공합니다. **Topics** + [고객 객체 유형 매핑의 개념 및 용어](customer-profiles-terminology.md) + [객체 유형 매핑 생성](create-object-type-mapping.md) + [Amazon Connect Customer Profiles의 객체 유형 매핑 정의 세부 정보](object-type-mapping-definition-details.md) + [Customer Profiles에서 객체 유형의 추가 속성](additional-properties-object-types.md) + [추론된 프로필](inferred-profiles.md) + [고객 응대 레코드 템플릿](ctr-contact-record-template.md) + [Customer Profiles에서 \$1phone 키를 사용하여 찾은 하나의 프로필과 연락처 레코드 연결](auto-associate-profile-using-phone-profile-key.md) + [Amazon Connect Customer Profiles의 객체 유형 매핑 예제](examples-object-type-mappings.md) + [Amazon Connect Customer Profiles의 암시적 프로필 객체 유형](implicit-profile-object-types.md) + [생성형 AI 기반 데이터 매핑](genai-powered-data-mapping.md) + [Customer Profiles 데이터 제한](customer-profiles-data-limits.md) # 고객 객체 유형 매핑의 개념 및 용어 다음 용어와 개념은 사용자 지정 객체 유형 매핑의 이해에 매우 중요합니다. **표준 프로필 객체** *표준 프로필 객체*는 모든 프로필에 포함된 사전 정의된 객체입니다. 표준 프로필 객체에는 전화번호, 이메일 주소, 이름 및 기타 표준 데이터와 같은 표준 필드가 포함됩니다. 이 데이터는 소스(예: Salesforce, ServiceNow 또는 Marketo)에 관계없이 표준 형식으로 검색할 수 있습니다. **프로필 객체** *프로필 객체*는 프로필에 대해 알려진 단일 정보 단위입니다. 전화 통화, 티켓, 사례 또는 웹 사이트의 클릭 스트림 레코드에 대한 정보를 예로 들 수 있습니다. 단일 프로필 객체는 최대 250KB일 수 있으며 임의의 구조화된 JSON 문서일 수 있습니다. + 모든 프로필 객체에는 유형이 있습니다. 예를 들어, 프로필 객체는 Amazon Connect 고객 응대 레코드, ServiceNow 사용자 또는 Marketo 리드일 수 있습니다. + 유형은 객체 유형 매핑을 나타냅니다. + 객체 유형 매핑은 해당 특정 객체가 Customer Profiles에 통합되는 방법을 정의합니다. **프로필** *프로필*에는 특정 고객이나 고객 응대에 대해 알려진 모든 정보가 포함됩니다. 여기에는 단일 표준 프로필 객체와 임의 개수의 추가 프로필 객체가 포함됩니다. **객체 유형 매핑** *객체 유형 매핑*은 Customer Profiles에 특정 유형의 데이터를 수집하는 방법을 알려 줍니다. 이는 Customer Profiles에 다음 정보를 제공합니다. + 데이터를 객체로부터 채워지고 표준 프로필 객체에 수집되는 방법. + 객체에서 인덱싱되어야 하는 필드와 이 유형의 객체를 특정 프로필에 할당하는 데 이러한 필드가 사용되는 방법. **매핑 템플릿** *매핑 템플릿*은 Customer Profiles 서비스에 포함된 사전 정의된 객체 유형 매핑입니다. Customer Profiles에는 Amazon Connect 고객 응대 레코드, Salesforce 계정, ServiceNow 사용자 및 Marketo 리드에 대한 매핑 템플릿이 포함됩니다. 사용 가능한 매핑 템플릿의 전체 목록을 보려면 [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html) API를 사용하세요. 매핑 템플릿을 사용하면 추가 정보를 지정하지 않고도 잘 알려진 소스의 데이터를 빠르게 수집할 수 있습니다. # Amazon Connect Customer Profiles 객체 유형 매핑을 생성합니다. 객체 유형 매핑은 Salesforce, Zendesk 또는 S3와 같은 소스 애플리케이션에서 특정 유형의 데이터를 통합 표준 프로필 객체로 수집하는 방법을 Customer Profiles에 알려 줍니다. 그런 다음 [Amazon Connect 에이전트 애플리케이션](customer-profile-access.md)을 사용하여 해당 객체의 데이터(예: 고객 주소 및 이메일)를 에이전트에게 표시할 수 있습니다. 객체 유형 매핑은 Customer Profiles에 다음 정보를 제공합니다. + 데이터를 객체로부터 채워지고 표준 프로필 객체에 수집되는 방법. + 객체에서 인덱싱되어야 하는 필드와 이 유형의 객체를 특정 프로필에 할당하는 데 이러한 필드가 사용되는 방법. 다음 두 가지 방법으로 객체 유형 매핑을 생성할 수 있습니다. + Amazon Connect 콘솔을 사용합니다. 사용자 인터페이스를 통해 데이터 매핑 기능에 쉽게 액세스할 수 있습니다. 예를 들어 사용자 지정 속성을 추가하고 고객 응대 모델에 대한 검색 및 고유 식별자를 정의할 수 있습니다. 코딩은 필요 없습니다. + Customer Profiles API를 사용합니다. 자세한 내용은 [Amazon Connect Customer Profiles API 참조](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html)를 확인하세요. 이 주제에서는 Amazon Connect 콘솔을 사용하여 매핑을 생성하는 방법에 대해 설명합니다. ## Amazon Connect 콘솔을 사용하여 데이터 매핑 생성 Amazon Connect는 자체 개발 애플리케이션 및 타사 애플리케이션의 고객 데이터를 Amazon S3, Salesforce, ServiceNow, Zendesk 및 Marketo와 매핑하기 위한 코드 없는 환경을 제공합니다. 데이터 매핑을 생성하려면 사용자 지정 프로필 객체의 모습을 설명하는 객체 유형 매핑을 정의해야 합니다. 이 매핑은 데이터의 필드가 표준 프로필의 필드를 채우 데 사용될 수 있는 방법 또는 데이터를 특정 프로필에 할당하는 데 사용될 수 있는 방법을 정의합니다. ### 1단계: 데이터 매핑 설정 1. [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)에서 Amazon Connect 콘솔을 엽니다. 1. 인스턴스 페이지에서 인스턴스 별칭을 선택합니다. 인스턴스 별칭은 Amazon Connect URL에 표시되는 **인스턴스 이름**이기도 합니다. 다음 이미지는 **Amazon Connect 가상 고객 센터 인스턴스** 페이지를 보여 주며, 인스턴스 별칭을 둘러싼 상자가 있습니다. ![\[Amazon Connect 가상 고객 센터 인스턴스 페이지, 인스턴스 별칭.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/instance.png) 1. 탐색 창에서 **고객 프로필**, **데이터 매핑**을 선택합니다. 1. 시작하려면 **데이터 매핑 생성**을 선택합니다. 1. **데이터 매핑 설정** 페이지의 **설명** 섹션에서 이 매핑의 소스 또는 용도를 식별하는 데 도움이 되는 이름을 추가합니다. 이는 객체 유형의 메타데이터입니다. 1. **데이터 소스** 섹션에서: 1. Salesforce 또는 Zendesk와 같이 데이터를 어디서 가져오는지 선택합니다. 선택에 따라 Amazon Connect는 사전 정의된 템플릿을 기반으로 사용 가능한 대상을 자동으로 선택합니다. 1. 소스 객체를 선택합니다. 이는 통합 프로필을 작성하는 데 사용됩니다. 1. **매핑 대상** 섹션에서 통합 고객 프로필을 구축하는 데 사용할 데이터를 선택합니다. 이 정보를 흐름 및 에이전트에게 표시하여 고객 응대와의 상호 작용을 개인화할 수 있습니다. 지원되는 매핑 대상에 대한 자세한 내용은 [Amazon Connect의 매핑 대상 정보](about-mapping-destinations.md) 섹션을 참조하세요. 1. **추가 옵션** 섹션에서 새 프로필 생성을 옵트아웃할 시기와 프로필 보존 기간을 선택할 수 있습니다. 이러한 옵션은 비용을 관리하는 데 도움이 됩니다. **참고** 기본적으로 도메인 보존 기간은 366일입니다. 도메인에 설정된 보존 기간을 변경하려면 [UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html) API를 사용하세요. 1. S3가 아닌 소스를 선택한 경우 *애플리케이션***과의 연결 설정** 섹션에서 기존 Amazon AppFlow 또는 Amazon EventBridge 연결을 선택하여 데이터를 연결하거나 새 연결을 생성하세요. 계정에 대한 세부 정보를 입력하여 이 데이터 소스에 대한 새 연결을 생성할 수 있습니다. 연결이 설정되면 데이터 소스에서 수집할 객체를 선택합니다. 1. **다음**을 선택합니다. ### 2단계: 맵 속성 **맵 *유형* 속성** 페이지에서 매핑 대상을 기반으로 사전 정의된 템플릿으로 채워진 필드 매핑 테이블을 볼 수 있습니다. 예를 들어 고객, 제품, 사례 또는 주문 속성으로 채워집니다. 속성(예: AccountNumber)을 선택한 다음 다른 대상을 선택하거나 자체 사용자 지정 속성 중 하나를 입력하여 사전 정의된 템플릿을 변경할 수 있습니다. 다음 이미지는 템플릿에서 고객 속성으로 채워진 페이지의 예를 보여 줍니다. ![\[Amazon Connect 탐색 메뉴, 고객 속성 매핑 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-data-mapping-2.png) 고객 프로필에 채우지 않으려는 항목을 제거하고, 소스를 변경하고, 사용자 지정 속성을 추가할 수 있습니다. 이 매핑은 데이터 소스를 사용하여 고객 프로필의 전화번호와 같은 고객 응대 정보를 채웁니다. 표준 프로필 템플릿의 속성을 사용합니다. **작은 정보** 사용자 지정 특성을 추가하기로 선택하면 대상에 항상 `Attributes.` 접두사가 추가됩니다. 이렇게 하면 Amazon Connect에서 사용자 지정 속성임을 인식할 수 있습니다. ![\[대상 필드에 매핑된 소스 필드를 보여 주는 고객 속성 매핑 인터페이스입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/custom-attribute-cp.png) 에이전트는 이제 Connect 에이전트 애플리케이션의 **추가 정보** 탭 아래에서 알파벳순으로 정렬된 사용자 지정 속성을 볼 수 있습니다. 다음 형식을 사용하여 에이전트에게 표시될 각 속성의 이름을 원하는 대로 생성할 수 있습니다. `/^Attributes\.[a-zA-Z0-9]+(?:[ _\-]+[a-zA-Z0-9]+)*$/` 수집된 모든 사용자 지정 속성은 Connect Agent 애플리케이션에 표시됩니다. 에이전트에게 특정 정보를 표시하지 않으려면 지금은 사용자 지정 특성을 수집하지 마세요. ### 3단계: 식별자 지정 **식별자 지정** 페이지에서 다음 섹션을 완료하세요. 매핑하는 데이터에 따라 페이지에 이들 중 일부가 표시되지 않을 수도 있습니다. **참고** `_profileId`, `_orderId`, `_caseId` 및 `_assetId` 이름은 내부용으로 예약되어 있습니다. 이러한 이름을 식별자 이름 중 하나로 사용하려는 경우 반드시 `LOOKUP_ONLY`로 선언해야 합니다. 즉, 시스템에서 프로필, 표준 자산, 표준 주문, 표준 사례와 매칭하기 위해 저장하거나 프로필, 자산, 사례 또는 주문을 검색하기 위해 저장하지 않습니다. 이러한 키를 검색 및 매칭에 사용할 수 있게 하려면 키 이름을 바꿔야 합니다. `LOOKUP_ONLY` 표준 식별자에 대한 자세한 내용은 [Customer Profiles의 키에 속성을 설정하기 위한 표준 식별자](standard-identifiers.md) 섹션을 참조하세요. + **고유 식별자**: 데이터를 수집할 때 오류가 발생하지 않도록 하려면 데이터에 대한 고유 식별자가 있어야 합니다. 이 식별자를 고유 키라고도 합니다. Customer Profiles는 이 데이터를 다른 데이터 소스 객체와 구분하고 검색 및 업데이트 데이터를 인덱싱하는 데 고유 식별자를 사용합니다. 고유 식별자는 하나만 있을 수 있습니다. + **고유 식별자**: 데이터를 수집할 때 오류가 발생하지 않도록 하려면 데이터에 대한 고객 고유 식별자가 하나 이상 있어야 합니다. 이 식별자를 프로필 키라고도 합니다. Customer Profiles는 이를 사용하여 데이터 사례가 기존 프로필과 연결되는지 아니면 다른 프로필에서 이 식별자를 검색하여 새 프로필을 만드는 데 사용되는지를 결정합니다. 고객 식별자를 여러 개 사용할 수 있습니다. **작은 정보** 에이전트는 상호 작용 시 에이전트 Workspace에서 이러한 고객 식별자를 사용하여 고객의 프로필을 찾을 수 있습니다. + **제품 식별자**: 데이터를 수집할 때 오류가 발생하지 않도록 하려면 데이터에 대한 제품 고유 식별자가 하나 이상 있어야 합니다. 이 식별자를 자산 키라고도 합니다. Customer Profiles는 이 데이터를 다른 고객 제품 구매 데이터와 구별하는 데 자산 키를 사용합니다. 이 키는 또한 데이터가 기존 프로필과 연결될 수 있는지 아니면 다른 프로필에서 이 식별자를 검색하여 새 프로필을 만드는 데 사용될 수 있는지를 결정합니다. 제품 식별자를 여러 개 사용할 수 있습니다. + **사례 식별자**: 데이터 수집 시 오류가 발생하지 않도록 하려면 데이터에 대한 사례 식별자가 하나 이상 있어야 합니다. 이 식별자를 사례 키라고도 합니다. Customer Profiles는 이 데이터를 다른 고객 사례 데이터와 구별하는 데 사례 키를 사용합니다. 이 키는 또한 데이터가 기존 프로필과 연결될 수 있는지 아니면 다른 프로필에서 이 식별자를 검색하여 새 프로필을 만드는 데 사용될 수 있는지를 결정합니다. 사례 식별자를 여러 개 사용할 수 있습니다. + **주문 식별자**: 데이터 수집 시 오류가 발생하지 않도록 하려면 데이터에 대한 주문 식별자가 하나 이상 있어야 합니다. 이 식별자를 주문 키라고도 합니다. Customer Profiles는 이 데이터를 다른 고객 주문 데이터와 구별하는 데 주문 키를 사용합니다. 이 키는 또한 데이터가 기존 프로필과 연결될 수 있는지 아니면 다른 프로필에서 이 식별자를 검색하여 새 프로필을 만드는 데 사용될 수 있는지를 결정합니다. 주문 식별자를 여러 개 사용할 수 있습니다. + **추가 검색 속성 - 선택 사항**: 검색 가능하도록 인덱싱하려는 데이터 소스 객체 의 속성을 선택할 수 있습니다. 기본적으로 모든 식별자가 인덱싱됩니다. **작은 정보** 데이터 소스 객체의 검색 속성에 대부분 동일한 값이 포함되어 있는 경우 데이터 수집이 느려질 수 있습니다. 데이터 소스 객체에서 고유한 검색 속성을 생성하는 것이 좋습니다. + **데이터 객체 타임스탬프:** 유사한 프로필을 통합하기 위해 자격 증명 확인이 활성화된 경우 데이터 객체 타임스탬프는 프로필 충돌 문제를 해결하는 데 사용됩니다. 두 개 이상의 유사한 프로필에 충돌하는 레코드가 있는 경우 가장 최근에 업데이트된 타임스탬프가 있는 프로필의 레코드가 사용됩니다. 객체가 마지막으로 업데이트된 시기에 참조할 객체의 속성을 선택할 수 있습니다. ### 4단계: 검토 및 생성 데이터 매핑이 생성된 후 **데이터 소스 통합 추가**를 선택하여 이 객체 유형을 사용할 수 있습니다. ![\[샘플 데이터 매핑 세부 정보 및 통합 상태를 보여 주는 Amazon Connect Customer Profiles 인터페이스입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-data-mapping-3.png) # Amazon Connect의 매핑 대상 정보 매핑 대상은 소스에서 Amazon Connect에 이미 정의된 표준 정의로의 매핑입니다. 다음 표에는 지원되는 매핑 대상이 나와 있습니다. | 소스 객체 | 대상: 고객, 제품, 주문, 사례 | | --- | --- | | S3 | 임의 | | Salesforce-Account | Customer | | Salesforce-Contact | Customer | | Salesforce-Asset | 제품 | | Zendesk-users | Customer | | Marketo-leads | Customer | | Servicenow-sys\$1user | Customer | | Segment-Identify | Customer | | Segment-Customer | Customer | | Shopify-Customer | Customer | | Shopify-DraftOrder | Order | | Zendesk-tickets | 사례 | | Servicenow-task | 사례 | | Servicenow-incident | 사례 | # Customer Profiles의 객체 유형 매핑 요구 사항 Customer Profiles가 수신 데이터를 처리할 수 있으려면 객체 유형 매핑에 다음 정보가 있어야 합니다. + 표준 프로필에 매핑되거나 프로필에 데이터를 할당하는 데 사용되어야 하는 수집된 객체의 모든 필드에 대한 정의. 이는 수집된 **소스** 객체의 어떤 필드를 표준 프로필 객체의 지정된 필드에 매핑해야 하는지를 Customer Profiles에 알려 줍니다. + 사용자 지정 데이터에서 소스 객체의 어떤 필드를 어떻게 인덱싱해야 하나요? Customer Profiles에서 소스 데이터를 수집할 때 인덱싱된 필드에 따라 다음이 결정됩니다. + 특정 객체가 속하는 프로필. + 서로 관련되어 있고 같은 프로필에 배치해야 하는 객체. 고객 응대 레코드의 계좌 번호 또는 고객 응대 ID를 예로 들 수 있습니다. + 프로필을 찾는 데 사용할 수 있는 값은 무엇인가요? 예를 들어 고객 응대 이름을 인덱싱할 수 있습니다. 이렇게 하면 에이전트는 특정 이름을 가진 고객의 프로필을 모두 찾을 수 있습니다. ## 키 요구 사항 키를 하나 이상 정의해야 합니다. Customer Profiles는 이 키를 사용하여 사용자 지정 프로필 객체를 프로필에 매핑합니다. 또한 사용자 지정 프로필 객체 매핑에는 객체를 고유하게 식별하는 키가 하나 이상 있어야 이 필드의 동일한 값을 지정하여 업데이트할 수 있습니다(단일 키로 이러한 요구 사항을 충족할 수 있음). 각 키는 하나 이상의 필드로 구성될 수 있습니다. ## 필드 요구 사항 필드 정의는 소스 객체에서 해당 필드 이름의 값을 읽는 방법을 지정합니다. 또한 필드 정의는 필드에 저장되는 데이터의 종류를 지정합니다. 객체 유형 이름은 임의의 영숫자 문자열 또는 '-' 및 '\$1' 문자일 수 있으며 예약된 표준 객체 유형에 사용되는 '\$1' 문자로 시작할 수 없습니다. # Amazon Connect Customer Profiles의 객체 유형 매핑 정의 세부 정보 객체 유형 매핑 정의는 필드 정의와 키 정의의 두 부분으로 구성됩니다. **작은 정보** 객체 유형 매퍼를 생성하는 방법을 알아보려면 [사전 구축된 Amazon S3 커넥터를 사용하는 Amazon Connect Customer Profiles로 고객 정보 통합 및 구성](https://aws.amazon.com/blogs/contact-center/unify-and-organize-customer-information-with-amazon-connect-customer-profiles-with-the-pre-built-amazon-s3-connector/) 블로그 게시물을 참조하세요. 또는 YouTube에서 [고객 프로필 데이터를 고객 센터 경험에 통합하는 방법](https://www.youtube.com/watch?v=LLIEwFel_7c&t=1767s) 동영상을 확인해 보세요. ## 필드 정의 세부 정보 필드 정의는 소스, 대상, 필드 유형을 정의합니다. 예제: ``` "Fields": { "{fieldName}": { "Source": "{source}", "Target": "{target}", "ContentType": "{contentType}" }, ... }, ... ``` + `Source`: 필드의 JSON 접근자 또는 필드 값을 생성하기 위한 핸들바 매크로일 수 있습니다. 구문 분석되는 소스 객체에는 ` _source`라는 이름이 지정되므로 소스 필드의 모든 필드 앞에 이 문자열을 붙여야 합니다. `_source` 객체만 지원됩니다. 핸들바 매크로 솔루션을 사용하면 상수를 생성하고 여러 소스 객체 필드를 단일 필드로 결합할 수 있습니다. 이는 인덱싱에 유용합니다. + `Target`: 표준 객체 유형에서 이 필드의 데이터를 매핑해야 하는 위치를 지정합니다. 표준 프로필을 채우면 수집되는 데이터 형식에 대한 특별한 지식 없이도 Customer Profiles를 기반으로 구축된 애플리케이션을 사용하여 모든 데이터 소스에서 수집한 데이터를 사용할 수 있습니다. 이 필드는 선택 사항입니다. 키에 필드를 포함하기 위한 목적으로만 필드를 정의하는 것이 좋습니다. 이 필드의 형식은 항상 JSON 접근자입니다. 지원되는 유일한 대상 객체는 `_profile`입니다. + `ContentType`: STRING, NUMBER, PHONE\$1NUMBER, EMAIL\$1ADDRESS, NAME 값이 지원됩니다. `ContentType`이 지정되지 않으면 STRING으로 간주됩니다. `ContentType`은 에이전트가 검색할 수 있도록 값을 인덱싱하는 방법을 결정하는 데 사용됩니다. 예를 들어 `ContentType`을 PHONE\$1NUMBER로 설정하면 전화번호가 처리되므로 에이전트는 어떤 형식으로든 전화번호를 검색할 수 있습니다. 예를 들어 문자열 “\$115551234567”은 “(555)-123-4567”과 매칭됩니다. ## 키 정의 세부 정보 키에는 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API를 사용하여 객체(또는 객체가 속한 프로필)를 검색하는 데 사용할 수 있는 키를 함께 정의하는 하나 이상의 필드가 포함되어 있습니다. 프로필을 고유하게 식별하거나 객체 자체를 고유하게 식별하도록 키를 정의할 수도 있습니다. ``` "Keys": { "{keyName}": [{ "StandardIdentifiers": [...], "FieldNames": [ "{fieldname}", ...] }], ... }, ... ``` 키 이름은 도메인 전체에 적용됩니다. 두 개의 서로 다른 객체 유형 매핑에서 이름이 같은 키가 두 개 있는 경우: + 이러한 키는 동일한 네임스페이스를 차지해야 합니다. + 이는 서로 다른 객체 간에 프로필을 서로 연결하는 데 사용할 수 있습니다. 객체 간에 키가 일치하는 경우 Customer Profiles는 두 객체를 동일한 프로필에 배치합니다. 다른 말로 표현하자면, 동일한 값이 키가 서로 관련되어 있다는 의미인 경우에만 도메인에서 키의 이름이 서로 같을 수 있습니다. 예를 들어, 한 유형의 객체에 지정된 전화번호는 다른 유형의 객체에 지정된 동일한 전화번호와 관련이 있습니다. Salesforce에서 가져온 객체에 지정된 내부 식별자는 Marketo에서 가져온 다른 객체와 값이 완전히 같더라도 해당 객체와 관련이 없을 수 있습니다. 키 정의는 다음 두 가지 방법으로 사용됩니다. + 수집 중에 Customer Profiles 내에서 객체를 할당해야 하는 프로필을 파악하는 데 사용됩니다. + 이를 통해 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API를 사용하여 키 값을 검색하고 프로필을 찾을 수 있습니다. ## 기본 검색 키 `_phone` 및 `_email`과 같은 기본 검색 키는 [표준 프로필](standard-profile-definition.md), [표준 자산](standard-asset-definition.md), [표준 주문](standard-order-definition.md) 및 [표준 사례](standard-case-definition.md) 객체 템플릿에 의해 사전 정의됩니다. 기본 검색 키를 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)의 키 이름으로 사용하여 프로필을 찾을 수 있습니다. # Customer Profiles의 키에 속성을 설정하기 위한 표준 식별자 표준 식별자를 사용하면 키에 속성을 설정할 수 있습니다. 프로필에 데이터를 수집하려는 방식에 따라 사용할 식별자를 결정하세요. 예를 들어 전화번호를 식별자 PROFILE로 표시합니다. 즉, 전화번호는 고유 식별자로 취급됩니다. Customer Profiles에 동일한 전화번호를 가진 두 고객 응대가 있는 경우 고객 응대는 단일 프로필로 병합됩니다. | 식별자 이름 | 설명 | | --- | --- | | AIR\$1PREFERENCE | 이 식별자는 이 키가 항공사 기본 설정을 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 항공사 기본 설정을 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | AIR\$1BOOKING | 이 식별자는 이 키가 항공편 예약을 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 항공권 예약을 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | AIR\$1SEGMENT | 이 식별자는 이 키가 항공 세그먼트를 고유하게 식별함을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 항공 세그먼트를 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | HOTEL\$1PREFERENCE | 이 식별자는 이 키가 호텔 기본 설정을 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 호텔 기본 설정을 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | HOTEL\$1STAY\$1REVENUE | 이 식별자는 이 키가 호텔 숙박 수익을 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 호텔 숙박 수익을 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | HOTEL\$1RESERVATION | 이 식별자는 이 키가 호텔 예약을 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 호텔 예약을 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | LOYALTY | 이 식별자는 이 키가 충성도를 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 충성도를 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | LOYALTY\$1TRANSACTION | 이 식별자는 이 키가 충성도 거래를 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 충성도 거래를 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | LOYALTY\$1PROMOTION | 이 식별자는 이 키가 충성도 거래를 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 충성도 프로모션을 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | UNIQUE | 이 식별자는 각 객체 유형에 대해 정확히 하나의 인덱스로 지정해야 합니다. 이 키는 객체를 가져오거나 필요한 경우 제출된 객체를 나중에 업데이트하기 위해 해당 객체 유형의 객체를 고유하게 식별하는 데 사용됩니다. 새 객체를 제출할 때 UNIQUE 키를 구성하는 모든 필드를 지정해야 합니다. 그러지 않으면 제출이 거부됩니다. | | 프로필 | 이 식별자는 이 키가 프로필을 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 프로필을 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | LOOKUP\$1ONLY | 이 식별자는 객체를 수집한 후 키가 저장되지 않음을 나타냅니다. 키는 수집 중에 프로필을 결정하는 용도로만 사용됩니다. 수집 중에는 키 값이 프로필과 연결되지 않습니다. 즉, 키 값을 검색하거나 나중에 수집된 객체를 동일한 키와 매칭하는 데 사용할 수 없습니다. 키를 `UNIQUE` 식별자와 `LOOKUP_ONLY` 식별자로 모두 지정할 수는 없습니다. `NEW_ONLY` 또는 `LOOKUP_ONLY` 식별자 없이 `PROFILE` 식별자를 가진 다른 키가 하나 이상 있는 경우에만 `LOOKUP_ONLY`와 함께 `PROFILE`을 사용할 수 있습니다. 유일한 예외는 `_profileId` 키로, 자체적으로 `PROFILE` 및 `LOOKUP_ONLY` 식별자 조합을 가질 수 있습니다. | | NEW\$1ONLY | 객체가 수집되기 전에 프로필이 이미 존재하지 않는 경우 키가 프로필에 연결됩니다. 그렇지 않으면 키는 객체를 프로필과 매칭하는 데만 사용됩니다. 키를 `UNIQUE` 식별자와 `NEW_ONLY` 식별자로 모두 지정할 수는 없습니다. `NEW_ONLY` 또는 `LOOKUP_ONLY` 식별자 없이 `PROFILE` 식별자를 가진 다른 키가 하나 이상 있는 경우에만 `NEW_ONLY`와 함께 `PROFILE`을 사용할 수 있습니다. | | SECONDARY | 객체를 프로필에 매칭하는 동안 Customer Profiles는 먼저 SECONDARY 식별자가 없는 모든 프로필 키를 조회합니다. 이러한 사항이 먼저 고려됩니다. SECONDARY 키는 이러한 키를 사용하여 매칭되는 프로필을 찾을 수 없는 경우에만 고려됩니다. | | ASSET | 이 식별자는 이 키가 자산을 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 자산을 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | ORDER | 이 식별자는 이 키가 주문을 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 주문을 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | | CASE | 이 식별자는 이 키가 사례를 고유하게 식별한다는 것을 의미합니다. 이 식별자를 지정하면 수집 중에 Customer Profiles가 이 키와 연결된 사례를 찾는다는 의미입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/standard-identifiers.html) | ## 호환되는 식별자 ![\[다양한 데이터 형식에 대해 허용 및 제한된 식별자와 키 이름을 보여 주는 매트릭스입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/standard-identifiers-compatibility-image.png) # Customer Profiles가 키 정의를 처리하는 방법 Customer Profiles는 사용자 지정 객체 매핑을 수집할 때 키 정의를 처리합니다. 다음 다이어그램은 Customer Profiles가 주요 정의의 표준 식별자를 처리하여 객체를 할당할 프로필을 결정하는 방법을 보여 줍니다. ![\[객체 할당 또는 대기열에 추가하기 위한 프로필 키 확인 프로세스를 보여 주는 흐름도입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-template1.png) # Customer Profiles가 조회를 위해 인덱스에 키를 추가하는 방법 다음 다이어그램은 Customer Profiles가 표준 식별자를 처리하여 키를 유지할지 여부를 결정하는 방법을 보여 줍니다. ![\[조회 및 새 객체 기준에 따라 Customer Profiles에서 키를 유지하기 위한 결정 프로세스를 보여 주는 흐름도입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-template2.png) 이 흐름도는 다음 단계를 보여 줍니다. 1. 키가 `LOOKUP_ONLY`를 지정했습니까? + 예인 경우 키를 유지하지 마세요. 1. 아니요인 경우 `NEW_ONLY`를 지정했습니까? + 아니요인 경우 조회에 사용할 수 있도록 인덱스에 키를 저장합니다. 1. 예인 경우 객체를 수집하면 새 프로필이 생성됩니까? + 아니요인 경우 조회에 사용할 수 있도록 인덱스에 키를 저장합니다. + 아니요인 경우 향후 조회를 위해 인덱스에 키를 유지하지 마십시오. # Amazon Connect Customer Profiles에서 표준 프로필에 객체 유형 매핑 이 섹션의 주제에서는 표준 프로필 정의와 외부 애플리케이션에서 표준 프로필로의 객체 유형 매핑을 제공합니다. **Topics** + [Amazon AppFlow 액세스 요구 사항](appflow-access-requirements-profile.md) + [Amazon AppIntegrations 액세스 요구 사항](standard-profile-appintegrations-requirements.md) + [Customer Profiles의 Amazon EventBridge 액세스 요구 사항](standard-profile-eventbridge-requirements.md) + [표준 프로필 정의](standard-profile-definition.md) + [Salesforce 객체 매핑](mapping-salesforce-objects.md) + [Zendesk 객체 매핑](mapping-zendesk-objects.md) + [Marketo 객체 매핑](mapping-marketo-objects.md) + [ServiceNow 객체 매핑](mapping-servicenow-objects.md) + [Segment 객체 매핑](mapping-segment-objects.md) + [Shopify 객체 매핑](mapping-shopify-objects.md) # Customer Profiles의 Amazon AppFlow 액세스 요구 사항 Amazon Connect Customer Profiles에 Zendesk, Marketo, Salesforce 및 ServiceNow 통합을 만들고 삭제하기 위해 다음의 Amazon AppFlow 액세스 요구 사항을 따릅니다. + appflow:CreateFlow + appflow:DeleteFlow # Customer Profiles의 Amazon AppIntegrations 액세스 요구 사항 Amazon Connect Customer Profiles의 Segment 및 Shopify 통합을 생성하고 삭제하기 위해 다음의 Amazon AppIntegrations 액세스 요구 사항을 사용합니다. + app-integrations:GetEventIntegration + app-integrations:ListEventIntegrationAssociations + app-integrations:CreateEventIntegrationAssociation + app-integrations:DeleteEventIntegrationAssociation # Customer Profiles의 Amazon EventBridge 액세스 요구 사항 Amazon Connect Customer Profiles의 Segment 및 Shopify 통합을 생성하고 삭제하기 위해 다음의 Amazon EventBridge 액세스 요구 사항을 사용합니다. + `events:ListTargetsByRule` + `events:PutRule` + `events:PutTargets` + `events:DeleteRule` + `events:RemoveTargets` # Amazon Connect Customer Profiles의 표준 프로필 정의 다음 표에는 Customer Profiles 표준 프로필 객체의 모든 필드가 나열되어 있습니다. | 표준 프로필 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | ProfileId | 문자열 | 고객 프로필의 고유 식별자입니다. | | AccountNumber | 문자열 | 고객에게 부여한 고유 계정 번호입니다. | | AdditionalInformation | 문자열 | 고객 프로필과 관련된 모든 추가 정보입니다. | | PartyType | 문자열 | 고객을 설명하는 데 사용되는 프로필 유형입니다. 유효한 값: INDIVIDUAL \$1 BUSINESS \$1 OTHER | | BusinessName | 문자열 | 고객의 비즈니스 이름입니다. | | FirstName | 문자열 | 고객의 이름입니다. | | MiddleName | 문자열 | 고객의 중간 이름입니다. | | LastName | 문자열 | 고객의 성입니다. | | BirthDate | 문자열 | 고객의 생년월일입니다. | | Gender | 문자열 | 고객의 성별 정체성입니다. | | PhoneNumber | 문자열 | 휴대폰, 집 또는 회사 번호로 지정되지 않은 고객의 전화번호입니다. | | MobilePhoneNumber | 문자열 | 고객의 휴대폰 번호입니다. | | HomePhoneNumber | 문자열 | 고객의 집 전화번호입니다. | | BusinessPhoneNumber | 문자열 | 고객의 회사 전화번호입니다. | | EmailAddress | 문자열 | 개인 또는 회사 주소로 지정되지 않은 고객의 이메일 주소입니다. | | PersonalEmailAddress | 문자열 | 고객의 회사 이메일 주소 | | BusinessEmailAddress | 문자열 | 고객의 회사 이메일 주소입니다. | | 주소 | 주소 | 우편, 배송 또는 청구서 수신 주소가 아닌 고객과 관련된 일반 주소입니다. | | ShippingAddress | 주소 | 고객의 배송 주소입니다. | | MailingAddress | 주소 | 고객의 우편 주소입니다. | | BillingAddress | 주소 | 고객의 청구서 수신 주소입니다. | | 속성 | 문자열 간 맵 | 고객 프로필의 키-값 속성 쌍입니다. | | ProfileType | 문자열 | 프로필 유형 유효한 값: PROFILE \$1 ACCOUNT\$1PROFILE | | EngagementPreferences | EngagementPreferences | 고객 또는 계정의 참여 기본 설정 | 표준 프로필 객체는 다음 표의 키로 인덱싱됩니다. | 표준 인덱스 이름 | 표준 프로필 필드 | | --- | --- | | \$1phone | PhoneNumber, MobilePhoneNumber, HomePhoneNumber 또는 BusinessPhoneNumber | | \$1email | EmailAddress, PersonalEmailAddress 또는 BusinessEmailAddress | | \$1account | AccountNumber | | \$1profileId | ProfileId | | \$1fullName | "FirstName MiddleName LastName" | 예를 들어 `_phone`을 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)의 키 이름으로 사용하여 PhoneNumber, MobilePhoneNumber, HomePhoneNumber 또는 BusinessPhoneNumber 속성이 검색 값과 일치하는 프로필을 찾을 수 있습니다. ## 주소 데이터 유형 | 표준 프로필 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | Address1 | 문자열 | 고객 주소의 첫 번째 행입니다. | | Address2 | 문자열 | 고객 주소의 두 번째 행입니다. | | Address3 | 문자열 | 고객 주소의 세 번째 행입니다. | | Address4 | 문자열 | 고객 주소의 네 번째 행입니다. | | City | 문자열 | 고객이 거주하는 도시입니다. | | 국가 | 문자열 | 고객이 거주하는 국가입니다. | | County | 문자열 | 고객이 거주하는 카운티입니다. | | PostalCode | 문자열 | 고객 주소의 우편번호입니다. | | Province | 문자열 | 고객이 거주하는 도입니다. | | State | 문자열 | 고객이 거주하는 주입니다. | ## EngagementPreferences 데이터 형식 | 표준 프로필 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 이메일 | ContactPreference 객체 배열 | 이메일 관련 연락처 기본 설정 목록 | | 전화번호 | ContactPreference 객체 배열 | 전화 관련 연락처 기본 설정 목록 | ## ContactPreference 데이터 형식 | 표준 프로필 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | KeyName | 문자열 | 고객 프로필의 고유 식별자입니다. | | KeyValue | 문자열 | keyName을 기반으로 프로필을 조회하는 데 사용되는 키 값입니다. | | ProfileId | 문자열 | 고객 프로필의 고유 식별자입니다. | | ContactType | 문자열 | 참여에 사용되는 연락처 유형입니다. 유효한 값: PhoneNumber \$1 MobilePhoneNumber \$1 HomePhoneNumber \$1 BusinessPhoneNumber \$1 EmailAddress \$1 PersonalEmailAddress \$1 BusinessEmailAddress | # Amazon Connect Customer Profiles의 표준 프로필에 Salesforce 객체 매핑 이 주제에는 Salesforce 객체에서 Customer Profiles의 표준 프로필 객체에 매핑되는 필드의 목록이 나열되어 있습니다. ## Salesforce-Account 객체 다음은 Salesforce-Account 객체의 모든 필드 목록입니다. Salesforce-Account 객체의 필드는 Salesforce 인스턴스의 구성에 따라 달라질 수 있습니다. + Id + IsDeleted + MasterRecordId + 이름 + Type + ParentId + BillingStreet + BillingCity + BillingState + BillingPostalCode + BillingCountry + BillingLatitude + BillingLongitude + BillingGeocodeAccuracy + BillingAddress.City + BillingAddress.Country + BillingAddress.geocodeAccuracy + BillingAddress.latitude + BillingAddress.longitude + BillingAddress.postalCode + BillingAddress.state + BillingAddress.street + ShippingStreet + ShippingCity + ShippingState + ShippingPostalCode + ShippingCountry + ShippingLatitude + ShippingLongitude + ShippingGeocodeAccuracy + ShippingAddress.city + ShippingAddress.country + ShippingAddress.latitude + ShippingAddress.longitude + ShippingAddress.postalCode + ShippingAddress.state + ShippingAddress.street + 전화번호 + Fax + AccountNumber + Website + PhotoUrl + Sic + Industry + AnnualRevenue + NumberOfEmployees + Ownership + TickerSymbol + 설명 + Rating + 사이트 + OwnerId + CreatedDate + CreatedById + LastModifiedDate + LastModifiedId + SystemModstamp + LastActivityDate + LastViewedDate + LastReferencedDate + Jigsaw + JigsawCompanyId + CleanStatus + AccountSource + DunsNumber + Tradestyle + NaicsCode + NaicsDesc + YearStarted + SicDesc + DandbCompanyId + IsBuyer ## Salesforce-Account 객체를 표준 프로필에 매핑 Salesforce-Account 객체에서 Customer Profiles의 표준 프로필 객체에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Salesforce-Account 객체에서 표준 프로필로 매핑될 수 있는 필드가 나열되어 있습니다. (이 표에는 Person 필드를 포함하도록 구성된 Salesforce 인스턴스에 대한 매핑이 포함되어 있습니다.) | Salesforce-Account 소스 필드 | 표준 프로필 대상 필드 | | --- | --- | | Id | Attributes.sfdcAccountId | | 이름 | BusinessName | | 전화번호 | PhoneNumber | | BillingStreet | BillingAddress.Address1 | | BillingCity | BillingAddress.City | | BillingState | BillingAddress.State | | BillingCountry | BillingAddress.Country | | BillingPostalCode | BillingAddress.PostalCode | | ShippingStreet | ShippingAddress.Address1 | | ShippingCity | ShippingAddress.City | | ShippingState | ShippingAddress.State | | ShippingCountry | ShippingAddress.Country | | ShippingPostalCode | ShippingAddress.PostalCode | | IsPersonAccount | PartyType | | PersonMobilePhone | MobilePhoneNumber | | PersonHomePhone | HomePhoneNumber | | PersonEmail | PersonalEmailAddress | | PersonMailingAddress.Street | MailingAddress.Address1 | | PersonMailingAddress.City | MailingAddress.City | | PersonMailingAddress.State | MailingAddress.State | | PersonMailingAddress.Country | MailingAddress.Country | | PersonMailingAddress.PostalCode | MailingAddress.PostalCode | | PersonBirthDate | BirthDate | | PersonOtherStreet | Address.Address1 | | PersonOtherCity | Address.City | | PersonOtherState | Address.State | | PersonOtherCountry | Address.Country | | PersonOtherPostalCode | Address.PostalCode | | FirstName | FirstName | | LastName | LastName | | MiddleName | MiddleName | | AccountNumber | AccountNumber | Salesforce 객체의 Salesforce-Account 고객 데이터는 다음 표의 인덱스를 사용하여 Amazon Connect 고객 프로필과 연결됩니다. | 표준 인덱스 이름 | Salesforce-Account 소스 필드 | | --- | --- | | \$1salesforceAccountId | Id | 예를 들어, [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API에서 키 이름으로 `_salesforceAccountId`를 사용하여 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Salesforce-Account`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Salesforce-Account 객체를 찾을 수 있습니다. ## Salesforce-Contact 객체 다음은 Salesforce-Contact 객체의 모든 필드 목록입니다. + Id + IsDeleted + MasterRecordId + Accountd + LastName + FirstName + Salutation + 이름 + OtherStreet + OtherCity + OtherState + OtherPostalCode + OtherCountry + OtherLatitude + OtherLongitude + OtherGeocodeAccuracy + OtherAddress.city + OtherAddress.country + OtherAddress.geocodeAccuracy + OtherAddress.latitude + OtherAddress.postalCode + OtherAddress.state + OtherAddress.street + MailingStreet + MailingCity + MailingState + MailingPostalCode + MailingCountry + MailingLatitude + MailingLongitude + MailingGeocodeAccuracy + MailingAddress.city + MailingAddress.country + MailingAddress.geocodeAccuracy + MailingAddress.latitude + MailingAddress.longitude + MailingAddress.postalCode + MailingAddress.state + MailingAddress.street + 전화번호 + Fax + MobilePhone + HomePhone + OtherPhone + AssistantPhone + ReportsToId + 이메일 + 제목 + Department + AssistantName + LeadSource + Birthdate + 설명 + OwnerId + CreatedDate + CreatedById + LastModifiedDate + LastModifiedById + SystemModstamp + LastActivityDate + LastCURequestDate + LastCUUpdateDate + LastViewedDate + LastReferencedDate + EmailBouncedReason + EmailBouncedDate + IsEmailBounced + PhotoUrl + Jigsaw + JigawContactId + CleanStatus + IndividualId ## Salesforce-Contact 객체를 표준 프로필에 매핑 Salesforce-Contact 객체에서 Customer Profiles의 표준 프로필 객체에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Salesforce-Contact 객체에서 표준 프로필 객체로 매핑될 수 있는 필드가 나열되어 있습니다. | Salesforce-Contact 소스 필드 | 표준 프로필 대상 필드 | | --- | --- | | Id | Attributes.sfdcContactId | | AccountId | Attributes.sfdcAccountId | | LastName | LastName | | FirstName | FirstName | | MiddleName | MiddleName | | OtherStreet | Address.Address1 | | OtherCity | Address.City | | OtherState | Address.State | | OtherCountry | Address.Country | | OtherPostalCode | Address.PostalCode | | MailingStreet | MailingAddress.Address1 | | MailingCity | MailingAddress.City | | MailingState | MailingAddress.State | | MailingCountry | MailingAddress.Country | | MailingPostalCode | MailingAddress.PostalCode | | 전화번호 | PhoneNumber | | HomePhone | HomePhoneNumber | | MobilePhone | MobilePhoneNumber | | 이메일 | EmailAddress | | Birthdate | BirthDate | Salesforce 객체의 Salesforce-Contact 고객 데이터는 다음 표의 인덱스를 사용하여 Amazon Connect 고객 프로필과 연결됩니다. | 표준 인덱스 이름 | Salesforce-Contact 소스 필드 | | --- | --- | | \$1salesforceContactId | Id | | \$1salesforceAccountId | AccountId | 예를 들어, [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API에서 키 이름으로 `_salesforceAccountId` 및 `_salesforceContactId`를 사용하여 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Salesforce-Contact`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Salesforce-Contact 객체를 찾을 수 있습니다. # Amazon Connect Customer Profiles의 표준 프로필에 Zendesk 객체 매핑 이 주제에는 Zendesk 객체에서 Customer Profiles 표준 프로필의 필드에 매핑되는 필드의 목록이 나열되어 있습니다. ## Zendesk-users 객체 다음은 Zendesk-users 객체의 모든 필드 목록입니다. + id + url + external\$1id + 이메일 + 활성화 + chat\$1only + customer\$1role\$1id + role\$1type + details + last\$1login\$1at + locale + locale\$1id + moderator + notes + only\$1private\$1comments + default\$1group\$1id + phone + shared\$1phone\$1number + photo + restricted\$1agent + 역할 + shared + tags + signature + suspended + ticket\$1restriction + time\$1zone + two\$1factor\$1auth\$1enabled + user\$1fields + verified + report\$1csv + created\$1at + updated\$1at ## Zendesk 사용자를 표준 프로필에 매핑 Zendesk-users 객체에서 Customer Profiles의 표준 프로필에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Zendesk-users 객체에서 표준 프로필로 매핑될 수 있는 필드가 나열되어 있습니다. | Zendesk-users 소스 필드 | 표준 프로필 대상 필드 | | --- | --- | | id | Attributes.ZendeskUserId | | external\$1id | Attributes.ZendeskExternalId | | 이메일 | EmailAddress | | phone | PhoneNumber | Zendesk 객체의 Zendesk-users 고객 데이터는 다음 인덱스를 사용하여 Amazon Connect 고객 프로필과 연결됩니다. | 표준 인덱스 이름 | Zendesk-user 소스 필드 | | --- | --- | | \$1zendeskUserId | Id | | \$1zendeskExternalId | external\$1id | 예를 들어, [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API에서 키 이름으로 `_zendeskUserId` 및 `_zendeskExternalId`를 사용하여 Amazon Connect 고객 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Zendesk-users`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 고객 프로필과 연결된 Zendesk-users 객체를 찾을 수 있습니다. # Amazon Connect Customer Profiles의 표준 프로필에 Marketo 객체 매핑 이 주제에는 Marketo 객체에서 Customer Profiles의 표준 프로필 객체에 매핑되는 필드의 목록이 나열되어 있습니다. ## Marketo-leads 객체 다음은 Marketo-leads 객체의 모든 필드 목록입니다. + id + firstName + lastName + middleName + 이메일 + phone + mobilePhone + billingStreet + billingCity + billingState + billingCountry + billingPostalCode + address + city + state + country + postalcode + gender + dateOfBirth ## Marketo-leads를 표준 프로필에 매핑 Marketo-leads 객체의 일부 필드는 표준 프로필에 매핑됩니다. | Marketo-leads 소스 필드 | 표준 프로필 대상 필드 | | --- | --- | | id | Attributes.MarketoLeadId | | sfdcAccountId | Attributes.sfdcAccountId | | sfdcContactId | Attributes.sfdcContactId | | firstName | FirstName | | lastName | LastName | | middleName | MiddleName | | 이메일 | EmailAddress | | phone | PhoneNumber | | mobilePhone | MobilePhoneNumber | | mobilePhone | MobilePhoneNumber | | billingStreet | BillingAddress.Address1 | | billingCity | BillingAddress.City | | billingState | BillingAddress.State | | billingCountry | BillingAddress.Country | | billingPostalCode | BillingAddress.PostalCode | | address | Address.Address1 | | city | Address.City | | state | Address.State | | country | Address.Country | | postalcode | Address.PostalCode | | gender | Gender | | dataOfBirth | BirthDate | Marketo의 Marketo-leads 고객 데이터는 다음 표의 인덱스를 사용하여 Amazon Connect 고객 프로필과 연결됩니다. | 표준 인덱스 이름 | Marketo-leads 소스 필드 | | --- | --- | | \$1marketoLeadId | id | | \$1salesforceAccountId | sfdcAccountId | | \$1salesforceContactId | sfdcContactId | 예를 들어, [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API에서 키 이름으로 `_marketoLeadId`, `_salesforceAccountId` 및 `_salesforceContactId`를 사용하여 Amazon Connect 고객 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Marketo-leads`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 고객 프로필과 연결된 Marketo-leads 객체를 찾을 수 있습니다. # Amazon Connect Customer Profiles의 표준 프로필에 ServiceNow 객체 매핑 이 주제에는 ServiceNow 객체에서 Amazon Connect Customer Profiles 표준 프로필 객체의 필드에 매핑되는 필드의 목록이 나열되어 있습니다. ## Servicenow-sys\$1user 객체 다음은 Servicenow-sys\$1user 객체의 모든 필드 목록입니다. + sys\$1id + 활성화 + building + calendar\$1integration + city + company + cost\$1center + country + date\$1format + default\$1perspective + department + edu\$1status + 이메일 + employee\$1number + enable\$1multifactor\$1authn + failed\$1attempts + first\$1name + gender + home\$1phone + internal\$1integration\$1user + introduction + last\$1login + last\$1login\$1device + last\$1login\$1time + last\$1name + last\$1password + ldap\$1server + location + locked\$1out + manager + middle\$1name + mobile\$1phone + 이름 + 알림 + password\$1needs\$1reset + phone + photo + preferred\$1language + 역할 + schedule + source + state + street + sys\$1class\$1name + sys\$1created\$1by + sys\$1created\$1on + sys\$1domain.link + sys\$1domain.value + sys\$1domain\$1path + sys\$1id + sys\$1mod\$1count + sys\$1updated\$1by + sys\$1udpated\$1on + time\$1format + time\$1zone + 제목 + user\$1name + user\$1password + web\$1service\$1access\$1only + zip ## Servicenow-sys\$1users를 표준 프로필 객체에 매핑 Servicenow-sys\$1users 객체에서 Customer Profiles 객체의 표준 프로필에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Servicenow-sys\$1users 객체에서 표준 프로필로 매핑될 수 있는 필드가 나열되어 있습니다. | Servicenow-sys\$1users 소스 필드 | 고객 프로필 대상 필드 | | --- | --- | | sys\$1id | Attributes.ServiceNowSystemId | | first\$1name | FirstName | | last\$1name | LastName | | middle\$1name | MiddleName | | gender | Gender | | 이메일 | EmailAddress | | phone | PhoneNumber | | home\$1phone | HomePhoneNumber | | mobile\$1phone | MobilePhoneNumber | | street | Address.Address1 | | city | Address.City | | state | Address.State | | country | Address.Country | | zip | Address.PostalCode | Servicenow 객체의 Servicenow-sys\$1user 고객 데이터는 다음 표의 인덱스를 사용하여 Amazon Connect 고객 프로필과 연결됩니다. | 표준 인덱스 이름 | Servicenow-sys\$1user 소스 필드 | | --- | --- | | \$1serviceNowSystemId | sys\$1id | 예를 들어, [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API에서 키 이름으로 `_serviceNowSystemId` 및 `_serviceNowIncidentId`를 사용하여 Amazon Connect 고객 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Servicenow-sys_user`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Servicenow-sys\$1user 객체를 찾을 수 있습니다. # Amazon Connect Customer Profiles의 표준 프로필에 Segment 객체 매핑 이 주제에는 Segment 객체에서 Amazon Connect Customer Profiles 표준 프로필 객체의 필드에 매핑되는 필드의 목록이 나열되어 있습니다. ## Segment-Identify 객체 다음은 Segment-Identify 객체의 모든 필드 목록입니다. + userId + 공통 필드 - Segment 설명서의 [사양: 공통 필드](https://segment.com/docs/connections/spec/common/) 참조 + Segment 예약 특성 - Segment 설명서의 [특성](https://segment.com/docs/connections/spec/identify/#traits) 참조 + traits.address.street + traits.address.city + traits.address.state + traits.address.postalCode + traits.address.country + traits.age + traits.avatar + traits.birthday + traits.company.name + traits.company.id + traits.company.industry + traits.company.employee\$1count + traits.company.plan + traits.createdAt + traits.description + traits.email + traits.firstName + traits.gender + traits.id + traits.lastName + traits.name + traits.phone + traits.title + traits.username + traits.website ## Segment-Identify를 표준 프로필 객체에 매핑 Segment-Identify 객체에서 Customer Profiles의 표준 프로필 객체에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Segment-Identify 객체에서 표준 프로필로 매핑될 수 있는 필드가 나열되어 있습니다. | Segment-Identify 소스 필드 | 표준 프로필 대상 필드 | | --- | --- | | | 표준 프로필 대상 필드 | | userId | Attributes.SegmentUserId | | traits.company.name | BusinessName | | traits.firstName | FirstName | | traits.lastName | LastName | | traits.birthday | BirthDate | | traits.gender | Gender | | traits.phone | PhoneNumber | | traits.email | EmailAddress | | traits.address.street | Address.Address1 | | traits.address.city | Address.City | | traits.address.state | Address.State | | traits.address.country | Address.Country | | traits.address.postalCode | Address.PostalCode | ### 예제 다음 예시는 소스 필드와 대상 필드를 매핑하는 방법을 보여 줍니다. ``` "segmentUserId": { "Source": "_source.detail.event.detail.userId", "Target": "_profile.Attributes.SegmentUserId" } ``` Segment 객체의 Segment-Identify 고객 데이터는 다음 인덱스를 사용하여 Amazon Connect 고객 프로필과 연결됩니다. | 표준 인덱스 이름 | Segment-Identify 소스 필드 | | --- | --- | | \$1segmentUserId | userId | 예를 들어, [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API에서 키 이름으로 `_segmentUserId`를 사용하여 Amazon Connect 고객 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Segment-Identify`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Segment-Identify 객체를 찾을 수 있습니다. # Amazon Connect Customer Profiles의 표준 프로필에 Shopify 객체 매핑 이 주제에는 Shopify 객체에서 Amazon Connect Customer Profiles 표준 프로필 객체의 필드에 매핑되는 필드의 목록이 나열되어 있습니다. ## Shopify-Customer 객체 다음은 Shopify-Customer 객체의 모든 필드 목록입니다. + accepts\$1marketing + accepts\$1marketing\$1updated\$1at + 주소 + currency + created\$1at + default\$1address.address1 + default\$1address.address2 + default\$1address.city + default\$1address.company + default\$1address.country + default\$1address.country\$1code + default\$1address.country\$1name + default\$1address.customer\$1id + default\$1address.default + default\$1address.first\$1name + default\$1address.id + default\$1address.last\$1name + default\$1address.name + default\$1address.phone + default\$1address.province + default\$1address.province\$1code + default\$1address.zip + 이메일 + first\$1name + id + last\$1name + last\$1order\$1id + last\$1order\$1name + metafield.key + metafield.value + metafield.namespace + metafield.value\$1type + marketing\$1opt\$1in\$1level + multipass\$1identifier + note + orders\$1count + phone + sms\$1marketing\$1consent.state + sms\$1marketing\$1consent.opt\$1in\$1level + sms\$1marketing\$1consent.consent\$1updated\$1at + sms\$1marketing\$1consent.consent\$1collected\$1from + state + tags + tax\$1exempt + tax\$1exemptions + total\$1spent + updated\$1at + verified\$1email ## Shopify-Customer 객체를 표준 프로필에 매핑 Shopify-Customer 객체에서 Customer Profiles의 표준 프로필 객체에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Shopify-Customer 객체에서 표준 프로필로 매핑될 수 있는 필드가 나열되어 있습니다. | Shopify-Customer 소스 필드 | 표준 프로필 대상 필드 | | --- | --- | | id | Attributes.ShopifyCustomerId | | email | EmailAddress | | first\$1name | FirstName | | last\$1name | LastName | | note | AdditionalInformation | | phone | PhoneNumber | | default\$1address.address1 | Address.Address1 | | default\$1address.address2 | Address.Address2 | | default\$1address.city | Address.City | | default\$1address.province | Address.Province | | default\$1address.country | Address.Country | | default\$1address.zip | Address.PostalCode | ### 예제 다음 예시는 소스 필드와 대상 필드를 매핑하는 방법을 보여 줍니다. ``` "shopifyCustomerId": { "Source": "_source.detail.event.detail.payload.id", "Target": "_profile.Attributes.ShopifyCustomerId" } ``` Shopify 객체의 Shopify-Customer 고객 데이터는 다음 인덱스를 사용하여 Amazon Connect 고객 프로필과 연결됩니다. | 표준 인덱스 이름 | Shopify-Customer 소스 필드 | | --- | --- | | \$1shopifyCustomerId | id | 예를 들어, [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API에서 키 이름으로 `_shopifyCustomerId`를 사용하여 Amazon Connect 고객 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Shopify-Customer`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Shopify-Customer 객체를 찾을 수 있습니다. # Amazon Connect Customer Profiles의 표준 주문에 객체 유형 매핑 이 섹션의 주제에서는 표준 주문 정의와 외부 애플리케이션에서 표준 주문으로의 객체 유형 매핑을 제공합니다. **Topics** + [Amazon AppIntegrations 액세스 요구 사항](standard-order-appintegrations-requirements.md) + [Amazon EventBridge 액세스 요구 사항](standard-order-eventbridge-requirements.md) + [표준 주문 정의](standard-order-definition.md) + [Shopify 객체 매핑](mapping-shopify-objects-standard-order.html.md) # Amazon AppIntegrations 액세스 요구 사항 Amazon Connect Customer Profiles의 Shopify 통합을 생성하고 삭제하기 위해 다음의 Amazon AppIntegrations 액세스 요구 사항을 사용합니다. + app-integrations:GetEventIntegration + app-integrations:ListEventIntegrationAssociations + app-integrations:CreateEventIntegrationAssociation + app-integrations:DeleteEventIntegrationAssociation # Amazon EventBridge 액세스 요구 사항 Amazon Connect Customer Profiles의 Shopify 통합을 생성하고 삭제하기 위해 다음의 Amazon EventBridge 액세스 요구 사항을 사용합니다. + `events:ListTargetsByRule` + `events:PutRule` + `events:PutTargets` + `events:DeleteRule` + `events:RemoveTargets` # Customer Profiles 표준 주문 객체 필드 다음 표에는 Customer Profiles 표준 주문 객체의 모든 필드가 나열되어 있습니다. | 표준 주문 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | OrderId | 문자열 | 표준 주문의 고유 식별자입니다. | | CustomerEmail | 문자열 | 고객의 이메일 주소입니다. | | CustomerPhone | 문자열 | 고객의 전화번호. | | CreatedDate | 문자열 | 주문 생성 날짜입니다. | | UpdatedDate | 문자열 | 주문 날짜가 업데이트되었습니다. | | ProcessedDate | 문자열 | 주문이 처리된 날짜입니다. | | ClosedDate | 문자열 | 주문 마감 날짜입니다. | | CancelledDate | 문자열 | 주문 날짜가 취소되었습니다. | | CancelReason | 문자열 | 주문의 취소 이유입니다. | | 이름 | 문자열 | 주문 이름입니다. | | AdditionalInformation | 문자열 | 주문과 관련된 모든 추가 정보입니다. | | Gateway | 문자열 | 주문의 결제 게이트웨이입니다. | | Status | 문자열 | 주문의 상태입니다. | | StatusCode | 문자열 | 주문의 상태 코드입니다. 유효한 값: 초안 \$1 활성화됨 | | StatusUrl | 문자열 | 주문의 상태 URL입니다. | | CreditCardNumber | 문자열 | 고객의 신용 카드 마지막 4자리입니다. | | CreditCardCompany | 문자열 | 고객의 신용 카드 회사입니다. | | FulfillmentStatus | 문자열 | 주문의 이행 상태입니다. | | TotalPrice | 문자열 | 주문의 총 가격입니다. | | TotalTax | 문자열 | 주문의 총 세금입니다. | | TotalDiscounts | 문자열 | 주문의 총 할인입니다. | | TotalItemsPrice | 문자열 | 주문의 총 항목 가격입니다. | | TotalShippingPrice | 문자열 | 주문의 총 배송 가격입니다. | | TotalTipReceived | 문자열 | 주문의 총 수신 팁입니다. | | 통화 | 문자열 | 주문의 통화입니다. | | TotalWeight | 문자열 | 주문의 총 무게입니다. | | BillingAddress | OrderAddress | 고객의 청구서 수신 주소입니다. | | ShippingAddress | OrderAddress | 고객의 배송 주소입니다. | | OrderItems | OrderItem 목록 | 주문한 항목입니다. | | 속성 | 문자열 간 맵 | 표준 사례의 키-값 속성 쌍입니다. | 표준 주문 객체는 다음 표의 키로 인덱싱됩니다. | 표준 인덱스 이름 | 표준 주문 필드 | | --- | --- | | \$1orderId | OrderId | 예를 들어, [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)에서 키 이름으로 `_orderId`를 사용하여 OrderID가 검색 값과 일치하는 주문이 있는 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `_order`로 설정된 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)를 사용하여 특정 프로필과 연결된 표준 주문 객체를 찾을 수 있습니다. ## OrderAddress 데이터 유형 | 표준 주문 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 이름 | 문자열 | 주문 주소와 연결된 이름입니다. | | Address1 | 문자열 | 주문 주소의 첫 번째 줄입니다. | | Address2 | 문자열 | 주문 주소의 두 번째 줄입니다. | | Address3 | 문자열 | 주문 주소의 세 번째 줄입니다. | | Address4 | 문자열 | 주문 주소의 네 번째 줄입니다. | | City | 문자열 | 주문 주소의 도시입니다. | | County | 문자열 | 주문 주소의 주입니다. | | State | 문자열 | 주문 주소의 상태입니다. | | Province | 문자열 | 주문 주소의 도입니다. | | 국가 | 문자열 | 주문 주소의 국가입니다. | | PostalCode | 문자열 | 주문 주소의 우편 번호입니다. | ## OrderItem 데이터 유형 | 표준 주문 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 제목 | 문자열 | 주문 항목의 제목입니다. | | 가격 | 문자열 | 주문 항목의 가격입니다. | | 수량 | 문자열 | 주문 항목의 수량입니다. | # Amazon Connect Customer Profiles의 표준 주문에 Shopify 객체 매핑 이 주제에는 Shopify 객체에서 Customer Profiles 표준 주문 객체의 필드에 매핑되는 필드의 목록이 나열되어 있습니다. ## Shopify-DraftOrder 객체 Shopify-DraftOrder 객체의 모든 필드 목록은 Shopify 설명서의 [DraftOrder 객체](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object)를 참조하세요. ## Shopify-DraftOrder 객체를 표준 주문에 매핑 Shopify-DraftOrder 객체에서 Customer Profiles의 표준 주문 객체에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Shopify-DraftOrder 객체에서 표준 주문으로 매핑될 수 있는 필드가 나열되어 있습니다. 소스에 `order_status_url`이 있는 경우 `StatusCode`는 `ACTIVATED`입니다. 그렇지 않으면 `StatusCode`는 `DRAFT`입니다. | Shopify-DraftOrder source field | 표준 주문 대상 필드 | | --- | --- | | id | Attributes.ShopifyOrderId | | customer.id | Attributes.ShopifyCustomerId | | note | AdditionalInformation | | 이메일 | CustomerEmail | | currency | Currency | | created\$1at | CreatedDate | | updated\$1at | UpdatedDate | | 이름 | 이름 | | status | Status | | order\$1status\$1url | StatusCode | | billing\$1address.address1 | BillingAddress.Address1 | | billing\$1address.address2 | BillingAddress.Address2 | | billing\$1address.city | BillingAddress.City | | billing\$1address.zip | BillingAddress.PostalCode | | billing\$1address.province | BillingAddress.Province | | billing\$1address.country | BillingAddress.Country | | billing\$1address.name | BillingAddress.Name | | shipping\$1address.address1 | ShippingAddress.Address1 | | shipping\$1address.address2 | ShippingAddress.Address2 | | shipping\$1address.city | ShippingAddress.City | | shipping\$1address.zip | ShippingAddress.PostalCode | | shipping\$1address.province | ShippingAddress.Province | | shipping\$1address.country | ShippingAddress.Country | | shipping\$1address.name | ShippingAddress.Name | | invoice\$1url | StatusUrl | | total\$1price | TotalPrice | | total\$1tax | TotalTax | | line\$1items[].title | OrderItems[].Title | | line\$1items[].price | OrderItems[].Price | | line\$1items[].quantity | OrderItems[].Quantity | ### 예제 다음 예시는 소스 필드와 대상 필드를 매핑하는 방법을 보여 줍니다. ``` "shopifyOrderId": { "Source": "_source.detail.event.detail.payload.id", "Target": "_order.Attributes.ShopifyOrderId" } ``` Shopify 객체의 Shopify-DraftOrder 고객 데이터는 다음 인덱스를 사용하여 Amazon Connect 표준 주문과 연결됩니다. | 표준 인덱스 이름 | Shopify-DraftOrder source field | | --- | --- | | \$1shopifyOrderId | id | 예를 들어 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API에서 `ObjectFilter.KeyName`으로 `_shopifyOrderId`를 사용하여 표준 주문을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Shopify-DraftOrder`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Shopify-DraftOrder 객체를 찾을 수 있습니다. ## Shopify-Order 객체 Shopify-Order 객체의 모든 필드 목록은 Shopify 설명서의 [Order 객체](https://shopify.dev/api/admin-rest/2021-10/resources/order#resource_object)를 참조하세요. ## Shopify-Order 객체를 표준 주문에 매핑 Shopify-Order 객체에서 Customer Profiles의 표준 주문 객체에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Shopify-Order 객체에서 표준 주문으로 매핑될 수 있는 필드가 나열되어 있습니다. 소스에 `order_status_url`이 있는 경우 `StatusCode`는 `ACTIVATED`입니다. 그렇지 않으면 `StatusCode`는 `DRAFT`입니다. | Shopify-Order source field | 표준 주문 대상 필드 | | --- | --- | | id | Attributes.ShopifyOrderId | | customer.id | Attributes.ShopifyCustomerId | | Cancel\$1at | CancelledDate | | cancel\$1reason | CancelReason | | closed\$1at | ClosedDate | | created\$1at | CreatedDate | | currency | Currency | | 이메일 | CustomerEmail | | financial\$1status | Status | | order\$1status\$1url | StatusCode | | fulfillment\$1status | FulfillmentStatus | | 게이트웨이 | Gateway | | 이름 | 이름 | | note | AdditionalInformation | | order\$1status\$1url | StatusUrl | | phone | CustomerPhone | | 에서 처리됨 | ProcessedDate | | total\$1discounts | TotalDiscounts | | total\$1line\$1items\$1price | TotalItemsPrice | | total\$1price | TotalPrice | | total\$1shipping\$1price\$1set.shop\$1money.amount | TotalShippingPrice | | total\$1tax | TotalTax | | total\$1tip\$1received | TotalTipReceived | | total\$1weight | TotalWeight | | updated\$1at | UpdatedDate | | billing\$1address.address1 | BillingAddress.Address1 | | billing\$1address.address2 | BillingAddress.Address2 | | billing\$1address.city | BillingAddress.City | | billing\$1address.zip | BillingAddress.PostalCode | | billing\$1address.province | BillingAddress.Province | | billing\$1address.country | BillingAddress.Country | | billing\$1address.name | BillingAddress.Name | | payment\$1details.credit\$1card\$1number | CreditCardNumber | | payment\$1details.credit\$1card\$1company | CreditCardCompany | | shipping\$1address.address1 | ShippingAddress.Address1 | | shipping\$1address.address2 | ShippingAddress.Address2 | | shipping\$1address.city | ShippingAddress.City | | shipping\$1address.zip | ShippingAddress.PostalCode | | shipping\$1address.province | ShippingAddress.Province | | shipping\$1address.country | ShippingAddress.Country | | shipping\$1address.name | ShippingAddress.Name | | line\$1items[].title | OrderItems[].Title | | line\$1items[].price | OrderItems[].Price | | line\$1items[].quantity | OrderItems[].Quantity | ### 예제 다음 예시는 소스 필드와 대상 필드를 매핑하는 방법을 보여 줍니다. ``` "shopifyOrderId": { "Source": "_source.detail.event.detail.payload.id", "Target": "_order.Attributes.ShopifyOrderId" } ``` Shopify 객체의 Shopify-Order 고객 데이터는 다음 인덱스를 사용하여 Amazon Connect 표준 주문과 연결됩니다. | 표준 인덱스 이름 | Shopify-Order source field | | --- | --- | | \$1shopifyOrderId | id | 예를 들어 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API에서 `ObjectFilter.KeyName`으로 `_shopifyOrderId`를 사용하여 표준 주문을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Shopify-Order`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Shopify-Order 객체를 찾을 수 있습니다. # 표준 커뮤니케이션 레코드에 대한 객체 유형 매핑 이 섹션의 주제에서는 표준 커뮤니케이션 레코드 정의와 캠페인 이벤트에서 표준 커뮤니케이션 레코드에 대한 객체 유형 매핑을 제공합니다. **Topics** + [Customer Profiles 표준 커뮤니케이션 레코드 객체 필드](customer-profiles-standard-communication-record-object-fields.md) + [Amazon Connect Customer Profiles의 표준 커뮤니케이션 레코드에 Campaign 객체 매핑](mapping-campaign-objects-to-the-standard-communication-record-in-amazon-connect-customer-profiles.md) # Customer Profiles 표준 커뮤니케이션 레코드 객체 필드 다음 테이블에는 Customer Profiles 표준 커뮤니케이션 레코드 객체의 모든 필드가 나열되어 있습니다. | 표준 communicationRecord 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | CommunicationRecordId | 문자열 | 표준 커뮤니케이션 레코드의 고유 식별자입니다. | | 채널 | 문자열 | 콜센터와 연락하는 데 사용되는 방법입니다. 예: VOICE, CHAT, EMAIL. | | ConnectInstanceArn | 문자열 | AWS Connect 인스턴스의 ARN입니다. | | CreatedDate | 문자열 | 커뮤니케이션 레코드가 생성된 시기를 나타내는 타임스탬프입니다. | | UpdatedDate | 문자열 | 커뮤니케이션 레코드가 마지막으로 업데이트된 시기를 나타내는 타임스탬프입니다. | | LastEventType | 문자열 | 이 커뮤니케이션에 대해 수집된 마지막 이벤트의 이벤트 유형입니다. | | 캠페인 | 캠페인 | 이 커뮤니케이션과 연결된 캠페인에 대한 세부 정보입니다. | | 엔드포인트 | 엔드포인트 | 이 커뮤니케이션에 사용되는 엔드포인트에 대한 정보입니다. | | 이벤트 | Map | 키가 전송, 열기 또는 클릭된 이메일과 같은 이벤트 유형인 이벤트 맵입니다. 이렇게 하면 이 커뮤니케이션 중에 발생한 각 고유 이벤트 유형의 마지막 이벤트가 추적됩니다. | | 속성 | Map | 표준 커뮤니케이션 레코드의 키-값 속성 페어입니다. | 표준 커뮤니케이션 레코드 객체는 다음 표의 키로 인덱싱됩니다. | 표준 인덱스 이름 | 표준 커뮤니케이션 레코드 필드 | | --- | --- | | \$1communicationRecordId | CommunicationRecordId | 예를 들어 `_communicationRecordId`을 [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html) API의 키 이름으로 사용하여 `CommunicationRecordId`가 검색 값과 일치하는 커뮤니케이션 레코드가 있는 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `_communicationRecord`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 표준 `communicationRecord` 객체를 찾을 수 있습니다. ## Campaign 데이터 형식 | 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | CampaignId | 문자열 | 아웃바운드 캠페인의 고유 ID입니다. | | CampaignName | 문자열 | 아웃바운드 캠페인의 이름입니다. | | CampaignRunId | 문자열 | 캠페인의 특정 실행에 대한 고유 ID입니다. | | CampaignActivityId | 문자열 | 캠페인 내 활동의 고유 ID입니다. | | SegmentArn | 문자열 | 사용자 세그먼트의 ARN입니다. | ## 엔드포인트 데이터 형식 | 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | EndpointAddress | 문자열 | 엔드포인트의 주소(예: 이메일 주소, 전화번호). | | EndpointType | 문자열 | 기본 이메일 또는 비즈니스 이메일과 같은 엔드포인트의 유형입니다. | ## Event 데이터 형식 | 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | UpdatedDate | 문자열 | 커뮤니케이션 이벤트가 발생한 시간을 나타내는 타임스탬프입니다. | | EventId | 문자열 | 각 커뮤니케이션 이벤트에 대한 고유 식별자입니다. | | EventType | 문자열 | 특정 커뮤니케이션 이벤트 유형입니다. | | 속성 | Map | 이벤트 유형별 속성의 키-값 페어입니다. | # Amazon Connect Customer Profiles의 표준 커뮤니케이션 레코드에 Campaign 객체 매핑 이 주제에는 Campaign 객체에서 Customer Profiles 표준 커뮤니케이션 레코드 객체의 필드에 매핑되는 필드의 목록이 나열되어 있습니다. ## Campaign-Email 객체 Campaign-Email 객체의 모든 필드 목록은 Amazon SES 설명서의 [Email 객체](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-retrieving-sns-contents.html)를 참조하세요. **Campaign-Email 객체를 표준 커뮤니케이션 레코드에 매핑** Campaign-Email 객체의 필드 하위 집합은 Customer Profiles의 표준 커뮤니케이션 레코드 객체에 매핑됩니다. 다음 테이블에는 Campaign-Email 객체에서 표준 커뮤니케이션 레코드로 매핑할 수 있는 필드가 나열되어 있습니다. | Campaign-Email 소스 필드 | 표준 커뮤니케이션 레코드 대상 필드 | | --- | --- | | campaign\$1event\$1id | Attributes.LastCampaignEventId | | outbound\$1request\$1id | Attributes.OutboundCampaignRequestId | | campaign\$1message\$1id | Attributes.CampaignMessageId | | channel.name | 채널 | | channel.subtype | Attributes.ChannelSubType | | endpoint\$1address | Endpoint.EndpointAddress | | endpoint\$1type | Endpoint.EndpointType | | instance\$1arn | ConnectInstanceArn | | campaign\$1name | Campaign.CampaignName | | campaign\$1id | Campaign.CampaignId | | campaign\$1run\$1id | Campaign.CampaignRunId | | campaign\$1activity\$1id | Campaign.CampaignActivityId | | segment\$1arn | Campaign.SegmentArn | | outbound\$1request\$1creation\$1timestamp | CreatedDate | | campaign\$1event\$1timestamp | UpdatedDate | | campaign\$1event\$1type | LastEventType | | campaign\$1event\$1timestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.UpdatedDate | | campaign\$1event\$1id | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventId | | campaign\$1event\$1type | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventType | | email.bounce.bounceType | Events.Bounce.Attributes.BounceType | | email.bounce.bounceSubType | Events.Bounce.Attributes.BounceSubType | | email.click.link | Events.Click.Attributes.Link | | email.click.ipAddress | Events.Click.Attributes.IpAddress | | email.open.ipAddress | Events.Open.Attributes.IpAddress | | email.reject.reason | Events.Reject.Attributes.Reason | | email.renderingFailure.templateName | Events.RenderingFailure.Attributes.TemplateName | | email.renderingFailure.errorMessage | Events.RenderingFailure.Attributes.ErrorMessage | | email.deliveryDelay.delayType | Events.DeliveryDelay.Attributes.DelayType | | email.complaint.complaintFeedbackType | Events.Complaint.Attributes.ComplaintFeedbackType | | email.complaint.complaintSubType | Events.Complaint.Attributes.ComplaintSubType | | email.mail.commonHeaders.subject | Attributes.Subject | ## Campaign-SMS 객체 Campaign-SMS 객체의 모든 필드 목록은AWS End User Messaging SMS 설명서의 [SMS 객체](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html)를 참조하세요. **Campaign-SMS 객체를 표준 커뮤니케이션 레코드에 매핑** Campaign-SMS 객체의 필드 하위 집합은 Customer Profiles의 표준 커뮤니케이션 레코드 객체에 매핑됩니다. 다음 테이블에는 Campaign-SMS 객체에서 표준 커뮤니케이션 레코드로 매핑할 수 있는 필드가 나열되어 있습니다. | Campaign-SMS 소스 필드 | 표준 커뮤니케이션 레코드 대상 필드 | | --- | --- | | campaign\$1event\$1id | Attributes.LastCampaignEventId | | outbound\$1request\$1id | Attributes.OutboundCampaignRequestId | | campaign\$1message\$1id | Attributes.CampaignMessageId | | channel.name | 채널 | | channel.subtype | Attributes.ChannelSubType | | endpoint\$1address | Endpoint.EndpointAddress | | endpoint\$1type | Endpoint.EndpointType | | instance\$1arn | ConnectInstanceArn | | campaign\$1name | Campaign.CampaignName | | campaign.campaign\$1id | Campaign.CampaignId | | campaign.campaign\$1run\$1id | Campaign.CampaignRunId | | campaign\$1activity\$1id | Campaign.CampaignActivityId | | segment\$1arn | Campaign.SegmentArn | | outbound\$1request\$1creation\$1timestamp | CreatedDate | | campaign\$1event\$1timestamp | UpdatedDate | | campaign\$1event\$1type | LastEventType | | campaign\$1event\$1timestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.UpdatedDate | | campaign\$1event\$1id | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventId | | campaign\$1event\$1type | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventType | | sms.messageType | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.MessageType | | sms.messageStatus | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.MessageStatus | | sms.messageStatusDescription | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.MessageStatusDescription | | sms.totalMessagePrice | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.TotalMessagePrice | | sms.totalCarrierFee | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.TotalCarrierFee | | sms.isoCountryCode | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.IsoCountryCode | ## Campaign-Telephony 객체 Campaign-Telephony 객체의 모든 필드 목록은 AWS End User Messaging SMS 설명서의 [음성 객체](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html)를 참조하세요. **Campaign-Telephony 객체를 표준 커뮤니케이션 레코드에 매핑** Campaign-Telephony 객체의 필드 하위 집합은 Customer Profiles의 표준 커뮤니케이션 레코드 객체에 매핑됩니다. 다음 테이블에는 Campaign-Telephony 객체에서 표준 커뮤니케이션 레코드로 매핑할 수 있는 필드가 나열되어 있습니다. | Campaign-Telephony 소스 필드 | 표준 커뮤니케이션 레코드 대상 필드 | | --- | --- | | campaign\$1event\$1id | Attributes.LastCampaignEventId | | outbound\$1request\$1id | Attributes.OutboundCampaignRequestId | | campaign\$1message\$1id | Attributes.CampaignMessageId | | channel.name | 채널 | | channel.subtype | Attributes.ChannelSubType | | endpoint.endpoint\$1address | Endpoint.EndpointAddress | | endpoint.endpoint\$1type | Endpoint.EndpointType | | instance\$1arn | ConnectInstanceArn | | campaign.campaign\$1name | Campaign.CampaignName | | campaign.campaign\$1id | Campaign.CampaignId | | campaign.campaign\$1run\$1id | Campaign.CampaignRunId | | campaign.campaign\$1activity\$1id | Campaign.CampaignActivityId | | campaign.segment\$1arn | Campaign.SegmentArn | | outbound\$1request\$1creation\$1timestamp | CreatedDate | | campaign\$1event\$1timestamp | UpdatedDate | | campaign\$1event\$1type | LastEventType | | campaign\$1event\$1timestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.UpdatedDate | | campaign\$1event\$1id | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventId | | campaign\$1event\$1type | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventType | | voice.agentInfo.connectedToAgentTimestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.ConnectedToAgentTimestamp | | voice.customerVoiceActivity.greetingEndTimestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.GreetingEndTimestamp | | voice.answeringMachineDetectionStatus | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.AnsweringMachineDetectionStatus | | campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp | ## Campaign-Orchestration 객체 **Campaign-Orchestration 객체를 표준 커뮤니케이션 레코드에 매핑** Campaign-Orchestration 객체의 필드 하위 집합은 Customer Profiles의 표준 커뮤니케이션 레코드 객체에 매핑됩니다. 다음 테이블에는 Campaign-Orchestration 객체에서 표준 커뮤니케이션 레코드로 매핑할 수 있는 필드가 나열되어 있습니다. | Campaign-Orchestration 소스 필드 | 표준 커뮤니케이션 레코드 대상 필드 | | --- | --- | | campaign\$1event\$1id | Attributes.LastCampaignEventId | | channel.name | 채널 | | channel.subtype | Attributes.ChannelSubType | | instance\$1arn | ConnectInstanceArn | | campaign.campaign\$1name | Campaign.CampaignName | | campaign.campaign\$1id | Campaign.CampaignId | | campaign.campaign\$1run\$1id | Campaign.CampaignRunId | | campaign.campaign\$1activity\$1id | Campaign.CampaignActivityId | | campaign.segment\$1arn | Campaign.SegmentArn | | campaign\$1event\$1timestamp | UpdatedDate | | campaign\$1event\$1type | LastEventType | | campaign\$1event\$1timestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.UpdatedDate | | campaign\$1event\$1id | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventId | | campaign\$1event\$1type | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventType | | campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp | ## 예제 다음 예시는 소스 필드와 대상 필드를 매핑하는 방법을 보여 줍니다. ``` "channel": {     "source": "_source.engagement.channel.name",     "target": "_communicationRecord.Channel" } ``` # Customer Profiles의 표준 자산에 객체 유형 매핑 이 섹션의 주제에서는 표준 자산 정의와 외부 애플리케이션에서 표준 자산으로의 객체 유형 매핑을 제공합니다. **Topics** + [Amazon AppFlow 액세스 요구 사항](appflow-access-requirements-asset.md) + [표준 자산 정의](standard-asset-definition.md) + [Salesforce 객체를 표준 자산에 매핑](mapping-salesforce-objects-to-asset.md) # Customer Profiles의 Amazon AppFlow 액세스 요구 사항 Amazon Connect Customer Profiles의 Salesforce 통합을 생성하고 삭제하기 위해 다음의 Amazon AppFlow 액세스 요구 사항을 사용합니다. + `appflow:CreateFlow` + `appflow:DeleteFlow` # Amazon Connect Customer Profiles의 표준 자산 정의 다음 표에는 Customer Profiles 표준 자산 객체의 모든 필드가 나열되어 있습니다. | 표준 자산 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | AssetId | 문자열 | 표준 자산의 고유 식별자입니다. | | AssetName | 문자열 | 자산의 이름입니다. | | SerialNumber | 문자열 | 에셋의 일련 번호입니다. | | ModelNumber | 문자열 | 자산의 모델 번호입니다. | | ModelName | 문자열 | 자산의 모델 이름입니다. | | ProductSKU | 문자열 | 자산의 재고 보관 단위입니다. | | PurchaseDate | 문자열 | 자산의 구매 날짜입니다. | | UsageEndDate | 문자열 | 자산의 사용 종료 날짜입니다. | | Status | 문자열 | 자산의 상태입니다. | | 가격 | 문자열 | 자산의 가격입니다. | | 수량 | 문자열 | 자산의 수량입니다. | | 설명 | 문자열 | 자산의 설명입니다. | | AdditionalInformation | 문자열 | 자산과 관련된 모든 추가 정보입니다. | | DataSource | 문자열 | 자산의 데이터 소스입니다. | | 속성 | 문자열 간 맵 | 표준 자산의 키-값 속성 쌍입니다. | 표준 자산 객체는 다음 표의 키로 인덱싱됩니다. | 표준 인덱스 이름 | 표준 자산 필드 | | --- | --- | | \$1assetId | AssetId | | \$1assetName | AssetName | | \$1serialNumber | SerialNumber | 예를 들어 `_assetName`을 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)의 키 이름으로 사용하여 AssetName이 검색 값과 일치하는 자산이 있는 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `_asset`로 설정된 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)를 사용하여 특정 프로필과 연결된 표준 자산 객체를 찾을 수 있습니다. # Customer Profiles의 Salesforce 객체를 표준 자산에 매핑 이 주제에는 Salesforce 객체에서 Customer Profiles의 표준 자산 객체에 매핑되는 필드의 목록이 나열되어 있습니다. ## Salesforce-Asset 객체 다음은 Salesforce-Asset 객체의 모든 필드 목록입니다. + Id + ContactId + AccountId + ParentId + RootAssetId + Product2Id + ProductCode + IsCompetitorProduct + CreatedDate + CreatedById + LastModifiedDate + LastModifiedById + SystemModstamp + IsDeleted + 이름 + SerialNumber + InstallDate + PurchaseDate + UsageEndDate + LifecycleStartDate + LifecycleEndDate + Status + 가격 + 수량 + 설명 + OwnerId + AssetProvidedById + AssetServiceById + IsInternal + AssetLevel + StockKeepingUnit + HasLifecycleManagement + CurrentMrr + CurrentLifecycleEndDate + CurrentQuantity + CurrentAmount + LastViewedDate + LastReferencedDate ## Salesforce-Asset 객체를 표준 자산에 매핑 Salesforce-Asset 객체에서 Customer Profiles의 표준 자산 객체에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Salesforce-Asset 객체에서 표준 자산으로 매핑될 수 있는 필드가 나열되어 있습니다. | Salesforce-Asset 소스 필드 | 표준 자산 대상 필드 | | --- | --- | | Id | Attributes.sfdcAssetId | | ContactId | Attributes.sfdcContactId | | AccountId | Attributes.sfdcAccountId | | SerialNumber | SerialNumber | | StockKeepingUnit | ProductSKU | | UsageEndDate | UsageEndDate | | Status | Status | | 가격 | 가격 | | 수량 | 수량 | | Description | 설명 | Salesforce 객체의 Salesforce-Asset 고객 데이터는 다음 표의 인덱스를 사용하여 Amazon Connect 표준 자산과 연결됩니다. | 표준 인덱스 이름 | Salesforce-Asset 소스 필드 | | --- | --- | | \$1salesforceAssetId | Id | | \$1salesforceContactId | ContactId | | \$1salesforceAccountId | AccountId | 예를 들어 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API에서 `ObjectFilter.KeyName`으로 `_salesforceAssetId` 및 `_salesforceAccountId`를 사용하여 표준 애셋을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Salesforce-Asset`으로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Salesforce-Asset 객체를 찾을 수 있습니다. # Customer Profiles의 표준 사례에 객체 유형 매핑 이 섹션의 주제에서는 표준 사례 정의와 외부 애플리케이션에서 표준 사례로의 객체 유형 매핑을 제공합니다. **Topics** + [Amazon AppFlow 액세스 요구 사항](appflow-access-requirements-case.md) + [표준 사례 정의](standard-case-definition.md) + [Zendesk 객체 매핑](mapping-zendesk-objects-case.md) + [ServiceNow 객체 매핑](mapping-servicenow-objects-standard-case.md) # Customer Profiles의 Amazon AppFlow 액세스 요구 사항 Amazon Connect Customer Profiles의 Zendesk 및 ServiceNow 통합을 생성하고 삭제하기 위해 다음의 Amazon AppFlow 액세스 요구 사항을 사용합니다. + `appflow:CreateFlow` + `appflow:DeleteFlow` # Customer Profiles 표준 사례 객체 필드 다음 표에는 Customer Profiles 표준 사례 객체의 모든 필드가 나열되어 있습니다. | 표준 사례 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | CaseId | 문자열 | 표준 사례의 고유 식별자입니다. | | 제목 | 문자열 | 사례의 제목입니다. | | 요약 | 문자열 | 사례의 요약입니다. | | Status | 문자열 | 사례의 상태입니다. | | 이유 | 문자열 | 사례의 사유입니다. | | CreatedBy | 문자열 | 사례를 생성한 사람입니다. | | CreatedDate | 문자열 | 사례가 생성된 날짜입니다. | | UpdatedDate | 문자열 | 사례가 업데이트된 날짜입니다. | | ClosedDate | 문자열 | 사례가 종료된 날짜입니다. | | AdditionalInformation | 문자열 | 사례와 관련된 모든 추가 정보입니다. | | DataSource | 문자열 | 사례의 데이터 소스입니다. | | 속성 | 문자열 간 맵 | 표준 사례의 키-값 속성 쌍입니다. | 표준 사례 객체는 다음 표의 키로 인덱싱됩니다. | 표준 인덱스 이름 | 표준 사례 필드 | | --- | --- | | \$1caseId | CaseId | 예를 들어 `_caseId`을 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)의 키 이름으로 사용하여 CaseId 가 검색 값과 일치하는 사례가 있는 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `_case`로 설정된 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)를 사용하여 특정 프로필과 연결된 표준 사례 객체를 찾을 수 있습니다. # Amazon Connect Customer Profiles의 표준 사례에 Zendesk 객체 매핑 이 주제에는 Zendesk 객체에서 Customer Profiles 표준 사례의 필드에 매핑되는 필드의 목록이 나열되어 있습니다. ## Zendesk-tickets 객체 다음은 Zendesk-tickets 객체의 모든 필드 목록입니다. + id + url + type + subject + raw\$1subject + description + priority + status + 수신자 + requester\$1id + submitter\$1id + assignee\$1id + organization\$1id + group\$1id + collaborator\$1ids + email\$1cc\$1ids + follower\$1ids + forum\$1topic\$1id + problem\$1id + has\$1incidents + due\$1at + tags + via.channel + custom\$1fields + satisfaction\$1rating + sharing\$1agreement\$1ids + followup\$1ids + ticket\$1form\$1id + brand\$1id + allow\$1channelback + allow\$1attachments + is\$1public + created\$1at + updated\$1at ## Zendesk-tickets 객체를 표준 사례에 매핑 Zendesk-tickets 객체에서 Customer Profiles의 표준 사례에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Zendesk-tickets 객체에서 표준 사례로 매핑될 수 있는 필드가 나열되어 있습니다. | Zendesk-tickets 소스 필드 | 표준 사례 대상 필드 | | --- | --- | | requester\$1id | Attributes.ZendeskUserId | | id | Attributes.ZendeskTicketId | | subject | 제목 | | description | 요약 | | status | Status | | requester\$1id | CreatedBy | | created\$1at | CreatedDate | | updated\$1at | UpdatedDate | Zendesk 객체의 Zendesk-tickets 고객 데이터는 다음 인덱스를 사용하여 Amazon Connect 표준 사례와 연결됩니다. | 표준 인덱스 이름 | Zendesk-tickets 소스 필드 | | --- | --- | | \$1zendeskUserId | requester\$1id | | \$1zendeskTicketId | id | 예를 들어 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API에서 `ObjectFilter.KeyName`으로 `_zendeskUserId` 및 `_zendeskTicketId`를 사용하여 표준 사례를 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Zendesk-tickets`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Zendesk-tickets 객체를 찾을 수 있습니다. # Amazon Connect Customer Profiles의 표준 사례에 ServiceNow 객체 매핑 이 주제에는 ServiceNow 객체에서 Amazon Connect Customer Profiles 표준 사례의 필드에 매핑되는 필드의 목록이 나열되어 있습니다. ## Servicenow-task 객체 다음은 Servicenow-task 객체의 모든 필드 목록입니다. + sys\$1id + 활성화 + activity\$1due + additional\$1assignee\$1list + approval + approval\$1history + approval\$1set + assigned\$1to + assignment\$1group + business\$1duration + business\$1service + calendar\$1duration + closed\$1at + closed\$1by + cmdb\$1ci.display\$1value + cmdb\$1ci.link + 설명 + comments\$1and\$1work\$1notes + company + contact\$1type + contract + correlation\$1display + 활성화 + correlation\$1id + delivery\$1plan + delivery\$1task + description + due\$1date + escalation + expected\$1start + follow\$1up + group\$1list + impact + knowledge + location + made\$1sla + number + opened\$1at + .display\$1value로 열었습니다. + order + parent + priority + reassignment\$1count + service\$1offering + short\$1description + sla\$1due + state + sys\$1class\$1name + sys\$1created\$1by + sys\$1created\$1on + 활성화 + sys\$1domain.global + sys\$1domain.link + sys\$1domain\$1path + sys\$1mod\$1count + sys\$1updated\$1by + sys\$1updated\$1on + time\$1worked + upon\$1approval + upon\$1reject + urgency + user\$1input + watch\$1list + work\$1end + work\$1notes + work\$1notes\$1list + work\$1start ## Servicenow-task를 표준 사례에 매핑 Servicenow-task 객체에서 Customer Profiles의 표준 사례에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Servicenow-task 객체에서 표준 사례로 매핑될 수 있는 필드가 나열되어 있습니다. | Servicenow-task 소스 필드 | 표준 사례 대상 필드 | | --- | --- | | sys\$1id | Attributes.ServiceNowTaskId | | opened\$1by.link | Attributes.ServiceNowSystemUserId | | short\$1description | 제목 | | description | 요약 | | status | Status | | sys\$1created\$1by | CreatedBy | | sys\$1created\$1on | CreatedDate | | sys\$1updated\$1on | UpdatedDate | Servicenow의 Servicenow-task 고객 데이터는 다음 표의 인덱스를 사용하여 Amazon Connect 표준 사례와 연결됩니다. | 표준 인덱스 이름 | Servicenow-task 소스 필드 | | --- | --- | | \$1serviceNowTaskId | sys\$1id | | \$1serviceNowSystemId | open\$1by.link | 예를 들어 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API에서 `ObjectFilter.KeyName`으로 `_serviceNowTaskId` 및 `_serviceNowSystemId`를 사용하여 표준 사례를 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Servicenow-task`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Servicenow-task 객체를 찾을 수 있습니다. ## Servicenow-incident 객체 다음은 Servicenow-incident 객체의 모든 필드 목록입니다. + sys\$1id + business\$1stc + calendar\$1stc + caller\$1id.link + caller\$1id.value + category + caused\$1by + child\$1incidents + close\$1code + hold\$1reason + incident\$1state + notify + parent\$1incident + problem\$1id + reopened\$1by + reopened\$1time + reopen\$1count + resolved\$1at + resolved\$1by.link + resolved\$1by.value + rfc + severity + subcategory ## Servicenow-incident를 표준 사례에 매핑 Servicenow-incident 객체에서 Customer Profiles의 표준 사례에 매핑되는 필드의 하위 목록입니다. 다음 표에는 Servicenow-incident 객체에서 표준 사례로 매핑될 수 있는 필드가 나열되어 있습니다. | Servicenow-Incident 소스 필드 | 표준 사례 대상 필드 | | --- | --- | | sys\$1id | Attributes\$1ServiceNowIncidentId | | caller\$1id.link | Attributes\$1ServiceNowSystemUserId | | incident\$1status | Status | | caller\$1id.link | CreatedBy | | resolved\$1at | ClosedDate | | category | 이유 | Servicenow 객체의 Servicenow-incident 고객 데이터는 다음 표의 인덱스를 사용하여 Amazon Connect 표준 사례와 연결됩니다. | 표준 인덱스 이름 | Servicenow 소스 필드 | | --- | --- | | \$1serviceNowIncidentId | sys\$1id | | \$1serviceNowSystemId | caller\$1id.link | 예를 들어 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API에서 ObjectFilter.KeyName으로 `_serviceNowIncidentId` 및 `_serviceNowSystemId`를 사용하여 표준 사례를 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Servicenow-incident`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Servicenow-incident 객체를 찾을 수 있습니다. # 표준 항공사 기본 설정의 객체 유형 매핑 이 섹션의 주제에서는 표준 항공사 기본 설정 정의를 제공합니다. **Topics** + [Customer Profiles 표준 항공사 기본 설정 객체 필드](standard-air-preference-object-fields.md) # Customer Profiles 표준 항공사 기본 설정 객체 필드 다음 테이블에는 Customer Profiles 표준 항공사 기본 설정 객체의 모든 필드가 나열되어 있습니다. **항공사 기본 설정** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | PreferenceId | 문자열 | 표준 항공사 기본 설정의 고유 식별자 | | 이름 | 문자열 | 기본 설정의 이름 | | CreatedDate | 문자열 | 기본 설정이 생성된 날짜 | | CreatedBy | 문자열 | 생성자의 식별자 | | UpdatedDate | 문자열 | 마지막으로 업데이트된 날짜 | | UpdatedBy | 문자열 | 마지막으로 업데이트한 사람의 식별자 | | StartDate | 문자열 | 기본 설정 시작 날짜 | | EndDate | 문자열 | 기본 설정 종료 날짜 | | Status | 문자열 | 기본 설정의 현재 상태 | | ReferenceId | 문자열 | 참조된 객체의 ID | | ReferenceType | 문자열 | 참조되는 객체의 유형 | | TravelType | 문자열 | 여행 유형(예: 직항편) | | Transfer | 문자열 | 선호하는 환승 유형 | | ArrivalAirport | 문자열 | 선호하는 도착 공항 | | ArrivalTerminal | 문자열 | 선호하는 도착 공항 터미널 | | DepartureAirport | 문자열 | 선호하는 출발 공항 | | DepartureTerminal | 문자열 | 선호하는 출발 공항 터미널 | | HomeAirport | 문자열 | 자주 이용하는 공항 | | CheckInChannel | 문자열 | 체크인 모드 | | CheckInChannelDevice | 문자열 | 체크인에 사용되는 디바이스 | | 언어 | 언어 | 선호하는 커뮤니케이션 언어에 대한 세부 정보 | | Seat | Seat | 좌석 선택에 대한 세부 정보 | | 여정 | 여정 | 여행 기본 설정 | | 접근성 | 접근성 | 접근성 요청에 대한 세부 정보 | | 보험 | 보험 | 보험에 대한 세부 정보 | | Interest | Interest | 관심사에 대한 세부 정보 | | Loyalty | Loyalty | 충성도에 대한 세부 정보 | | 다이닝룸 | 다이닝룸 | 식사 기본 설정 | | MediaEntertainment | MediaEntertainment | 미디어 및 엔터테인먼트 기본 설정 | | PaymentForm | PaymentForm | 결제 방법 기본 설정 | | PetInfo | PetInfo | 반려동물 세부 정보 | | SpecialRequest | SpecialRequest | 특별 요청 세부 정보 | | TicketDistribution | TicketDistribution | 티켓 배포 기본 설정 | | 마케팅 | 마케팅 | 마케팅 기본 설정 | | Medical | Medical | 의료에 대한 기본 설정 | | Baggage | Baggage | 수화물 대한 기본 설정 | | ContactDetails | ContactDetails | 기본 연락처에 대한 세부 정보 | | ContactDetailAddress | ContactDetailAddress | 연락처 세부 정보 주소 | | ContactDetailCommunication | ContactDetailCommunication | 커뮤니케이션 기본 설정 | | 속성 | Map | 항공사 기본 설정 속성의 키-값 페어 | 표준 항공사 기본 설정 객체는 다음 테이블의 키로 인덱싱됩니다. **표준 인덱스 필드** | 표준 인덱스 이름 | 표준 기본 설정 레코드 필드 | | --- | --- | | \$1airPreferenceId | PreferenceId | | \$1airReferenceId | ReferenceId | 예를 들어, `_airPreferenceId`를 키 이름으로 사용하여 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)를 통해 검색 값과 일치하는 PreferenceId를 가진 항공사 기본 설정이 있는 프로필을 찾을 수 있습니다. `ProfileId`와 `ObjectTypeName`을 `_airPreference`로 설정하여 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)를 사용하면 특정 프로필과 연관된 표준 airPreference 객체를 찾을 수 있습니다. **ContactDetail 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | Type | 문자열 | 연락처 유형(예: 개인, 긴급) | | PreferenceLevel | 문자열 | 이 연락처의 우선 순위 수준 | | PhoneNumber | 문자열 | 전화번호 | | 관계 | 문자열 | 프로필과의 관계 | | EmailAddress | 문자열 | 이메일 주소 | | EmailLanguage | 문자열 | 연락처 세부 정보 이메일 커뮤니케이션을 위한 기본 언어 | | PhoneLanguage | 문자열 | 연락처 세부 정보 전화 통신을 위한 기본 언어 | **ContactDetailAddress 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | Type | 문자열 | 연락처의 주소 유형입니다. | | Address1 | 문자열 | 연락처 주소의 첫 번째 줄입니다. | | Address2 | 문자열 | 연락처 주소의 두 번째 줄입니다. | | Address3 | 문자열 | 연락처 주소의 세 번째 줄입니다. | | Address4 | 문자열 | 연락처 주소의 네 번째 줄입니다. | | City | 문자열 | 연락처 주소의 도시입니다. | | 국가 | 문자열 | 연락처 주소의 국가입니다. | | County | 문자열 | 연락처 주소의 카운티입니다. | | PostalCode | 문자열 | 회사 주소의 우편번호입니다. | | Province | 문자열 | 연락처 주소의 도입니다. | | State | 문자열 | 연락처 주소의 주입니다. | **ContactDetailCommunication 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 방법 | 문자열 | 커뮤니케이션 방법(예: SMS, 이메일) | | PreferenceLevel | 문자열 | 커뮤니케이션 수단에 대한 기본 설정 수준 | **Language 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | PhoneLanguage | 문자열 | 선호하는 전화 커뮤니케이션 언어 | | EmailLanguage | 문자열 | 선호하는 이메일 커뮤니케이션 언어 | | InPersonLanguage | 문자열 | 선호하는 대면 커뮤니케이션 언어 | | PreferenceLevel | 문자열 | 언어 기본 설정 수준 | **Seat 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | PreferenceLevel | 문자열 | 좌석 우선 순위 기본 설정 | | Direction | 문자열 | 선호하는 좌석 방향(예: 앞, 뒤) | | Location | 문자열 | 선호하는 좌석 위치(예: 창가, 통로) | | 위치 | 문자열 | 좌석 위치(예: 왼쪽, 오른쪽) | | 열 | 문자열 | 원하는 좌석 행 | | ClassOfService | 문자열 | 여행 클래스(예: 경제, 비즈니스) | | NeighborFree | 문자열 | 떨어져 있는 좌석에 대한 기본 설정 | | 영유아 | 문자열 | 영유아용 좌석 기본 설정 | | ExtraSeat | 문자열 | 추가 좌석 기본 설정 | **Journey 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | MaxConnections | 문자열 | 허용되는 최대 연결 수 | | PreferredAirline | 문자열 | 선호하는 항공사 | | UpgradeAuction | 문자열 | 업그레이드 경매 옵트인 | | FlightTime | 문자열 | 선호하는 비행 시간 | | FlightMaxDuration | 문자열 | 선호하는 최대 이동 시간 | **Accessibility 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 휠체어 | 문자열 | 휠체어 접근성 정보 | | 욕실 | 문자열 | 욕실 접근성 정보 | | Assistance | 문자열 | 지원 정보 | | DisabilityType | 문자열 | 장애에 대한 정보 | | SupportAnimal | 문자열 | 동물 정보 지원 | | ProximityToFacilities | 문자열 | 시설에 근접해야 함 | **Insurance 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 이름 | 문자열 | 보험 제공업체 또는 플랜 이름 | | PreferenceLevel | 문자열 | 보험 기본 설정 수준 | **Interest 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 이름 | 문자열 | 특정 관심 영역 | | PreferenceLevel | 문자열 | 이 관심의 우선 순위 | **Loyalty 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 이름 | 문자열 | 충성도 프로그램 이름 | | MembershipId | 문자열 | 충성도 프로그램의 멤버십 ID | | PreferenceLevel | 문자열 | 충성도 프로그램 기본 설정 수준 | **Dining 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | MealType | 문자열 | 선호하는 식사 유형 | | FavoriteCuisine | 문자열 | 즐겨찾는 음식 유형 | | Beverage | 문자열 | 선호하는 음료 | | DietaryRestriction | 문자열 | 식이 제한 | | AllergyInfo | 문자열 | 알레르기 세부 정보 | | PreferenceLevel | 문자열 | 식사 기본 설정 수준 | **Media and entertainment 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 이름 | 문자열 | 선호하는 엔터테인먼트 이름 | | PreferenceLevel | 문자열 | 미디어/엔터테인먼트에 대한 기본 설정 수준 | **PaymentForm 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 이름 | 문자열 | 결제 방법 이름 | | Type | 문자열 | 결제 유형(예: 신용 카드, PayPal) | | PreferenceLevel | 문자열 | 결제 방법 기본 설정 수준 | | UsageContext | 문자열 | 결제 방법이 사용되는 위치 | **PetInfo 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | Type | 문자열 | 반려동물 유형 | | PreferenceLevel | 문자열 | 반려동물에 대한 기본 설정 수준 | **SpecialRequest 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | Type | 문자열 | 특별 요청 유형 | | 이름 | 문자열 | 요청 이름 또는 설명 | | PreferenceLevel | 문자열 | 요청의 우선 순위 수준 | **TicketDistribution 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | PreferenceLevel | 문자열 | 티켓 배포에 대한 기본 설정 수준 | | 방법 | 문자열 | 티켓 배송 방법(예: 이메일, 물리적) | | TicketTime | 문자열 | 선호하는 티켓 배송 시간 | **Marketing 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | ChannelType | 문자열 | 마케팅 채널 유형(예: SMS, 이메일) | | OptIn | 문자열 | 마케팅 옵트인 상태 | | 빈도 | 문자열 | 마케팅 커뮤니케이션 빈도 | | StartDate | 문자열 | 마케팅 기본 설정 시작 날짜 | | EndDate | 문자열 | 마케팅 선호 종료 날짜 | **Medical 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 산소 | 문자열 | (항공사 제공, 승객 소유, 집중기 등) | | MedicalEquipment | 문자열 | 의료 장비에 대한 세부 정보입니다(예:CPAP 머신, 산소 발생기). | | Assistance | 문자열 | 여행 중에 여행자에게 일반적인 의료 지원이 필요한지 여부를 지정합니다(예: 기내 지원, 약물 지원). | | Stretcher | 문자열 | 여행자에게 비행 중 들것이 필요한 경우, 일반적으로 의료 운송 사례에 사용됩니다. | | WheelChair | 문자열 | 휠체어 세부 정보(유출 불가, 습전지, 이동 불가, RampNeeded, stairsAssistance, 항공사 제공 등) | **Baggage 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | Animal | 문자열 | 여행자가 보조 동물 또는 반려 동물과 함께 여행하고 있는지 여부를 나타내며 관련 사양 또는 제한 사항을 포함합니다(inHold, Cabin). | | BaggageType | 문자열 | 선호하는 유형의 위탁자 처리(예: 휴대 전용, 위탁된 위탁자, 크기 초과)를 지정합니다. | | Assistance | 문자열 | 여행자에게 공항 포터 서비스 또는 공항청사 운송 도우미와 같은 화환 운송 또는 관리에 대한 지원이 필요한지 여부를 나타냅니다. | | PreferenceLevel | 문자열 | 수화물 필드에 대한 기본 설정 | # 표준 호텔 기본 설정의 객체 유형 매핑 이 섹션의 주제에서는 표준 호텔 기본 설정 정의를 제공합니다. **Topics** + [Customer Profiles 표준 호텔 기본 설정 객체 필드](standard-hotel-preference-object-fields.md) # Customer Profiles 표준 호텔 기본 설정 객체 필드 다음 테이블에는 Customer Profiles 표준 호텔 기본 설정 객체의 모든 필드가 나열되어 있습니다. **호텔 기본 설정** | 표준 hotelPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | PreferenceId | 문자열 | 표준 호텔 기본 설정의 고유 식별자 | | 이름 | 문자열 | 기본 설정의 이름 | | CreatedDate | 문자열 | 기본 설정이 생성된 날짜 | | CreatedBy | 문자열 | 생성자의 식별자 | | UpdatedDate | 문자열 | 마지막으로 업데이트된 날짜 | | UpdatedBy | 문자열 | 마지막으로 업데이트한 사람의 식별자 | | StartDate | 문자열 | 기본 설정 시작 날짜 | | EndDate | 문자열 | 기본 설정 종료 날짜 | | Status | 문자열 | 기본 설정의 현재 상태 | | 흡연 | 문자열 | 흡연 기본 설정 | | CleaningTime | 문자열 | 청소 시간 | | CheckInType | 문자열 | 체크인 유형 | | CheckOutType | 문자열 | 체크아웃 유형 | | ReferenceId | 문자열 | 참조된 객체의 ID | | ReferenceType | 문자열 | 참조되는 객체의 유형 | | Location | Location | 호텔 객실 위치 기본 설정 | | Bedding | Bedding | 침대 기본 설정 | | Tour | Tour | 투어 기본 설정 | | ContactDetails | ContactDetails | 기본 연락처에 대한 세부 정보 | | ContactDetailAddress | ContactDetailAddress | 연락처 세부 정보 주소 | | ContactDetailCommunication | ContactDetailCommunication | 커뮤니케이션 기본 설정 | | 언어 | 언어 | 언어 기본 설정 | | CarRental | CarRental | 렌터카 기본 설정 | | 접근성 | 접근성 | 접근성 기본 설정 | | Interest | Interest | 관심 세부 정보 | | Loyalty | Loyalty | 충성도 기본 설정 | | 다이닝룸 | 다이닝룸 | 식사 기본 설정 | | MediaEntertainment | MediaEntertainment | 미디어 및 엔터테인먼트 기본 설정 | | PaymentForm | PaymentForm | 결제 기본 설정 | | PetInfo | PetInfo | 반려동물 정보 기본 설정 | | SpecialRequest | SpecialRequest | 특별 요청에 대한 세부 정보 | | 마케팅 | 마케팅 | 마케팅 기본 설정 | | Medical | Medical | 의료 기본 설정 | | Baggage | Baggage | 수화물 기본 설정 | | 속성 | Map | 호텔 기본 설정의 키-값 속성 페어 | 표준 호텔 기본 설정 객체는 다음 표의 키로 인덱싱됩니다. **표준 인덱스 필드** | 표준 인덱스 이름 | 표준 기본 설정 레코드 필드 | | --- | --- | | \$1hotelPreferenceId | PreferenceId | | \$1hotelReferenceId | ReferenceId | 예를 들어, `_hotelPreferenceId`를 키 이름으로 사용하여 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)를 통해 검색 값과 일치하는 PreferenceId를 가진 호텔 기본 설정이 있는 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `_hotelPreference`로 설정된 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)를 사용하여 특정 프로필과 연결된 표준 hotelPreference 객체를 찾을 수 있습니다. **ContactDetail 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | Type | 문자열 | 연락처 유형(예: 개인, 긴급) | | PreferenceLevel | 문자열 | 이 연락처의 우선 순위 수준 | | PhoneNumber | 문자열 | 전화번호 | | 관계 | 문자열 | 프로필과의 관계 | | EmailAddress | 문자열 | 이메일 주소 | | EmailLanguage | 문자열 | 연락처 세부 정보 이메일 커뮤니케이션을 위한 기본 언어 | | PhoneLanguage | 문자열 | 연락처 세부 정보 전화 통신을 위한 기본 언어 | **ContactDetailAddress 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | Type | 문자열 | 연락처의 주소 유형입니다. | | Address1 | 문자열 | 연락처 주소의 첫 번째 줄입니다. | | Address2 | 문자열 | 연락처 주소의 두 번째 줄입니다. | | Address3 | 문자열 | 연락처 주소의 세 번째 줄입니다. | | Address4 | 문자열 | 연락처 주소의 네 번째 줄입니다. | | City | 문자열 | 연락처 주소의 도시입니다. | | 국가 | 문자열 | 연락처 주소의 국가입니다. | | County | 문자열 | 연락처 주소의 카운티입니다. | | PostalCode | 문자열 | 연락처 주소의 우편번호입니다. | | Province | 문자열 | 연락처 주소의 도입니다. | | State | 문자열 | 연락처 주소의 주입니다. | **ContactDetailCommunication 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | 방법 | 문자열 | 커뮤니케이션 방법 | | PreferenceLevel | 문자열 | 커뮤니케이션 방법의 기본 설정 수준 | | 빈도 | 문자열 | 커뮤니케이션 빈도 | **Language 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | PhoneLanguage | 문자열 | 선호하는 전화 언어 | | EmailLanguage | 문자열 | 선호하는 이메일 언어 | **CarRental 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | Vendor | 문자열 | 선호하는 렌터카 공급업체 | | VehicleType | 문자열 | 선호하는 차량 유형 | | PreferenceLevel | 문자열 | 렌터카 기본 설정 수준 | **Location 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | PreferredFloor | 문자열 | 객실 바닥에 대한 기본 설정 | | ElevatorProximity | 문자열 | 승강기에 대한 근접성 기본 설정 | | QuietZone | 문자열 | 조용한 구역에 대한 기본 설정 | | LobbyProximity | 문자열 | 로비와의 근접성에 대한 기본 설정 | | 보기 | 문자열 | 객실에서 원하는 뷰 | | RoomType | 문자열 | 선호하는 객실 유형 | | PreferenceLevel | 문자열 | 위치 기본 설정 수준 | **Bedding 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | BedType | 문자열 | 선호하는 객실 유형 | | MattressType | 문자열 | 선호하는 매트리스 유형 | | PillowType | 문자열 | 선호하는 배게 유형 | | NumberOfPillows | 문자열 | 선호하는 필로우 수 | | BeddingMaterial | 문자열 | 침구 재료 | | 알레르기 | 문자열 | 알레르기 관련 베딩 기본 설정 | **Tour 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | City | 문자열 | 선호하는 도시 | | 문화 | 문자열 | 문화 투어 관심사 | | 어드벤처 | 문자열 | 어드벤처 투어 관심사 | | 나이트라이프 | 문자열 | 나이트라이프 둘러보기 관심사 | | GuideLanguage | 문자열 | 선호하는 투어 가이드 언어 | | StartTime | 문자열 | 선호하는 투어 시작 시간 | | GroupSize | 문자열 | 선호하는 투어 그룹 규모 | | PreferenceLevel | 문자열 | 투어 기본 설정의 중요성 | **Accessibility 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | 휠체어 | 문자열 | 휠체어 접근성 정보 | | 욕실 | 문자열 | 욕실 접근성 정보 | | Assistance | 문자열 | 지원 정보 | | DisabilityType | 문자열 | 장애에 대한 정보 | | SupportAnimal | 문자열 | 동물 정보 지원 | | ProximityToFacilities | 문자열 | 시설에 근접해야 함 | **Interest 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | NameOfInterest | 문자열 | 관심사 이름 | | PreferenceLevel | 문자열 | 관심에 대한 기본 설정 수준 | **Loyalty 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | LoyaltyName | 문자열 | 충성도 프로그램 이름 | | MembershipId | 문자열 | 충성도 멤버십 ID | | PreferenceLevel | 문자열 | 충성도 기본 설정 수준 | | PriorityServices | 문자열 | 우선 서비스 기본 설정 | **Dining 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | MealType | 문자열 | 선호하는 식사 유형 | | FavoriteCuisine | 문자열 | 선호하는 요리 유형 | | Beverage | 문자열 | 음료 기본 설정 | | DietaryRestriction | 문자열 | 식이 제한 | | AllergyInfo | 문자열 | 알레르기 정보 | | PreferenceLevel | 문자열 | 식사 기본 설정 수준 | **MediaEntertainment 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | 이름 | 문자열 | 선호하는 미디어 또는 엔터테인먼트의 이름 | | PreferenceLevel | 문자열 | 미디어 또는 엔터테인먼트에 대한 기본 설정 수준 | **PaymentForm 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | 이름 | 문자열 | 결제 방법과 연결된 이름 | | Type | 문자열 | 결제 방법 유형 | | PreferenceLevel | 문자열 | 결제 방법 기본 설정 수준 | | UsageContext | 문자열 | 결제 양식이 사용되는 컨텍스트 | **PetInfo 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | Type | 문자열 | 반려동물 유형 | | PreferenceLevel | 문자열 | 반려동물에 대한 기본 설정 수준 | **Special Request 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | Type | 문자열 | 특별 요청 유형 | | 이름 | 문자열 | 특별 요청의 이름 | | PreferenceLevel | 문자열 | 요청의 기본 설정 수준 | **Marketing 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | ChannelType | 문자열 | 마케팅 채널 유형(예: SMS, 이메일) | | OptIn | 문자열 | 마케팅 옵트인 상태 | | 빈도 | 문자열 | 마케팅 커뮤니케이션 빈도 | | StartDate | 문자열 | 마케팅 기본 설정 시작 날짜 | | EndDate | 문자열 | 마케팅 선호 종료 날짜 | **Medical 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | 산소 | 문자열 | 휘발유 공급 기본 설정 | | MedicalEquipment | 문자열 | 의료 장비에 대한 세부 정보 | | Assistance | 문자열 | 필요한 의료 지원 유형 | | Stretcher | 문자열 | 들것 게스트 요구 사항 | | WheelChair | 문자열 | 필요한 의자 유형 및 지원 | **Baggage 데이터 형식** | 표준 hotelPreference 필드 | Type | 설명 | | --- | --- | --- | | 자전거 | 문자열 | 자전거 장비 요구 사항 | | BaggageType | 문자열 | 수하물 세부 정보(예: 대량) | | 배송업체 | 문자열 | 배송업체 관련 수화물 기본 설정 | | 취약 | 문자열 | 취약한 항목 기본 설정 | | 기본 설정 수준 | 문자열 | 수화물 기본 설정 수준 | # 표준 항공권 예약에 대한 객체 유형 매핑 이 섹션의 주제에서는 항공권 예약에 대한 표준 정의를 제공합니다. **Topics** + [Customer Profiles 표준 항공권 예약 객체 필드](standard-air-booking-object-fields.md) # Customer Profiles 표준 항공권 예약 객체 필드 다음 표에는 Customer Profiles 표준 항공권 예약 객체의 모든 필드가 나열되어 있습니다. **AirBooking** | 표준 airBooking 필드 | Type | 설명 | | --- | --- | --- | | BookingId | 문자열 | 표준 항공권 예약의 고유 식별자 | | ContextId | 문자열 | 예약 소스 추적을 위한 컨텍스트별 식별자 | | PreferenceRef | 문자열 | 예약에 대한 기본 설정 객체를 참조하는 식별자 | | BookingName | 문자열 | 예약과 연결된 이름 | | PassengerIndex | 문자열 | 예약 내 승객의 인덱스 | | TravellerId | 문자열 | 예약과 연결된 승객의 고유 식별자 | | GroupBooking | 문자열 | 그룹에 대한 예약인지 여부를 나타냄 | | NumberOfPassengers | 문자열 | 예약의 총 승객 수 | | NumberOfAdults | 문자열 | 예약의 총 성인 수 | | NumberOfChildren | 문자열 | 예약의 총 아이 수 | | ProcessedDate | 문자열 | 예약이 처리된 날짜 | | CreatedDate | 문자열 | 예약이 생성된 날짜 | | CreatedBy | 문자열 | 생성자의 자격 증명 | | UpdatedDate | 문자열 | 최종 업데이트 날짜 | | UpdatedBy | 문자열 | 예약을 마지막으로 업데이트한 사람의 식별자 | | Status | 문자열 | 현재 예약 상태 | | PriorityStatus | 문자열 | 예약의 우선 순위 티어 | | ReservationStatus | 문자열 | 예약의 예약 상태 | | MarketingCode | 문자열 | 마케팅 소스 또는 캠페인을 나타내는 코드 | | MarketingName | 문자열 | 마케팅 캠페인 이름 | | TravelAgent | 문자열 | 예약과 연결된 여행사 | | TravelAgency | 문자열 | 여행사 이름 | | TravelCorpNumber | 문자열 | 여행사 고객 번호 | | Booker | 문자열 | 해당 인물이 예약을 한 사람인지 여부를 나타냅니다. | | AdditionalInformation | 문자열 | 추가 자유 형식 정보 | | 이메일 | 문자열 | 여행 날짜 업데이트를 위한 이메일 문의 | | PhoneNumber | 문자열 | 여행 날짜 업데이트를 위한 전화 문의 | | CancelledDate | 문자열 | 예약 취소 날짜(해당하는 경우) | | 외교관 | 문자열 | 외교 상태를 나타냅니다. | | 하위 | 문자열 | 승객의 어린이 여부를 나타냅니다. | | 비활성화됨 | 문자열 | 장애 상태를 나타냅니다. | | 산소 | 문자열 | 산소 공급의 필요성을 나타냅니다. | | PetOnly | 문자열 | 반려동물 운송을 위한 예약만 가능합니다. | | CancellationCharge | 문자열 | 해당되는 경우 취소 수수료. 0은 수수료가 없음을 의미합니다. | | Refundable | 문자열 | 예약 환불에 관한 세부 사항 | | Inventory | 인벤토리 | 예약을 위한 재고 세부 정보 | | Loyalty | Loyalty | 예약을 위한 충성도 세부 정보 | | 채널 | 채널 | 예약을 위한 채널 세부 정보 | | Payment | Payment | 예약에 대한 결제 세부 정보 | | BillingAddress | 주소 | 예약을 위한 결제 주소 세부 정보 | | 가격 | 가격 | 예약 요금 세부 정보 | | PaymentStatus | PaymentStatus | 예약의 결제 상태 | | 속성 | Map | 사용자 지정 또는 확장 속성 | **표준 인덱스 필드** | 표준 인덱스 이름 | 표준 기본 설정 레코드 필드 | | --- | --- | | \$1airBookingId | BookingId | | \$1airPreferenceRef | PreferenceRef | **Loyalty 데이터 형식** | 표준 airBooking 필드 | Type | 설명 | | --- | --- | --- | | ProgramName | 문자열 | 충성도 프로그램 이름 | | MembershipId | 문자열 | 충성도 프로그램 멤버십 번호 | | 계층 | 문자열 | 충성도 멤버십 등급 수준 | **Channel 데이터 유형** | 표준 airBooking 필드 | Type | 설명 | | --- | --- | --- | | CreationChannelId | 문자열 | 예약 생성 시 사용된 채널 ID | | LastUpdatedChannelId | 문자열 | 예약을 업데이트하는 데 사용되는 채널의 ID | | 방법 | 문자열 | 채널을 통해 사용되는 방법(예: 웹, 앱, 전화) | **Payment 데이터 형식** | 표준 airBooking 필드 | Type | 설명 | | --- | --- | --- | | Type | 문자열 | 결제 방법 유형(예: 카드, 바우처) | | CreditCardToken | 문자열 | 안전한 참조를 위한 토큰화된 카드 | | CreditCardType | 문자열 | 사용된 신용 카드 유형 | | CreditCardExpiration | 문자열 | 카드 만료 날짜 | | Cvv | 문자열 | CVV 번호 | | NameOnCreditCard | 문자열 | 카드 소유자 이름 | | RoutingNumber | 문자열 | 은행 라우팅 번호(해당하는 경우) | | AccountNumber | 문자열 | 은행 계좌 번호(해당하는 경우) | | VoucherId | 문자열 | 결제에 사용되는 구독자 | | DiscountCode | 문자열 | 프로모션 할인 코드 적용 | | DiscountPercent | 문자열 | 결제에 적용되는 할인율 | **Billing Address 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | Address1 | 문자열 | 고객 주소의 첫 번째 행입니다. | | Address2 | 문자열 | 고객 주소의 두 번째 행입니다. | | Address3 | 문자열 | 고객 주소의 세 번째 행입니다. | | Address4 | 문자열 | 고객 주소의 네 번째 행입니다. | | City | 문자열 | 고객 주소의 도시입니다. | | 국가 | 문자열 | 고객 주소의 국가입니다. | | County | 문자열 | 고객 주소의 주입니다. | | PostalCode | 문자열 | 고객 주소의 우편번호입니다. | | Province | 문자열 | 고객 주소의 도입니다. | | State | 문자열 | 고객 주소의 주입니다. | **Price 데이터 형식** | 표준 airBooking 필드 | Type | 설명 | | --- | --- | --- | | TotalPrice | 문자열 | 예약의 총 가격 | | BasePrice | 문자열 | 예약의 기본 가격 | | TravellerPrice | 문자열 | 승객당 지불된 요금 | | DiscountAmount | 문자열 | 기본 요금에 적용되는 할인 | | Currency | 문자열 | 결제가 이루어진 통화 | **Payment Status 데이터 형식** | 표준 airBooking 필드 | Type | 설명 | | --- | --- | --- | | PaidAt | 문자열 | 결제가 완료된 시점의 타임스탬프 | | AwaitingPayment | 문자열 | 결제가 보류 중임을 나타냅니다. | | RequiredBy | 문자열 | 결제 기한 | **Inventory 데이터 형식** | 표준 airBooking 필드 | Type | 설명 | | --- | --- | --- | | 좌석 | 문자열 | 예약의 총 좌석 수 | # 표준 항공 세그먼트의 객체 유형 매핑 이 섹션의 주제에서는 표준 항공 세그먼트 정의를 제공합니다. **Topics** + [Customer Profiles 표준 항공 세그먼트 객체 필드](standard-air-segment-object-fields.md) # Customer Profiles 표준 항공 세그먼트 객체 필드 다음 테이블에는 Customer Profiles 표준 항공 세그먼트 객체의 모든 필드가 나열되어 있습니다. **항공 세그먼트** | 표준 airSegment 필드 | Type | 설명 | | --- | --- | --- | | SegmentId | 문자열 | 표준 항공 세그먼트의 고유 식별자 | | BookingRef | 문자열 | 예약 참조 식별자 | | SegmentName | 문자열 | 세그먼트의 이름/설명 | | PassengerIndex | 문자열 | 승객의 인덱스 번호 | | SegmentIndex | 문자열 | 세그먼트의 인덱스 번호 | | SeatSelection | 문자열 | 좌석 선택 세부 정보 | | NumberOfPassengers | 문자열 | 총 승객 수 | | NumberOfLegs | 문자열 | 비행 구간 수 | | 계층 | 문자열 | 승객 티어/상태 수준 | | Origin | 문자열 | 출발 공항 코드 | | OriginCountryCode | 문자열 | 출발 국가 코드 | | Dest | 문자열 | 목적지 공항 코드 | | DestCountryCode | 문자열 | 목적지의 국가 코드 | | ProcessedDate | 문자열 | 세그먼트를 처리한 날짜 | | CreatedDate | 문자열 | 레코드가 생성된 날짜 | | CreatedBy | 문자열 | 레코드를 생성한 사용자 | | UpdatedDate | 문자열 | 레코드가 마지막으로 업데이트된 날짜 | | UpdatedBy | 문자열 | 레코드를 마지막으로 업데이트한 사용자 | | Status | 문자열 | 세그먼트의 현재 상태 | | FlightNumber | 문자열 | 편명 | | 통신 사업자 | 문자열 | 항공사 코드 | | CarrierType | 문자열 | 항공사 유형 | | IsInternational | 문자열 | 항공편이 국제 항공편인지 여부를 나타냅니다. | | IsEticket | 문자열 | 전자 티켓인지 여부를 나타냅니다. | | IsArmed | 문자열 | 무장 승객 여부를 나타냅니다. | | LapInfant | 문자열 | 노트북 영유아 세부 정보 | | Pet | 문자열 | 반려동물과 함께 여행할지 여부를 나타냅니다. | | PrisonerOrGuard | 문자열 | 수감자 또는 가드 상태를 나타냅니다. | | 하위 | 문자열 | 승객의 어린이 여부를 나타냅니다. | | Married | 문자열 | 세그먼트가 결혼했는지 여부를 나타냅니다. | | CheckinEligible | 문자열 | 체크인 자격을 나타냅니다. | | InEligibleReason | 문자열 | 체크인할 수 없는 경우의 이유 | | UnEscortedMinor | 문자열 | 비동반 마이너 상태를 나타냅니다. | | PremiumAccess | 문자열 | 프리미엄 액세스 구매를 나타냅니다. | | MissingData | 문자열 | 누락된 데이터를 나타냅니다. | | CurrentClassOfService | 문자열 | 현재 서비스 클래스 | | BookedClassOfService | 문자열 | 원래 예약된 서비스 클래스 | | CodeShare | 문자열 | 코드 공유 항공편 표시 | | ReverseCodeShare | 문자열 | 역방향 코드 공유를 나타냅니다. | | MarketCarrierCode | 문자열 | 마케팅 통신사 코드 | | OpCarrierCode | 문자열 | 항공사 코드 | | InConnection | 문자열 | 수신 연결 세부 정보 | | OutConnection | 문자열 | 발신 연결 세부 정보 | | MilesToEarn | 문자열 | 획득할 마일 | | 지속 시간 | 문자열 | 비행 시간 | | DurationTimeUnit | 문자열 | 지속 시간의 시간 단위 | | 거리 | 문자열 | 비행 거리 | | DistanceUnit | 문자열 | 거리 측정 단위 | | SellType | 문자열 | 강제 판매인지 여부를 나타냅니다. | | GoShow | 문자열 | 진행 중인지 여부를 나타냅니다 | | Incapacitated | 문자열 | 승객의 장애 여부를 나타냅니다. | | Upgraded | 문자열 | 항공편이 업그레이드되었는지 여부를 나타냅니다. | | Downgraded | 문자열 | 항공편이 다운그레이드되었는지 여부를 나타냅니다. | | BaggageInsurance | 문자열 | 단체 보험 | | MaxAllowedBaggage | 문자열 | 허용되는 최대 수화물 수 | | BaggageQuantity | 문자열 | 수화물 수 | | BaggageFee | 문자열 | 총 수화물 수수료 | | Arrival | 포트 | 세그먼트의 도착 세부 정보 | | Departure | 포트 | 세그먼트의 출발 세부 정보 | | Seat | Seat | 좌석 세부 정보 | | 우선순위 | 우선순위 | 우선 순위 세부 정보 | | Doc | Doc | 여행을 위한 서류 정보 첨부 | | Baggage | 수화물 목록 | 수화물 세부 정보 | | Pets | 반려동물 목록 | 반려동물 세부 정보 | | OtherServices | OtherService 목록 | 기타 서비스 세부 정보 | | 속성 | Map | 추가 속성 | **표준 인덱스 필드** | 표준 인덱스 이름 | 표준 기본 설정 레코드 필드 | | --- | --- | | \$1airSegmentId | SegmentId | | \$1airBookingRef | BookingRef | **Baggage 데이터 형식** | 표준 airSegment 필드 | Type | 설명 | | --- | --- | --- | | Id | 문자열 | 수화물 식별자 | | TagNumber | 문자열 | 수화물 태그 번호 | | DepartureDate | 문자열 | 출발 날짜 | | BaggageType | 문자열 | 수화물 유형 | | 가중치 | 문자열 | 수화물 무게 | | 길이 | 문자열 | 수화물 길이 | | 너비 | 문자열 | 수화물 너비 | | Height | 문자열 | 수화물 높이 | | PriorityBagDrop | 문자열 | 우선 수하물 위탁 서비스 | | PriorityBagReturn | 문자열 | 우선 수하물 반환 서비스 | | HandsFreeBaggage | 문자열 | 면세 장비 서비스 | | Fee | 문자열 | 수화물 수수료 | | IsGateBag | 문자열 | 게이트에서 위탁 수하물을 나타냅니다. | | IsHeavy | 문자열 | 무거운 수화물을 나타냅니다. | **Seat 데이터 형식** | 표준 airSegment 필드 | Type | 설명 | | --- | --- | --- | | SeatNumber | 문자열 | 좌석 번호 | | SeatZone | 문자열 | 좌석 구역 | | SeatType | 문자열 | 좌석 유형 | | 가격 | 문자열 | 좌석 가격 | | NeighborFree | 문자열 | 이웃 좌석이 무료인지 여부를 나타냅니다. | | UpgradeAuction | 문자열 | 경매 업그레이드 가용성을 나타냅니다. | | Available | 문자열 | 좌석 가용성을 나타냅니다. | | ExtraSeat | 문자열 | 추가 좌석 표시 | | AdditionalInformation | 문자열 | 추가 좌석 정보 | **Port 데이터 형식** | 표준 airSegment 필드 | Type | 설명 | | --- | --- | --- | | Location | 문자열 | 위치 이름 | | 코드 | 문자열 | 공항 코드 | | 터미널 | 문자열 | 공항 터미널 | | 국가 | 문자열 | 공항 국가 | | Date | 문자열 | Date | | Time | 문자열 | Time | | EstimatedTime | 문자열 | 예상 시간 | | ScheduledTime | 문자열 | 예약된 시간 | **Priority 데이터 형식** | 표준 airSegment 필드 | Type | 설명 | | --- | --- | --- | | TransactionId | 문자열 | 트랜잭션 식별자 | | PriorityServiceType | 문자열 | 우선 순위 서비스 유형 | | LoungeAccess | 문자열 | 라운지 액세스를 나타냅니다. | | 가격 | 문자열 | 우선 서비스 가격 | | AdditionalInformation | 문자열 | 추가 우선 순위 정보 | **Pet 데이터 형식** | 표준 airSegment 필드 | Type | 설명 | | --- | --- | --- | | 종 | 문자열 | 반려동물 종 | | 품종 | 문자열 | 반려동물 품종 | | 가중치 | 문자열 | 반려동물 무게 | | WeightUnit | 문자열 | 무게 측정 단위 | | TransportType | 문자열 | 반려동물 운송 유형 | **OtherService 데이터 형식** | 표준 airSegment 필드 | Type | 설명 | | --- | --- | --- | | ServiceType | 문자열 | 서비스 유형 | | 설명 | 문자열 | 서비스 설명 | | 가격 | 문자열 | 서비스 요금 | **Doc 데이터 형식** | 표준 airSegment 필드 | Type | 설명 | | --- | --- | --- | | DocType | 문자열 | 문서 유형 | | DocTypeNeeded | 문자열 | 문서가 필요한지 여부를 나타냅니다. | | Nationality | 문자열 | 문서의 국적 | | DateOfBirth | 문자열 | 생년월일 | | AppId | 문자열 | 애플리케이션 식별자 | | AgentId | 문자열 | 에이전트 식별자 | | VerifiedDateTime | 문자열 | 서류 확인 시간 | # 표준 호텔 예약을 위한 객체 유형 매핑 이 섹션의 주제에서는 표준 호텔 예약 정의를 제공합니다. **Topics** + [Customer Profiles 표준 호텔 예약 객체 필드](standard-hotel-reservation-object-fields.md) # Customer Profiles 표준 호텔 예약 객체 필드 다음 테이블에는 Customer Profiles 표준 호텔 예약 객체의 모든 필드가 나열되어 있습니다. **호텔 예약** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | ReservationId | 문자열 | 표준 호텔 예약의 고유 식별자 | | ConfirmationNumber | 문자열 | 호텔 또는 예약 엔진에서 제공한 확인 번호 | | PreferenceRef | 문자열 | 예약에 대한 기본 설정 객체를 참조하는 식별자입니다. | | Status | 문자열 | 예약의 현재 상태(예: 확인됨, 취소됨) | | TripType | 문자열 | 여행의 목적 또는 특성(예: 휴가, 비즈니스) | | BrandCode | 문자열 | 호텔 브랜드를 나타내는 코드 | | HotelCode | 문자열 | 특정 호텔을 식별하는 코드 | | PhoneNumber | 문자열 | 예약을 위한 연락처 전화번호 | | EmailAddress | 문자열 | 예약을 위한 연락처 이메일 주소 | | GroupId | 문자열 | 예약을 그룹 예약에 연결하는 ID | | ContextId | 문자열 | 예약 소스 추적을 위한 컨텍스트별 식별자 | | ProcessedDate | 문자열 | 예약이 처리된 시점의 타임스탬프 | | CreatedDate | 문자열 | 예약 생성 시점의 타임스탬프 | | CreatedBy | 문자열 | 예약을 생성한 사용자/시스템의 식별자 | | UpdatedDate | 문자열 | 예약이 마지막으로 업데이트된 시점의 타임스탬프 | | UpdatedBy | 문자열 | 예약을 업데이트한 사용자/시스템의 식별자 | | AgentId | 문자열 | 예약을 처리하는 에이전트의 ID | | Reserver | 문자열 | 프로파일이 예약자인지 여부를 나타냅니다. | | SameDayRate | 문자열 | 같은 날 예약했는지 여부를 나타냅니다. | | Refundable | 문자열 | 예약이 환불 가능한지 여부를 나타냅니다. | | CancellationCharge | 문자열 | 해당되는 경우 취소 수수료. 0은 수수료가 없음을 의미합니다. | | TransactionId | 문자열 | 거래의 고유 식별자 | | AmountPerNight | 문자열 | 객실에 대해 1박에 청구되는 금액 | | AdditionalNote | 문자열 | 특별 참고 사항 또는 지침 | | NumberOfNights | 문자열 | 예약 일수 | | NumberOfGuests | 문자열 | 예약의 총 게스트 수 | | TotalAmountBeforeTax | 문자열 | 세전 총 비용 | | TotalAmountAfterTax | 문자열 | 세후 총 비용 | | 체크아웃 | CheckOut | 체크아웃 세부 정보 | | Loyalty | Loyalty | 충성도 세부 정보 | | 방 | 방 | 객실 세부 정보 | | CheckIn | CheckIn | 체크인 세부 정보 | | Payment | Payment | 결제 세부 정보 | | Currency | Currency | 통화 세부 정보 | | 취소 | 취소 | 취소 세부 정보 | | 채널 | 채널 | 채널 세부 정보 | | RatePlan | RatePlan | 요금제 세부 정보 | | 게스트 | 게스트 | 게스트 세부 정보 | | 서비스 | 서비스 목록 | 서비스 목록 | | 속성 | Map | 추가 속성 | **표준 인덱스 필드** | 표준 인덱스 이름 | 표준 기본 설정 레코드 필드 | | --- | --- | | \$1hotelReservationId | ReservationId | | \$1hotelPreferenceRef | preferenceRef | **Checkout 데이터 형식** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | 조기 | 문자열 | 얼리 체크아웃이 예약되거나 요청됨 | | Late | 문자열 | 레이트 체크아웃이 예약되거나 요청됨 | | 본인 | 문자열 | 셀프 체크아웃이 예약되거나 요청됨 | | Date | 문자열 | 예약 체크아웃 날짜 | **Loyalty 데이터 형식** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | ProgramName | 문자열 | 충성도 프로그램 이름 | | MembershipId | 문자열 | 충성도 프로그램의 멤버 ID | | 계층 | 문자열 | 멤버십 티어 또는 레벨 | **Room 데이터 형식** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | TypeCode | 문자열 | 객실 유형/범주 코드 | | TypeName | 문자열 | 객실 유형 이름 | | TypeDesc | 문자열 | 객실 유형에 대한 설명 | | 숫자 | 문자열 | 할당된 객실 번호 | | Capacity | 문자열 | 객실 최대 수용 인원 | | AccessibilityType | 문자열 | 접근성 기능 | | SmokingAllowed | 문자열 | 객실에서 흡연이 허용되는지 여부를 나타냅니다. | **CheckIn 데이터 형식** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | Date | 문자열 | 예약 체크인 날짜 | | DigitalKey | 문자열 | 디지털 객실 키가 발급되었는지 여부를 나타냅니다. | | 조기 | 문자열 | 조기 체크인이 요청되었는지 여부를 나타냅니다. | | Late | 문자열 | 레이트 체크인이 요청되었는지 여부를 나타냅니다. | | RoomKeys | 문자열 | 발급된 객실 키 수 | | UserSelectedRoom | 문자열 | 게스트가 자신의 객실을 선택한 경우 true | **Payment 데이터 형식** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | Type | 문자열 | 결제 방법 유형(예: 신용, 직불, 바우처) | | CreditCardToken | 문자열 | 토큰화된 신용 카드 번호 | | CreditCardType | 문자열 | 신용 카드 유형(예: Visa, Amex) | | CreditCardExpiration | 문자열 | 신용 카드 유효 기간 | | Cvv | 문자열 | 카드 확인 값 | | NameOnCreditCard | 문자열 | 신용 카드에 인쇄된 이름 | | RoutingNumber | 문자열 | 은행 송금 번호 | | AccountNumber | 문자열 | 은행 계좌 번호 | | VoucherId | 문자열 | 사용된 경우 바우처 식별자 | | DiscountCode | 문자열 | 적용된 할인 코드 | | DiscountPercent | 문자열 | 할인율 적용 | **Currency 데이터 형식** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | 코드 | 문자열 | 통화의 ISO 코드(예: USD) | | 이름 | 문자열 | 통화의 전체 이름(예: 미국 달러) | | Symbol | 문자열 | 통화 기호(예: \$1) | **Cancellation 데이터 형식** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | 이유 | 문자열 | 취소 이유 | | 설명 | 문자열 | 추가 취소 정보 | **Channel 데이터 유형** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | CreationChannelId | 문자열 | 예약이 이루어진 채널의 ID | | LastUpdatedChannelId | 문자열 | 예약을 마지막으로 업데이트한 채널의 ID | | 방법 | 문자열 | 예약에 사용되는 방법(예: 웹, 모바일 앱) | **RatePlan 데이터 형식** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | 코드 | 문자열 | 예약된 요금제의 코드 식별자 | | 이름 | 문자열 | 예약된 요금제 이름 | | 설명 | 문자열 | 요금제에 대한 설명 | **Service 데이터 형식** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | ServiceType | 문자열 | 서비스 유형(예: 스파, 아침 식사) | | 설명 | 문자열 | 서비스에 대한 설명 | | 비용 | 문자열 | 서비스 비용 | **Guest 데이터 형식** | 표준 hotelReservation 필드 | Type | 설명 | | --- | --- | --- | | Adults | 문자열 | 성인 게스트 수 | | Children | 문자열 | 자녀 게스트 수 | # 표준 충성도의 객체 유형 매핑 이 섹션의 주제에서는 표준 충성도 정의를 제공합니다. **Topics** + [Customer Profiles 표준 충성도 객체 필드](standard-loyalty-object-fields.md) # Customer Profiles 표준 충성도 객체 필드 다음 테이블에는 Customer Profiles 표준 충성도 객체의 모든 필드가 나열되어 있습니다. **Loyalty** | 표준 충성도 필드 | Type | 설명 | | --- | --- | --- | | LoyaltyId | 문자열 | 표준 충성도의 고유 식별자 | | ProgramId | 문자열 | 충성도 프로그램 식별자 | | MembershipId | 문자열 | 프로그램 내 대체 식별자 | | ProgramName | 문자열 | 충성도 프로그램 이름 | | Group | 문자열 | 충성도 프로그램의 그룹 또는 범주 | | 채널 | 문자열 | 충성도 프로그램에 액세스할 수 있는 채널 | | CreatedDate | 문자열 | 충성도 계정이 생성된 날짜 | | EnrollmentDate | 문자열 | 고객이 프로그램에 등록한 날짜 | | CreatedBy | 문자열 | 충성도 계정을 생성한 사용자 또는 시스템 | | UpdatedDate | 문자열 | 충성도 계정이 마지막으로 업데이트된 날짜 | | LastUpdatedBy | 문자열 | 충성도 계정을 마지막으로 업데이트한 사용자 또는 시스템 | | UpgradeDate | 문자열 | 티어가 마지막으로 업그레이드된 날짜 | | RenewalDate | 문자열 | 충성도 멤버십 갱신 날짜 | | AdditionalInformation | 문자열 | 모든 추가 정보 | | EmailAddress | 문자열 | 고객의 이메일 주소 | | EmailAddressVerified | 문자열 | 이메일 확인 여부를 나타내는 플래그 | | PhoneNumber | 문자열 | 고객의 전화번호 | | PhoneNumberVerified | 문자열 | 전화번호가 확인되었는지 여부를 나타내는 플래그 | | Status | 문자열 | 충성도 계정의 현재 상태 | | 계층 | 계층 | 티어 세부 정보 | | Points | Points | 포인트 세부 정보 | | PointExpirations | PointExpiration 목록 | 포인트 만료 세부 정보 | | Payment | Payment | 결제 세부 정보 | | PaymentInformation | PaymentInformation | 결제 정보 세부 정보 | | BillingAddress | 충성도 주소 | 주소 세부 정보 | | 속성 | Map | 달리 다루지 않는 추가 속성 | **표준 인덱스 필드** | 표준 인덱스 이름 | 표준 기본 설정 레코드 필드 | | --- | --- | | \$1loyaltyId | LoyaltyId | | \$1loyaltyMembershipId | membershipId | **Loyalty Address 데이터 형식** | 표준 airPreference 필드 | 데이터 유형 | 설명 | | --- | --- | --- | | Address1 | 문자열 | 고객 주소의 첫 번째 행입니다. | | Address2 | 문자열 | 고객 주소의 두 번째 행입니다. | | Address3 | 문자열 | 고객 주소의 세 번째 행입니다. | | Address4 | 문자열 | 고객 주소의 네 번째 행입니다. | | City | 문자열 | 고객이 거주하는 도시입니다. | | 국가 | 문자열 | 고객이 거주하는 국가입니다. | | County | 문자열 | 고객이 거주하는 카운티입니다. | | PostalCode | 문자열 | 고객 주소의 우편번호입니다. | | Province | 문자열 | 고객이 거주하는 도입니다. | | State | 문자열 | 고객이 거주하는 주입니다. | **Tier 데이터 형식** | 표준 충성도 필드 | Type | 설명 | | --- | --- | --- | | CurrentTier | 문자열 | 고객의 현재 충성도 티어 | | NextTier | 문자열 | 고객에게 승급될 다음 티어 | | PointsToNextTier | 문자열 | 다음 티어에 도달하는 데 필요한 포인트 | **Points 데이터 형식** | 표준 충성도 필드 | Type | 설명 | | --- | --- | --- | | Points.Unit | 문자열 | 포인트의 측정 단위 | | Points.Lifetime | 문자열 | 획득한 총 수명 포인트 | | Points.Balance | 문자열 | 현재 포인트 잔액 | | Points.Redeemed | 문자열 | 사용한 총 포인트 | **PointExpiration 데이터 형식** | 표준 충성도 필드 | Type | 설명 | | --- | --- | --- | | Points | 문자열 | 만료되는 포인트 | | Date | 문자열 | 포인트 만료 날짜 | **Payment 데이터 형식** | 표준 충성도 필드 | Type | 설명 | | --- | --- | --- | | Type | 문자열 | 결제 유형 | | CreditCardToken | 문자열 | 토큰화된 신용 카드 참조 | | CreditCardType | 문자열 | 신용 카드 유형(예: Visa) | | CreditCardExpiration | 문자열 | 신용 카드 유효 기간 | | Cvv | 문자열 | 카드 확인 값 | | NameOnCreditCard | 문자열 | 카드의 이름 | | RoutingNumber | 문자열 | 은행 송금 번호 | | AccountNumber | 문자열 | 은행 계좌 번호 | | VoucherId | 문자열 | 바우처 식별자 | **PaymentInformation 데이터 형식** | 표준 충성도 필드 | Type | 설명 | | --- | --- | --- | | 일정 | 문자열 | 결제 일정 | | LastPaymentDate | 문자열 | 마지막 결제 날짜 | | NextPaymentDate | 문자열 | 다음 결제 날짜 | | NextBillAmount | 문자열 | 다음 청구서 금액 | | CurrencyCode | 문자열 | 통화 코드(예: USD) | | CurrencyName | 문자열 | 통화의 전체 이름 | | CurrencySymbol | 문자열 | 통화 기호(예: \$1) | # 표준 충성도 거래에 대한 객체 유형 매핑 이 섹션의 주제에서는 표준 충성도 거래 정의를 제공합니다. **Topics** + [Customer Profiles 표준 충성도 거래 객체 필드](standard-loyalty-transaction-object-fields.md) # Customer Profiles 표준 충성도 거래 객체 필드 다음 테이블에는 Customer Profiles 표준 충성도 거래 객체의 모든 필드가 나열되어 있습니다. **충성도 거래** | 표준 loyaltyTransaction 필드 | Type | 설명 | | --- | --- | --- | | TransactionId | 문자열 | 표준 충성도 거래의 고유 식별자입니다. | | TransactionName | 문자열 | 거래의 이름 또는 레이블입니다. | | TransactionType | 문자열 | 거래 유형(예: 획득, 사용, 조정). | | ProgramRef | 문자열 | 관련 충성도 프로그램에 대한 참조입니다. | | MembershipRef | 문자열 | 거래에 사용된 충성도 멤버십에 대한 참조입니다. | | PromotionRef | 문자열 | 이 거래에 영향을 준 프로모션에 대한 참조입니다. | | CreatedDate | 문자열 | 거래가 생성된 날짜입니다. | | TransactionDate | 문자열 | 거래가 발생한 날짜입니다. | | Industry | 문자열 | 거래와 관련된 산업(예: 항공사, 호텔). | | Location | 문자열 | 거래가 발생한 위치입니다. | | CreatedBy | 문자열 | 거래를 생성한 사람의 식별자입니다. | | UpdatedDate | 문자열 | 거래가 마지막으로 업데이트된 날짜.입니다. | | UpdatedBy | 문자열 | 거래를 마지막으로 업데이트한 사람의 식별자입니다. | | Status | 문자열 | 거래의 현재 상태입니다. | | AccrualType | 문자열 | 발생 방법(수동, 자동 등). | | 카테고리 | 문자열 | 거래 범주(예: 항공편, 호텔 숙박). | | 채널 | 문자열 | 거래가 시작된 채널(예: 온라인, 매장 내). | | ProductId | 문자열 | 거래에 연결된 제품 또는 서비스의 식별자입니다. | | Amount | 문자열 | 거래에서 소비되거나 거래된 금액입니다. | | OriginValue | 문자열 | 변환 또는 오프셋 이전의 원래 값입니다. | | OriginValueCurrency | 문자열 | 원래 거래 값의 통화입니다. | | OriginValueOffset | 문자열 | 프로모션, 환불 등에 대한 원래 값으로 조정 | | PointsEarned | 문자열 | 이 거래에서 획득한 총 포인트입니다. | | PointOffset | 문자열 | 조정된 포인트(예: 보너스, 페널티). | | QualifyingPointsEarned | 문자열 | 티어 검증에 포함되는 포인트입니다. | | TierBefore | 문자열 | 거래 전 고객 티어입니다. | | TierAfter | 문자열 | 거래 후 고객 티어입니다. | | 브랜드 | 문자열 | 거래와 연결된 브랜드입니다. | | 설명 | 문자열 | 거래에 대한 서술적 설명입니다. | | AdditionalInformation | 문자열 | 거래와 관련된 추가 정보를 프리폼합니다. | | PaymentMethod | 문자열 | 사용된 결제 방법(예: 카드, 바우처) | | PointTransfer | PointTransfer | 포인트 전송 세부 정보 | | 속성 | Map | 추가 속성 | **표준 인덱스 필드** | 표준 인덱스 이름 | 표준 기본 설정 레코드 필드 | | --- | --- | | \$1loyaltyTransactionId | TransactionId | **PointTransfer 데이터 형식** | 표준 loyaltyTransaction 필드 | Type | 설명 | | --- | --- | --- | | TransferId | 문자열 | 전송 거래의 식별자입니다. | | SourceProgramId | 문자열 | 소스 충성도 프로그램의 ID입니다. | | DestinationProgrmId | 문자열 | 대상 충성도 프로그램의 ID입니다. | | SourceMembershipId | 문자열 | 소스 프로그램의 멤버십 ID입니다. | | DestinationMembershipId | 문자열 | 대상 프로그램의 멤버십 ID입니다. | | PointsTransferred | 문자열 | 소스 프로그램에서 공제된 포인트입니다. | | PointsReceived | 문자열 | 대상 프로그램에 적립되는 포인트입니다. | # 표준 충성도 프로모션에 대한 객체 유형 매핑 이 섹션의 주제에서는 표준 충성도 프로모션 정의를 제공합니다. 사용 **Topics** + [Customer Profiles 표준 충성도 프로모션 객체 필드](standard-loyalty-promotion-object-fields.md) # Customer Profiles 표준 충성도 프로모션 객체 필드 다음 테이블에는 Customer Profiles 표준 충성도 프로모션 객체의 모든 필드가 나열되어 있습니다. **충성도 프로모션** | 표준 loyaltyPromotion 필드 | Type | 설명 | | --- | --- | --- | | PromotionId | 문자열 | 표준 충성도 프로모션의 고유 식별자입니다. | | PromotionName | 문자열 | 프로모션의 표시 이름입니다. | | PromotionType | 문자열 | 프로모션 유형 또는 범주(예: 보너스, 티어 부스트, 바우처). | | ProgramType | 문자열 | 프로모션이 연결된 충성도 프로그램의 유형을 나타냅니다. | | ProgramRef | 문자열 | 관련 프로모션 프로그램에 대한 참조 ID입니다. | | PartnerId | 문자열 | 프로모션과 관련된 파트너 조직의 참조 ID입니다. | | PartnerNumber | 문자열 | 파트너와 관련된 식별자 또는 번호입니다. | | 계층 | 문자열 | 프로모션의 대상이 되거나 영향을 받는 티어 수준입니다. | | StartDate | 문자열 | 프로모션이 활성화되는 경우 | | EnrolledDate | 문자열 | 사용자가 프로모션에 등록한 날짜입니다. | | EndDate | 문자열 | 프로모션이 종료되는 시점입니다. | | Amount | 문자열 | 프로모션과 관련된 통화 또는 포인트 값입니다. | | Period | 문자열 | 프로모션 기간(예: 주간, 월간, 캠페인 기반). | | Status | 문자열 | 프로모션의 현재 상태(예: 활성, 만료됨, 완료됨). | | CreatedDate | 문자열 | 프로모션 레코드가 생성된 날짜입니다. | | CreatedBy | 문자열 | 프로모션 레코드를 생성한 사용자 또는 시스템입니다. | | UpdatedDate | 문자열 | 프로모션 레코드가 마지막으로 업데이트된 날짜입니다. | | UpdatedBy | 문자열 | 프로모션을 마지막으로 업데이트한 사용자 또는 시스템입니다. | | CampaignRef | 문자열 | 이 프로모션이 속한 더 광범위한 캠페인에 대한 외부 참조입니다. | | AdditionalInformation | 문자열 | 프로모션에 대한 기타 메모 또는 마케팅 사본. | | TriggerLimit | TriggerLimit | 트리거 제한 세부 정보 | | 사용법 | 사용법 | 사용 세부 정보 | | 규칙 | 규칙 | 프로모션 규칙 세부 정보 | | Incentive | Incentive | 프로모션 인센티브 세부 정보 | | 속성 | Map | 추가 메타데이터 또는 프로그램별 값입니다. | **표준 인덱스 필드** | 표준 인덱스 이름 | 표준 기본 설정 레코드 필드 | | --- | --- | | \$1loyaltyPromotionId | PromotionId | **Rules 데이터 형식** | 표준 loyaltyPromotion 필드 | Type | 설명 | | --- | --- | --- | | 이름 | 문자열 | 프로모션 규칙 내의 규칙 이름입니다. | | 설명 | 문자열 | 프로모션 규칙 내의 규칙 설명입니다. | **Incentive 데이터 형식** | 표준 loyaltyPromotion 필드 | Type | 설명 | | --- | --- | --- | | Type | 문자열 | 인센티브 유형(예: bonusPoints, voucher, tierUpgrade). | | 값 | 문자열 | 포인트 금액 또는 바우처 값과 같은 인센티브의 값입니다. | | 단위 | 문자열 | 인센티브 값의 단위(예: 포인트, %, USD). | **TriggerLimit 데이터 형식** | 표준 loyaltyPromotion 필드 | Type | 설명 | | --- | --- | --- | | Times | 문자열 | 프로모션을 트리거할 수 있는 횟수입니다. | | 간격 | 문자열 | 트리거 제한 간격입니다. | **Usage 데이터 형식** | 표준 loyaltyPromotion 필드 | Type | 설명 | | --- | --- | --- | | UsageProgressPercent | 문자열 | 프로모션 사용량의 진행률입니다. | | UsageCompleted | 문자열 | 완료된 사용량 수입니다. | | UsageTarget | 문자열 | 목표 사용 횟수입니다. | # Web Analytics 객체에 대한 객체 유형 매핑 **WebAnalytics 표준 객체 스키마** | Field | Type | 설명 | | --- | --- | --- | | 이벤트 속성 | | EventId | 문자열 | 웹 분석 이벤트의 고유 식별자입니다. | | EventType | 문자열 | - 페이지 보기, 양식 제출, 버튼 클릭,와 같은 웹 분석 이벤트 유형줄 바꿈 가져오기\$1u0000이어치 바 상호 작용, 앱 오류 프롬프트, 장바구니 상호 작용, 구매, 스크롤 등 | | EventTimestamp | 숫자 | 이벤트의 Epoch 밀리초 타임스탬프입니다. | | EventDuration | 숫자 | EventDuration은 사용자가 특정 상호 작용 중에 소비한 시간을 초 단위로 나타냅니다. 일반적인 사용 사례에는 제품 보기에 소요된 시간, 특정 페이지의 브라우징 세션 길이, 기능에 소요된 시간 등이 포함됩니다. | | EventValue | 숫자 | EventValue는 상호 작용 이벤트의 값 또는 중요도를 나타내는 숫자 속성입니다. 일반적인 사용 사례에는 트랜잭션 이벤트에 대한 구매 금액, 제품 등급에 대한 등급 값, 비디오 보기에 대한 완료율 등이 포함됩니다. | | 세션 속성 | | Session.Id | 문자열 | 세션의 고유 식별자입니다. | | Session.StartTimestamp | 숫자 | 세션의 시작 타임스탬프를 나타내는 Epoch 밀리초입니다. | | 페이지/스크린 속성 | | Page.Title | 문자열 | 모바일 앱의 웹 앱/화면 이름 제목입니다. | | Page.Location | 문자열 | 웹 페이지의 URL입니다. 모바일의 경우 딥 링크이거나 화면으로 라우팅될 수 있습니다. | | Page.Referrer | 문자열 | 이전 화면/페이지. | | Page.Category | 문자열 | 화면/페이지의 논리적 그룹화. 중첩된 URLs. | | HTML/DOM 요소 | | Element.Id | 문자열 | HTML 요소 ID | | Element.Type | 문자열 | 요소 유형 - 버튼, 앵커 링크 등 | | Element.Classes | 문자열 | 요소의 CSS 스타일 클래스 | | Element.Text | 문자열 | 요소 텍스트(버튼, 입력 필드 자리 표시자 등에 유용). | | Element.AltText | 문자열 | HTML 요소의 AltText(일반적으로 이미지에 사용됨). | | Element.Source | 문자열 | 비디오, 이미지 등의 소스 | | 양식 | | Form.Id | 문자열 | 입력 양식의 고유 식별자 | | Form.Name | 문자열 | 양식 이름 | | Form.Length | 문자열 | 양식의 입력 필드 수입니다. | | Form.ValidationErrors | 숫자 | 양식의 검증 오류 수입니다. | | Form.FieldsCompleted | 숫자 | 완료된 필드 수입니다. | | Form.FieldsRequired | 숫자 | 필요한 필드 수입니다. | | 검색 | | Search.Query | 문자열 | 입력에 사용되는 쿼리 문자열 | | Search.TotalMatchingResults | 숫자 | 총 검색 결과 수입니다. | | Search.ResultsPerPage | 숫자 | 페이지당 표시되는 결과 수입니다. | | Search.CurrentResultsPage | 숫자 | 사용자가 보고 있는 현재 결과 페이지입니다. | | Search.FilterExpression | 문자열 | 사용된 추가 필터 표현식입니다. | | Search.SortCriteria | 문자열 | 검색 결과 정렬 기준입니다. 예: 관련성, 가격 등 | | Search.SortOrder | 문자열 | 검색 결과의 정렬 순서 - 오름차순/내림차순. | | 항목/항목 목록 | | 항목 | 항목 | 장바구니에 추가된 항목, 본 항목 등을 나타내는 이벤트의 중점 항목 | | ItemsList | 목록<항목> | 이벤트의 항목, 즉 구매한 항목, 장바구니의 항목, 항목 검색 결과 등을 집중적으로 나열합니다. | | 항목 노출 | | AdditionalItemImpressions | 목록<항목> | 추가 항목 노출 목록 | | 장바구니 | | Cart.Id | 문자열 | 장바구니의 고유 식별자입니다. | | Cart.ItemsCount | 숫자 | 장바구니의 항목 수입니다. | | 장바구니 통화 | 문자열 | 장바구니 값의 통화입니다. | | Cart.Value | 숫자 | 장바구니에 있는 항목의 금전적 값입니다. | | 주문 정보 | | OrderId | 문자열 | 주문의 고유 식별자입니다. 주문 식별자는 여기에만 저장되며, 주문과 관련된 기타 정보는 표준 주문 객체에 저장됩니다. | | 장치 | | DeviceId | 문자열 | 사용자 디바이스의 고유 식별자입니다. | | 속성 스크롤 | | Scroll.DepthPercentage | 문자열 | 세로 스크롤 깊이 백분율입니다. 이렇게 하면 사용자가 웹 페이지를 스크롤하는 거리를 이해하는 데 도움이 됩니다. | | Scroll.PositionX | 숫자 | 왼쪽에서 픽셀 단위의 가로 스크롤 위치입니다. | | Scroll.PositionY | 숫자 | 상단에서 픽셀 단위로 세로 스크롤 위치. | | 오류 | | Error.Description | 문자열 | 오류에 대한 간단한 설명입니다. | | Error.Type | 문자열 | 사용자 입력 오류/서버 오류입니다. | | User | | User.Id | 문자열 | 사용자의 고유 식별자 | | User.AnonymousId | 문자열 | 익명 UserId. 사용자가 로그인하지 않을 때 사용자에게 할당되는 uniqueId입니다. | | User.IsReturning | 문자열 | 사용자가 재방문하는지 여부를 나타내는 부울 값입니다. | | User.IsLoggedIn | 문자열 | 사용자가 로그인했는지 여부를 나타내는 부울 값입니다. | | 활동 위치 | | Location.Country | 문자열 | 사용자 활동 국가입니다. | | Location.State | 문자열 | 사용자 활동 상태입니다. | | Location.Province | 문자열 | 사용자 활동 도입니다. | | Location.County | 문자열 | 사용자 활동 카운티. | | Location.City | 문자열 | 사용자 활동 도시입니다. | | Location.Latitude | 문자열 | 사용자 활동 위치 좌표 | | Location.Longitude | 문자열 | 사용자 활동 위치 좌표 | | 애플리케이션 속성 | | Application.Name | 문자열 | 애플리케이션의 이름입니다. | | Application.Version | 문자열 | 디바이스가 모바일인 경우 여기에서 애플리케이션 버전을 캡처할 수 있습니다. 사용자는 모집단 A/B 테스트 또는 실험 속성에이 기능을 사용하는 것도 고려할 수 있습니다. | | Application.Environment | 문자열 | Beta, Gamma, Prod와 같은 애플리케이션 환경. | | 사용자 지정 속성 | | 속성 | Map | 이벤트에 추가할 사용자 지정 속성 또는 메타데이터입니다. | **WebAnalytics 항목 객체 스키마** | Field | Type | 설명 | | --- | --- | --- | | Id | 문자열 | 항목의 고유 식별자입니다. | | 제목 | 문자열 | 항목의 제목입니다. | | 카테고리 | 문자열 | 항목의 범주입니다. | | 값 | 문자열 | 항목의 통화 값입니다. | | 통화 | 문자열 | 항목의 통화입니다. | | 수량 | 숫자 | 항목의 수량입니다. | | ImpressionType | 문자열 | 이벤트의 노출 유형을 식별하는 문자열입니다. 예: 추천, 후원, 인기 제품 등 | | ImpressionId | 문자열 | 노출을 고유하게 식별하기 위한 문자열 식별자입니다. | **디바이스 표준 객체 스키마** | Field | Type | 설명 | | --- | --- | --- | | DeviceId | 문자열 | 디바이스의 고유 식별자입니다. | | Type | 문자열 | 디바이스 유형(예: 데스크톱, 모바일) | | 모델 | 문자열 | 디바이스 모델, 예: Macbook Pro/Air, IPhone 16 등 | | 제조업체 | 문자열 | 디바이스 제조업체입니다. | | OperatingSystem | 문자열 | Windows, MacOs, IOS, Android를 나타냅니다. | | OperatingSystemVersion | 문자열 | OS 버전 | | ScreenWidth | 숫자 | Screen ViewPort의 너비 | | ScreenHeight | 숫자 | Screen ViewPort의 높이 | | 브라우저 | 문자열 | 사용자가 상호 작용하는 브라우저의 이름입니다. | | BrowserVersion | 문자열 | 브라우저 버전 | | Locale | 문자열 | 디바이스 또는 앱 로캘. | | 속성 | Map | 디바이스에 대한 모든 사용자 지정 속성입니다. | # 항목 카탈로그의 객체 유형 매핑 | Field | Type | 설명 | | --- | --- | --- | | Id | 문자열 | 카탈로그의 항목에 대한 고유 식별자입니다. | | 이름 | 문자열 | 항목 이름 | | 코드 | 문자열 | 카탈로그 항목 코드 | | Type | 문자열 | 카탈로그 항목 유형 | | 카테고리 | 문자열 | 카탈로그의 항목 범주 | | 설명 | 문자열 | 항목 설명 | | AdditionalInformation | 문자열 | 항목과 관련된 추가 정보입니다. | | ImageLink | 문자열 | 항목 이미지 링크 | | 링크 | 문자열 | 항목 URL | | 가격 | 문자열 | 항목 가격 | | CreatedAt | Long | 항목이 생성된 Epoch 타임스탬프 | | UpdatedAt | Long | 항목이 업데이트된 Epoch 타임스탬프 | | 속성 | Map | 추가 항목 속성 | **참고** API를 통해서만 APIs. 모든 추천자를 먼저 삭제한 후 항목 카탈로그 통합을 삭제할 수 있습니다. 이렇게 하면 데이터 종속성 문제가 방지됩니다. **삭제 단계:** 1. 도메인의 모든 기존 추천자 삭제 2. 항목 카탈로그 통합으로 이동합니다. 3. 삭제 옵션을 선택합니다. # 표준 호텔 숙박 수익에 대한 객체 유형 매핑 이 섹션의 주제에서는 표준 호텔 숙박 수익 정의를 제공합니다. **Topics** + [Customer Profiles 표준 호텔 숙박 수익 객체 필드](standard-hotel-stay-revenue-object-fields.md) # Customer Profiles 표준 호텔 숙박 수익 객체 필드 다음 테이블에는 Customer Profiles 표준 호텔 숙박 수익 객체의 모든 필드가 나열되어 있습니다. **호텔 숙박 수익** | 표준 hotelStayRevenue 필드 | Type | 설명 | | --- | --- | --- | | StayRevenueId | 문자열 | 표준 호텔 숙박 수익의 고유 식별자입니다. | | CurrencyCode | 문자열 | 통화의 ISO 코드(예: USD) | | CurrencyName | 문자열 | 통화의 전체 이름(예: 미국 달러) | | CurrencySymbol | 문자열 | 통화 기호(예: \$1) | | ReservationId | 문자열 | 호텔 예약의 고유 식별자 | | GuestId | 문자열 | 게스트의 고유 식별자입니다. | | LastUpdatedOn | 문자열 | 숙박 레코드에 대한 마지막 업데이트의 타임스탬프 | | CreatedOn | 문자열 | 숙박 레코드가 생성된 시점의 타임스탬프 | | LastUpdatedBy | 문자열 | 숙박 레코드를 마지막으로 업데이트한 사용자/시스템의 식별자 | | CreatedBy | 문자열 | 숙박 레코드를 생성한 사용자/시스템의 식별자 | | StartDate | 문자열 | 호텔 숙박 시작일 | | HotelCode | 문자열 | 특정 호텔을 식별하는 코드 | | Type | 문자열 | 수익 유형(예: 객실 요금, 부가 요금, 세금) | | 설명 | 문자열 | 수익 항목에 대한 설명 | | Amount | 문자열 | 수익 항목의 금액 | | ProcessedDate | 문자열 | 수익이 처리된 날짜 | | Status | 문자열 | 수익 항목의 상태 | | 속성 | Map | 추가 메타데이터 또는 프로그램별 값입니다. | **표준 인덱스 필드** | 표준 인덱스 이름 | 표준 기본 설정 레코드 필드 | | --- | --- | | \$1hotelStayRevenueId | StayRevenueId | # Customer Profiles에서 객체 유형의 추가 속성 속성 유형은 해당 객체 유형의 데이터를 암호화하는 데 사용되어야 하는 키를 정의합니다. 이 객체를 수집하여 새 프로필을 만들 수 있는지 여부를 정의하는 옵션이 있습니다. 일반적으로 기존 프로필과 매칭할 수 없는 객체가 수집된 경우 이 옵션이 true인 경우 새 프로필이 생성됩니다. true가 아닌 경우 수집된 객체가 생성되어 도메인 DLQ(Dead Letter Queue)에 기록됩니다. 또한 여기에는 이 객체 유형의 데이터를 Customer Profiles에 보존해야 하는 기간도 포함됩니다. **참고** 개별 객체에 대한 보존은 데이터 수집 시점에 설정됩니다. 특정 객체 유형에 대한 보존 변경은 수집되는 새 데이터에만 적용됩니다. 이미 수집된 기존 데이터에는 적용되지 않습니다. **참고** 이 객체가 기존 프로필과 일치하는 경우 API 직접 호출 또는 에이전트 Workspace를 통해 수동으로 채워진 필드를 덮어쓰지 않으므로 자동 수집이 수동 프로필을 덮어쓰지 않습니다. 예를 들어, 에이전트 Workspace의 에이전트가 FirstName ‘John’으로 프로필을 수동으로 생성한다고 가정해 보겠습니다. Standard Profile의 FirstName 필드에 대한 객체 매핑 데이터가 수집됩니다. 이 객체가 프로필과 연결되면 FirstName ‘John’을 덮어쓰지 않습니다. # 추론된 프로필 필드가 없는 객체를 수집하여 프로필이 생성되는 경우 이 새 프로필의 표준 프로필 객체는 비어 있습니다. 이 빈 표준 프로필 객체는 **추론된 프로필**입니다. 추론된 프로필을 만들 때 프로필 객체의 표준 객체에 다음 두 필드가 채워집니다(사용 가능한 경우). + 수집된 객체에 콘텐츠 유형 `EMAIL_ADDRESS`로 정의된 필드가 있는 경우 이 값이 표준 프로필의 `EmailAddress` 필드에 채워집니다. + 수집된 객체에 콘텐츠 유형이 `PHONE_NUMBER`인 필드가 있는 경우 이 값이 표준 프로필의 `PhoneNumber` 필드에 채워집니다. 필드 정의에 정의된 대상이 필드에 없더라도 이러한 필드의 값은 표준 프로필에 채워집니다. 연락처 레코드 템플릿 유형과 도메인에 사용되는 템플릿을 조정하는 방법에 대한 자세한 내용은 [고객 응대 레코드 템플릿 사용 예](ctr-contact-record-template.md#ctr-contact-record-template-usage-examples) 섹션을 참조하세요. # Amazon Connect Customer Profiles의 연락처 레코드 템플릿 고객 응대 레코드는 전화 통화 또는 채팅과 같은 다양한 고객 응대 이벤트의 필수 메타데이터를 캡처하는 프로필 객체 역할을 합니다. 이는 고객과의 상호 작용을 문서화하고 분석하는 데 중요한 역할을 합니다. 연락처 이벤트가 발생할 때, 도메인에 적용할 수 있는 세 가지 별개의 기본 템플릿이 있습니다. 이러한 템플릿은 구성 옵션으로 사용되어 시스템 내에서 고객 응대 이벤트가 처리되는 방식을 제어합니다. 각 템플릿은 특정 규칙과 작업을 정의하므로 비즈니스 요구 사항에 따라 고객 응대 이벤트 처리를 조정할 수 있습니다. **Topics** + [추론 프로필 생성 및 프로필 자동 연결(CTR-NoInferred)](#ctr-contact-record-template-no-inferred) + [프로필만 자동 연결(CTR-AutoAssociateOnly)](#ctr-contact-record-template-auto-associate) + [추론된 프로필만 생성(CTR)](#ctr-contact-record-template-inferred-only) + [고객 응대 레코드 템플릿 사용 예](#ctr-contact-record-template-usage-examples) + [AWS Console에서 연락처 레코드 유형을 업데이트하는 방법](#ctr-contact-record-template-usage-examples-console) + [이메일 연락처의 이름을 프로필에 자동으로 추가](#add-email-names-to-profile) ## 추론 프로필 생성 및 프로필 자동 연결(CTR-NoInferred) **설명** CTR-NoInferred 템플릿을 사용하고 전화 통화와 같은 고객 응대 이벤트가 발생하면 데이터를 처리하기 위한 특정 프로세스가 시작됩니다. 처음에 시스템은 `_ctrContactId` 키를 사용하여 고객 응대 이벤트와 관련된 기존 프로필을 검색합니다. 일치하는 프로필이 발견되면 고객 응대 이벤트가 해당 프로필과 자동으로 연결됩니다. 그러나 `_ctrContactId` 키를 사용하는 기존 프로필이 없는 경우 시스템은 `_phone`이라는 보조 키를 사용하여 프로필을 검색합니다. 이 키는 고객 응대 이벤트와 관련된 전화번호를 기반으로 기존 프로필을 찾는 데 사용됩니다. 매칭되는 프로필이 발견되면 고객 응대 이벤트가 해당 프로필과 자동으로 연결됩니다. `_ctrContactId` 키 또는 `_phone` 키를 사용하여 기존 프로필을 사용할 수 없는 경우 시스템은 추론된 프로필을 새로 만듭니다. 그런 다음 이 추론된 프로필에 고객 응대 이벤트의 메타데이터가 채워지므로 정보가 캡처되어 시스템 내에 저장됩니다. 이 프로세스를 통해 고객 응대 이벤트를 효율적으로 처리하고, 기존 프로필과의 자동 연결을 촉진하고, 필요할 때 추론된 프로필을 만들 수 있습니다. 조직은 이러한 메커니즘을 활용하여 고객 상호 작용에 대한 포괄적인 기록을 유지하고 시스템 내에서 고객 응대 이벤트 데이터를 효과적으로 관리할 수 있습니다. CTR-NoInferred 템플릿을 기본 동작으로 사용하는 것이 좋습니다. 특히 중복 프로필을 줄일 수 있다는 점에서 상당한 이점이 있기 때문입니다. ![\[고객 응대 레코드 CTR-NoInferred 템플릿 다이어그램.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/ctr-contact-record-template-no-inferred.png) ## 프로필만 자동 연결(CTR-AutoAssociateOnly) **설명** CTR-AutoAssociateOnly 템플릿은 CTR-NoInferred 템플릿과 비슷하게 작동하지만 한 가지 중요한 차이점이 있습니다. 자동 연결을 위한 기존 프로필을 찾을 수 없는 경우 추론된 프로필을 생성하지 않는다는 점입니다. 전화 통화와 같은 고객 응대 이벤트가 발생하면 CTR-AutoAssociateOnly 템플릿은 `_ctrContactId` 키를 사용하여 매칭되는 기존 프로필을 검색합니다. 프로필이 발견되면 고객 응대 이벤트가 해당 프로필과 자동으로 연결됩니다. 그러나 `_ctrContactId` 키를 사용하는 기존 프로필이 없는 경우 템플릿은 `_phone` 키를 사용하는 보조 검색 메커니즘을 사용합니다. 고객 응대 이벤트와 동일한 전화번호와 연결된 기존 프로필을 검색합니다. 매칭되는 프로필이 발견되면 고객 응대 이벤트가 해당 프로필과 자동으로 연결됩니다. CTR-AutoAssociateOnly 템플릿을 사용하는 목적은 프로필 생성을 엄격하게 제어하면서 기존 프로필과 자동으로 연결할 수 있도록 하기 위한 것입니다. CTR-NoInferred 템플릿과 달리 이 템플릿은 매칭되는 프로필이 없을 경우 추론된 프로필을 만들지 못하도록 합니다. 이를 통해 프로필은 수동으로만 생성되므로 조직은 프로필 관리에 있어 더 높은 수준의 제어 및 정확성을 확보할 수 있습니다. CTR-AutoAssociateOnly 템플릿을 사용하면 조직에서 프로필 생성과 관련된 특정 규칙을 준수하면서 자동 연결을 활용할 수 있습니다. 이 접근 방식을 통해 고객 응대 이벤트 처리를 간소화하고 프로필 에코시스템을 정밀하게 제어할 수 있으므로 데이터를 정확하게 표현하고 효율적인 고객 관리를 촉진할 수 있습니다. ![\[고객 응대 레코드 CTR-AutoAssociateOnly 템플릿 다이어그램.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/ctr-contact-record-template-auto-associate.png) ## 추론된 프로필만 생성(CTR) **설명** CTR 템플릿은 `_ctrContactId` 키에만 의존하여 기존 프로필을 검색하며 매칭되는 프로필이 발견되면 고객 응대 이벤트를 프로필과 자동으로 연결합니다. 하지만 기존 프로필이 없는 경우 템플릿은 추론된 프로필을 만들어 고객 응대 이벤트 메타데이터로 채웁니다. 이렇게 하면 기존 프로필이 없는 경우에도 고객 응대 이벤트가 캡처되지만 추론된 프로필이 많이 생성될 수 있습니다. 이렇게 추론된 프로필이 너무 많으면 시스템 내에서 프로필이 중복되는 문제가 발생할 수 있습니다. 이러한 문제를 해결하고 더 나은 프로필 관리 방법을 촉진하려면 CTR-NoInferred 템플릿을 기본 옵션으로 사용하는 것이 좋습니다. CTR-NoInferred 템플릿을 사용하면 시스템에서 추론된 프로필을 만들지 않아도 되므로 중복 프로필 발생을 줄일 수 있습니다. 이 템플릿을 사용하면 고객 응대 이벤트를 보다 간단하고 효율적으로 처리할 수 있으므로 데이터 무결성과 정확성이 향상됩니다. CTR-NoInferred 템플릿을 기본 옵션으로 채택함으로써 조직은 프로필 관리 프로세스를 최적화하고 데이터 중복을 최소화하며 고객 상호 작용을 보다 안정적으로 표현할 수 있습니다. ![\[고객 응대 레코드 CTR 템플릿 다이어그램.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/ctr-contact-record-template-inferred-only.png) ## 고객 응대 레코드 템플릿 사용 예 **Amazon Connect 관리자 웹 사이트** + Amazon Connect 관리자 웹 사이트에서 새 도메인을 생성할 때 원하는 CTR 동작을 선택할 수 있습니다. 이 작업은 **프로필 생성 및 자동 연결** 섹션에서 사용할 수 있는 라디오 버튼 옵션을 통해 수행할 수 있습니다. 마찬가지로 기존 도메인을 선택할 때 라디오 버튼 옵션에는 이전에 해당 도메인과 연결된 동작이 반영됩니다. + 현재 활성화된 도메인을 편집할 때 도메인 세부 정보 페이지에는 **프로필 생성 및 자동 연결** 섹션에 현재 적용된 동작이 표시됩니다. 이 섹션의 헤더에 있는 **편집** 버튼을 선택하면 **프로필 생성 및 자동 연결** **편집** 페이지로 리디렉션됩니다. 여기서 요구 사항에 따라 다른 동작을 선택할 수 있습니다. + 또는 **데이터 매핑** 페이지에서 CTR 매핑을 보는 경우 **템플릿 변경** 버튼을 선택할 수 있습니다. 이 작업을 수행하면 **프로필 생성 및 자동 연결** **편집** 페이지로 이동하여 필요에 맞는 다른 동작을 선택할 수 있습니다. 이러한 옵션을 사용하면 도메인의 CTR 동작을 유연하게 관리할 수 있으므로 특정 선호도나 변화하는 비즈니스 요구 사항에 따라 설정을 쉽게 사용자 지정하고 수정할 수 있습니다. **AWS CLI** + **CTR-NoInferred** 템플릿을 사용하려면 CLI에서 다음 명령을 실행합니다. `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles and auto-associates profiles" --template-id CTR-NoInferred ` + **CTR-AutoAssociateOnly** 템플릿을 사용하려면 CLI에서 다음 명령을 실행합니다. `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Auto-associate with profiles only" --template-id CTR-AutoAssociateOnly ` + **CTR** 템플릿을 사용하려면 CLI에서 다음 명령을 실행합니다. `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles only" --template-id CTR ` **API** API 사용에 대한 자세한 내용은 [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)을 참조하세요. ## AWS Console에서 연락처 레코드 유형을 업데이트하는 방법 1. Customer Profiles 콘솔의 **Customer Profiles 도메인** 섹션에서 **세부 정보 보기**를 선택합니다. ![\[Customer Profiles 도메인 섹션에서 세부 정보 보기를 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-1.png) 1. **도메인 세부 정보** 페이지의 **프로필 생성 및 자동 연결** 섹션에서 **편집**을 선택합니다. ![\[프로필 생성 및 자동 연결 섹션에서 편집을 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-2.png) 1. 도메인에 적용할 원하는 연락처 레코드 동작을 선택하고 **저장**을 선택합니다. ![\[도메인에 적용할 원하는 연락처 레코드 동작을 선택하고 저장을 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-3.png) ## 이메일 연락처의 이름을 프로필에 자동으로 추가 이메일 연락처의 이름을 고객 프로필로 채우도록 흐름을 설정할 수 있습니다. [프로필 업데이트](customer-profiles-block.md#customer-profiles-block-properties-update-profile) 작업을 사용하도록 구성된 [고객 프로필](customer-profiles-block.md) 블록을 사용합니다. # Customer Profiles에서 \$1phone 키를 사용하여 찾은 하나의 프로필과 연락처 레코드 연결 `_phone` 키를 사용하여 찾은 하나의 프로필과 고객 응대 레코드를 자동으로 연결할 수 있습니다. **예제** 도메인에서는 `CreateProfile` API에 의해 다음과 같은 프로필이 생성됩니다. ``` { "FirstName": "John", "LastName": "Doe", "PhoneNumber": "+11234567890" } ``` 기본 CTR 템플릿을 사용하여 `PhoneNumber` \$111234567890번으로부터 전화를 받은 경우, 에이전트가 이미 고객 응대 레코드를 위 프로필의 동일한 발신자와 수동으로 연결하지 않은 한 고객 응대 레코드는 위 프로필과 자동으로 연결되지 않습니다. 고객 응대 레코드가 수동 또는 자동으로 연결되지 않은 경우 Customer Profiles는 고객 응대 레코드의 정보로 추론된 프로필을 생성합니다. 에이전트의 수동 개입 없이 위 프로필을 고객 응대 레코드와 자동으로 연결하려면 CTR-NoInferred 템플릿을 사용할 수 있습니다. CTR-NoInferred 템플릿을 사용하여 `PhoneNumber` \$111234567890번으로부터 전화를 받으면 고객 응대 레코드는 `_phone` 프로필 키를 사용하여 위 프로필과 자동으로 연결됩니다. Customer Profiles가 고객 응대 레코드를 프로필에 자동으로 연결할 수 *없는* 두 가지 시나리오가 있습니다. + `_phone` 프로필 키를 사용하여 프로필을 두 개 이상 찾은 경우 Customer Profiles는 고객 응대 레코드를 고유한 프로필에 연결할 수 없으며 요청이 거부됩니다. + `_phone` 프로필 키에 대한 프로필이 없는 경우 Customer Profiles는 추론된 프로필을 생성합니다. CTR-NoInferred 템플릿을 사용하여 기본 CTR 템플릿을 대체하려면 CLI에서 다음 명령을 실행합니다. `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "No inferred contact record profiles" --template-id CTR-NoInferred` 기본 동작으로 되돌리려면 CLI에서 다음 명령을 실행합니다. `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Revert to inferred contact record profiles" --template-id CTR` # Amazon Connect Customer Profiles의 객체 유형 매핑 예제 ## 프로필을 생성하는 객체 유형 매핑 다음 예제는 표준 프로필을 채우는 데이터를 보여 줍니다. 수신 객체는 다음과 같습니다. ``` { "account": 1234, "email": "john@examplecorp.com", "address": { "address1": "Street", "zip": "Zip", "city": "City" }, "firstName": "John", "lastName": "Doe" } ``` 다음 코드는 수신 객체를 표준 프로필 객체에 매핑하고 고유한 키인 `PersonalEmailAddress`, `fullName` 및 `accountId`를 인덱싱하는 것을 보여 줍니다. ``` { "Fields": { "accountId": { "Source": "_source.account", "Target": "_profile.AccountNumber", "ContentType": "NUMBER" }, "shippingAddress.address1": { "Source": "_source.address.address1", "Target": "_profile.ShippingAddress.Address1" }, "shippingAddress.postalCode": { "Source": "_source.address.zip", "Target": "_profile.ShippingAddress.PostalCode" }, "shippingAddress.city": { "Source": "_source.address.city", "Target": "_profile.ShippingAddress.City" }, "personalEmailAddress": { "Source": "_source.email", "Target": "_profile.PersonalEmailAddress", "ContentType": "EMAIL_ADDRESS" }, "fullName": { "Source": "{{_source.firstName}} {{_source.lastName}}" }, "firstName": { "Source": "_source.firstName", "Target": "_profile.FirstName" }, "lastName": { "Source": "_source.lastName", "Target": "_profile.LastName" } }, "Keys": { "_email": [ { "FieldNames": ["personalEmailAddress"] } ], "_fullName": [ { "FieldNames": ["fullName"] } ], "_account": [ { "StandardIdentifiers": ["PROFILE","UNIQUE"], "FieldNames": ["accountId"] } ] } } ``` 참고로 `email` 및 `fullname`은 인덱싱되지만 프로필을 검색하는 데 사용되지는 않습니다. 계정은 고유 키입니다. 객체를 지정하는 데 필요합니다. 계정 ID가 동일한 객체가 수집될 때마다 동일한 계정 ID로 이전 객체를 덮어씁니다. 표준 프로필 객체에는 여러 필드가 채워집니다(`Target`이 정의된 필드 참조). ## 표준 프로필을 채우지 않는 객체 유형 매핑 이 예에서는 좀 더 복잡한 사용 사례를 보여 줍니다. 프로필과 관련된 데이터를 수집하지만 반드시 표준 프로필 객체를 채우지는 않습니다. 수신 객체는 다음과 같습니다. ``` { "email": "john@examplecorp.com", "timestamp": "2010-01-01T12:34:56Z", "subject": "Whatever this is about", "body": "Body of ticket" } ``` 다음은 이 데이터를 매핑하는 한 가지 방법입니다. ``` { "Fields": { "email": { "Source": "_source.email", "ContentType": "EMAIL_ADDRESS" }, "timestamp": { "Source": "_source.timestamp" } }, "Keys": { "_email": [ { "StandardIdentifiers": ["PROFILE","LOOKUP_ONLY"], "FieldNames": ["email"] } ], "ticketEmail": [ { "StandardIdentifiers": ["PROFILE","SECONDARY","NEW_ONLY"], "FieldNames": ["email"] } ], "uniqueTicket": [ { "StandardIdentifiers": ["UNIQUE"], "FieldNames": ["email","timestamp"] } ] } } ``` 이 예제에서는 데이터를 수집한 다음 처음 조회할 때 이메일 주소를 수집합니다. + 이메일 주소가 단일 프로필과 매칭되면 해당 특정 프로필에 데이터를 연결하는 데 사용됩니다. 다른 고유 식별자가 없으므로 티켓의 고유 식별자는 이메일과 타임스탬프로 구성됩니다. + 지정된 이메일에 프로필이 없는 경우 `EmailAddress` 필드 하나가 채워진 새 프로필이 생성됩니다. 수집된 객체는 이 새로운 **추론된 프로필**에 연결됩니다. 프로필을 찾을 수 있는 두 개의 검색 가능한 키는 `_email` 및 `uniqueTicket`입니다. + 지정된 이메일 주소를 가진 프로필이 두 개 이상 있는 경우 `EmailAddress` 필드 하나가 채워진 새 프로필이 생성되고 객체가 이 새 프로필에 연결됩니다. 이 프로필은 `_email` 및 `uniqueTicket` 외에 정의된 `ticketEmail` 키를 사용하여 생성됩니다. 해당 이메일의 모든 후속 티켓은 이 새로운 **추론된 프로필**에 할당됩니다. 그 이유는 ` _email` 키가 세 개의 프로필을 참조하므로 삭제되지만 `ticketEmail` 키는 단일 프로필(새로 추론된 프로필)만 참조하고 여전히 유효하기 때문입니다. + **추론된 프로필**이 새로 생성되는 경우 해당 프로필을 생성한 첫 번째 객체부터 `EmailAddress` 필드가 채워집니다. # Amazon Connect Customer Profiles의 암시적 프로필 객체 유형 템플릿 ID의 이름([ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html) API에서 반환됨)과 매칭되는 모든 객체 유형을 명시적으로 정의하지 않고도 사용할 수 있습니다. 객체 유형은 이 객체 유형의 템플릿 정의와 정확히 일치합니다. 명시적 객체 유형이 정의되면 이 유형이 암시적 유형을 대체합니다. 암시적 객체 유형은 [ListProfileObjectTypes](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypes.html) API에 포함되거나 [GetProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetProfileObjectType.html) 작업에 의해 반환되지만, 해당 객체 유형에서 수집된 모든 데이터를 제거하려는 경우에는 여전히 삭제할 수 있습니다. # Amazon Connect의 생성형 AI 기반 데이터 매핑 Amazon Connect Customer Profiles는 통합 프로필을 생성하는 데 필요한 시간을 크게 줄이는 생성형 AI 기반 고객 데이터 매핑 기능을 제공하므로 보다 개인화된 고객 경험을 제공할 수 있습니다. 이 기능을 사용하면 고객 센터 관리자가 Adobe Analytics, Salesforce 또는 Amazon Simple Storage Service(S3)와 같이 사용 가능한 70개 이상의 노코드 데이터 커넥터에서 고객 데이터를 추가하면 Amazon Connect Customer Profiles는 이러한 소스의 데이터를 분석하여 서로 다른 소스에 걸쳐 다양한 형식으로 존재하는 데이터를 구성하고 통합 프로필로 결합하는 방법을 자동으로 결정합니다 Amazon Connect. 콜센터 관리자는 고객 프로필 설정을 검토 및 완료하여 에이전트에게 관련 고객 정보를 제공하고 IVR 및 챗봇을 동적으로 개인화하여 고객 만족도와 에이전트 생산성을 개선할 수 있습니다. 생성형 AI 기반 고객 데이터 매핑은 다음 리전에서 사용할 수 있습니다. + 미국 동부(버지니아 북부) + 미국 서부(오레곤) + 아프리카(케이프타운) + 아시아 태평양(싱가포르) + 아시아 태평양(시드니) + 아시아 태평양(도쿄) + 아시아 태평양(서울) + 캐나다(중부) + 유럽(프랑크푸르트) + 유럽(런던) ## 생성형 AI 기반 데이터 매핑 설정 1. Amazon Connect Customer Profiles 콘솔을 엽니다. 1. **데이터 소스 통합** 탭에서 **데이터 소스 통합 추가**를 선택합니다. 1. 연결을 설정합니다. 지원되는 모든 커넥터를 사용할 수 있는 데이터 소스를 드롭다운에서 선택합니다. ![\[지원되는 모든 커넥터를 사용할 수 있는 데이터 소스를 드롭다운에서 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/genai-augmented-data-mapping-1.png) 1. 데이터를 매핑합니다. 데이터 매핑을 자동 생성하는 옵션을 선택하거나 기존 매핑 템플릿을 선택하거나 처음부터 새로 생성합니다. ![\[데이터를 매핑합니다. 데이터 매핑을 자동 생성하는 옵션을 선택하거나 기존 매핑 템플릿을 선택하거나 처음부터 새로 생성합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/genai-augmented-data-mapping-2.png) 1. 매핑 요약을 검토합니다. 모든 고객 속성을 보여 주는 자동 생성된 매핑 결과 요약을 검토합니다. 수집 키를 편집하고 데이터 모으기를 시작하기 전에 확인하세요. 필드 매핑 및 키에 대한 자세한 내용은 [Amazon Connect Customer Profiles의 객체 유형 매핑 정의 세부 정보](object-type-mapping-definition-details.md) 섹션을 참조하세요. ![\[매핑 요약을 검토합니다. 모든 고객 속성을 보여 주는 자동 생성된 매핑 결과 요약을 검토합니다. 수집 키를 편집하고 데이터 모으기를 시작하기 전에 확인하세요.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/genai-augmented-data-mapping-3.png) ## 작동 방식 이 시스템은 4단계로 작동합니다. 첫 번째 단계에서 Customer Profiles는 소스 속성을 가져와 가능한 경우 데이터 소스에서 데이터를 샘플링한 다음 대상에 가장 적합한 객체 유형을 결정합니다. Amazon S3 데이터 소스의 경우 선택한 Amazon S3 버킷과 접두사에 있는 첫 번째 CSV 파일이 샘플 데이터로 사용됩니다. 다른 데이터 소스의 경우 Customer Profiles는 AppFlow를 통해 소스 속성을 가져옵니다. 두 번째 단계에서는 대규모 언어 모델(LLM)을 활용하여 각 사용자 지정 속성을 추가로 처리하고 이를 표준 고객 프로필 속성에 매핑합니다. 세 번째 단계에서는 LLM을 다시 사용하여 키 역할을 할 수 있는 적절한 속성(예: 고객 식별자)을 선택합니다. 마지막으로 네 번째 단계에서는 타임스탬프 형식 탐지기가 타임스탬프를 구문 분석하여 레코드의 올바른 연대순을 유지합니다. 시스템은 예측 결과를 조합한 후 20초 이내에 최대 120개 속성에 대한 매핑을 생성할 수 있습니다. ## 생성형 AI 기반 데이터 매핑 문제 해결 다음 섹션에는 발생할 수 있는 오류 메시지가 표시됩니다. 또한 각 문제의 원인과 해결 방법도 제공합니다. ### 오류: 객체 문자열을 JSON으로 구문 분석할 수 없음 요청의 객체 문자열이 유효한 JSON이 아닙니다. 요청의 객체 문자열을 검토하고 유효한 JSON인지 확인하세요. ### 오류: '객체'의 값이 다음 제한 사항을 충족하지 못함: 멤버의 길이는 5보다 작거나 같아야 함 요청에 객체가 너무 많습니다. 요청에는 최대 5개의 객체가 허용됩니다. 객체 수를 5개 이하로 줄이세요. ### 오류: 120개 속성 한도를 초과함 하나의 JSON 객체에는 중첩된 JSON 속성을 포함하여 최대 120개의 속성이 허용됩니다. JSON 객체에서 매핑할 필요가 없는 일부 속성을 제거하세요. ![\[하나의 JSON 객체에는 중첩된 JSON 속성을 포함하여 최대 120개의 속성이 허용됩니다. JSON 객체에서 매핑할 필요가 없는 일부 속성을 제거하세요.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/genai-augmented-data-mapping-breached-limit.png) ### 경고: 데이터를 구분하는 **고유 키**를 찾지 못했습니다. 프로필을 식별하는 **프로필 키**를 찾지 못했습니다. 모델이 지정된 객체에서 유효한 객체 유형을 찾지 못했습니다. 입력을 변경하거나 제안된 대로 수동 매핑 방식을 사용하세요. ![\[모델이 지정된 객체에서 유효한 객체 유형을 찾지 못했습니다. 입력을 변경하거나 제안된 대로 수동 매핑 방식을 사용하세요.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/genai-augmented-data-mapping-unique-key-warning.png) # Amazon Connect Customer Profiles 데이터 제한 Amazon Connect Customer Profiles를 사용하면 통합 프로필을 생성하는 데 사용하는 다양한 유형의 고객 데이터에 데이터 수집 제한을 설정하여 데이터 온보딩을 사용자 지정할 수 있습니다. 데이터 매핑에 제한을 설정하면 매핑 간에 수집할 데이터의 우선순위를 지정할 수 있습니다. 프로필당 모든 매핑의 기본 최대 한도는 1000입니다. **참고** 데이터 제한은 추정치이며, 단일 프로필에서 수집량이 많은 기간 동안 어느 방향으로든 몇 단위의 편차가 발생할 수 있으므로 약간 다를 수 있습니다. ## Customer Profiles 데이터 제한 구성 방법 1. Amazon Connect Customer Profiles 콘솔을 엽니다. 1. **데이터 제한** 탭을 선택하여 데이터 객체에 대한 제한을 구성합니다. ![\[데이터 제한 탭으로 이동하여 데이터 객체에 대한 제한을 구성합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-data-limits-setup-1.png) 1. 원하는 데이터 객체의 한도에 마우스를 올려 놓고 편집 아이콘을 선택합니다. ![\[원하는 데이터 객체의 한도에 마우스를 올려 놓고 편집 아이콘을 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-data-limits-setup-2.png) 1. 한도를 입력하고 체크 표시 아이콘을 선택하여 한도를 저장하거나 업데이트합니다. ![\[이미지는 입력되는 새 제한을 표시하고 제한을 저장하거나 업데이트하는 데 사용되는 체크 표시 아이콘을 강조 표시합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-data-limits-setup-3.png) ## Customer Profiles 데이터 제한을 지우는 방법 1. 제한을 지우려는 데이터 객체의 라디오 버튼을 선택합니다. 그런 다음 **한도 지우기**를 선택할 수 있습니다. ![\[데이터 제한 페이지에서 데이터 객체 왼쪽의 라디오 버튼을 강조 표시합니다. 여기에서 라디오 버튼을 선택하면 객체의 데이터 제한에 대해 지우기 버튼을 활성화할 수 있습니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-data-limits-clear-1.png) 1. *확인*을 입력하여 선택한 데이터 객체의 제한 값을 지웁니다. ![\[데이터 객체의 제한 값을 지우려는지 확인하는 팝업 상자입니다. 모든 소문자로 'confirm'을 입력하여 지우기 작업을 확인합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-data-limits-clear-2.png) # Customer Profiles로 고객 데이터 생성 및 수집 Amazon S3를 사용하여 모든 소스의 데이터를 정의하고 사용자 지정 또는 사전 구축된 통합 없이 고객 프로필을 원활하게 강화할 수 있습니다. 예를 들어 에이전트에게 관련 구매 내역 정보를 제공하고 싶다고 가정해 보겠습니다. 내부 애플리케이션의 구매 거래 데이터를 S3의 스프레드시트 파일로 가져온 다음 고객 프로필에 연결할 수 있습니다. 이를 설정하려면 사용자 지정 프로필 객체의 모습을 설명하는 [객체 유형 매핑](customer-profiles-object-type-mapping.md)을 정의해야 합니다. 이 매핑은 데이터의 필드가 표준 프로필의 필드를 채우 데 사용될 수 있는 방법 또는 데이터를 특정 프로필에 할당하는 데 사용될 수 있는 방법을 정의합니다. 객체 유형 매핑을 만든 후에는 [PutProfileObject](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObject.html) API를 사용하여 CRM의 사용자 지정 프로필 데이터를 사용자 지정 프로필 객체에 업로드할 수 있습니다. **참고** Customer Profiles는 점 표기법이 포함된 CSV 헤더의 데이터 수집을 지원하지 않습니다. Customer Profiles가 데이터 매핑을 위해 Amazon S3 버킷의 데이터에 액세스하는 데 필요한 IAM 권한 목록은 [Actions defined by Amazon Connect Customer Profiles](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonconnectcustomerprofiles.html#amazonconnectcustomerprofiles-actions-as-permissions)의 표에서 `PutProfileObject` 섹션을 참조하세요. ## Customer Profile 수집 **계정 기반 프로필 수집** 1. S3에 파일을 업로드합니다. 계정 프로필과 계정 프로필 자체에서 참조되는 프로필에 대한 수집은 별도로 이루어져야 합니다. 1. 계정 프로필 수집에 사용되는 새 파일에는 이메일 및 전화에 대한 프로필 유형 및 참여 기본 설정과 같은 새 속성이 포함되어야 합니다. 1. AWS Console을 사용하여 S3에서 고객 프로필로 파일 수집 **샘플 프로필(다음 계정 기반 프로필에서 참조) CSV** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/customer-profiles-object-type-mappings.html) **샘플 계정 기반 프로필 CSV** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/customer-profiles-object-type-mappings.html) **이메일을 사용한 참여 기본 설정의 예**: ``` [ {"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PersonalEmailAddress"}, {"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PersonalEmailAddress"} ] ``` **전화를 사용한 참여 기본 설정의 예**: ``` [ {"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PhoneNumber"}, {"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PhoneNumber"} ] ``` **참고** **ProfileType** `PROFILE`의 경우 동일한 방법을 사용하여 참여 기본 설정을 수집하고 추가할 수 있습니다. 1. 두 개의 데이터 매핑을 생성합니다. 하나는 하위 프로필용이고 다른 하나는 계정 기반 프로필용입니다. ![\[각각 설명된 관계를 기반으로 매핑을 생성하는 두 개의 데이터 소스 통합을 생성합니다. 계정/프로파일을 예로 들 수 있습니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-1.png) 1. 그런 다음 고객 프로필 속성을 매핑합니다. `ProfileType`이라는 대상을 기록해 둡니다. ![\[그런 다음 고객 프로필 속성을 매핑합니다. ProfileType이라는 대상을 기록해 둡니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-2.png) **계정 기반 프로필에서 참조되는 프로필을 수집하기 위한 샘플 객체 유형 매핑** ``` { "AllowProfileCreation": true, "Description": "Standard Profile Object Type", "Fields": { "FirstName": { "ContentType": "STRING", "Source": "_source.FirstName", "Target": "_profile.FirstName" }, "LastName": { "ContentType": "STRING", "Source": "_source.LastName", "Target": "_profile.LastName" }, "PhoneNumber": { "ContentType": "PHONE_NUMBER", "Source": "_source.PhoneNumber", "Target": "_profile.PhoneNumber" }, "PersonalEmailAddress": { "ContentType": "EMAIL_ADDRESS", "Source": "_source.PersonalEmailAddress", "Target": "_profile.PersonalEmailAddress" }, "State": { "ContentType": "STRING", "Source": "_source.State", "Target": "_profile.Address.State" }, "CustomerId": { "ContentType": "STRING", "Source": "_source.CustomerId", "Target": "_profile.Attributes.CustomerId" }, "ProfileType": { "ContentType": "STRING", "Source": "_source.ProfileType", "Target": "_profile.ProfileType" } }, "Keys": { "CustomerId": [ { "FieldNames": [ "CustomerId" ], "StandardIdentifiers": [ "PROFILE", "UNIQUE" ] } ] } } ``` 1. 이 프로세스를 반복하여 계정 기반 프로필을 수집합니다. EngagementPreferences.Email 및 EngagementPreference.Phone을 기록해 둡니다. ![\[이 프로세스를 반복하여 계정 기반 프로필을 수집합니다. EngagementPreferences.Email 및 EngagementPreference.Phone을 기록해 둡니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-3.png) **계정 기반 프로필 수집을 위한 샘플 객체 유형 매핑** ``` { "AllowProfileCreation": true, "Description": "Account-based profiles Object Type", "Fields": { "AccountNumber": { "ContentType": "STRING", "Source": "_source.AccountId", "Target": "_profile.AccountNumber" }, "PrimaryOwner": { "ContentType": "STRING", "Source": "_source.PrimaryOwner", "Target": "_profile.Attributes.PrimaryOwner" }, "SecondaryOwner": { "ContentType": "STRING", "Source": "_source.SecondaryOwner", "Target": "_profile.Attributes.SecondaryOwner" }, "ProfileType": { "ContentType": "STRING", "Source": "_source.ProfileType", "Target": "_profile.ProfileType" }, "EmailEngagementPreferences": { "ContentType": "STRING", "Source": "_source.EmailEngagementPreferences", "Target": "_profile.EngagementPreferences.Email" }, "PhoneEngagementPreferences": { "ContentType": "STRING", "Source": "_source.PhoneEngagementPreferences", "Target": "_profile.EngagementPreferences.Phone" } }, "Keys": { "Account": [ { "FieldNames": [ "AccountNumber" ], "StandardIdentifiers": [ "PROFILE", "UNIQUE" ] } ] } } ``` 1. 각각 설명된 관계를 기반으로 매핑을 생성하는 두 개의 데이터 소스 통합을 생성합니다. 계정/프로파일을 예로 들 수 있습니다. **참고** 계정 기반 프로필 수집은 Amazon Connect Customer Profiles 콘솔의 [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html) API 또는 프로필 지표를 사용하여 계정 기반 프로필에서 참조된 프로필의 성공적인 수집을 확인한 후에만 이루어져야 합니다. 자동 생성 매핑은 계정 기반 프로필과 하위 프로필을 수집하는 데는 작동하지 않습니다. 연락처 기본 설정의 이메일 및 전화 목록에는 하위 프로필을 참조하기 위한 `KeyName` 및 `KeyValue` 또는 `ProfileId`가 있을 수 있습니다. `KeyName`은 고유 식별자여야 합니다. 하위 프로필에 대한 업데이트는 계정 기반 프로필의 참여 기본 설정을 업데이트하지 않습니다. 업데이트는 수집 경로를 통해 이루어져야 합니다. # Amazon Connect Customer Profiles와 Kinesis 통합 생성 다음 단계는 Amazon Kinesis Data Streams에서 Amazon Connect Customer Profiles로 객체를 스트리밍하는 과정을 설명합니다. 통합은 두 가지 주요 단계로 구성됩니다. 1. Kinesis Data Streams에서 EventBridge 버스로 데이터를 스트리밍하도록 EventBridge 파이프를 구성합니다. 1. 생성된 EventBridge 파이프를 사용하여 Kinesis Data Streams와의 Customer Profiles 데이터 통합 설정 ## 1단계: Kinesis에서 EventBridge로 데이터 스트리밍 1. Amazon EventBridge 콘솔([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/))을 엽니다. 1. 탐색 창에서 **이벤트 버스**를 선택합니다. 1. **Create event bus(이벤트 버스 생성)**를 선택하세요. 1. **이벤트 버스 세부 정보** 섹션에서 설명이 포함된 이름을 제공합니다. 예를 들어 `kinesis-to-customer-profiles`입니다. 1. **생성(Create)**을 선택합니다. 1. Kinesis Data Streams 세부 정보 페이지로 이동합니다. 1. **EventBridge 파이프** 탭을 선택하고 **Kinesis Data Streams를 파이프에 연결**을 선택합니다. 1. EventBridge 파이프의 이름을 생성합니다. 1. **대상 설정** 페이지에 도달할 때까지 설정 마법사를 따릅니다. 1. 대상에서 1단계에서 생성된 이벤트 버스를 선택합니다. 예를 들어 `kinesis-to-customer-profiles`입니다. 1. **대상** 섹션 뒤에 **대상 입력 변환기** 아코디언을 확장합니다. 1. 대상 입력 변환기를 다음과 같이 설정합니다. ``` {     "data": <$.data> } ``` 1. **파이프 생성**을 선택하여 설정을 완료합니다. 이 시점에서 Kinesis 이벤트를 EventBridge로 라우팅하도록 성공적으로 구성했습니다. 다음으로 Customer Profiles와의 통합을 생성합니다. ## 2단계: EventBridge 데이터를 Customer Profiles로 수집 1. Amazon Connect 콘솔에서 **Customer Profiles**를 활성화합니다. 1. **데이터 소스 통합** 탭을 선택하고 **데이터 소스 통합 추가**를 선택합니다. 1. **데이터 소스** 드롭다운에서 **Kinesis**를 선택합니다. 1. **EventBridge 파이프 이름** 드롭다운에서 1단계에서 생성한 파이프를 선택하고 **다음**을 선택합니다. 1. **데이터 매핑** 페이지에서 적절한 객체 유형 매핑을 선택하고 **다음**을 선택합니다. 1. **검토 및 통합** 페이지에서 구성을 검토하고 **데이터 소스 통합 추가**를 선택하여 설정을 완료합니다. 이제 Kinesis Data Streams가 Amazon Connect Customer Profiles와 통합되었으며 이제 Kinesis에서 Customer Profiles로 이벤트를 전송할 준비가 되었습니다. # 통합 고객 프로필 데이터 내보내기 Amazon Connect Customer Profiles는 통합 고객 프로필을 Amazon Kinesis Data Stream으로 실시간 데이터 내보내기를 제공합니다. 데이터 스트리밍을 활성화하면 Amazon Kinesis 데이터 스트림으로 새 프로필 및 기존 프로필 업데이트 데이터를 자동으로 수신할 수 있습니다. CRMs 및 마케팅 자동화 도구와 같은 소스 시스템 데이터를 Amazon Connect Customer Profiles의 최신 정보로 up-to-date 상태로 유지할 수 있습니다. 예를 들어 고객이 고객 센터에 전화하여 주소를 업데이트하면 에이전트는 새 고객 주소를 추가하도록 변경할 수 있으며, 업데이트된 프로필 정보는 Kinesis 데이터 스트림으로 실시간 전송됩니다. 이를 설정하려면 Customer Profiles 콘솔에서 **데이터 내보내기**를 활성화해야 합니다. ## 실시간 내보내기 활성화 **도메인의 데이터 스트리밍을 활성화하려면** 1. Amazon Connect Customer Profiles 콘솔을 엽니다. 1. **데이터 내보내기** 탭을 선택하고 **데이터 스트리밍 활성화**를 선택합니다. ![\[실시간 데이터 내보내기를 통해 Kinesis 데이터 스트림을 활성화할 수 있습니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/enable-real-time-export-1.png) 1. **데이터 스트리밍 활성화**를 선택하고 드롭다운 메뉴에서 기존 Kinesis 데이터 스트림을 선택하거나, **새 Kinesis 데이터 스트림 생성**을 선택하여 Kinesis 콘솔을 열고 스트림을 생성합니다. 자세한 내용은 [스트림 생성 및 관리](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html)를 참조하세요. ![\[실시간 데이터 내보내기를 통해 Kinesis 데이터 스트림을 활성화할 수 있습니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/enable-real-time-export-2.png) 1. 설정을 저장하려면 **데이터 스트리밍 활성화** 버튼을 선택합니다. ## 실시간 내보내기 활성화 **도메인의 데이터 스트리밍을 비활성화하려면** 1. Amazon Connect Customer Profiles 콘솔을 엽니다. 1. **데이터 내보내기** 탭을 선택하고 **데이터 스트리밍 비활성화**를 선택합니다. ![\[실시간 데이터 내보내기를 통해 Kinesis 데이터 스트림을 비활성화할 수 있습니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/disable-real-time-export-1.png) ## 실시간 내보내기 Kinesis 페이로드 **JSON의 샘플 출력 이벤트** ``` { "SchemaVersion": 0, "EventId": "eventId", "EventTimestamp": "2020-01-01T00:00:00Z", "EventType": "CREATED", "DomainName": "domainName", "ObjectTypeName": "objectTypeName", "AssociatedProfileId": "associatedProfileId", "ProfileObjectUniqueKey": "profileObjectUniqueKey", "Object": { "map": { "k1": [ "a", "b", "c" ] } }, "IsMessageRealTime": true } ``` **SchemaVersion** 스키마의 현재 버전입니다. **EventId** 고유한 이벤트 ID입니다. **EventTimestamp** ISO8601 표준을 사용한 이벤트의 타임스탬프입니다. **EventType** 내보낸 이벤트의 유형입니다. 값: CREATED, UPDATED, HEALTH\$1CHECK + CREATED: 내보내기 이벤트가 CreateProfile을 위한 것이었습니다. + UPDATED: 내보내기 이벤트가 UpdateProfile을 위한 것이었습니다. + HEALTH\$1CHECK: 내보내기 이벤트가 Kinesis 스트림에서 Customer Profiles가 제대로 `putEvent`하는지 확인하기 위한 HealthCheck 이벤트를 위한 것이었습니다. **DomainName** 이벤트가 속한 도메인으로 이벤트의 `/Domain`입니다. **ObjectTypeName** 이벤트의 객체 유형입니다. 값: `_profile`, `_asset`, `_order`, `_case`. 또한 `Salesforce-Account`와 같은 사전 정의된 템플릿 이름 또는 [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) API를 사용하여 생성할 수 있는 사용자 정의 객체 이름을 사용할 수 있습니다. **AssociatedProfileId** 객체가 연결된 표준 프로필의 ID입니다. 객체 유형이 `_profile`이 아닌 경우에만 표시됩니다. **ProfileObjectUniqueKey** 서비스에서 생성된 ProfileObject의 고유 식별자입니다. 유형: 문자열 **Object** 표준 프로필 또는 표준 프로필 객체 자체입니다. **IsMessageRealTime** 메시지가 실시간인지 아니면 다시 전송되었는지 알려 주는 플래그입니다. **JSON의 샘플 페이로드** ``` { "SchemaVersion": 0, "EventId": "6049bf39-0000-0000-0000-b75656dd51a8", "EventTimestamp": "2023-02-24T07:17:05.356Z", "EventType": "UPDATED", "DomainName": "SampleDomain", "ObjectTypeName": "Salesforce-Account", "AssociatedProfileId": "5ffcee99ab0000000000b3ae01225e40", "ProfileObjectUniqueKey": "cNo77ZI0000000000pCPB7RQcqfeBaRfBwrzW2MMbws=", "Object": { "Id": "0012v00002kVKVuAAO", "IsDeleted": false, "Name": "Company A", "Phone": "+12065551234", "PhotoUrl": "/services/images/photo/0012v00002kVKVuAAO", "OwnerId": "0052v00000fmQ7sAAE", "CreatedDate": "2019-12-13T07:56:04.000+0000", "CreatedById": "0052v00000fmQ7sAAE", "LastModifiedDate": "2023-02-22T20:29:43.000+0000", "LastModifiedById": "0052v00000fmQ7sAAE", "SystemModstamp": "2023-02-22T20:29:43.000+0000", "LastActivityDate": "2020-03-18", "LastViewedDate": "2023-02-23T00:09:49.000+0000", "LastReferencedDate": "2023-02-23T00:09:49.000+0000", "CleanStatus": "Pending" }, "IsMessageRealTime": true } ``` # Kinesis Data Stream으로 실시간 이벤트 내보내기 문제 해결 Kinesis Data Stream으로 이벤트를 처음 내보낼 때 지연이 발생할 수 있습니다. 이는 서비스 연결 역할에 대한 IAM 권한을 전파하는 데 걸리는 시간 때문입니다. 실제 문제가 발생하면 스트리밍 상태가 오류 상태가 될 수 있습니다. ![\[대상 Kinesis Data Stream에 도달할 수 없는 이벤트가 오류 상태로 들어갑니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/real-time-export-troubleshooting.png) 다음 섹션에는 발생할 수 있는 오류 메시지가 표시됩니다. 또한 각 문제의 원인과 해결 방법도 제공합니다. ## 오류: Kinesis 데이터 스트림이 활성화되지 않았습니다. 구성을 확인하고 나중에 이벤트 스트림을 다시 생성하세요. 대상 Kinesis 데이터 스트림이 `ACTIVE` 상태에 있지 않습니다. 이는 Kinesis 데이터 스트림이 생성되거나 삭제되는 중일 때 발생할 수 있습니다. 오류를 해결하려면 Kinesis 데이터 스트림이 ACTIVE 상태인지 확인하고 데이터 스트리밍 설정을 다시 활성화하세요. ## 오류: Kinesis 데이터 스트림이 존재하지 않습니다. 유효한 Kinesis 데이터 스트림 대상으로 이벤트 스트림을 다시 생성하세요. 대상 Kinesis 데이터 스트림이 삭제되었습니다. 오류를 해결하려면 기존 Kinesis 데이터 스트림을 대상으로 사용하여 데이터 스트리밍을 다시 활성화하세요. ## 오류: Kinesis 데이터 스트림이 제한되고 있습니다. 더 높은 Kinesis 처리량을 적절하게 프로비저닝하는 것을 고려하세요. 대상 Kinesis 데이터 스트림이 제한(과소 프로비저닝)되고 있습니다. 오류를 해결하려면 대상 Kinesis 데이터 스트림에 샤드 수가 충분한지 확인한 다음 데이터 스트리밍을 다시 활성화하세요. ## 오류: Kinesis 데이터 스트림을 암호화하는 데 사용된 KMS 키가 제한되고 있습니다. KMS 요청 할당량을 적절하게 늘리는 것을 고려해 보세요. 오류: Kinesis 데이터 스트림에서 사용된 KMS 키가 제한되고 있습니다. 오류를 해결하려면 데이터 스트리밍을 다시 활성화하세요. ## 오류: Kinesis 데이터 스트림의 KMS 키 구성을 확인하세요. Customer Profiles가 Kinesis 데이터 스트림에서 사용된 KMS 키에 액세스할 수 없습니다. 이는 KMS 키에 Customer Profiles 서비스 연결 역할의 액세스를 거부하는 키 정책이 있거나 키가 활성화 상태가 아닌 경우 발생할 수 있습니다. 오류를 해결하려면 KMS 키 정책이 Customer Profiles 서비스 연결 역할의 액세스를 거부하지 않고 키가 활성화 상태인지 확인하세요. 오류를 해결하려면 데이터 스트리밍을 다시 활성화하세요. # 모든 통합 고객 프로필 데이터에 대한 대량 내보내기 설정 **참고** 이 주제의 단계를 완료하려면 개발자 기술이 있어야 하며 및 AWS KMS Amazon S3 사용에 대한 경험이 있어야 합니다. Amazon Connect Customer Profiles가 통합 고객 프로필을 생성하면 자사 및 서드파티 소스의 데이터를 결합하여 원시 데이터와 정보를 더 정확한 프로필로 개선, 개선 및 개선합니다. Customer Profiles는 또한 새 데이터를 추가하여 데이터세트의 품질을 개선합니다. 향상된 데이터세트를 사용하여 더 많은 정보와 대상 마케팅, 영업 및 고객 서비스 전략을 공식화하는 등의 추가 사용 사례를 만들 수 있습니다. 예를 들어 통합 고객 프로필을 활용하여 다음을 수행할 수 있습니다. + 도메인 전체의 고객 데이터를 감사합니다. + 예를 들어 영업 및 마케팅 보고서에 대한 사내 분석을 수행합니다. + 데이터를 자체 도구 또는 서드파티 제품으로 내보내 광고를 개인화하고 고객을 대상으로 지정합니다. 추가 사용 사례에 통합 고객 프로필 데이터를 활용하려면 Amazon S3로 대량 내보낼 수 있습니다. 이 주제에서는 이를 수행하는 방법을 설명합니다. **Topics** + [1단계: KMS 키 및 S3 버킷 설정](#enable-cpbulk-export) + [2단계: 대량 내보내기 작업 생성](#create-bulk-export-job) + [3단계: 대량 내보내기 작업의 상태 확인](#check-status-bulk-cp-export) + [4단계: S3에서 내보낸 데이터 보기](#view-bulk-cp-export) + [대량 내보내기 작업 업데이트](#update-bulk-cp-export) + [대량 내보내기 작업 삭제 또는 취소 - 지원되지 않음](#delete-bulk-cp-export) ## 1단계: KMS 키 및 S3 버킷 설정 도메인에 대한 대량 내보내기를 활성화하려면 다음 리소스를 설정해야 합니다. + [특정 리소스 정책이 있는 KMS 키](#cp-kms) + [특정 리소스 정책이 있는 대상 S3 버킷](#cp-s3-bulk). 버킷에서 [액세스 제어 목록(ACL)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acls.html)을 구성하지 마세요. 다음 단계에서 설명합니다. ### 새 KMS 키를 생성하거나 기존 KMS 키를 재사용합니다. 대량 내보내기를 위해 KMS 키를 설정하려면 대량 내보내기 대상으로 구성하려는 Amazon S3 버킷과 동일한 AWS 리전에 있는 기존 KMS 키를 생성하거나 재사용해야 합니다. Amazon Connect AppIntegrations 서비스가 키에 대한 KMS 작업을 수행하도록 허용해야 합니다. **키 정책**에 다음 문을 추가합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Enable AppIntegrations access to KMS key", "Effect": "Allow", "Principal": { "AWS": [ "arn:aws:iam::111122223333:root" ], "Service": [ "app-integrations.amazonaws.com" ] }, "Action": [ "kms:Encrypt*", "kms:Describe*", "kms:Decrypt*", "kms:GenerateDataKey*" ], "Resource": "*" } ] } ``` ------ ### S3 대상 버킷 설정 KMS 키와 동일한 AWS 리전에 새 버킷 또는 기존 버킷을 구성하고 S3 버킷에 리소스 정책을 구성해야 합니다. 버킷을 구성할 때 **SSE-KMS를 사용한 암호화**를 선택하고 이전 절차에서와 동일한 KMS 키를 사용해야 합니다. 또한 S3 버킷에서 ACL을 활성화하지 마세요. 다음은 리소스 정책의 예입니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Allow AppIntegrations to write data to destination bucket", "Effect": "Allow", "Principal": { "Service": [ "app-integrations.amazonaws.com" ] }, "Action": [ "s3:GetObject", "s3:ListBucket", "s3:PutObject", "s3:PutObjectAcl" ], "Resource": [ "arn:aws:s3:::{{amzn-s3-demo-bucket1}}", "arn:aws:s3:::{{amzn-s3-demo-bucket2}}/*" ], "Condition": { "StringEquals": { "aws:SourceAccount": "{{AwsAccountId}}" }, "ArnEquals": { "aws:SourceArn": "arn:aws:*-*:{us-east-1}:{{AwsAccountId}}:data-integration/*" } } } ] } ``` ------ ## 2단계: 대량 내보내기 작업 생성 대량 내보내기 작업을 생성하려면 다음 Amazon Connect AppIntegrations API를 간접적으로 호출합니다. 1. [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html): 이 API는 데이터 소스(예: Customer Profiles)와의 통합을 생성합니다. 1. [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html): 이 API는 데이터 소스를 사용하여 대상(예: S3 버킷)에 데이터를 씁니다. 다음은 이러한 API를 직접적으로 호출하는 방법에 대한 추가 설명입니다. ### 데이터 통합 생성 데이터 통합은 데이터의 *데이터 소스*를 나타냅니다. [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html) API를 직접적으로 호출하거나 [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html) CLI 명령을 실행하여 데이터 통합을 생성할 수 있습니다. Customer Profiles *객체 유형* 및 Customer Profiles *도메인*을 제공해야 합니다. 여러 객체 유형을 내보내려면 각 객체에 대해 별도의 데이터 통합을 생성해야 합니다. 예를 들어 `_profile` 및 `_asset` 객체를 모두 내보내려면 두 개의 개별 데이터 통합을 생성해야 합니다. **참고** 지난 30분 내에 수집된 모든 데이터는 내보내기에 포함되지 않을 수 있습니다. 다음 코드 샘플은 [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html) CLI 명령을 실행하는 방법을 보여 줍니다. ``` aws appintegrations create-data-integration \ --region "us-west-2" \ --name "bulk-export-job-01" \ --description "Data integration for _profile objects" \ --kms-key "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012" \ --source-uri "AmazonConnect://AppIntegrations" \ --object-configuration '{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}' ``` 다음 코드 샘플은 [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html) API를 직접적으로 호출하는 방법을 보여 줍니다. ``` { "Description": "Data integration for _profile objects", "KmsKey": "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012", "Name": "unique-data-integration-name-01", "SourceURI": "AmazonConnect://AppIntegrations", "ObjectConfiguration": { "CustomerProfiles": { "domainName": [ "my-domain-pdx" ], "objectType": [ "_profile" ] } } } ``` ### 데이터 통합 연결 생성 데이터 통합 연결은 데이터를 내보낼 대상과 내보낼 데이터를 선택할 시간 범위를 나타냅니다. [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html) API를 직접적으로 호출하거나 [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html) CLI 명령을 실행하여 데이터 통합을 생성할 수 있습니다. `StartTime` 및 `EndTime` 속성을 사용하여 시간 범위를 구성합니다. 이 시간 범위는 Customer Profiles에서 객체가 마지막으로 업데이트된 시기와 일치합니다. 지정한 대상 S3 버킷은 버킷 이름일 뿐이거나 데이터를 내보낼 추가 폴더 또는 S3 접두사를 포함할 수 있습니다. **참고** **동시 대량 내보내기 작업**의 할당량은 [Amazon Connect Customer Profiles 서비스 할당량](amazon-connect-service-limits.md#customer-profiles-quotas) 섹션을 참조하세요. 대량 내보내기 작업이 완료되거나 실패하면 더 이상 동시성 할당량에 포함되지 않습니다. 다음 코드 샘플은 [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html) CLI 명령을 실행하는 방법을 보여 줍니다. ``` aws appintegrations create-data-integration-association \ --region "us-west-2" \ --data-integration-identifier "unique-data-integration-name-01" \ --destination-uri "s3://amzn-s3-demo-bucket1" \ --execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}' ``` 다음 코드 샘플은 [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html) API를 직접적으로 호출하는 방법을 보여 줍니다. ``` { "DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012", "DestinationURI": "s3://amzn-s3-demo-bucket1", "ExecutionConfiguration": { "ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": { "StartTime": "1713565000004", "EndTime": "1713565000005" } } } ``` ## 3단계: 대량 내보내기 작업의 상태 확인 대량 내보내기 작업의 상태를 보려면 [ListDataIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_ListDataIntegrationAssociations.html) API를 직접적으로 호출하거나 [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html) CLI 명령을 실행할 수 있습니다. 다음 코드 샘플은 [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html) CLI 명령을 실행하는 방법을 보여 줍니다. ``` aws appintegrations list-data-integration-associations \ --region "us-west-2" \ --data-integration-identifier "unique-data-integration-name-01" ``` ## 4단계: S3에서 내보낸 데이터 보기 데이터 통합 연결이 `IN_PROGRESS`에 있는 경우 S3 버킷에 복사되는 데이터가 표시되기 시작합니다. 내보낸 데이터는 다음 경로 구조를 사용하여 작성됩니다. + \$1BucketNameAndFolderName\$1 + \$1AwsAccountId\$1 + \$1DomainName\$1 + \$1RequestTimestamp\$1 + \$1lStartTime\$1-\$1EndTime\$1 + \$1ObjectTypeName\$1 + 다음은 경로 예제입니다. `amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012` ## 대량 내보내기 작업 업데이트 작업이 완료되면 다른 데이터 풀 시작 시간 및 데이터 풀 종료 시간으로 데이터 통합 연결을 업데이트할 수 있습니다. 이렇게 하면 새 대량 내보내기 작업이 생성됩니다. 과거에 대량 내보내기를 수행했고 이전 내보내기 이후 업데이트된 데이터만 내보내려는 경우 이 작업을 수행할 수 있습니다. 예를 들어 마지막 대량 내보내기 작업이 3개월 전인 경우 데이터 통합 연결을 3개월 전부터 오늘까지의 기간으로 업데이트할 수 있습니다. [UpdateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_UpdateDataIntegrationAssociation.html) API를 직접적으로 호출하거나 [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html) CLI 명령을 실행하여 내보내기 작업을 업데이트할 수 있습니다. 다음 코드 샘플은 [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html) CLI 명령을 실행하는 방법을 보여 줍니다. ``` aws appintegrations update-data-integration-association \ --region "us-west-2" \ --data-integration-identifier "unique-data-integration-name-01" \ --data-integration-association-identifier "arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012" \ --execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}' ``` ## 대량 내보내기 작업 삭제 또는 취소 - 지원되지 않음 대량 내보내기는 삭제하거나 취소할 수 없습니다. 내보내기 작업이 완료되면 더 이상 내보내기 할당량에 포함되지 않습니다. # Amazon Connect Customer Profiles 도메인 삭제 매핑을 삭제하면 해당 매핑과 관련된 객체 및 데이터만 삭제됩니다. 프로필과 연결된 객체가 여러 개 있는 경우 특정 매핑을 삭제해도 프로필 데이터가 지워지지 않을 수 있습니다. 특정 데이터를 삭제하려면 매핑을 삭제해야 하지만 다른 매핑의 데이터가 포함된 프로필은 여전히 존재할 수 있습니다. 이로 인해 기존 프로필에 대한 추가 요금이 부과될 수 있습니다. 이러한 문제를 방지하려면 다음 단계에 따라 Amazon Connect 콘솔을 사용하여 Customer Profiles 도메인을 삭제하면 됩니다. 1. Amazon Connect 콘솔에 로그인하고 왼쪽 탐색 창에서 고객 프로필을 선택합니다. Customer Profiles 도메인을 선택한 다음 **세부 정보 보기**를 선택합니다. ![\[Amazon Connect Customer Profiles 도메인 삭제 페이지, 도메인 세부 정보 보기 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/delete-customer-profiles-domain-step1.png) 1. **도메인 삭제**를 선택합니다. ![\[Amazon Connect Customer Profiles 도메인 삭제 페이지, 도메인 삭제 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/delete-customer-profiles-domain-step2.png) 1. 도메인을 삭제하려면 상자에 *confirm*을 입력하고 **도메인 삭제**를 선택합니다. ![\[Amazon Connect Customer Profiles 도메인 삭제 페이지, 직접 confirm이라고 입력한 후의 도메인 삭제 확인 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/delete-customer-profiles-domain-step3.png) # Amazon Connect Customer Profiles의 기본 계산된 속성 *계산된 속성*은 공식을 사용하여 다른 속성에서 파생된 값입니다. 이를 사용하여 사용자의 집계 동작을 식별할 수 있습니다. 계산된 속성을 생성하여 자체 비즈니스 로직을 정의하여 고객 프로필 데이터를 실행 가능한 데이터 포인트로 변환할 수 있습니다. 이를 통해 대화형 음성 응답과 같은 자동화된 경험을 개인화할 수 있습니다. 계산된 속성을 사용하면 고객의 과거 행동에 관한 핵심 속성을 식별할 수 있습니다. 예제: + 마지막으로 방문한 웹 사이트 또는 마지막으로 말한 에이전트 + 선호하는 채널 및 연락 빈도와 같은 동작 패턴 + 신규 고객 및 평균 티켓 크기와 같은 고객 가치 계산된 속성 API를 통해 평균, 개수, 최소값, 최대값, 합계와 같은 일반적인 집계 연산을 사용하여 새 속성을 만들 수 있습니다. 계산된 속성은 원시 데이터를 실행 가능한 데이터 포인트 및 지표로 실시간, 자동으로 변환합니다. 고객 센터 관리자는 고객 프로필에서 사용할 수 있는 원시 데이터를 기반으로 계산을 정의하고 구성할 수 있습니다. 이렇게 계산된 속성을 사용하면 대화형 음성 응답(IVR) 또는 챗봇과 같은 자동화된 환경을 더 쉽게 구축할 수 있습니다. 개인화된 경험을 구축하고 에이전트가 고객 컨텍스트를 더 빨리 이해하도록 도울 수 있습니다. 계산된 속성 APIs를 사용할 수 있는 AWS 리전 목록은 섹션을 참조하세요[리전별 Customer Profiles 계산된 속성 API 가용성](regions.md#customerprofiles_calculatedattributesregion). **Topics** + [계산된 속성 시작하기](customerprofiles-calculated-attributes-admin-website.md) + [계산된 속성 API](customerprofiles-calculated-attributes-apis.md) + [사용자 지정 계산된 속성 정의 생성](customerprofiles-calculated-attributes-creating-definition.md) + [계산된 속성 값 검증](customerprofiles-calculated-attributes-validating-values.md) + [기본 계산된 속성](customerprofiles-default-calculated-attributes.md) + [오류 메시지 및 해결 방법](customerprofiles-calculated-attributes-troubleshooting.md) # Amazon Connect Customer Profiles에서 계산된 속성 시작하기 계산된 속성을 사용하여 자체 비즈니스 로직을 정의하고, 고객 프로필 데이터를 실행 가능한 데이터 포인트로 변환하고, 대화형 음성 응답과 같은 자동화된 경험을 개인화할 수 있습니다. 계산된 속성을 사용하여 고객의 과거 행동, 행동 패턴 및 고객 가치에 대한 주요 속성을 식별할 수 있습니다. 이 섹션의 주제에서는 계산된 속성을 생성, 보기, 편집 및 삭제하는 방법을 보여 줍니다. **Topics** + [계산된 속성 생성](calculated-attributes-admin-website-create.md) + [이벤트 필터 설정](calculated-attributes-admin-website-event-filters.md) + [계산된 속성 보기](calculated-attributes-admin-website-view.md) + [계산된 속성 편집](calculated-attributes-admin-website-edit.md) + [계산된 속성 삭제](calculated-attributes-admin-website-delete.md) # Amazon Connect에서 계산된 속성 생성 1. 사전 조건: 필요한 보안 프로필 권한이 있는지 확인합니다. 자세한 내용은 [Amazon Connect Customer Profiles에서 계산된 속성에 대한 권한 업데이트](security-profile-customer-profile-calc-attribs.md) 단원을 참조하십시오. 1. Amazon Connect 관리자 웹 사이트에서 **Customer Profiles**, **계산된 속성**으로 이동하여 계산된 속성 테이블 보기에서 **속성** **생성을** 선택합니다. ![\[에이전트 Workspace의 고객 프로필 탭, 연결 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-create-1.png) 1. 계산된 속성을 생성하려면 설명적인 이름을 지정하고, 속성에 대한 세부 정보를 포함한 설명(선택 사항)을 추가한 후 필수 필드를 구성합니다. + **계산:** 속성 계산 방법(평균/개수/합계/최소/첫 번째 발생/마지막 발생/최대 발생 횟수)을 정의합니다. + **속성:** 고객 프로필 데이터의 데이터 포인트입니다. **참고** 표준 객체 유형(`_asset`, `_case`, `_order`)에서 속성을 선택하는 경우 속성은 PascalCase 에 있어야 합니다. 즉, 속성 이름에 있는 각 단어의 첫 글자는 `_case.CreatedBy` 또는 `_order.TotalPrice`와 같이 대문자로 표시됩니다. ![\[에이전트 Workspace의 고객 프로필 탭, 연결 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-create-2.png) 1. 또한 *더하기* 아이콘을 선택하여 다른 속성을 추가할 수 있습니다. 최대 2개의 속성을 선택하여 연산자로 계산하고 결합할 수 있습니다. *더하기* 또는 *빼기*와 같은 연산자를 지정하여 속성 값을 조합하세요. ![\[에이전트 Workspace의 고객 프로필 탭, 연결 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-create-3.png) 1. 계산을 선택하면 선택적으로 이벤트 수, 기간 및 소스 타임스탬프를 구성할 수 있습니다. 기본적으로 계산된 속성은 수집 날짜를 기준으로 무제한 이벤트, 무제한 기간 및 타임스탬프를 사용하도록 구성됩니다. 지정된 시간 동안 적어도 하나의 이벤트가 발생하면 출력이 반환됩니다. + **이벤트 수:** 제한 구성 또는 무제한 사용(기본값) + **기간:** 특정 기간을 설정하거나 무제한 사용(기본값) + **소스 타임스탬프:** 특정 타임스탬프 필드 또는 수집 날짜(기본값) 중에서 선택합니다. **참고** 이벤트 제한은 없지만 가장 오래된 데이터가 최신 데이터로 대체되는 데이터 크기 제한이 있습니다. 소스 타임스탬프는 생성 후 변경할 수 없습니다. ![\[에이전트 Workspace의 고객 프로필 탭, 연결 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-create-4.png) 1. 선택적으로 관련 이벤트만 계산에 포함하도록 기준을 정의할 수 있습니다. 자세한 정보는 [이벤트 필터 설정](calculated-attributes-admin-website-event-filters.md)을 참조하세요. 1. **생성**을 선택하여 계산된 속성을 생성합니다. 1. 계산된 속성이 성공적으로 생성된 후, 테이블 보기에 배너가 표시되어 세그먼트나 흐름에서 해당 계산된 속성을 사용할 수 있습니다. 또한 준비 상태에 따라 계산된 속성의 상태를 볼 수 있습니다. ![\[계산된 속성이 생성된 배너입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-create-5.png) # 이벤트 필터 설정 이벤트 필터를 사용하면 계산된 속성에 사용할 프로필 객체를 필터링할 수 있습니다. 예를 들어, 이벤트 필터는 고객의 표준 자산 객체를 필터링하여 **상태가 설치됨 또는 등록됨**인 자산만 계산에 포함되도록 할 수 있습니다. **참고** 계산된 속성 정의를 생성한 후에는 이벤트 필터를 편집할 수 없습니다. 계산된 속성을 생성할 때 하나 이상의 이벤트 필터를 생성할 수 있습니다. 이벤트 필터는 다음 구성 요소로 이루어집니다. ![\[이벤트 필터 구성 요소입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-event-filters-1.png) + **필터 그룹**: 프로필 객체에 적용하는 필터 그룹입니다. OR 관계로 연결된 여러 필터 그룹을 추가할 수 있습니다. + **필터**: 속성, 연산자 및 값을 지정하여 계산된 속성의 계산에 포함된 프로필 객체를 필터링합니다. 사용 사례에 필요한 만큼 필터를 추가할 수 있습니다. + **속성**: 필터링할 객체의 속성입니다. Customer Profiles 도메인에 저장된 객체에서 속성을 선택하거나 객체 유형 정의에 정의된 필드 이름을 사용할 수 있습니다. 객체 유형 매핑에 대한 자세한 내용은 [Amazon Connect Customer Profiles의 객체 유형 매핑 정의 세부 정보](object-type-mapping-definition-details.md) 섹션을 참조하세요. **참고** Amazon Connect 관리자 웹 사이트에서 속성 드롭다운에는 프로필 객체가 속성으로 저장되거나 업데이트된 마지막 시간의 타임스탬프가 표시됩니다. 프로파일 객체의 속성과 이름이 같은 객체 유형의 필드가 모두 있는 경우 이벤트 필터는 필터링에서 객체 유형 필드 이름의 우선 순위를 지정합니다. 예를 들어 프로파일 객체에 **상태**라는 속성이 있고 **상태**라는 객체 유형 필드도 있는 경우 필터는 필터링에 객체 유형 필드 **상태**를 사용합니다. + **연산자** - 입력한 값에 대한 속성의 관계를 결정합니다. 자세한 내용은 [필터 연산자](#calculated-attributes-admin-website-event-filter-operators) 섹션을 참조하세요. + **값** - 객체를 필터링할 값입니다. OR 관계로 연결된 여러 값을 지정할 수 있습니다. 예를 들어 *자산의 상태는 설치됨 또는 등록됨*입니다. 값은 대/소문자를 구분합니다. 예를 들어 *자산의 상태가 설치됨*이면 *자산의 상태가 설치됨*과 다른 결과가 반환됩니다. 프로필 객체를 보려면 Amazon Connect Customer Profiles [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html) API를 사용합니다. 선택적으로 최대 2개의 이벤트 필터를 생성하고 둘 사이의 관계(AND/OR/EXCLUDE)를 생성할 수 있습니다. 관계에 대한 자세한 내용은 [이벤트 필터 간의 관계](#calculated-attributes-admin-website-relationship-between-event-filters) 섹션을 참조하세요. ## 필터 연산자 연산자는 입력한 값에 대한 속성의 관계를 결정합니다. 다음 테이블에서는 사용 가능한 연산자를 설명합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/calculated-attributes-admin-website-event-filters.html) **참고** Amazon Connect 관리자 웹 사이트에서 계산된 속성은 모든 시간 기반 필터에 UTC 시간대와 기본 시간인 00:00:00 UTC를 사용합니다. 날짜를 기준으로 필터링 할 수 있지만 시간은 동일한 값으로 기록됩니다. 2024-1-1 날짜를 입력하면 콘솔은 이 시간을 2024-01-01T00:00:00Z로 전달합니다. **참고** 기본적으로 이벤트 필터는 프로필 객체가 저장되거나 업데이트될 때 평가됩니다. 예를 들어 `PurchaseDate`가 지난 주 내에 있는 표준 자산 객체를 필터링하면 *자산 객체가 저장되거나 업데이트되는 시점으로부터 지난 주 내에 상대 시간*이 계산됩니다. 즉, 필터링 결과는 객체가 저장되거나 업데이트되는 시기에 따라 달라질 수 있습니다. ## 이벤트 필터 간의 관계 선택적으로 두 번째 이벤트 필터를 추가하고 첫 번째 이벤트 필터와의 관계를 정의할 수 있습니다. Amazon Connect 관리자 웹 사이트에서 계산된 속성을 생성할 때 계산된 속성당 최대 2개의 이벤트 필터를 가질 수 있습니다. 계산된 속성에 두 번째 이벤트 필터를 추가하는 경우 두 가지 방법 중 하나를 선택하여 두 이벤트 필터가 연결되는 방법을 지정할 수 있습니다. + **AND 관계** - AND 관계를 사용하여 두 이벤트 필터를 연결하는 경우 첫 번째 및 두 번째 이벤트 필터를 모두 충족하는 객체가 계산에 포함됩니다. + **OR 관계** - OR 관계를 사용하여 두 이벤트 필터를 연결하는 경우 첫 번째 또는 두 번째 이벤트 필터를 충족하는 객체가 계산에 포함됩니다. + **EXCLUDE 관계** - EXCLUDE 관계를 사용하여 두 개의 이벤트 필터를 연결하는 경우 첫 번째 이벤트 필터는 충족하지만 두 번째 이벤트 필터는 충족하지 않는 객체가 계산에 포함됩니다. ## 다음 단계 + [흐름 편집기를 통해 고객 센터에서 계산된 속성 사용](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-block.html#customer-profiles-block-properties-get-calculated-attributes) + [계산된 속성을 사용하여 고객 세그먼트 정의](https://docs.aws.amazon.com/connect/latest/adminguide/segmentation-admin-website) + [Amazon Connect에서 계산된 속성 보기](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-view.html) + [Amazon Connect에서 계산된 속성 편집](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-edit.html) + [Amazon Connect에서 계산된 속성 삭제](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-delete.html) # Amazon Connect에서 계산된 속성 보기 1. https://*instance name*.my.connect.aws/의 Amazon Connect 관리자 웹 사이트에 로그인합니다. 관리자 계정을 사용하거나, **Customer Profiles - 계산된 속성** 권한이 부여된 보안 프로파일에 할당된 계정을 사용합니다. 1. Amazon Connect의 왼쪽 탐색 창에서 **Customer Profiles**, **계산된 속성**을 선택합니다. 1. **계산된 속성** 페이지의 테이블의 **이름** 열에서 계산된 속성을 선택합니다. 다음 이미지는 **이름** 열에 나열된 계산된 속성의 예를 보여 줍니다. ![\[계산된 속성을 나열하는 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-view-1.png) 1. 이제 선택한 속성의 세부 정보를 볼 수 있습니다. 다음 이미지는 계산된 속성에 대한 세부 정보 페이지를 보여 줍니다. ![\[계산된 속성의 세부 보기입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-view-2.png) # Amazon Connect에서 계산된 속성 편집 1. 계산된 속성을 편집하려면 **편집** 버튼을 활성화하는 라디오 버튼을 선택하여 테이블 보기에서 속성을 선택합니다. **편집**을 선택합니다. ![\[계산된 속성 편집\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-1.png) 1. **설명**, **이벤트 수**, **기간**을 편집할 수 있습니다. 완료되면 **저장**을 선택합니다. ![\[계산된 속성을 편집합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-2.png) # Amazon Connect에서 계산된 속성 삭제 1. 계산된 속성을 삭제하려면 삭제하려는 속성 옆의 라디오 버튼을 선택하여 테이블에서 속성을 선택합니다. 1. 선택한 후 **삭제**를 선택합니다. 1. **속성 삭제** 팝업에서 세부 정보를 확인하고 *confirm*을 입력하여 **삭제** 버튼을 활성화합니다. ![\[계산된 속성을 삭제합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/calculated-attributes-admin-website-delete-1.png) 1. **삭제**를 선택합니다. # Amazon Connect Customer Profiles 계산된 속성 API 다음 Customer Profiles 계산된 속성 API를 사용할 수 있습니다. ------ #### [ CreateCalculatedAttributeDefinition ] **CreateCalculatedAttributeDefinition** 새 계산된 속성을 생성합니다. 도메인에 기존 객체 유형이 있어야 합니다. 단일 소스 객체에서 가져오려는 속성과 해당 속성에 집계 방식으로 적용할 수학 연산, 시간 범위 및 객체 수를 정의할 수 있습니다. 생성 후에는 Customer Profiles에 수집된 새 객체 데이터가 `GetCalculatedAttributeForProfile` API를 사용하여 프로필에 대해 검색할 수 있는 계산된 속성에 포함됩니다. 기록 데이터도 사용하려면 `UseHistoricalData`를 true로 지정합니다. API 응답의 `Readiness` 및 `Status` 필드는 계산된 속성에 기록 데이터를 포함하는 상태에 대한 정보를 제공합니다. 계산된 속성을 정의하면 도메인 내의 모든 프로필에 사용할 수 있습니다. 계산된 각 속성은 하나의 ObjectType과 해당 ObjectType의 필드 최대 두 개만 참조할 수 있습니다. **요청** ``` POST /domains/DomainName/calculated-attributes/CalculatedAttributeName ``` ``` { "CalculatedAttributeName": "string", "DisplayName": "string", "Description": "string", "AttributeDetails": { "Attributes": [ { "Name": "string" } ... ], "Expression": "string", }, "Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE", "Conditions": { "Range": { "Value": "number", "Units": "string" }, "ObjectCount": "number", "Threshold": { "Value": "string", "Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO" } }, "Tags": {} } ``` **응답** ``` { "CalculatedAttributeName": "string", "DisplayName": "string", "Description": "string", "AttributeDetails": { "Attributes": [ { "Name": "string" } ... ], "Expression": "string", }, "Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE" "Conditions": { "Range": { "Value": "number", "Units": "string" }, "ObjectCount": "number", "Threshold": { "Value": "string", "Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO" } }, "CreatedAt": number, "LastUpdatedAt": number, "Tags": {} } ``` **요청 본문** + **CalculatedAttributeName** 계산된 속성의 고유한 (도메인별) 이름입니다. + 유형: 문자열 + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z0-9_-]+$` + 필수 여부: 예 + **DisplayName** 계산된 속성의 표시 이름입니다. + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z_][a-zA-Z_0-9-\s]*$` + 필수 항목 여부: 아니요 + **설명** 계산된 속성에 대한 설명입니다. + 유형: 문자열 + 길이 제약: 최소 길이 1. 최대 길이는 1,000. + 필수 여부: 아니요 + **UseHistoricalData** 계산된 속성이 생성되기 전에 수집된 기록 데이터를 계산에 포함해야 하는지 여부입니다. + 유형: Boolean + 필수 여부: 아니요 + **AttributeDetails** 정의에 사용된 속성 및 속성 간에 사용된 수학 연산에 대한 세부 정보입니다. 다음 구성 요소를 참조하세요. + **속성** 수학 표현식에 지정된 속성 항목 목록입니다. + **AttributeItem** 수학 표현식에 지정된 단일 속성 항목의 세부 정보입니다. + 이름 + 프로필 객체 유형에 정의된 속성의 이름입니다. + 유형: 문자열 + **표현식** 속성 목록에 제공된 속성 항목에 대해 수행되는 수학 표현식입니다. 표현식의 각 요소는 \$1"\$1ObjectTypeName.AttributeName\$1\$1"의 구조를 따라야 합니다. + 예 : `{ObjA.AttributeA} - {ObjA.AttributeB}` + 유형: 문자열 + 다음과 같은 수학 연산만 지원됩니다. `+ - * /` + 계산된 속성 정의를 작성한 후에는 표현식을 수정할 수 없습니다. + **조건** 계산된 속성 집계 기준 및 임계값을 정의합니다. + 유형: 조건 객체 + Range + ObjectCount + Threshold + **Range** 데이터가 집계에 포함되는 상대적 기간입니다. + 유형: 범위 객체 + 값: 지정된 단위의 시간 길이. `ValueRange`에서 값을 재정의합니다. + 유형: 정수 + 필수 항목 여부: 아니요 + ValueRange: 고객이 계산된 속성에 포함되는 데이터의 상대 기간을 지정할 수 있는 구조입니다. 양수는 엔드포인트가 과거임을 나타내고 음수는 미래임을 나타냅니다. ValueRange는 값을 재정의합니다. + 유형: ValueRange + 필수 여부: 아니요 + 시작 + 객체를 포함할 시간의 시작 시간입니다. 양수는 시작 포인트가 과거임을 나타내고 음수는 미래임을 나타냅니다. + 유형: 정수 + 필수 항목 여부: 예 + 종료 + 객체를 포함할 시기의 종료 시간입니다. 양수는 시작 포인트가 과거임을 나타내고 음수는 미래임을 나타냅니다. + 유형: 정수 + 필수 항목 여부: 예 + TimestampSource: 날짜를 구문 분석해야 하는 JSON 객체의 필드를 지정하는 표현식입니다. 표현식은 "\$1ObjectTypeName.\$1\$1"의 타임스탬프 필드 위치입니다. 예를 들어 객체 유형이 MyType이고 소스 JSON이 `{"generatedAt": {"timestamp": "1737587945945"}}`인 경우 TimestampSource는 `"{MyType.generatedAt.timestamp}"`이어야 합니다. + 길이 제약: 최소 길이 1. 최대 길이는 255. + 필수 여부: 아니요 + TimestampFormat: JSON 객체의 타임스탬프 필드가 지정된 형식입니다. 이 값은 EPOCHMILLI(초/밀리초 수준 정밀도가 있는 Unix 에포크 타임스탬프의 경우) 또는 ISO\$18601(초/밀리초 수준 정밀도가 있는 ISO\$18601 형식, 선택적 오프셋 Z 또는 HH:MM 또는 HHMM 형식) 중 하나여야 합니다. 예를 들어 객체 유형이 MyType이고 소스 JSON이 `{"generatedAt": {"timestamp": "2001-07-04T12:08:56.235-0700"}},`인 경우 TimestampFormat은 `"ISO_8601"`이어야 합니다. + 단위: 시간 단위 + 유효한 값: 일 + 필수 항목 여부: 예 + 필수 항목 여부: 예 + 초기 범위: 최대 366일 + **ObjectCount** 계산된 속성에 사용되는 프로필 객체의 수입니다. + 형식: 숫자 + 범위: 1에서 100까지 + 필수 여부: 아니요 + **Threshold** 참/거짓으로 계산된 속성을 생성하기 위한 비교 로직입니다. + 유형: 임계값 객체 + 값 + 임계값의 값 + 유형: 문자열 + 필수 항목 여부: 아니요 + 연산자 + 임계값의 연산자 + 유형: ENUM + 유효한 값: + GREATER\$1THAN + LESS\$1THAN + EQUAL\$1TO + NOT\$1EQUAL\$1TO + 필수 여부: 아니요 + **통계** 계산된 속성에 대해 수행할 집계 작업입니다. + 유형: ENUM + 유효한 값: + FIRST\$1OCCURRENCE + LAST\$1OCCURRENCE + COUNT + SUM + MINIMUM + MAXIMUM + AVERAGE + MAX\$1OCCURRENCE ------ #### [ UpdateCalculatedAttributeDefinition ] **UpdateCalculatedAttributeDefinition** 계산된 속성 정의를 업데이트합니다. 업데이트는 표시 이름, 설명, 시간 범위, 객체 수 및 임계값으로 제한됩니다. 이 API는 부분 업데이트를 지원하므로 업데이트가 필요한 파라미터만 포함하면 됩니다. **참고** 조건을 업데이트할 때: 계산된 속성의 날짜 범위를 늘려도 현재 날짜 범위보다 오래된 과거 데이터가 포함되지는 않습니다. 계산된 속성 정의가 생성된 후에는 TimestampSource 및 TimestampFormat을 업데이트할 수 없습니다. **요청** ``` PUT /domains/DomainName/calculated-attributes/CalculatedAttributeName ``` ``` { "DisplayName": "string", "Description": "string", "Conditions": { "Range": { "Value": "number", "Units": "string" }, "ObjectCount": "number", "Threshold": { "Value": "string", "Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO" } } } ``` **응답** ``` { "CalculatedAttributeName": "string", "DisplayName": "string", "Description": "string", "AttributeDetails": { "Attributes": [ { "Name": "string" } ... ], "Expression": "string", }, "Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE" "Conditions": { "Range": { "Value": "number", "Units": "string" }, "ObjectCount": "number", "Threshold": { "Value": "string", "Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO" } }, "CreatedAt": number, "LastUpdatedAt": number, "Tags": {} } ``` **요청 본문** + **DisplayName** 계산된 속성의 표시 이름입니다. + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z_][a-zA-Z_0-9-\s]*$` + 필수 항목 여부: 아니요 + **설명** 계산된 속성에 대한 설명입니다. + 유형: 문자열 + 길이 제약: 최소 길이 1. 최대 길이는 1,000. + 필수 여부: 아니요 + **조건** 계산된 속성 집계 기준 및 임계값을 정의합니다. + 유형: 조건 객체 + Range + ObjectCount + Threshold + **Range** 데이터가 집계에 포함되는 상대적 기간입니다. + 유형: 범위 객체 + 값: 지정된 단위의 시간 길이 + 유형: 정수 + 필수 항목 여부: 아니요 + ValueRange: 고객이 계산된 속성에 포함되는 데이터의 상대 기간을 지정할 수 있는 구조입니다. 양수는 엔드포인트가 과거임을 나타내고 음수는 미래임을 나타냅니다. ValueRange는 값을 재정의합니다. + 유형: ValueRange + 필수 여부: 아니요 + 시작 + 객체를 포함할 시간의 시작 시간입니다. 양수는 시작 포인트가 과거임을 나타내고 음수는 미래임을 나타냅니다. + 유형: 정수 + 필수 항목 여부: 예 + 종료 + 객체를 포함할 시기의 종료 시간입니다. 양수는 시작 포인트가 과거임을 나타내고 음수는 미래임을 나타냅니다. + 유형: 정수 + 필수 항목 여부: 예 + 단위: 시간 단위 + 유효한 값: 일 + 필수 항목 여부: 예 + 필수 항목 여부: 예 + 초기 범위: 최대 366일 + **ObjectCount** 계산된 속성에 사용되는 프로필 객체의 수입니다. + 형식: 숫자 + 범위: 1에서 100까지 + 필수 여부: 아니요 + **Threshold** 참/거짓으로 계산된 속성을 생성하기 위한 비교 로직입니다. + 유형: 임계값 객체 + 값 + 임계값의 값 + 유형: 문자열 + 필수 항목 여부: 아니요 + 연산자 + 임계값의 연산자 + 유형: ENUM + 유효한 값: + GREATER\$1THAN + LESS\$1THAN + EQUAL\$1TO + NOT\$1EQUAL\$1TO + 필수 여부: 아니요 ------ #### [ GetCalculatedAttributeDefinition ] **GetCalculatedAttributeDefinition** 계산된 속성 정의를 가져옵니다. **요청** ``` GET /domains/DomainName/calculated-attributes/CalculatedAttributeName ``` **요청 본문** ``` The request does not have a request body. ``` **응답** ``` { "CalculatedAttributeName": "string", "DisplayName": "string", "Description": "string", "AttributeDetails": { "Attributes": [ { "Name": "string" } ... ], "Expression": "string", }, "Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE" "Conditions": { "Range": { "Unit": "string", "Value": number "ValueRange" { "Start": number "End": number }, "TimestampFormat": "string", "TimestampSource": "string" }, "ObjectCount": "number", "Threshold": { "Value": "string", "Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO" } }, "UseHistoricalData" boolean, "Status": "PREPARING" | "IN_PROGRESS" | "COMPLETED" | "FAILED", "Readiness": { "ProgressPercentage": number, "Message": "string", }, "CreatedAt": number, "LastUpdatedAt": number, "Tags": {} } ``` **URI 요청 파라미터** + **DomainName** 도메인의 고유 이름입니다. + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z0-9_-]+$` + 필수 여부: 예 + **CalculatedAttributeName** 계산된 속성의 고유한 (도메인별) 이름입니다. + 유형: 문자열 + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z0-9_-]+$` + 필수 여부: 예 ------ #### [ DeleteCalculatedAttributeDefinition ] **DeleteCalculatedAttributeDefinition** 기존의 계산된 속성 정의를 삭제합니다. 기본 계산된 속성은 삭제할 수 있지만 일단 삭제한 후에는 해당 작업을 취소할 수 없으며 다시 사용하려면 `CreateCalculatedAttributeDefinition` API를 사용하여 직접 다시 생성해야 합니다. **요청** ``` DELETE /domains/DomainName/calculated-attributes/CalculatedAttributeName ``` **요청 본문** ``` The request does not have a request body. ``` **응답** ``` The response does not have a response body. ``` **URI 요청 파라미터** + **DomainName** 도메인의 고유 이름입니다. + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z0-9_-]+$` + 필수 여부: 예 + **CalculatedAttributeName** 계산된 속성의 고유한 (도메인별) 이름입니다. + 유형: 문자열 + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z0-9_-]+$` + 필수 여부: 예 ------ #### [ ListCalculatedAttributeDefinitions ] **ListCalculatedAttributeDefinitions** 도메인의 모든 계산된 속성 정의를 검색합니다. **요청** ``` GET /domains/DomainName/calculated-attributes?max-results=MaxResults&next-token=NextToken ``` **요청 본문** ``` The request does not have a request body. ``` **응답** ``` { "Items": [ { "UseHistoricalData": boolean, "ReadinessStatus": PREPARING | IN_PROGRESS | COMPLETED | FAILED, "CalculatedAttributeName": "string", "CreatedAt": number, "Description": "string", "DisplayName": "string", "LastUpdatedAt": number, "Tags": { "string" : "string" } } ], "NextToken": "string" } ``` **URI 요청 파라미터** + **DomainName** 도메인의 고유 이름입니다. + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z0-9_-]+$` + 필수 여부: 예 + **MaxResults** 페이지당 반환되는 최대 객체 수입니다. + 유효 범위: 최소값 1. 최대값은 100입니다. + **NextToken** 이전 ListCalculatedAttributeDefinition API 호출의 페이지 매김 토큰입니다. + 길이 제약: 최소 길이 1. 최대 길이는 1,024입니다. ------ #### [ GetCalculatedAttributeForProfile ] **GetCalculatedAttributeForProfile** 계산을 시작하고 단일 프로필에 대해 계산된 단일 속성의 결과를 검색합니다. **요청** ``` GET /domains/DomainName/profile/ProfileId/calculated-attributes/CalculatedAttributeName ``` **요청 본문** ``` The request does not have a request body. ``` **응답** ``` { "Name": "string", "DisplayName": "string", "Value": "string", "IsDataPartial": "string", "LastObjectTimestamp" : number } ``` **URI 요청 파라미터** + **DomainName** 도메인의 고유 이름입니다. + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z0-9_-]+$` + 필수 여부: 예 + **CalculatedAttributeName** 계산된 속성의 고유한 (도메인별) 이름입니다. + 유형: 문자열 + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z0-9_-]+$` + 필수 여부: 예 ------ #### [ ListCalculatedAttributesForProfile ] **ListCalculatedAttributesForProfile** 계산을 시작하고 단일 프로필에 대해 계산된 모든 속성의 결과를 검색합니다. **요청** ``` GET /domains/DomainName/profile/ProfileId/calculated-attributes?max-results=MaxResults&next-token=NextToken ``` **요청 본문** ``` The request does not have a request body. ``` **응답** ``` { "Items": [ { "CalculatedAttributeName": "string", "DisplayName": "string", "Value": "string", "IsDataPartial" : "string", "LastObjectTimestamp" : number }, ... ], "NextToken": "string" } ``` **URI 요청 파라미터** + **DomainName** 도메인의 고유 이름입니다. + 길이 제한: 최소 길이는 1. 최대 길이는 64. + 패턴: `^[a-zA-Z0-9_-]+$` + 필수 여부: 예 + **ProfileId** + 패턴: `[a-f0-9]{32}` + 필수 여부: 예 + **MaxResults** 페이지당 반환되는 최대 객체 수입니다. + 유효 범위: 최소값 1. 최대값은 100입니다. + **NextToken** 이전 ListCalculatedAttributeDefinition API 호출의 페이지 매김 토큰입니다. + 길이 제약: 최소 길이 1. 최대 길이는 1,024입니다. ------ # 사용자 지정 Amazon Connect Customer Profiles 계산된 속성 정의 생성 Customer Profiles [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html) API를 사용하면 사용자 지정 객체 유형에 따라 프로그래밍 방식으로 고유한 계산된 속성을 만들 수 있습니다. 이 주제에서는 사용자 지정 JSON 파일을 사용하여 계산된 속성을 생성하는 방법을 보여 줍니다. ## 1단계: JSON 파일 생성 다음 내용의 JSON 파일을 생성합니다. ``` { "DomainName": "your-domain-name", "CalculatedAttributeName": "your-calculated-attribute-name", "UseHistoricalData": true, "DisplayName": "your-display-name", "Description": "your-description", "AttributeDetails": { "Attributes": [ { "Name": "your-attribute-name" } ], "Expression": "{your-object-type.your-attribute-name}" }, "Statistic": "your-statistic", "Conditions": { "Range": { "ValueRange" { "Start": your-range-start "End": your-range-end }, "TimestampSource": "{your-object-type.your-timestamp-source}", "Unit": "days" }, "ObjectCount": your-object-count, "Threshold": { "Value": "your-threshold-value", "Operator": "your-threshold-operator" } } } ``` 고유한 값으로 JSON을 사용자 지정하려면 다음 지침을 따르세요. + **속성**: 여기에는 계산된 속성에 사용할 객체 유형의 필드 이름이 포함되어야 합니다. 이 목록에서 참조되는 두 가지 속성이 지원됩니다. + **표현식**: 속성 간에 수행할 수 있는 기본 수학 표현식이 지원됩니다. 속성이 하나뿐인 경우에는 이 필드가 `{ObjectTypeName.AttributeName}`이어야 하고, 그렇지 않으며 수학 표현식을 염두에 두고 있는 경우 이 필드에 두 속성이 모두 포함되어야 합니다. + **통계**: 실제로 집계 작업을 수행하는 계산 API 중 하나를 호출할 때 수행되는 작업입니다. 대부분은 설명이 필요 없지만, 그렇지 않은 항목에 대한 설명을 추가했습니다. **지원되는 통계** + `FIRST_OCCURRENCE`는 가장 먼저 수집된 객체의 표현식에 지정된 속성을 반환합니다. + `LAST_OCCURRENCE`는 가장 최근에 수집된 객체의 표현식에 지정된 속성을 반환합니다. + `COUNT`는 선택한 데이터의 개수를 반환합니다. + `SUM`은 선택한 데이터의 합계를 반환합니다. + `MINIMUM`은 선택한 데이터의 최소값을 반환합니다. + `MAXIMUM`은 선택한 데이터의 최대값을 반환합니다. + `AVERAGE`는 선택한 데이터의 평균을 반환합니다. + `MAX_OCCURRENCE`는 표현식에 지정된 것 중 가장 자주 발생하는 값을 반환합니다. + **범위**: + 단위: 현재 DAYS 단위만 지원합니다. + ValueRange: ValueRange의 시작 또는 종료 필드에 양수를 지정하여 시작할 일수를 나타내고 음수는 향후 시작할 일수를 나타냅니다. + TimestampSource: 날짜를 구문 분석해야 하는 JSON 객체의 필드를 지정하는 표현식입니다. 표현식은 "\$1ObjectTypeName.\$1\$1"의 타임스탬프 필드 위치입니다. 예를 들어 객체 유형이 MyType이고 소스 JSON이 `{"generatedAt": {"timestamp": "1737587945945"}}`인 경우 TimestampSource는 `"{MyType.generatedAt.timestamp}"`이어야 합니다. + **ObjectCount**: 계산된 속성 계산이 몇 개의 객체를 기반으로 해야 하는지 나타냅니다. + **임계값**: 정확히 계산된 속성 값 대신, 예를 들어 어떤 값이 특정 값보다 큰지 확인하려는 경우 임계값을 사용할 수 있습니다. 임계값은 임의의 문자열일 수 있으며 다음과 같은 임계값 연산자가 지원됩니다. + `GREATER_THAN` + `LESS_THAN` + `EQUAL_TO` + `NOT_EQUAL_TO` + UseHistoricalData: 계산된 속성이 생성되기 전에 수집된 기록 데이터를 계산에 포함해야 하는지 여부입니다. ## 2단계: CreateCalculatedAttributeDefinition API 호출 값을 사용하여 JSON 파일을 만들고 사용자 지정한 후에는 다음 예와 같이 [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html) API를 호출합니다. ``` aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name ``` 다음 엔드포인트를 사용할 수도 있습니다. ``` https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes ``` # API를 사용하여 Amazon Connect Customer Profiles에서 계산된 속성 값 검증 `GetCalculatedAttributeForProfile` 및 `ListCalculatedAttributesForProfile`의 프로필 수준 API 두 개가 있습니다. + **GetCalculatedAttributeForProfile** - 단일 프로필에 대해 계산된 단일 속성을 검색합니다. + **ListCalculatedAttributesForProfile** - 단일 프로필에 대해 계산된 속성 목록을 검색합니다. 유효한 프로필 ID가 있으면 계산된 속성의 값을 볼 수 있습니다. **응답의 예** ``` { "CalculatedAttributeName": "_average_hold_time", "DisplayName": "Average hold time", "IsDataPartial": "true", "Value": "24144" } ``` **isDataPartial** - 이 플래그는 시간 범위(30일) 또는 객체 수에 도달하지 않아 계산된 속성이 아직 계산 중임을 의미합니다. 예를 들어 30일간의 평균이 필요할 경우 30일이 경과한 후에만 `IsDataPartial` 필드가 false로 설정됩니다. ## 계산된 속성의 목록 검색 ** AWS CLI 사용** ``` aws customer-profiles list-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --profile-id your-profile-id ``` **사용자 지정 JSON 파일과 함께 AWS CLI 사용** 다음 내용의 JSON 파일을 생성합니다. ``` { "DomainName": "your-domain-name", "ProfileId" "some-profile-id" } ``` ``` aws customer-profiles list-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json ``` **엔드포인트:** ``` https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/ ``` ## 계산된 단일 속성 검색 ** AWS CLI를 사용합니다**. ``` aws customer-profiles get-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --calculated-attribute-name your-calculated-attribute-name --profile-id your-profile-id ``` ** AWS CLI를 사용자 지정 JSON 파일과 함께 사용합니다**. 다음 내용의 JSON 파일을 생성합니다. ``` { "DomainName": "your-domain-name", "CalculatedAttributeName": "your-calculated-attribute-name", "ProfileId" "your-profile-id" } ``` ``` aws customer-profiles get-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json ``` **엔드포인트:** ``` https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/your-calculated-attribute-name ``` # Amazon Connect Customer Profiles의 기본 계산된 속성 ## 기본 계산된 속성 Amazon Connect Customer Profiles는 고객 응대 레코드를 기반으로 out-of-the 제공합니다. 속성은 다음과 같습니다. **가장 빈번한 채널** ``` { "CalculatedAttributeName": "_most_frequent_channel", "DisplayName": "Most frequent channel", "Description": "Returns customer's frequently used communication channel. Channels include voice, chat, task.", "CreatedAt": null, "LastUpdatedAt": null, "Statistic": "MAX_OCCURRENCE", "Conditions": { "Range": { "Value": 30, "Unit": "DAYS" }, "ObjectCount": null }, "AttributeDetails": { "Attributes": [ { "Name": "channel" } ], "Expression": "{CTR.channel}" }, "Tags": { } } ``` **마지막 채널** ``` { "CalculatedAttributeName": "_last_channel", "DisplayName": "Last channel", "Description": "Returns customer's last communication channel. Channels include voice, chat, task.", "CreatedAt": null, "LastUpdatedAt": null, "Statistic": "LAST_OCCURRENCE", "Conditions": { "ObjectCount": null }, "AttributeDetails": { "Attributes": [ { "Name": "channel" } ], "Expression": "{CTR.channel}" }, "Tags": { } } ``` **마지막 에이전트 식별자** ``` { "CalculatedAttributeName": "_last_agent_id", "DisplayName": "Last agent identifier", "Description": "Returns identifier of the last agent customer connected with.", "CreatedAt": null, "LastUpdatedAt": null, "Statistic": "LAST_OCCURRENCE", "Conditions": { "ObjectCount": null }, "AttributeDetails": { "Attributes": [ { "Name": "agent.id" } ], "Expression": "{CTR.agent.id}" }, "Tags": { } } ``` **자주 전화하는 사람** ``` { "CalculatedAttributeName": "_frequent_caller", "DisplayName": "Frequent caller", "Description": "Returns true or false based on the number of times a customer has called.", "CreatedAt": null, "LastUpdatedAt": null, "Statistic": "COUNT", "Conditions": { "Range": { "Value": 30, "Unit": "DAYS" }, "ObjectCount": null, "Threshold": { "Value": "5", "Operator": "GREATER_THAN" } }, "AttributeDetails": { "Attributes": [ { "Name": "contactId" } ], "Expression": "{CTR.contactId}" }, "Tags": { } } ``` **평균 대기 시간** ``` { "CalculatedAttributeName": "_average_hold_time", "DisplayName": "Average hold time", "Description": "Returns customer's average hold time for voice calls.", "CreatedAt": null, "LastUpdatedAt": null, "Statistic": "AVERAGE", "Conditions": { "Range": { "Value": 30, "Unit": "DAYS" }, "ObjectCount": null }, "AttributeDetails": { "Attributes": [ { "Name": "agent.customerHoldDurationMillis" }, { "Name": "queue.durationMillis" } ], "Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}" }, "Tags": { } } ``` **평균 통화 시간** ``` { "CalculatedAttributeName": "_average_call_duration", "DisplayName": "Average call duration", "Description": "Returns customer's average call duration for voice calls.", "CreatedAt": null, "LastUpdatedAt": null, "Statistic": "AVERAGE", "Conditions": { "Range": { "Value": 30, "Unit": "DAYS" }, "ObjectCount": null }, "AttributeDetails": { "Attributes": [ { "Name": "disconnectTimestamp" }, { "Name": "initiationTimestamp" } ], "Expression": "{CTR.disconnectTimestamp} - {CTR.initiationTimestamp}" }, "Tags": { } } ``` **고객의 최대 대기 시간** ``` { "CalculatedAttributeName": "_maximum_hold_time", "DisplayName": "Customer's maximum hold time", "Description": "Returns customer's maximum hold time for voice calls in the past month.", "AttributeDetails": { "Attributes": [ { "Name": "agent.customerHoldDurationMillis" }, { "Name": "queue.durationMillis" } ], "Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}" }, "Statistic": "MAXIMUM", "Conditions": { "Range": { "Value": 30, "Unit": "DAYS" }, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` ## 기본 프로필 계산된 속성 Amazon Connect Customer Profiles는 프로필을 기반으로 out-of-the 기본 속성을 제공합니다. 속성은 다음과 같습니다. **새로운 고객** ``` { "CalculatedAttributeName": "_new_customer", "DisplayName": "New customer", "Description": "Returns true or false for new customer profiles created.", "CreatedAt": null, "LastUpdatedAt": null, "Statistic": "TIME_DIFFERENCE_FROM_NOW", "Conditions": { "ObjectCount": null, "Threshold": { "Value": "30", "Operator": "LESS_THAN" } }, "AttributeDetails": { "Attributes": [ { "Name": "createdAt" } ], "Expression": "{_profile.createdAt}" }, "Tags": { } } ``` ## 기본 자산 계산된 속성 Amazon Connect Customer Profiles는 자산을 기반으로 out-of-the 제공합니다. 속성은 다음과 같습니다. **자산 수** ``` { "CalculatedAttributeName": "_assets_count", "DisplayName": "Count of assets", "Description": "Returns the count of assets for a customer.", "AttributeDetails": { "Attributes": [ { "Name": "AssetId" } ], "Expression": "{_asset.AssetId}" }, "Statistic": "COUNT", "Conditions": { "Range": null, "ObjectCount": null, "Threshold":null }, "Launched": false } ``` **첫 번째 자산 구매 날짜** ``` { "CalculatedAttributeName": "_asset_first_occurrence", "DisplayName": "First asset purchased date", "Description": "Returns purchase date of the customer's first asset.", "AttributeDetails": { "Attributes": [ { "Name": "PurchaseDate" } ], "Expression": "{_asset.PurchaseDate}" }, "Statistic": "FIRST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` **마지막 자산 구매 날짜** ``` { "CalculatedAttributeName": "_asset_last_occurrence", "DisplayName": "Last asset purchased date", "Description": "Returns purchase date of the customer's last asset.", "AttributeDetails": { "Attributes": [ { "Name": "PurchaseDate" } ], "Expression": "{_asset.PurchaseDate}" }, "Statistic": "LAST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` **총 자산 가격** ``` { "CalculatedAttributeName": "_assets_price_sum", "DisplayName": "Total asset price", "Description": "Returns customer's total asset price.", "AttributeDetails": { "Attributes": [ { "Name": "Price" } ], "Expression": "{_asset.Price}" }, "Statistic": "SUM", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` **평균 자산 가격** ``` { "CalculatedAttributeName": "_assets_price_average", "DisplayName": "Average asset price", "Description": "Returns customer's average asset price.", "AttributeDetails": { "Attributes": [ { "Name": "Price" } ], "Expression": "{_asset.Price}" }, "Statistic": "AVERAGE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` **첫 번째 자산 이름** ``` { "CalculatedAttributeName": "_assets_name_first_occurrence", "DisplayName": "First asset name", "Description": "Returns name of the customer's first asset", "AttributeDetails": { "Attributes": [ { "Name": "AssetName" } ], "Expression": "{_asset.AssetName}" }, "Statistic": "FIRST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` **마지막 자산 이름** ``` { "CalculatedAttributeName": "_assets_name_last_occurrence", "DisplayName": "Last asset name", "Description": "Returns name of the customer's last asset.", "AttributeDetails": { "Attributes": [ { "Name": "AssetName" } ], "Expression": "{_asset.AssetName}" }, "Statistic": "LAST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` ## 기본 사례 계산된 속성 Amazon Connect Customer Profiles는 사례에 따라 out-of-the 가능한 기본 속성을 제공합니다. 속성은 다음과 같습니다. **사례 수** ``` { "CalculatedAttributeName": "_cases_count", "DisplayName": "Count of cases", "Description": "Returns the count of customer's cases for a customer.", "AttributeDetails": { "Attributes": [ { "Name": "CaseId" } ], "Expression": "{_case.CaseId}" }, "Statistic": "COUNT", "Conditions": { "Range": null, "ObjectCount": null, "Threshold":null }, "Launched": false } ``` **첫 번째 사례 생성 날짜** ``` { "CalculatedAttributeName": "_case_first_occurrence", "DisplayName": "First case created date", "Description": "Returns created date of the customer's first case.", "AttributeDetails": { "Attributes": [ { "Name": "CreatedDate" } ], "Expression": "{_case.CreatedDate}" }, "Statistic": "FIRST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` **마지막 사례 생성 날짜** ``` { "CalculatedAttributeName": "_case_last_occurrence", "DisplayName": "Last case created date", "Description": "Returns created date of the customer's last case.", "AttributeDetails": { "Attributes": [ { "Name": "CreatedDate" } ], "Expression": "{_case.CreatedDate}" }, "Statistic": "LAST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` **미해결 사례 수** ``` { "CalculatedAttributeName": "_cases_open_status_count", "DisplayName": "Count of open cases", "Description": "Returns the count of customer's open cases.", "AttributeDetails": { "Attributes": [ { "Name": "CaseId" } ], "Expression": "{_case.CaseId}" }, "Statistic": "COUNT", "Conditions": { "Range": null, "ObjectCount": null, "Threshold":null }, "Filter": { "Include": "ALL", "Groups": [ { "Type": "ALL", "Dimensions": [ { "Attributes": { "Status": { "DimensionType": "INCLUSIVE", "Values": ["Open"] } } } ] } ] }, "Launched": false } ``` **종료된 사례 수** ``` { "CalculatedAttributeName": "_cases_closed_status_count", "DisplayName": "Count of closed cases", "Description": "Returns the count of customer's closed cases.", "AttributeDetails": { "Attributes": [ { "Name": "CaseId" } ], "Expression": "{_case.CaseId}" }, "Statistic": "COUNT", "Conditions": { "Range": null, "ObjectCount": null, "Threshold":null }, "Filter": { "Include": "ALL", "Groups": [ { "Type": "ALL", "Dimensions": [ { "Attributes": { "Status": { "DimensionType": "INCLUSIVE", "Values": ["Closed"] } } } ] } ] }, "Launched": false } ``` ## 기본 커뮤니케이션 레코드 계산된 속성 Amazon Connect Customer Profiles는 통신 레코드를 기반으로 기본 속성을 out-of-the. 속성은 다음과 같습니다. **마지막 이메일 열기 날짜** ``` { "CalculatedAttributeName": "_campaign_email_last_open", "DisplayName": "Last email open date", "Description": "Returns the last email open date of the customer.", "AttributeDetails": { "Attributes": [ { "Name": "Events.Open.UpdatedDate" } ], "Expression": "{_communicationRecord.Events.Open.UpdatedDate}" }, "Statistic": "LAST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Filter": { "Include": "ALL", "Groups": [ { "Type": "ALL", "Dimensions": [ { "Attributes": { "Attributes.ChannelSubType": { "DimensionType": "INCLUSIVE", "Values": ["connect:Email"] }, "Events.Open.EventType": { "DimensionType": "INCLUSIVE", "Values": ["Open"] } } } ] } ] }, "Launched": false } ``` **이메일 열기 수** ``` { "CalculatedAttributeName": "_campaign_email_open_count", "DisplayName": "Email open count", "Description": "Returns the number of times emails were opened by a customer.", "AttributeDetails": { "Attributes": [ { "Name": "CommunicationRecordId" } ], "Expression": "{_communicationRecord.CommunicationRecordId}" }, "Statistic": "COUNT", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Filter": { "Include": "ALL", "Groups": [ { "Type": "ALL", "Dimensions": [ { "Attributes": { "Attributes.ChannelSubType": { "DimensionType": "INCLUSIVE", "Values": ["connect:Email"] }, "Events.Open.EventType": { "DimensionType": "INCLUSIVE", "Values": ["Open"] } } } ] } ] }, "Launched": false } ``` **이메일 전송 횟수** ``` { "CalculatedAttributeName": "_campaign_email_delivery_count", "DisplayName": "Email delivery count", "Description": "Returns the number of times emails were delivered to a customer.", "AttributeDetails": { "Attributes": [ { "Name": "CommunicationRecordId" } ], "Expression": "{_communicationRecord.CommunicationRecordId}" }, "Statistic": "COUNT", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Filter": { "Include": "ALL", "Groups": [ { "Type": "ALL", "Dimensions": [ { "Attributes": { "Attributes.ChannelSubType": { "DimensionType": "INCLUSIVE", "Values": ["connect:Email"] }, "Events.Delivery.EventType": { "DimensionType": "INCLUSIVE", "Values": ["Delivery"] } } } ] } ] }, "Launched": false } ``` **SMS 전송 횟수** ``` { "CalculatedAttributeName": "_campaign_sms_delivery_count", "DisplayName": "SMS delivered count", "Description": "Returns the number of times SMS were delivered to a customer.", "AttributeDetails": { "Attributes": [ { "Name": "CommunicationRecordId" } ], "Expression": "{_communicationRecord.CommunicationRecordId}" }, "Statistic": "COUNT", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Filter": { "Include": "ALL", "Groups": [ { "Type": "ALL", "Dimensions": [ { "Attributes": { "Attributes.ChannelSubType": { "DimensionType": "INCLUSIVE", "Values": ["connect:SMS"] }, "Events.TEXT_DELIVERED.EventType": { "DimensionType": "INCLUSIVE", "Values": ["TEXT_DELIVERED"] } } } ] } ] }, "Launched": false } ``` **마지막 SMS 차단 날짜** ``` { "CalculatedAttributeName": "_campaign_sms_last_stop", "DisplayName": "Last SMS blocked date", "Description": "Returns the last SMS blocked date of the customer.", "AttributeDetails": { "Attributes": [ { "Name": "Events.TEXT_BLOCKED.UpdatedDate" } ], "Expression": "{_communicationRecord.Events.TEXT_BLOCKED.UpdatedDate}" }, "Statistic": "LAST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Filter": { "Include": "ANY", "Groups": [ { "Type": "ALL", "Dimensions": [ { "Attributes": { "Attributes.ChannelSubType": { "DimensionType": "INCLUSIVE", "Values": ["connect:SMS"] }, "Events.TEXT_BLOCKED.EventType": { "DimensionType": "INCLUSIVE", "Values": ["TEXT_BLOCKED"] } } } ] } ] }, "Launched": false } ``` **마지막 SMS 이동통신사 차단 날짜** ``` { "CalculatedAttributeName": "_campaign_sms_last_stop_carrier", "DisplayName": "Last SMS carrier blocked date", "Description": "Returns the last SMS carrier blocked date of the customer.", "AttributeDetails": { "Attributes": [ { "Name": "Events.TEXT_CARRIER_BLOCKED.UpdatedDate" } ], "Expression": "{_communicationRecord.Events.TEXT_CARRIER_BLOCKED.UpdatedDate}" }, "Statistic": "LAST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Filter": { "Include": "ANY", "Groups": [ { "Type": "ALL", "Dimensions": [ { "Attributes": { "Attributes.ChannelSubType": { "DimensionType": "INCLUSIVE", "Values": ["connect:SMS"] }, "Events.TEXT_CARRIER_BLOCKED.EventType": { "DimensionType": "INCLUSIVE", "Values": ["TEXT_CARRIER_BLOCKED"] } } } ] } ] }, "Launched": false } ``` ## 기본 주문 계산된 속성 Amazon Connect Customer Profiles는 주문에 따라 out-of-the 기본 속성을 제공합니다. 속성은 다음과 같습니다. **주문 수** ``` { "CalculatedAttributeName": "_orders_count", "DisplayName": "Count of orders", "Description": "Returns the count of orders for a customer.", "AttributeDetails": { "Attributes": [ { "Name": "OrderId" } ], "Expression": "{_order.OrderId}" }, "Statistic": "COUNT", "Conditions": { "Range": null, "ObjectCount": null, "Threshold":null }, "Launched": false } ``` **첫 번째 주문 생성 날짜** ``` { "CalculatedAttributeName": "_order_first_occurrence", "DisplayName": "First order created date", "Description": "Returns created date of the customer's first order.", "AttributeDetails": { "Attributes": [ { "Name": "CreatedDate" } ], "Expression": "{_order.CreatedDate}" }, "Statistic": "FIRST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` **마지막 주문 생성 날짜** ``` { "CalculatedAttributeName": "_order_last_occurrence", "DisplayName": "Last order created date", "Description": "Returns created date of the customer's last order.", "AttributeDetails": { "Attributes": [ { "Name": "CreatedDate" } ], "Expression": "{_order.CreatedDate}" }, "Statistic": "LAST_OCCURRENCE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` **모든 주문의 총 가격** ``` { "CalculatedAttributeName": "_orders_total_price_sum", "DisplayName": "Total price of all orders", "Description": "Returns sum of total price for all customer's orders.", "Statistic": "SUM", "AttributeDetails": { "Attributes": [ { "Name": "TotalPrice" } ], "Expression": "{_order.TotalPrice}" }, "Conditions": { "Range": null, "ObjectCount": null, "Threshold":null }, "Launched": false } ``` **총 가격의 주문 평균** ``` { "CalculatedAttributeName": "_orders_total_price_average", "DisplayName": "Orders average of total price", "Description": "Returns average of total price for all customer's orders.", "AttributeDetails": { "Attributes": [ { "Name": "TotalPrice" } ], "Expression": "{_order.TotalPrice}" }, "Statistic": "AVERAGE", "Conditions": { "Range": null, "ObjectCount": null, "Threshold": null }, "Launched": false } ``` # Amazon Connect Customer Profiles 계산된 속성에 대한 오류 메시지 및 해결 방법 다음 표에는 각 오류에 대한 계산된 속성 오류 메시지, 원인 및 해결 방법이 나와 있습니다. | 오류 메시지 | 원인 | 해결 방법 | | --- | --- | --- | | 프로필의 계산된 속성을 검색하면 null 값이 표시됩니다. | 이는 계산된 속성에 데이터가 없기 때문일 수 있습니다. 계산된 속성을 만든 후에는 새 데이터를 수집해야 합니다. | 통합 또는 CreateProfile 및 PutProfileObject API를 통해 새 데이터를 수집하거나 기존 데이터 다시 수집 | # Amazon Connect Customer Profiles에서 고객 세그먼트 설정 *고객 세그먼트*란 특정 속성을 공유하는 고객 프로필 그룹입니다. 예를 들어 고객 세그먼트에는 특정 도시에 거주하는 모든 고객 또는 자주 전화를 걸고 평균 지출이 500달러를 초과하는 모든 고객이 포함될 수 있습니다. Amazon Connect 아웃바운드 캠페인을 사용하면 고객 세그먼트로 캠페인을 보낼 수 있습니다. 고객 세그먼트는 사용자가 정의한 속성을 기반으로 동적으로 평가되며 속성 값이 변경될 때 시간이 지남에 따라 변경될 수 있습니다. 예를 들어 Customer Profiles 도메인에 새 프로필을 추가하거나 기존 프로필을 수정하거나 삭제하는 경우 해당 고객 세그먼트의 프로필 수가 증가하거나 감소할 수 있습니다. 고객 세그먼트 생성\$1에 대한 자세한 내용은 [Amazon Connect에서 고객 세그먼트 구축](customer-segments-building-segments.md) 섹션을 참조하세요. 세그먼트를 빌드하기 위한 사전 조건으로 관리자는 AWS Management Console에서 도메인을 설정하고 프로파일 Amazon Connect, 주문, 자산 및/또는 사례 데이터를 Customer Profiles로 가져오도록 통합을 구성해야 합니다. 자세한 내용은 [Amazon Connect 인스턴스에 Customer Profiles 활성화](enable-customer-profiles.md) 단원을 참조하십시오. 데이터 통합을 활성화하면 도메인으로 들어오는 새 데이터를 기반으로 동적 세그먼트를 계속 생성할 수 있습니다. 고객 세그먼트에는 Amazon Connect Customer Profiles 도메인의 고객 프로필만 포함됩니다. Customer Profiles는 S3 또는 외부 애플리케이션에서 수집하거나 에이전트 앱, 고객 응대 흐름 또는 API를 통해 생성할 수 있습니다. 고객 프로필에 대한 자세한 내용은 [Amazon Connect의 고객 프로필이란 무엇인가요?](customer-profiles-what-data.md) 섹션을 참조하세요. **Topics** + [고객 세그먼트 구축](customer-segments-building-segments.md) + [세그먼트 관리](customer-segments-managing-segments.md) + [가져온 파일에서 세그먼트 생성](customer-segments-imported-files.md) + [세그먼트를 CSV 파일로 내보내기](customer-segments-exporting-segments.md) + [세그먼트 AI 어시스턴트 사용](customer-segments-ai-assistant.md) + [문제 해결](customer-segments-troubleshooting.md) # Amazon Connect에서 고객 세그먼트 구축 **참고** **SQL(베타)로 구동되는 분할을 사용하려면 데이터 스토어를 켜야 합니다. Customer Profiles 홈 페이지 화면으로 이동하여 상단 파란색 배너에서 데이터 스토어를 활성화하세요.** **참고** Amazon Connect 관리자 웹 사이트에서 세분화 빌더 환경으로 이동하려면이 기능에 대한 보안 프로필 권한이 필요합니다. 자세한 내용은 [보안 프로필 권한을 할당하여 고객 세그먼트 관리](security-profile-customer-profile-segmentation.md) 단원을 참조하십시오. 세그먼트를 빌드하기 전에 Customer Profiles 도메인 설정 데이터 통합을 사용하여 Customer Profiles 도메인의 프로필을 채우는 것이 좋습니다. Customer Profiles와의 데이터 통합을 구성하는 방법에 대한 자세한 내용은 [외부 애플리케이션을 Amazon Connect Customer Profiles와 통합](integrate-external-apps-customer-profiles.md) 섹션을 참조하세요. 세그먼트에는 계산된 속성을 사용하여 캡처한 이벤트가 포함될 수 있습니다. 사용자 지정 계산된 속성을 구성하고 계산된 기본 속성 고객 프로필 제안을 검토하는 방법에 대한 자세한 내용은 [Amazon Connect Customer Profiles의 기본 계산된 속성](customerprofiles-calculated-attributes.md) 섹션을 참조하세요. Amazon Connect는 고객 세그먼트를 구축하는 두 가지 방법을 제공합니다. 1/ Spark SQL을 통해 세그먼트 정의(베타, 데이터 스토어 활성화 필요), 2/ 대상 그룹 및 필터를 통해 세그먼트 정의(클래식 세분화). 둘 다 생성형 AI 기반 세그먼트 AI 어시스턴트를 통해 자연어 프롬프트를 사용할 수 있습니다. 한 가지 방법으로 세그먼트를 정의하는 경우 해당 세그먼트를 다른 세그먼트로 이동하고 다시 시작해야 합니다. ## Spark SQL로 구동되는 세그먼트 Spark SQL로 구동되는 세그먼트를 사용하면 전체 Customer Profile 데이터와 확장된 기능을 사용하여 세그먼트를 정의할 수 있습니다. 표준 프로필 객체 속성과 사용자 지정 객체 속성을 사용할 수 있습니다. 표준 객체와 사용자 지정 객체를 함께 조인하여 다양한 객체의 데이터를 사용하고, 백분위수와 같은 통계로 세그먼트를 필터링하고, 비교를 위해 날짜 필드를 표준화하는 등의 SQL 기반 기능을 사용할 수도 있습니다. Segment Assistant AI에 자연어 프롬프트를 입력하여 시작할 수 있습니다. 세그먼트 AI 어시스턴트는 Spark SQL로의 번역을 포함하여 세그먼트를 정의합니다. Segment Assistant AI는 세그먼트를 정의하는 데 수행한 단계를 제공하며 생성하려는 것과 일치하는지 확인할 수 있습니다. SQL, 자연어로 된 SQL 단계 및 Spark SQL의 AI 생성 요약을 보고 추가로 검증할 수도 있습니다. 변경하려면 자연어 프롬프트를 업데이트하거나 Spark SQL을 직접 편집할 수 있습니다. Spark SQL 세그먼트를 직접 생성할 수도 있습니다. **클래식 분할과 마찬가지로 Spark SQL로 구동되는 세그먼트는 세그먼트 멤버십 호출, 흐름 블록 및 아웃바운드 캠페인에 사용할 수 있습니다.** **고객 이벤트에 의해 시작된 세그먼트 멤버십 호출, 흐름 블록 또는 아웃바운드 캠페인에서 Spark SQL 세그먼트를 사용하는 경우 마지막으로 내보낸 세그먼트(세그먼트 스냅샷)를 사용합니다. 멤버십에 사용되는 세그먼트 스냅샷은 생성 후 1년이 지나면 만료됩니다. 4XX 오류가 발생하면 세그먼트(세그먼트 스냅샷)를 내보냈는지 확인합니다.** **고객 세그먼트에서 시작한 아웃바운드 캠페인은 세그먼트(세그먼트 스냅샷)를 내보낼 필요가 없습니다.** ### 1단계: 새 세그먼트 빌드 세그먼트 AI 어시스턴트에서 "세그먼트 생성 방법"을 선택하여 귀중한 세그먼트 생성에 대한 자세한 지침을 보거나 "세그먼트 생성 방법"을 선택하여 자연어 프롬프트를 입력하여 세그먼트를 생성합니다. 또는 SQL을 사용하여 쿼리 편집기에서 새 세그먼트를 정의합니다. **참고 - 시간대 기반 아웃바운드 캠페인을 생성하려면 시간대 속성이 세그먼트 출력의 일부인지 확인해야 합니다.** **참고 - 아웃바운드 캠페인에서 세그먼트를 사용하려면 세그먼트 출력의 프로필 IDs가 고유한지 확인해야 합니다.** ### 2단계: 이름 및 설명 지정 이름에 나중에 쉽게 알아볼 수 있도록 고객 세그먼트의 이름을 입력합니다. **참고 -** Amazon Connect 관리자 웹 사이트는 입력한 이름을 세그먼트`DisplayName`의 로 사용하고 이를 기반으로 식별자를 생성합니다. 생성된 식별자는 Customer Profiles API를 사용하여 세그먼트에 액세스할 때 `SegmentDefinitionName`으로 사용됩니다. (선택 사항) 설명에 고객 세그먼트에 대한 설명을 입력합니다. ### 3단계: 세그먼트 검토 및 검증 세그먼트 AI 어시스턴트가 사용한 데이터와 세그먼트를 생성하는 데 사용한 AI 모델을 검토합니다. 생성한 SQL을 검토하여 쿼리 편집기에서 세그먼트를 정의할 수도 있습니다. 세그먼트를 생성할 수 없는 경우 정확한 세그먼트를 생성하는 데 도움이 되도록 제공한 피드백을 해결합니다. 세그먼트가 생성되면 Customer Profiles는 자동으로 세그먼트 견적을 생성합니다. 편집하려면 쿼리 편집기에서 "새 대화"를 클릭하거나 SQL을 생성/편집하여 새 프롬프트를 제공할 수 있습니다. 세그먼트 AI 어시스턴트를 사용하지 않는 경우 쿼리 편집기 아래의 "쿼리 검증 및 추정" 버튼을 클릭하여 쿼리를 검증하고 견적을 생성할 수 있습니다. **참고 - Spark SQL로 구동되는 세그먼트는 다른 쿼리 엔진과 마찬가지로 세그먼트 및 사용된 SQL에서 사용하는 프로필 데이터의 양에 따라 시간이 걸립니다(예: 객체 간에 여러 조인하는 데 시간이 걸림).** ### 4단계: 세그먼트 생성 세그먼트를 빌드하고 만족하면 오른쪽 상단의 "세그먼트 생성" 버튼을 선택합니다. 세그먼트를 생성한 후에는 흐름의 세그먼트를 사용하고 아웃바운드 캠페인의 세그먼트를 사용하여 작업 - .csv로 내보내기를 선택할 수 있습니다. **참고 - 아웃바운드 캠페인 또는 흐름 블록에서 세그먼트를 사용하는 경우 세그먼트가 마지막으로 생성된 시기에 따라 세그먼트 멤버십을 확인합니다. 흐름 또는 캠페인이 실행 중일 때 실시간 세그먼트 멤버십 검사가 필요한 경우 Classic 세분화를 사용합니다.** ## 대상 그룹 및 필터를 사용한 클래식 세분화 고객 세그먼트를 생성할 때 시작 잠재고객을 선택하고 세그먼트를 정의하는 필터를 선택하여 해당 잠재고객을 구체화합니다. 예를 들어 잠재고객 그룹을 생성한 다음 특정 국가에 거주하고 자주 전화하는 모든 고객의 필터를 선택할 수 있습니다. 세그먼트는 캠페인 실행, 고객 응대 흐름 실행, 세그먼트 추정 또는 내보내기 등 온디맨드로 다시 계산됩니다. 그 결과, 각 세그먼트의 크기 및 멤버십은 시간의 경과에 따라 변화합니다. 또한 두 번째 잠재고객 그룹을 생성한 다음 두 잠재고객 그룹 간에 관계(AND, OR 또는 EXCLUDE)를 생성하여 첫 번째 잠재고객 그룹에서 고객을 추가로 좁히거나 연결하거나 제외할 수 있습니다. ![\[두 개의 잠재고객 그룹.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-segments-building-segments-1.png) ## 잠재고객 그룹 고객 세그먼트를 생성할 때 하나 이상의 잠재고객 그룹을 생성합니다. 잠재고객 그룹은 다음과 같은 구성 요소로 구성됩니다. ![\[잠재고객 그룹의 구성 요소를 보여 주는 개념 다이어그램입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-segments-audience-groups-1.png) + **시작 잠재고객**: 초기 사용자 모집단을 정의하는 고객 세그먼트입니다. 최대 5명의 시작 대상 또는 Customer Profiles 도메인의 모든 프로필을 지정할 수 있습니다. + **필터 그룹**: 시작 잠재고객 위에 적용하는 잠재고객 정보의 범주입니다. OR 관계로 연결된 여러 필터 그룹을 추가할 수 있습니다. + **필터**: 필터는 세그먼트에 속하는 잠재고객 수를 줄입니다. 필터는 세그먼트를 필요에 따라 맞춤 조정하기 위해 원하는 만큼 추가할 수 있습니다. 고객 세그먼트에는 하나 이상의 잠재고객 그룹이 있어야 하지만 선택적으로 두 번째 잠재고객 그룹을 생성한 다음 두 잠재고객 그룹 간에 관계(AND/OR/EXCLUDE)를 생성할 수 있습니다. 이러한 결과에 대한 자세한 내용은 [5단계: 두 번째 잠재고객 그룹 추가(선택 사항)](#step-5-add-the-second-audience-group-optional) 섹션을 참조하세요. ## 고객 세그먼트 생성 다음 단계는 고객 세그먼트 생성 및 구성을 설명합니다. + 1단계: 새 세그먼트 빌드 + 2단계: 이름 및 설명 구성 + 3단계: 잠재고객 그룹 1에 포함할 시작 잠재고객 선택 + 4단계: 필터 그룹 선택 및 구성(선택 사항) + 5단계: 잠재고객 그룹 2 추가(선택 사항) ### 1단계: 새 세그먼트 빌드 1. 세그먼트를 생성하려면 사전 조건으로 보안 프로필 권한을 생성해야 합니다. 자세한 내용은 [보안 프로필 권한을 할당하여 고객 세그먼트 관리](security-profile-customer-profile-segmentation.md) 단원을 참조하십시오. 또한 세그먼트의 멤버십을 가장 잘 시각화하려면 세그먼트 생성 전에 데이터를 수집하는 것이 좋습니다. S3 또는 외부 애플리케이션을 통해 프로필을 수집하려면 [Customer Profiles로 고객 데이터 생성 및 수집](customer-profiles-object-type-mappings.md) 또는[외부 애플리케이션을 Amazon Connect Customer Profiles와 통합](integrate-external-apps-customer-profiles.md) 섹션 참조하세요. 1. 고객 세그먼트 테이블 보기에서 **세그먼트 생성**을 선택합니다. ![\[세그먼트 생성 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-1-build-a-new-segment-1.png) ### 2단계: 이름 및 설명 지정 + **이름**에 나중에 쉽게 알아볼 수 있도록 고객 세그먼트의 이름을 입력합니다. **참고** Amazon Connect 관리자 웹 사이트는 입력한 이름을 세그먼트`DisplayName`의 로 사용하고 이를 기반으로 식별자를 생성합니다. 생성된 식별자는 Customer Profiles API를 사용하여 세그먼트에 액세스할 때 `SegmentDefinitionName`으로 사용됩니다. + (선택 사항) **설명**에 고객 세그먼트에 대한 설명을 입력합니다. ![\[세그먼트 이름 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-2-configure-specify-name-and-description-1.png) ### 3단계: 잠재고객 그룹 1에 포함할 시작 잠재고객 선택 먼저 잠재고객 그룹의 시작 잠재고객을 어떻게 정의할지 선택합니다. 1. **잠재고객 그룹 1**의 **시작 잠재고객** 드롭다운 목록에서 잠재고객 그룹에 포함할 세그먼트를 하나 이상 선택하거나 **Customer Profiles에서 모든 프로필**을 선택합니다. **참고** 여러 세그먼트를 시작 잠재고객으로 선택하면 세그먼트가 `OR` 관계에 의해 연결됩니다. 예를 들어 **프리미엄 멤버십 고객과** **기본 멤버십 고객** 세그먼트를 시작 잠재고객으로 선택하면 두 세그먼트 중 하나에 있는 모든 프로필이 포함됩니다. ![\[시작 잠재고객 드롭다운 목록입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1.png) 1. ProfileType으로 세그먼트를 생성하려면 먼저 **Customer Profiles의 모든 계정**을 초기 잠재고객으로 사용합니다. 이 접근 방식을 사용하면 계정 기반 프로필을 효과적으로 필터링할 수 있습니다. 달리 지정하지 않는 한 분할 프로세스는 고객 프로필 도메인 내의 모든 프로필을 자동으로 내보냅니다. 이 기본 동작은 포괄적인 적용 범위를 보장하지만 특정 대상 지정 요구 사항에 맞게 조정할 수 있습니다. 다음은 세그먼트 정의를 생성하는 방법의 예입니다(계정 또는 표준 프로필 기반). **모든 계정 기반 프로필을 필터링합니다(ProfileType=ACCOUNT\$1PROFILE).** ![\[모든 계정 기반 프로필을 필터링합니다(ProfileType=ACCOUNT_PROFILE).\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-5.png) **참고** 하위 프로필로만 세그먼트를 생성하려면 계정 기반 프로필을 제외하는 새 잠재고객을 생성합니다. 예를 들어 `ProfileType`이 포함된 프로필은 PROFILE이거나 `ProfileType`가 비어 있는 경우입니다. ![\[하위 프로필로만 세그먼트를 생성하려면 계정 기반 프로필을 제외하는 새 잠재고객을 생성합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-6.png) **`Phone`을 사용하여 연결할 계정을 대상으로 하는 샘플 캠페인** ![\[Phone을 사용하여 연결할 계정을 대상으로 하는 샘플 캠페인\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-7.png) 이 예제에서 캠페인은 다음 직접 호출 시퀀스를 사용하여 단일 계정을 대상으로 합니다. 1. John에게 첫 번째 연락 시도(ID: 2) 1. John이 응답하지 않으면 Sally(ID: 3)에게 백업 연락처로 전화를 겁니다. 1. 시작 대상을 선택하면 **예상 잠재고객** 섹션이 업데이트되어 적격 프로필이 표시됩니다. 잠재고객 그룹을 편집한 후 예상 잠재고객 섹션에서 **새로 고침** 버튼을 클릭하여 추정치를 다시 가져올 수 있습니다. ![\[예상 잠재고객 섹션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-2.png) ### 4단계: 잠재고객 필터 선택 및 적용(선택 사항) 시작 잠재고객을 선택한 후 속성에 조건부 로직을 적용하여 잠재고객을 추가로 세분화할 수 있습니다. 세그먼트는 표준 프로필 속성, 사용자 지정 프로필 속성 및 계산된 속성을 지원합니다. ![\[잠재고객 필터.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-1.png) **잠재고객 필터를 선택하고 구성하는 방법** 1. **속성**에는 다음 유형 중에서 속성을 선택합니다. 1. **계산된 속성** - 계산된 속성 중 하나를 기준으로 잠재고객을 필터링합니다. 기본 계산된 속성과 사용자 지정 계산된 속성을 구성하는 방법에 대한 자세한 내용은 [Amazon Connect Customer Profiles의 기본 계산된 속성](customerprofiles-calculated-attributes.md) 섹션을 참조하세요. 1. **표준 속성** - 표준 프로필 속성 중 하나를 기준으로 잠재고객을 필터링합니다. 표준 프로필 속성 목록은 [Amazon Connect Customer Profiles의 표준 프로필 정의](standard-profile-definition.md) 섹션을 참조하세요. 1. **사용자 지정 속성** - 사용자 지정 프로필 속성 중 하나를 기준으로 잠재고객을 필터링합니다. **참고** 도메인 내에 최대 1,000개의 최신 프로필 속성을 저장합니다. 도메인에 많은 양의 속성이 포함된 경우 가장 오래된 속성이 이 목록에 표시되지 않을 수 있습니다. 1. **연산자**를 선택합니다. 연산자는 입력한 값에 대한 속성의 관계를 결정합니다. 다음은 사용 가능한 연산자에 대한 설명입니다. 사용 가능한 연산자는 선택한 속성의 값 유형에 따라 변경됩니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/customer-segments-building-segments.html) **참고** Amazon Connect 관리자 웹 사이트의 고객 세그먼트는 모든 시간 기반 필터에 UTC 시간대와 기본 시간인 00:00:00 UTC를 사용합니다. 날짜를 기준으로 필터링 할 수 있지만 시간은 동일한 값으로 기록됩니다. 2024-1-1 날짜를 입력하면 콘솔은 이 시간을 2024-01-01T00:00:00Z로 전달합니다. **참고** 계산된 속성에 대한 필터를 지정할 때 계산된 속성 정의의 기간을 재정의할 수 있습니다. 예를 들어 필터 `Frequent caller is true for the event time period of 60 days`는 [계산된 속성 정의에 구성된 기간](customerprofiles-calculated-attributes-apis.md) 대신 지난 60일 이내에 값을 평가하도록 *자주 전화하는 사람* [Amazon Connect Customer Profiles의 기본 계산된 속성](customerprofiles-default-calculated-attributes.md)을 재정의합니다. 이 재정의는 세그먼트에 고유하며 계산된 속성 정의 자체에는 영향을 주지 않습니다. ![\[평가할 속성, 연산자 및 값입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-2.png) 1. 값을 지정합니다. `OR` 관계로 연결된 여러 값을 지정할 수 있습니다. 예: `Address.Country`는 `USA` 또는 `Mexico`입니다. 값 입력은 도메인에 저장된 고객 프로필을 기반으로 문자열 연산자에 대한 제안 사항을 드롭다운에 표시합니다. **참고** 값은 대소문자를 구분합니다. 예를 들어 *Address.Country is US*는 *Address.Country is us*와 다른 결과를 반환합니다. 1. (선택 사항) 이 기준에 추가 속성을 적용하려면 **필터 추가**를 선택합니다. 다른 필터 그룹을 생성하려면 **그룹 추가**를 선택합니다. **참고** 필터 그룹에 여러 필터가 있는 경우 필터는 AND 관계로 연결됩니다. 예를 들어 '*Address.Country* is USA' 및 '*Customer'의 평균 대기 시간*이 10초를 초과하는' 필터 2개가 포함된 필터 그룹은 *Address.Country*가 미국**이고** *평균 대기 시간이* 10초를 초과하는 프로필이 세그먼트에 속합니다. 대상 그룹에 여러 필터 그룹이 있는 경우 Amazon Connect 관리자 웹 사이트의 고객 세그먼트는 OR 관계를 사용하여 필터 그룹 간에 연결합니다. ![\[잠재고객 필터 2개.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-3.png) 1. 잠재고객 그룹 설정이 끝나면 **세그먼트 생성**을 선택합니다. ### 5단계: 두 번째 잠재고객 그룹 추가(선택 사항) 선택적으로 두 번째 잠재고객 그룹을 추가하고 잠재고객 그룹 1과의 관계를 정의합니다.Amazon Connect 관리자 웹 사이트를 사용하여 고객 세그먼트를 생성할 때 세그먼트당 최대 2개의 잠재고객 그룹을 가질 수 있습니다. 세그먼트에 두 번째 잠재고객 그룹을 추가할 경우, 두 잠재고객 그룹 간의 연결 방식을 지정하는 두 가지 방법 중 하나를 선택할 수 있습니다. + **AND 관계** - AND 관계를 사용하여 두 잠재고객을 연결하는 경우 세그먼트에는 잠재고객 그룹 1과 잠재고객 그룹 2의 필터를 모두 충족하는 모든 프로필이 포함됩니다. + **OR 관계** - OR 관계를 사용하여 두 잠재고객을 연결하는 경우 세그먼트에는 잠재고객 그룹 1 또는 잠재고객 그룹 2의 필터를 충족하는 모든 프로필이 포함됩니다. + **EXCLUDE 관계** - EXCLUDE 관계를 사용하여 두 잠재고객을 연결하는 경우 세그먼트에는 잠재고객 그룹 2의 프로필을 제외한 잠재고객 그룹 1의 프로필이 포함됩니다. **두 번째 잠재고객 그룹을 구성하는 방법** 1. 잠재고객 그룹 1을 구성한 후 SELECT**AND**, **OR** 또는 **EXCLUDE** 관계를 선택합니다. ![\[AND, OR 또는 EXCLUDE 옵션입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-1.png) 1. 잠재고객 그룹 2에서 시작 잠재고객을 선택합니다. 자세한 내용은 [3단계: 잠재고객 그룹 1에 포함할 시작 잠재고객 선택](#step-3-choose-the-starting-audiences-to-include-in-audience-group) 섹션을 참조하세요. 1. (선택 사항) 세그먼트 범위를 좁히고자 하는 필터를 선택합니다. 자세한 내용은 [4단계: 잠재고객 필터 선택 및 적용(선택 사항)](#step-4-choose-and-apply-audience-filters-optional) 섹션을 참조하세요. 1. 세그먼트 설정이 끝나면 **세그먼트 생성**을 선택합니다. 세그먼트가 생성되었으므로 이제 아웃바운드 캠페인 또는 흐름에서 세그먼트를 사용할 수 있습니다. ![\[세그먼트가 성공적으로 생성되었다는 메시지입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-2.png) ## Spark SQL로 구동되는 세그먼트 생성 Spark SQL로 구동되는 세그먼트를 사용하면 전체 Customer Profile 데이터와 확장된 기능을 사용하여 세그먼트를 정의할 수 있습니다. 표준 프로필 객체 속성과 사용자 지정 객체 속성을 사용할 수 있습니다. 표준 객체와 사용자 지정 객체를 함께 조인하여 다양한 객체의 데이터를 사용하고, 백분위수와 같은 통계로 세그먼트를 필터링하고, 비교를 위해 날짜 필드를 표준화하는 등의 SQL 기반 기능을 사용할 수도 있습니다. Segment Assistant AI에 자연어 프롬프트를 입력하여 시작할 수 있습니다. 세그먼트 AI 어시스턴트는 Spark SQL로의 번역을 포함하여 세그먼트를 정의합니다. Segment Assistant AI는 세그먼트를 정의하는 데 수행한 단계를 제공하며 생성하려는 것과 일치하는지 확인할 수 있습니다. SQL, 자연어로 된 SQL 단계 및 Spark SQL의 AI 생성 요약을 보고 추가로 검증할 수도 있습니다. 변경하려면 자연어 프롬프트를 업데이트하거나 Spark SQL을 직접 편집할 수 있습니다. Spark SQL 세그먼트를 직접 생성할 수도 있습니다. Spark SQL로 구동되는 세그먼트는 세그먼트 멤버십 호출, 흐름 블록 및 아웃바운드 캠페인에 사용할 수 있습니다. 세그먼트가 마지막으로 생성된 시점(세그먼트 스냅샷)을 기준으로 세그먼트를 확인합니다. 4XX 오류가 발생하면 세그먼트 스냅샷을 실행해야 합니다. **참고** **SQL 분할은 최대 10년의 데이터가 있는 데이터 스토어에서 실행됩니다. 클래식 세분화에서 최신 데이터 사용(지난 3년 동안 업데이트된 데이터)** ### 1단계: 새 세그먼트 빌드 세그먼트 AI 어시스턴트에서 “세그먼트 생성 방법”을 선택하여 귀중한 세그먼트 생성에 대한 자세한 지침을 보거나 “세그먼트 생성 방법”을 선택하여 자연어 프롬프트를 입력하여 세그먼트를 생성합니다. 또는 SQL을 사용하여 쿼리 편집기에서 새 세그먼트를 정의합니다. ### 2단계: 이름 및 설명 지정 이름에 나중에 쉽게 알아볼 수 있도록 고객 세그먼트의 이름을 입력합니다. **참고** Amazon Connect 관리자 웹 사이트는 입력한 이름을 세그먼트`DisplayName`의 로 사용하고 이를 기반으로 식별자를 생성합니다. 생성된 식별자는 Customer Profiles API를 사용하여 세그먼트에 액세스할 때 `SegmentDefinitionName`으로 사용됩니다. (선택 사항) 설명에 고객 세그먼트에 대한 설명을 입력합니다. ### 3단계: 세그먼트 검토 및 검증 세그먼트 AI 어시스턴트가 사용한 데이터와 세그먼트를 생성하는 데 사용한 AI 모델을 검토합니다. 생성한 SQL을 검토하여 쿼리 편집기에서 세그먼트를 정의할 수도 있습니다. 세그먼트를 생성할 수 없는 경우 정확한 세그먼트를 생성하는 데 도움이 되도록 제공한 피드백을 해결합니다. 세그먼트가 생성되면 Customer Profiles는 자동으로 세그먼트 견적을 생성합니다. 편집하려면 쿼리 편집기에서 “새 대화”를 클릭하거나 SQL을 생성/편집하여 새 프롬프트를 제공할 수 있습니다. 세그먼트 AI 어시스턴트를 사용하지 않는 경우 쿼리 편집기 아래의 “쿼리 검증 및 추정” 버튼을 클릭하여 쿼리를 검증하고 견적을 생성할 수 있습니다. **참고** Spark SQL로 구동되는 세그먼트는 다른 쿼리 엔진과 마찬가지로 세그먼트 및 사용된 SQL에서 사용하는 프로필 데이터의 양에 따라 시간이 걸립니다(예: 객체 간 여러 조인에는 일반적으로 더 많은 시간이 소요됨). ### 4단계: 세그먼트 생성 세그먼트를 빌드하고 만족하면 오른쪽 상단에서 “세그먼트 생성” 버튼을 선택합니다. 세그먼트를 생성한 후에는 흐름의 세그먼트를 사용하고 아웃바운드 캠페인의 세그먼트를 사용하여 작업 - .csv로 내보내기를 선택할 수 있습니다. **참고** 아웃바운드 캠페인 또는 흐름 블록에서 세그먼트를 사용하는 경우 세그먼트가 마지막으로 생성된 시기에 따라 세그먼트 멤버십을 확인합니다. 흐름 또는 캠페인이 실행 중일 때 실시간 세그먼트 멤버십 검사가 필요한 경우 Classic 세분화를 사용합니다. # Amazon Connect에서 고객 세그먼트 관리 Amazon Connect 관리자 웹 사이트를 사용하여 고객 세그먼트를 생성, 조회, 복사 및 기타 관리 태스크를 수행할 수 있습니다. 해당 설정을 보기 위해 고객 세그먼트를 여는 경우 세그먼트를 사용하는 캠페인을 빠르게 생성할 수도 있습니다. 자세한 내용은 Amazon Connect 개발자 안내서의 [Amazon Connect에서 고객 세그먼트 구축](customer-segments-building-segments.md) 및 키 생성을 참조하세요. **고객 세그먼트를 관리하는 방법** 1. **고객 세그먼트** 페이지에서 관리할 세그먼트를 선택합니다. ![\[고객 세그먼트 페이지, 세그먼트 목록.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-segments-managing-segments-1.png) 1. **작업** 메뉴에서 다음 옵션을 사용할 수 있습니다. 1. **세부 정보 보기** - 세그먼트가 생성된 날짜 및 시간과 세그먼트가 마지막으로 업데이트된 날짜 및 시간을 포함하여 고객 세그먼트에 대한 정보를 표시하려면 이 옵션을 선택합니다.이 작업을 수행하려면 Amazon Connect 사용자에게 **CustomerProfiles.Segments.View** 보안 프로필 권한이 필요합니다. 1. **복제** - 선택한 세그먼트를 복사하여 새로운 고객 세그먼트를 생성하려면 이 옵션을 선택합니다. 그러면 원래 세그먼트를 변경하지 않고 새 세그먼트의 모든 설정을 수정할 수 있습니다. 이 작업을 수행하려면 Amazon Connect 사용자에게 **CustomerProfiles.Segments.Create** security profile 권한이 필요합니다. 1. **CSV 내보내기** - 고객 세그먼트를 컴퓨터의 파일로 내보내려면 이 옵션을 선택합니다. 자세한 내용은 [Amazon Connect에서 고객 세그먼트를 CSV 파일로 내보내기](customer-segments-exporting-segments.md) 섹션을 참조하세요.이 작업을 수행하려면 Amazon Connect 사용자에게 **CustomerProfiles.Segments.Export** 보안 프로필 권한이 필요합니다. 1. **삭제** - 고객 세그먼트를 영구 삭제하려면 이 옵션을 선택합니다. 세그먼트를 삭제한 후에는 복구할 수 없습니다.이 작업을 수행하려면  Amazon Connect 사용자에게 **CustomerProfiles.Segments.Delete** 보안 프로필 권한이 필요합니다. **중요** 세그먼트를 삭제하면 해당 세그먼트를 사용하는 모든 활성 캠페인이 실패합니다 마찬가지로 세그먼트 위에 구축된 모든 세그먼트는 작동이 중지됩니다. 세그먼트를 삭제하기 전에 먼저 활성 캠페인이나 다른 세그먼트에서 세그먼트가 사용되지 않는지 확인하는 것이 좋습니다. # Amazon Connect에서 가져온 파일에서 세그먼트 생성 **참고** Amazon Connect 관리자 웹 사이트에서 세분화 빌더 환경에 액세스하려면 적절한 보안 프로필 권한이 구성되어 있는지 확인합니다. 자세한 내용은 [보안 프로필 권한을 할당하여 고객 세그먼트 관리](security-profile-customer-profile-segmentation.md) 단원을 참조하십시오. 고객 세그먼트 가져오기는 프로필 데이터가 포함된 CSV 파일을 사용하여 새 프로필을 생성하거나 기존 프로필을 업데이트한 다음 세그먼트로 그룹화합니다. CSV 파일의 크기는 1GB 미만이어야 하며 표준 프로필 속성에 매핑되는 유효한 헤더를 포함해야 합니다. 다음 단계는 가져온 고객 세그먼트를 생성하고 구성하는 방법을 설명합니다. 1. [새로운 세그먼트 생성](#create-new-segment) 1. [CSV 파일 업로드](#upload-csv-file) 1. [세그먼트 세부 정보 구성](#configure-segment-details) 1. [고객 속성 매핑](#map-customer-attributes) 1. [프로필 만료 설정](#set-profile-expiry) 1. [세그먼트 가져오기 생성 및 모니터링](#create-monitor-segment-import) ## 새로운 세그먼트 생성 1. 세그먼트를 생성하려면 사전 조건으로 보안 프로필 권한을 생성해야 합니다. 자세한 내용은 [보안 프로필 권한을 할당하여 고객 세그먼트 관리](security-profile-customer-profile-segmentation.md) 단원을 참조하십시오. 1. Amazon Connect 관리자 웹 사이트에서 **Customer Profiles****Customer 세그먼트**로 이동합니다. 1. **세그먼트 생성**을 선택하고 드롭다운에서 **파일 업로드 시작**을 선택합니다. ## CSV 파일 업로드 다음 중 하나를 기준으로 CSV 파일을 선택합니다. + **파일 선택**을 선택하고 파일을 선택합니다. + 파일을 업로드 영역으로 끌어다 놓습니다. 파일 이름은 다음과 같아야 합니다. + CSV 형식 + 크기가 1GB 미만 + 헤더 포함 + UTF-8 인코딩 ## 세그먼트 세부 정보 구성 **이름**에 세그먼트에 대해 인식 가능한 식별자를 지정합니다. 이 필드는 필수 항목입니다. + 문자(a\$1z, A\$1Z), 숫자(0\$19), 하이픈(-) 또는 밑줄(\$1)만 사용합니다. + 문자나 숫자로 시작해야 합니다(밑줄은 안 됨). + 최대 길이는 255자입니다. **참고** Amazon Connect 관리자 웹 사이트는이 이름을 세그먼트`DisplayName`의 로 사용하고 고유 `SegmentDefinitionName` 식별자를 생성합니다. 이 식별자는 Amazon Connect Customer Profiles API를 통해 세그먼트에 액세스할 때 사용됩니다. **설명**(선택 사항)에서 세그먼트에 대한 세부 정보를 추가합니다. + 최대 길이는 1000자입니다. ## 고객 속성 매핑 객체 유형 매핑은 Customer Profiles가 CSV 데이터를 처리하는 방법을 정의합니다. 이 매핑은 다음과 같습니다. + CSV 데이터가 표준 프로필 객체를 채우는 방법을 결정합니다. + 프로파일 할당을 위해 인덱싱할 필드를 지정합니다. 객체 유형 매핑에 대한 자세한 내용은 [Customer Profiles로 고객 데이터 생성 및 수집](customer-profiles-object-type-mappings.md) 섹션을 참고하세요. 다음 옵션 중 하나를 선택하여 CSV 열을 Customer Profiles 속성에 매핑합니다. ### 옵션 1: AI 기반 매핑(권장) 1. **고객 속성 생성**을 선택한 후 **다음**을 선택합니다. 1. 시스템은 CSV 헤더를 분석하고 표준 프로필 속성에 대한 적절한 매핑을 제안합니다. 1. 제안된 매핑을 검토합니다. 1. 선택 사항: 매핑 사용자 지정: + 표준 프로필 속성 매핑을 수정합니다. + `Attributes.attribute-name` 형식을 사용하여 사용자 지정 속성을 추가합니다. + 고유 식별자를 업데이트합니다. ### 옵션 2: 수동 매핑 1. 각 CSV 열 헤더를 프로파일 속성에 매핑합니다. + 표준 프로필 속성을 사용합니다. 전체 목록은 [Amazon Connect Customer Profiles의 표준 프로필 정의](standard-profile-definition.md) 단원을 참조하세요. + `Attributes.attribute-name` 형식을 사용하여 사용자 지정 속성을 생성합니다. **참고** 최대 25개의 속성을 매핑할 수 있습니다. 1. 매핑된 속성 하나를 고객 식별자(고유 키)로 선택합니다. ### 고객 식별자 선택 매핑을 완료한 후 매핑된 속성 하나를 고객 식별자로 선택합니다. Amazon Connect Customer Profiles는 이 식별자를 사용하여 다음을 수행합니다. + 새 프로필을 생성하거나 기존 프로필을 업데이트합니다. + 수신 데이터를 기존 프로필과 일치시킵니다. **참고** 속성 매핑은 AI 기반 매핑이든 수동 매핑이든 관계없이 설정 중 언제든지 수정할 수 있습니다. ## 프로필 만료 설정 가져온 프로필이 만료되는 시기를 지정합니다. 1. 만료 옵션을 선택합니다. + 기본값: 가져오기 날짜로부터 14일 + 사용자 지정: 날짜 선택기를 사용하여 날짜 선택 1. 사용자 지정 만료 날짜의 경우: + 최소: 가져오기 후 1일 + 최대: 가져오기 후 90일 Customer Profiles는 세그먼트 및 프로필 도메인에서 만료된 프로필을 제거합니다. **참고** 데이터 보존 요구 사항에 맞는 만료 기간을 선택합니다. 사용자 지정 날짜를 선택하기 전에 기본 14일 기간이 비즈니스 요구 사항을 충족하는지 고려합니다. ## 세그먼트 가져오기 생성 및 모니터링 **세그먼트 생성** 1. 구성을 검토합니다. 1. **세그먼트 생성**을 선택합니다. 1. 시스템은 다음을 수행합니다. + CSV 파일을 업로드합니다. + 데이터를 기반으로 프로필을 생성/업데이트합니다. + 프로필을 세그먼트로 그룹화합니다. + 알림 배너를 사용하여 진행 상황을 표시합니다. 가져오기 진행 상황 모니터링 + 세그먼트 세부 정보 페이지에서 가져오기 진행 상황을 확인합니다. + 알림 배너는 가져오기 작업이 진행 중임을 보여 줍니다. + 가져오기 작업 세부 정보 표에는 다음이 표시됩니다. + 파일 이름 + 가져오기 작업 생성 날짜 + 가져오기 작업 완료 날짜 + 처리된 프로필 수 + 성공적인 가져오기 수 + 실패한 가져오기 수 + 진행 중에 가져오기를 취소할 수 있습니다. + 가져오기 작업이 진행 중인 동안 캠페인에서 세그먼트를 사용할 수 있습니다. **참고** 가져온 세그먼트는 가져오기가 완료되면 아웃바운드 캠페인 또는 내보내기에 다른 세그먼트처럼 사용할 수 있습니다. 세그먼트 세부 정보 페이지에서 가져오기 상태 및 결과를 포함한 세그먼트 세부 정보를 볼 수 있습니다. # Amazon Connect에서 고객 세그먼트를 CSV 파일로 내보내기 Amazon Connect 관리자 웹 사이트의 **고객 세그먼트** 페이지에서 기존 세그먼트를 컴퓨터의 파일로 내보낼 수 있습니다.이 경우 Customer Profiles는 고객 세그먼트의 프로필과 연결된 모든 프로필 속성을 CSV 파일로 내보냅니다. **고객 세그먼트를 내보내는 방법** 1. 고객 세그먼트 페이지의 작업 드롭다운에서 **CSV 내보내기**를 선택합니다. ![\[고객 세그먼트 페이지, CSV 내보내기 옵션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-segments-exporting-segments-1.png) 또는 **세부 정보 보기** 페이지로 이동하여 **다음 작업**, **다운로드**를 선택할 수 있습니다. ![\[세그먼트의 세그먼트 세부 정보 페이지, 다음 작업 옵션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-segments-exporting-segments-2.png) **참고** Amazon Connect 관리자 웹 사이트는 최대 350,000개의 프로필이 포함된 고객 세그먼트 내보내기를 지원합니다. 많은 수의 프로필이 포함된 세그먼트를 내보내야 하는 경우 Customer Profiles API에서 `CreateSegmentSnapshot` 작업을 사용합니다. `CreateSegmentSnapshot` 작업은 ORC, JSONL 및 CSV 파일의 세그먼트를 S3 버킷으로 내보내는 작업을 지원합니다. API는 버킷에서 내보낸 세그먼트 외에도 테스트 파일을 출력합니다. 1. 내보내기 작업이 시작된 후 프로세스가 완료될 때까지 다운로드가 포함된 창 또는 탭을 열어 둡니다. ![\[세그먼트를 내보내고 있다는 메시지입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-segments-exporting-segments-3.png) 1. 내보내기 작업이 완료되면 Amazon Connect 관리자 웹 사이트가 자동으로 파일 다운로드를 시작합니다. ![\[세그먼트가 성공적으로 다운로드되었다는 메시지입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-segments-exporting-segments-4.png) 내보낸 CSV 파일에는 내보낸 프로필 전체에 채워진 모든 [표준 및 고객 프로필 속성](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html)이 포함됩니다. # Amazon Connect에서 세그먼트 AI 어시스턴트 사용 Amazon Connect Customer Profiles는 생성형 AI 기반 세분화를 지원하여 비기술 비즈니스 사용자가 자연어 쿼리([세그먼트 AI 어시스턴트](#generating-a-segment-by-prompt))를 사용하여 잠재고객을 구축하고 고객 데이터의 추세([세그먼트 생성을 위한 영감 카드](#inspiration-cards-for-segment-creation))를 기반으로 추천을 받을 수 있도록 합니다. 이러한 기능은 [Amazon Bedrock](https://aws.amazon.com/bedrock/)의 고급 AI 알고리즘을 활용하여 선제적이고 개인화된 지원을 통해 고객 만족도를 높이고 수익을 창출할 수 있습니다. 예를 들어, 지난 주에 개인화된 서비스 제안을 통해 고객 지원에 자주 연락한 고객 세그먼트를 생성할 수 있습니다. 또한 총 지출이 증가한 고객을 식별하고 개인 맞춤형 할인을 제공하여 충성도를 높이고 성장을 촉진할 수 있습니다. 생성형 AI를 세분화 워크플로에 통합하면 다음과 같은 이점이 추가됩니다. + **간소화된 세그먼트 생성**: 대화형 언어를 사용하여 복잡한 고객 세그먼트를 구축하여 비기술 사용자가 프로세스에 액세스할 수 있도록 하고 효율성을 높입니다. + **데이터 기반 세그먼트 생성 아이디어**: 고객 데이터의 추세를 기반으로 AI 기반 세그먼트 영감을 받습니다. + **향상된 개인 맞춤:** 맞춤형 커뮤니케이션 및 제안을 위해 특정 고객 그룹을 쉽게 식별하고 대상으로 지정합니다. 다음 섹션에서는 각 기능, 기능 사용 방법, 고객 세분화 작업을 개선하는 데 도움이 되는 이점에 대해 설명합니다. **참고** 세그먼트 AI 어시스턴트를 사용하려면 사용자에게 세그먼트 생성 **CustomerProfiles.Segments.Create**에 대한 권한이 필요합니다. 이러한 AI 기반 도구는 중요한 제안을 제공하지만 권장 세그먼트를 검토하고 조정하여 조직의 특정 비즈니스 목표에 부합하고 데이터 사용 정책을 준수하는지 확인하는 것이 중요합니다. ## 세그먼트 생성을 위한 영감 카드 영감 카드는 **고객 세그먼트** 페이지의 AI 기반 기능입니다. 세그먼트 생성 프로세스를 간소화하고 개선합니다. 다음 이미지는 세 장의 영감 카드 예제를 보여 줍니다. ![\[고객 세그먼트 페이지의 영감을 주는 카드의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/inspiration-cards-for-segment-creation-1.png) 이러한 카드는 Amazon Connect Customer Profiles 데이터를 기반으로 매번 최대 3가지 범주의 세그먼트 아이디어를 생성하여 세그먼트 생성 프로세스를 장려하고 간소화합니다.  **참고** 추세 데이터는 계산된 기본 속성의 이벤트 수집 날짜를 기반으로 합니다. **주요 기능** + **데이터 기반 영감**: 각 영감 카드는 특정 고객 데이터 및 추세에 맞게 조정된 세그먼트 아이디어를 제공합니다. + 영감 카드는 세 가지 비즈니스 중심 테마에 대한 아이디어를 제공합니다. + **프로모션**: 특정 프로모션 전략으로 고객을 대상으로 하는 아이디어입니다. + **보존**: 고객 보존 노력을 위한 세그먼트를 식별합니다. + **지원**: 고객 서비스에 특별한 주의가 필요할 수 있는 고객 그룹을 강조 표시합니다. + **인사이트 기반 권장 사항**: 과거 추세, 데이터 인사이트 및 생성형 AI를 활용하여 의미 있고 실행 가능한 인사이트를 생성합니다. **영감 카드를 사용하는 방법** 1. **고객 세그먼트** 페이지로 이동합니다. 1. 영감 카드 섹션을 찾습니다. 세 가지 세그먼트 제안이 표시됩니다. 1. 각 카드를 검토하여 제안된 세그먼트와 잠재적 애플리케이션을 이해합니다. 1. 사용하려는 카드를 찾으면 해당 카드에서 **시작하기**를 선택합니다. 1. 추가 영감 카드를 생성하려면 **자세히 살펴보기**를 선택합니다. Amazon Connect Customer Profiles 데이터를 기반으로 새로운 세그먼트 아이디어를 제공할 수 있습니다. 1. **시작하기**를 선택하면 **세그먼트 생성** 페이지로 자동으로 이동합니다. 1. 선택한 세그먼트 아이디어가 세그먼트 빌더에 채워져 검토 및 세분화할 준비가 되었습니다. ## 자연어 프롬프트를 사용하여 세그먼트 생성 세그먼트 AI 어시스턴트는 자연어 프롬프트를 사용하여 세그먼트를 생성하는 안내 접근 방식을 제공하여 복잡한 세그먼트를 생성하는 프로세스를 간소화하므로 대상 잠재고객을 자연어로 설명하고 구조화되고 실행 가능한 세그먼트 정의를 받을 수 있습니다. 다음 이미지는 세그먼트 AI 어시스턴트 프롬프트의 예를 보여 줍니다. ![\[세그먼트 AI 어시스턴트 프롬프트의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/generating-a-segment-by-prompt-1.png) **이 기능에 액세스하려면 다음을 수행합니다.** 1. **고객 세그먼트** 페이지로 이동한 다음 **세그먼트 생성**을 선택합니다. 1. 다음 이미지와 같이 페이지 오른쪽에서 세그먼트 AI 어시스턴트 패널을 찾습니다. ![\[페이지 오른쪽에 있는 세그먼트 AI 어시스턴트 패널의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/generating-a-segment-by-prompt-2.png) **세그먼트 AI 어시스턴트 사용** 1. 어시스턴트는 사용자에게 세분화 요구 사항을 이해하기 위한 일련의 질문을 안내합니다. 어시스턴트와의 모든 상호 작용 경로는 프롬프트를 생성합니다. 1. 사용자는 원하는 세그먼트에 대한 텍스트 설명을 제공할 수 있습니다. 1. 프롬프트 작업 단계에서는 자세한 설명을 작성하기 위한 참조로 샘플 프롬프트를 제공합니다. 1. 입력에 따라 Amazon Connect는 구조화된 세그먼트 정의를 생성합니다. 1. 생성된 세그먼트 정의는 세그먼트 빌더에 자동으로 적용됩니다. 1. 표준 세그먼트 빌더 도구를 사용하여 생성된 세그먼트를 추가로 세분화할 수 있습니다. 세그먼트 빌더의 필터를 수정하면 이전에 생성된 기존 조건을 덮어씁니다.  1. 생성된 세그먼트를 검토하고 필요한 조정을 수행한 후 **세그먼트 생성**을 선택하여 프로세스를 완료할 수 있습니다. 이 작업을 수행하면 세그먼트가 저장되고 캠페인에서 사용할 수 있습니다. **모범 사례** 세그먼트 AI 어시스턴트를 사용할 때는 다음 모범 사례를 염두에 두세요. + 특정 설명을 작성합니다. 세그먼트 AI 어시스턴트는 기존 속성의 이름을 사용할 때 더 정확한 조건을 생성합니다. + 참조하는 모든 속성이 도메인에 있는지 확인합니다. + 간단한 프롬프트로 시작하고 다른 프롬프트를 사용해 보세요. 첫 번째 시도에서 원하는 내용을 받지 못한 경우 프롬프트를 다시 작성합니다. 새 프롬프트를 제출하면 기존 조건이 대체되거나 **새 대화**를 선택하여 대체됩니다. + 세그먼트가 실제 데이터 값을 정확하게 반영하도록 세그먼트 빌더에 세그먼트 세분화 및 검증 시간을 할당합니다. **참고** 세그먼트 AI 어시스턴트는 일반적인 설명자 및 기준과 함께 작동하도록 설계되었습니다. 세그먼트를 설명할 때는 항상 데이터 보호 규정 및 회사 정책을 준수하세요. 프롬프트와 설명에 민감한 정보나 개인 정보가 포함되어 있지 않은지 확인하세요.  ## 생성된 세그먼트에 대한 피드백 제공 세그먼트가 생성되면 사용자는 기능의 성능을 평가하고 피드백을 제공하는 것이 좋습니다. 이 피드백 메커니즘은 세그먼트 생성 프로세스를 개선하고 비즈니스 요구 사항을 효과적으로 충족하는 데 도움이 됩니다. 다음 이미지는 피드백 페이지를 보여 줍니다. ![\[피드백이 기록되었다는 메시지의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/providing-feedback-on-generated-segments-1.png) 피드백 프로세스는 두 스테이지로 구성됩니다. 1. **초기 반응**: 알림 섹션의 오른쪽 하단 모서리에서 엄지 위로 및 엄지 아래로 아이콘을 찾을 수 있습니다. 다음 중 하나를 클릭하여 생성된 세그먼트에 대한 일반적인 만족도를 나타냅니다. 1. **추가 피드백**: 엄지 위로 또는 엄지 아래로 아이콘을 선택하면 더 자세한 피드백을 제공하는 옵션이 제공됩니다. 자유 형식 의견을 남길 수 있는 텍스트 입력 필드의 형태를 취합니다. 포괄적인 평가를 위해 빠른 반응(엄지 위로/아래로)과 텍스트 입력을 모두 사용하고, 해당하는 경우 특정 예제 또는 사용 사례를 제공하고, 생성된 세그먼트가 비즈니스 목표에 부합하는 방식에 초점을 맞추고, 세그먼트 생성 프로세스를 개선하는 개선 사항 또는 추가 기능을 제안하는 것이 좋습니다. 세그먼트 생성 프로세스를 개선할 개선 사항 또는 추가 기능을 제안합니다. 피드백 프로세스에 적극적으로 참여함으로써 사용자는 세그먼트 생성 기능의 지속적인 개선에 기여하여 궁극적으로 더 효과적인 고객 세분화 및 대상 마케팅 전략으로 이어집니다. ## 오류 처리 세그먼트 AI 어시스턴트를 사용하여 고객 세그먼트를 생성할 때 다음과 같은 오류 메시지가 표시될 수 있습니다. **현재 요청을 처리할 수 없습니다.** 이 오류는 세그먼트 생성을 위한 유효한 프롬프트를 제공한 후에도 발생할 수 있습니다. 다음 이미지는 이 오류 메시지의 예제를 보여 줍니다. ![\[Amazon Connect가 요청을 처리할 수 없다는 오류 메시지의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-segments-ai-error-handling-1.png) 다음 단계를 사용하면이 오류를 이해하고 해결하는 데 도움이 됩니다. **가능한 원인:** + **시스템 부하 높음**: 세그먼트 AI 어시스턴트에 수요가 많거나 여러 요청을 동시에 처리하고 있을 수 있습니다. + **일시적인 서비스 중단**: 새 세그먼트 요청을 처리하는 서비스의 기능이 잠시 중단될 수 있습니다. + **복잡한 쿼리**: 시스템에서 특히 복잡하거나 리소스 집약적인 세그먼트 쿼리를 처리하는 데 더 많은 시간이 필요할 수 있습니다. **수행할 작업:** + **대기 및 재시도**: 오류 메시지는 몇 분 정도 기다렸다가 다시 시도할 것을 제안합니다. 이렇게 하면 시스템이 임시 문제를 해결할 수 있습니다. + **세그먼트 수동 생성**: 세그먼트가 즉시 필요한 경우 세그먼트 빌더를 사용하여 수동으로 생성하도록 선택할 수 있습니다. **재시도 방법:** 1. 몇 분간 기다리십시오. 1. 채팅 인터페이스 하단에서 **새 대화**를 선택합니다. 1. 새 대화를 시작하고 세그먼트 생성 프롬프트를 다시 입력합니다. **모범 사례** + 여러 번 시도한 후에도 오류가 지속되면 세그먼트 기준을 단순화하거나 더 작고 관리 가능한 요청으로 분류하는 것이 좋습니다. + 시스템 오버로드의 원인이 될 수 있으므로 빠르게 연속해서 반복 요청하지 않도록 하세요. + 문제가 계속되면 고객 지원 센터에 문의하여 추가 지원을 받으세요. 이 오류는 일반적으로 일시적이며 제공된 지침을 따르면 원하는 세그먼트를 성공적으로 생성할 수 있습니다. ## 알려진 제한 사항 세그먼트 AI 어시스턴트를 효과적으로 사용하려면 데이터 처리 수명 주기를 이해하는 것이 중요합니다. 이 섹션에서는 비즈니스 사용자가 데이터 통합의 다양한 단계에서 기대할 수 있는 사항과 세그먼트 제안에 미치는 영향을 간략하게 설명합니다. **데이터 처리 및 품질 영향:** 세그먼트 AI 어시스턴트는 초기 데이터 수집과 사후 처리라는 두 가지 주요 단계를 통해 발전합니다. 초기 수집 중에 시스템은 실제 속성 값을 완전히 활용하지 못하여 프롬프트 해석에 더 많이 의존할 수 있습니다. 예를 들어 VIP *고객*을 위한 프롬프트는 데이터의 기존 *골드* 티어를 사용하는 대신 *VIP* 세그먼트를 제안할 수 있습니다. 처리가 완료된 후 시스템은 실제 속성 값을 활용하여 세그먼트를 더 정확하게 생성하고 프롬프트 해석에 대한 의존도를 줄이며 전체 세분화 품질을 개선합니다. **참고** 고급 기능에 의존하기 전에 완전한 데이터 처리에 충분한 시간을 둡니다. 고객 프로필 데이터를 정기적으로 업데이트합니다. 세그먼트 정확도는 Amazon Connect Customer Profiles에서 고객 데이터의 완전성과 최신성에 따라 달라집니다. 시스템에서 응답에 누락된 속성에 플래그를 지정합니다. **시스템 성능:** 대용량 기간에는 세그먼트 생성이 지연될 수 있습니다. 시스템은 일반적인 워크로드에 최적화되어 있지만 세분화 요구 사항이 광범위한 기업은 그에 따라 프로세스를 조정해야 할 수 있습니다. **속성 가용성**: 생성된 세그먼트의 품질은 Amazon Connect Customer Profiles에서 사용 가능한 고객 데이터에 따라 달라집니다. 고객 프로필 데이터가 더 포괄적이고 up-to-date일수록 프롬프트를 해석하고 관련 세그먼트를 정의하는 데 시스템이 더 정확할 수 있습니다. 존재하지 않는 속성이 있는 경우 누락된 속성이 포함된 메시지를 반환합니다.  **프롬프트 복잡성**: 매우 복잡하거나 미묘한 세그먼트 정의의 경우 자연어 처리에 제한이 있을 수 있습니다. 고객은 비교적 간단한 프롬프트로 시작하고 기능에 대한 경험을 얻으면서 복잡성을 점진적으로 높여야 합니다. **세그먼트 개선**: 시스템 생성 세그먼트는 훌륭한 출발점이지만 고객은 세부 정보를 검토하고 개선하여 세그먼트가 비즈니스 목표에 완벽하게 부합하는지 확인해야 할 수 있습니다. 분할 인터페이스를 사용하면 초기 생성 후 완전히 사용자 지정할 수 있습니다. **성능 및 규모 조정**: 동시성이 높으면 언어 모델이 각 프롬프트를 처리해야 하므로 세그먼트 생성 프로세스에 약간의 지연 시간이 있을 수 있습니다. 이 시스템은 일반적인 세분화 워크로드를 처리하도록 설계되었지만 세분화 요구가 매우 높은 고객은 그에 따라 워크플로를 조정해야 할 수 있습니다. # Amazon Connect에서 고객 세그먼트 문제 해결 ## 고객 세그먼트 옵션이 왼쪽 탐색 패널에 표시되지 않음 Amazon Connect 관리자 웹 사이트 왼쪽 탐색 패널에 **고객 세그먼트** 옵션이 없는 경우 사용자의 보안 프로필에 **고객 세그먼트 - 보기** 권한이 있는지 확인합니다. 자세한 내용은 섹션을 참조하세요 [보안 프로필 권한을 할당하여 고객 세그먼트 관리](security-profile-customer-profile-segmentation.md). 권한이 업데이트된 후Amazon Connect 관리자 웹 사이트 페이지를 새로 고쳐 변경 사항을 반영합니다. ## CSV 내보내기 버튼을 사용할 수 없거나 내보내기 작업 시간이 초과됨 350,000개 이상의 프로필이 포함된 세그먼트 내보내기는 Amazon Connect 관리자 웹 사이트에서 지원되지 않습니다. 또는 명령줄 참조(CLI) 또는 SDK를 통해 `CreateSegmentSnapshot` API를 사용하여 이 유형의 세그먼트를 Amazon S3 버킷으로 내보내는 것이 좋습니다. ## 오류: 고유 속성 60개 한도에 도달했습니다. 이 오류는 세그먼트 정의의 고유 속성 수가 할당량을 초과할 때 발생합니다. 시작 잠재고객을 재귀적으로 포함하여 고유한 속성의 수가 계산됩니다. **Solutions** + 세그먼트 정의에서 잠재고객 필터를 제거하거나 대상 필터가 포함된 시작 잠재고객을 제거하여 고유한 속성 수를 줄입니다. + Service Quotas의 [할당량 증가 요청](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) - 세그먼트의 최대 고유 속성 수  기본 Service Quotas에 대한 자세한 내용은 [Amazon Connect Customer Profiles Service Quotas](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles)를 참조하세요. ## 오류: 계산된 고유 속성 10개 한도에 도달했습니다. 이 오류는 세그먼트 정의의 고유한 계산된 속성 수가 할당량을 초과할 때 발생합니다. 시작 잠재고객을 재귀적으로 포함하여 고유한 속성의 수가 계산됩니다. **Solutions** + 세그먼트 정의에서 계산된 속성에 대한 잠재고객 필터를 제거하거나 계산된 속성에 대한 잠재고객 필터가 포함된 시작 잠재고객을 제거하여 고유한 계산된 속성 수를 줄입니다. + Service Quotas의 [할당량 증가 요청](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) - 세그먼트 내 고유 계산 속성의 최대 개수. 기본 Service Quotas에 대한 자세한 내용은 [Amazon Connect Customer Profiles Service Quotas](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles)를 참조하세요. ## 오류: 잠재고객을 시작하는 깊이 제한인 5개에 도달했습니다. 이 오류는 시작 잠재고객 깊이가 할당량을 초과할 때 발생합니다. 깊이는 잠재고객 그룹의 모든 시작 잠재고객에 대해 재귀적으로 계산됩니다. 예를 들어 세그먼트 '적격 임대 업그레이드'를 시작 잠재고객으로 선택하고 세그먼트 '적격 임대 업그레이드'에 다른 세그먼트가 시작 잠재고객으로 있는 경우 깊이는 2가 됩니다. **Solution** + 깊이 중첩된 시작 잠재고객이 포함된 잠재고객 그룹에서 하나 이상의 시작 잠재고객을 제거합니다. 기본 서비스 할당량에 대한 자세한 내용은 [Amazon Connect Customer Profiles Service Quotas](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles)를 참조하세요. # Amazon Connect Customer Profiles에서 프로파일 탐색기 설정 Amazon Connect Customer Profiles Explorer는 고객에 대한 포괄적인 360° 보기를 제공하는 동적 all-in-one 대시보드입니다. 조각화된 고객 데이터를 통합하고 조직이 데이터 표시를 사용자 지정하고, 상호 작용을 추적하고, 고객 정보를 실행 가능한 인사이트로 변환하여 비즈니스 가치와 고객 충성도를 높일 수 있습니다. 여행 및 숙박과 같은 산업의 조직은 프로파일 탐색기를 사용하여 이 직관적인 인터페이스를 통해 고객을 더 잘 이해하고 고객과 소통할 수 있습니다. + 실시간 검색 결과와 함께 여러 식별자(이메일, 전화, 예약 참조 등)를 동시에 사용하여 **고객을 즉시 찾습니다**. + **보기를 사용자 지정**하여 특정 비즈니스 요구 사항에 가장 관련성이 높은 정보의 우선순위를 지정하고, 사용자가 정의한 가장 관련성이 높은 고객 데이터를 강조 표시하는 도메인별 레이아웃을 설계합니다. + 대화형 시각화 및 데이터 디스플레이를 사용하여 인구 통계 데이터, 커뮤니케이션 기록, 행동 상호 작용, 세그먼트 멤버십을 포함한 **전체 고객 컨텍스트에 액세스**합니다. + 핵심 패턴과 맞춤형 행동 추론을 강조하는 고객 요약과 함께 **AI 기반 인사이트를 활용합니다**. ![\[프로파일 탐색기 대시보드.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/customer-profiles-profile-explorer-1.png) **Topics** + [프로필 탐색기 활성화](enabling-profile-explorer.md) + [시작하기](getting-started-profile-explorer.md) + [레이아웃 정의](layout-definition.md) + [에이전트 Workspace에 프로필 탐색기 추가](add-profileexplorer-to-agentworkspace.md) # 프로필 탐색기 활성화 다음 단계를 통해 관리자 및 사용자에 대해 프로파일 탐색기를 활성화할 수 있습니다. 이 프로세스에는 레이아웃 구성과 보기 액세스 모두에 대한 권한 설정이 포함됩니다. **Topics** + [관리자가 레이아웃을 정의할 수 있도록 활성화](#enable-administrators-define-layout) + [사용자가 프로필 탐색기를 볼 수 있도록 활성화](#enable-users-view-profile-explorer) + [설정 확인](#verify-setup) ## 관리자가 레이아웃을 정의할 수 있도록 활성화 관리자는 프로파일 탐색기 레이아웃을 생성하고 편집하려면 특정 권한이 필요합니다. + 프로파일 탐색기 보안 프로파일 내에서 다음 권한을 할당합니다. + **프로필 탐색기 - 편집**: 기존 프로필 탐색기 레이아웃을 수정할 수 있습니다. + **프로필 탐색기 - 생성**: 프로필 탐색기 레이아웃 생성을 활성화합니다. + **프로필 탐색기 - 보기**: 구성된 프로필 탐색기 레이아웃을 볼 수 있는 액세스를 활성화합니다. ![\[사용자가 프로필 탐색기 레이아웃을 생성, 편집 및 볼 수 있는 권한을 추가합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/enable-administrators-define-layout-1.png) ## 사용자가 프로필 탐색기를 볼 수 있도록 활성화 사용자는 프로필 탐색기 레이아웃에 액세스하고 상호 작용하려면 적절한 권한이 필요합니다. + 프로파일 탐색기 보안 프로파일 내에서 다음 권한을 할당합니다. + **프로필 탐색기 - 보기**: 구성된 프로필 탐색기 레이아웃을 볼 수 있는 액세스를 활성화합니다. ![\[사용자가 프로필 탐색기 레이아웃을 볼 수 있도록 권한을 추가합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/enable-users-view-profile-explorer-1.png) ## 설정 확인 프로파일 탐색기를 성공적으로 활성화할 수 있는지 확인하려면: 관리자로 로그인하여 다음을 수행할 수 있는지 확인합니다. + 프로필 탐색기 페이지에 액세스합니다. + 프로파일 탐색기 레이아웃을 생성하고 수정합니다. 일반 사용자로 로그인하여 다음을 수행할 수 있는지 확인합니다. + 프로필 탐색기에 액세스합니다. + 프로파일 탐색기 레이아웃을 봅니다. + 활성화된 기능과 상호 작용합니다. # Amazon Connect Customer Profiles 프로필 탐색기 시작하기 프로파일 탐색기를 시작하고 인터페이스의 기본 사항을 알아봅니다. **Topics** + [레이아웃 제어](layout-controls.md) + [탐색기 레이아웃 편집](editing-explorer-layout.md) + [탐색기 레이아웃 저장](saving-explorer-layout.md) # 레이아웃 제어 ![\[사용자가 프로필 탐색기 레이아웃을 볼 수 있도록 권한을 추가합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/layout-controls-1.png) 프로필 탐색기 시작 콘솔. 1. 태그 편집 1. 위젯 추가 1. 레이아웃 작업 ## 태그 편집 탭 컨트롤을 사용하여 대시보드를 논리적 섹션으로 구성합니다. + **1a. 탭 추가**: 새 탭을 생성하여 고객 데이터의 다양한 측면을 구분합니다. + **1b. 탭 제거**: 레이아웃에서 불필요한 탭을 삭제합니다. + **1c. 탭 이름 바꾸기**: 콘텐츠를 반영하도록 탭 이름 사용자 지정합니다. + **1d. 탭 재정렬**: 탭을 끌어서 놓아 원하는 순서로 정렬합니다. ![\[탭 편집 팝업.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/layout-controls-2.png) ## 위젯 추가 다양한 데이터 시각화 위젯을 사용하여 활성 탭을 개선합니다. ### 사용 가능한 위젯 + 기본 위젯 + [생성형 AI 요약](default-widgets.md#generative-ai-summary) + [고객 정보](default-widgets.md#customer-information) + [계산된 속성](default-widgets.md#calculated-attribute) + [연락처](default-widgets.md#contacts) + [Cases](default-widgets.md#cases-cp) + [주문](default-widgets.md#orders-cp) + [자산](default-widgets.md#assets-cp) + 사용자 지정 위젯 + [표](custom-widgets.md#table-widget) + [키-값 페어:](custom-widgets.md#key-value-pair) + [주요 지표](custom-widgets.md#key-metric) + [도넛 차트](custom-widgets.md#donut-chart) 사용하려는 위젯을 선택하고 탐색을 시작하기만 하면 됩니다. ## 레이아웃 작업 전체 대시보드 구성을 관리합니다. + **레이아웃 저장**: 현재 대시보드 구성 보존 ![\[레이아웃 저장 팝업.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/layout-controls-3.png) **참고** 모든 변경 사항은 저장될 때까지 초안으로 표시됩니다. # 탐색기 레이아웃 편집 위젯 및 배치를 관리하기 위한 간단하고 직관적인 제어를 통해 프로파일 탐색기 레이아웃을 사용자 지정합니다. ## 위젯 제어 각 위젯은 오른쪽 상단 모서리에 점 3개 메뉴가 있어 두 가지 기본 옵션을 제공합니다. + **1A 편집**: 해당 특정 위젯의 구성 패널을 엽니다. + **1B 제거**: 레이아웃에서 위젯을 삭제합니다. ![\[탐색기 레이아웃에 대한 팝업을 편집하거나 제거합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/widget-controls-1.png) ## 위젯 사용자 지정 + **끌어서 놓기**: 대시보드의 아무 곳에나 위젯 재배치 + **크기 조정**: 위젯 테두리를 선택하고 드래그하여 차원 조정 + **구성**: 각 위젯 유형별 편집 패널을 통해 세부 설정에 액세스합니다. ![\[탐색기 레이아웃에서 위젯을 사용자 지정하고 재정렬합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/widget-customization-1.png) **참고** 각 위젯 유형에는 고유한 구성 옵션이 있습니다. 특정 위젯 설정에 대한 자세한 내용은 위젯 설명서를 참조하세요. ## 새 위젯 추가 레이아웃에 새 구성 요소를 추가하려면 제어판에서 **위젯 추가** 버튼을 사용합니다. # 탐색기 레이아웃 저장 프로파일 탐색기 레이아웃 구성을 저장하고 관리하는 방법입니다. ## 레이아웃 지속성 프로파일 탐색기 레이아웃에 대한 변경 사항을 저장해야 유지됩니다. 페이지에서 나가거나 브라우저를 새로 고칠 때 저장되지 않은 변경 사항이 손실됩니다. ## 기본 레이아웃 각 프로필 탐색기 구현에는 하나의 기본 레이아웃이 포함됩니다. 이는 조직의 기본 구성 역할을 하며 필요에 따라 수정할 수 있습니다. ## 변경 내용을 저장합니다. 레이아웃 수정 사항을 저장하려면 다음을 수행합니다. 1. 레이아웃 작업 메뉴에서 **저장**을 선택합니다. 1. 저장 대화 상자에서 변경 사항을 확인합니다. 1. 저장이 완료되면 모든 사용자에 대해 레이아웃이 업데이트됩니다. ![\[탐색기 레이아웃에 레이아웃 대화 상자를 저장합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/saving-changes-1.png) **참고** 레이아웃 변경 사항을 저장하려면 적절한 권한이 필요합니다. 필요한 권한에 대한 자세한 내용은 [프로필 탐색기 활성화](enabling-profile-explorer.md) 섹션을 참조하세요. # 레이아웃 정의 프로파일 탐색기 레이아웃의 구조 및 구성 요소 이해합니다. **Topics** + [작동 방식](how-it-works.md) + [위젯](widgets.md) # 작동 방식 프로필 탐색기는 고객 정보를 표시하는 다양한 위젯을 제공하며, 레이아웃은 대시보드의 전체 구조와 구성을 나타내는 JSON 정의로 저장됩니다. 시각적 레이아웃의 각 위젯 및 구성 요소는 이 정의 내의 특정 JSON 블록에 해당합니다. ## 핵심 구성 요소 레이아웃 정의의 모든 구성 요소는 다섯 가지 공통 요소로 구성됩니다. + **유형** + 구성 요소 범주를 정의합니다. + 구성 요소가 렌더링되는 방식을 결정합니다. + 예: BoardItem, Table, KeyValuePair + **Id** + 각 구성 요소의 고유 식별자 + 구성 요소 추적 및 업데이트에 사용 + 빌더에서 구성 요소가 생성될 때 자동으로 생성됩니다. + **Props** + 구성 요소별 속성 + 모양 및 동작 제어 + 구성 설정 포함 + **하위 항목** + 중첩된 구성 요소 또는 콘텐츠 + 계층적 관계 정의 + 여러 하위 구성 요소를 포함할 수 있음 + **DataSource** + 데이터 오리진을 지정합니다. + 데이터 검색 파라미터를 정의합니다. + 구성 요소에 대한 데이터 바인딩 제어 ## 레이아웃 구성 요소 정의 예 다음은 대시보드 테이블 구성 요소의 샘플 JSON 구조입니다. ``` { "Id": "unique-identifier", "Type": "BoardItem", "Props": {}, "Children": [ { "Id": "unique-identifier", "Type": "Table", "Props": {}, "Children": [ { "Id": "unique-identifier", "Type": "TextContent", "Props": {}, "Children": ["string"] } ] } ], "DataSource": [ { "Type": "source-type", "Params": {} } ] } ``` ## 동적 데이터 구성 프로파일 탐색기는 템플릿 표현식을 사용하여 구성 요소 내에서 Customer Profiles 데이터에 동적으로 액세스하고 표시합니다. ### 단일 값 지원 키 값 페어 및 주요 지표와 같은 구성 요소의 경우 다음에 액세스할 수 있습니다. #### 표준 프로필 정보 ``` {{Customer.}} ``` 사용 예: + `{{Customer.FirstName}}` + `{{Customer.LastName}}` + `{{Customer.PhoneNumber}}` #### 계산된 속성 ``` {{Customer.CalculatedAttributes.}} ``` 사용 예: + `{{Customer.CalculatedAttributes._cases_count}}` + `{{Customer.CalculatedAttributes._new_customer}}` ### 테이블 형식 데이터 지원 구문 #### 계산된 속성 ``` {{Customer.CalculatedAttributes.DisplayName}} ``` ``` {{Customer.CalculatedAttributes.CalculatedAttributeDefinitionName}} ``` #### Segments ``` {{Customer.CalculatedAttributes.DisplayName}} ``` ``` {{Customer.CalculatedAttributes.SegmentDefinitionName}} ``` #### 프로필 객체 ``` {{Customer.ObjectAttributes..}} ``` **사용 예**: + `{{Customer.ObjectAttributes.CTR.contactId}}` + `{{Customer.ObjectAttributes.Order.orderId}}` ### 구현 예제 #### 단일 값 구성 요소 ``` { "Type": "KeyValuePair", "Props": { "Items": [ { "Label": { "Content": { "Type": "TextContent", "Children": ["Customer Name"] } }, "Value": { "Content": { "Type": "TextContent", "Children": ["{{Customer.FirstName}}"] } } } ] } } ``` #### 테이블 형식 구성 요소 ``` { "Type": "Table", "Props": { "ColumnDefinitions": [ { "Cell": { "Content": { "Type": "TextContent", "Children": ["{{Customer.ObjectAttributes.CTR.contactId}}"] } }, "Header": "Contact ID" } ] } } ``` **참고** 참조하는 속성, 객체 및 세그먼트가 레이아웃에서 사용하기 전에 Customer Profiles 구성에 존재하는지 확인합니다. # 위젯 프로파일 탐색기에서 사용할 수 있는 다양한 위젯 유형을 살펴봅니다. ## 개요 프로파일 탐색기의 위젯은 레이아웃 정의 내의 JSON 구성 요소로 빌드된 복합 요소입니다. 이러한 위젯은 복잡한 JSON 구조를 나타내지만 UI 빌더는 기술 구성을 자동으로 처리하여 대시보드 관리를 간단하고 액세스 가능하게 만듭니다. **Topics** + [개요](#widgets-overview) + [사용 가능한 위젯](#available-widgets) + [기본 위젯](default-widgets.md) + [사용자 지정 위젯](custom-widgets.md) ## 사용 가능한 위젯 + 기본 위젯 + [생성형 AI 요약](default-widgets.md#generative-ai-summary) + [고객 정보](default-widgets.md#customer-information) + [계산된 속성](default-widgets.md#calculated-attribute) + [연락처](default-widgets.md#contacts) + [Cases](default-widgets.md#cases-cp) + [주문](default-widgets.md#orders-cp) + [자산](default-widgets.md#assets-cp) + 사용자 지정 위젯 + [표](custom-widgets.md#table-widget) + [키-값 페어:](custom-widgets.md#key-value-pair) + [주요 지표](custom-widgets.md#key-metric) + [도넛 차트](custom-widgets.md#donut-chart) # 기본 위젯 프로파일 탐색기는 Customer Profiles 데이터와 원활하게 작동하도록 설계된 사전 구성된 위젯 모음과 함께 제공됩니다. 이러한 기본 위젯은 최소한의 설정으로 즉각적인 가치를 제공하므로 클릭 몇 번으로 정교한 대시보드를 구축할 수 있습니다. ![\[탐색기 레이아웃에 기본 위젯을 추가합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/default-widgets-1.png) ## 즉시 사용 가능한 위젯 + [생성형 AI 요약](#generative-ai-summary) + [고객 정보](#customer-information) + [계산된 속성](#calculated-attribute) + [연락처](#contacts) + [Cases](#cases-cp) + [주문](#orders-cp) + [자산](#assets-cp) **참고** 이러한 위젯은 미리 구성되어 있지만 특정 요구 사항에 더 잘 맞게 위젯을 사용자 지정할 수 있습니다. 쉽게 온보딩할 수 있는 출발점 역할을 합니다. ## 생성형 AI 요약 프로필 탐색기는 주요 행동 패턴을 강조하는 간결한 요약을 생성하는 기본 AI 기반 고객 인사이트를 제공하고, 상호 작용 기록을 기반으로 맞춤형 고객 인사이트를 제공하고, 고객 360 데이터의 실행 가능한 권장 사항을 표시합니다. AI 생성 요약은 조직이 여러 고객 접점의 패턴을 식별하고, 각 고객에 맞는 맞춤형 행동 인사이트를 제공하고, 향상된 고객 경험과 향상된 충성도를 지원하여 데이터 기반 결정을 내리는 데 도움이 됩니다. ![\[생성형 AI 요약 위젯.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/generative-ai-summary-1.png) ## 고객 정보 고객 정보 위젯은 키-값 페어 구성 요소를 사용하여 표준 고객 프로필 데이터를 명확하고 체계적으로 보여 줍니다. 이 기본 위젯은 스캔하기 쉬운 형식으로 필수 고객 정보를 자동으로 표시합니다. ### 개요 이 위젯은 키 값 페어 구성 요소를 활용하여 고객 속성을 구조화된 레이아웃으로 표시합니다. + 이름 + 성 + 이메일 주소 + 전화번호 + 주소 + 계좌 번호 + 프로필 ID ### 데이터 위젯은 Customer Profiles 도메인에 자동으로 연결하고 표준 프로필 속성에서 정보를 가져옵니다. 기본 기능에는 추가 구성이 필요하지 않습니다. **참고**:이 위젯은 표준 프로필 속성으로 사전 구성되어 제공되지만 특정 요구 사항에 따라 표준 프로필의 어떤 속성을 표시할지 사용자 지정할 수 있습니다. #### 자세히 알아보기 + [표준 프로필 정의](standard-profile-definition.md) + 키-값 페어: ## 계산된 속성 계산된 속성 위젯을 사용하면 고객 프로필의 계산된 속성의 데이터를 활용하여 주요 지표 구성 요소를 표시할 수 있습니다. ### 개요 계산된 속성 위젯을 사용하면 고객 프로필의 계산된 속성의 데이터를 활용하여 주요 지표 구성 요소를 표시할 수 있습니다. ### 구성 요소 기능 + 계산된 지표를 단일 값 지표로 표시 ### 사용 사례의 예는 다음과 같습니다. + 캠페인 배달 + 열린 사례 + 평균 통화 시간 + 채널 기본 설정 ### 구성 계산된 속성을 선택하고 원하는 표시 형식을 선택하기만 하면 됩니다. **참고** 계산된 속성을 이 위젯에서 사용하려면 먼저 Customer Profiles 도메인에서 구성해야 합니다. **자세히 알아보기** + 주요 지표 + [계산된 속성 설정](customerprofiles-calculated-attributes-admin-website.md) ## 연락처 테이블 JSON 구성 요소를 사용하여 구축된 고객 응대 위젯은 Customer Profiles 고객 응대 객체 데이터를 정리된 테이블 형식으로 표시합니다. 이 위젯은 Customer Profiles CTR 데이터에 자동으로 연결하여 주요 연락처 정보와 상호 작용 기록을 표시합니다. ### 특성 + 모든 고객 응대 이벤트 보기 + 연락처 기록 정렬 및 필터링 + 표시된 연락처 필드 사용자 지정 + 세부 연락처 정보 액세스 Customer Profiles CTR 객체에 대한 자세한 내용은 [Amazon Connect Customer Profiles의 연락처 레코드 템플릿](ctr-contact-record-template.md) 섹션을 참조하세요. ## Cases 테이블 JSON 구성 요소를 사용하여 구축된 사례 위젯은 Customer Profiles 사례 객체 데이터를 정리된 테이블 형식으로 표시합니다. 이 위젯은 Customer Profiles 사례 데이터에 자동으로 연결하여 지원 상호 작용 및 사례 관리 세부 정보를 표시합니다. ### 특성 + 모든 고객 사례 보기 + 사례 레코드 정렬 및 필터링 + 표시된 사례 필드 사용자 지정 + 자세한 사례 정보 액세스 Customer Profiles Case 객체에 대한 자세한 내용은 [Customer Profiles의 표준 사례에 객체 유형 매핑](object-type-mapping-standard-case.md) 섹션을 참조하세요. ## 주문 테이블 JSON 구성 요소를 사용하여 구축된 주문 위젯은 Customer Profiles 주문 객체 데이터를 정리된 테이블 형식으로 표시합니다. 이 위젯은 Customer Profiles 주문 데이터에 자동으로 연결하여 구매 내역 및 거래 세부 정보를 표시합니다. ### 특성 + 모든 고객 주문 이벤트 보기 + 주문 레코드 정렬 및 필터링 + 표시된 순서 필드 사용자 지정 + 자세한 주문 정보 액세스 Customer Profiles Order 객체에 대한 자세한 내용은 [Amazon Connect Customer Profiles의 표준 주문에 객체 유형 매핑](object-type-mapping-standard-order.md) 섹션을 참조하세요. ## 자산 테이블 JSON 구성 요소를 사용하여 구축된 자산 위젯은 Customer Profiles 자산 객체 데이터를 정리된 테이블 형식으로 표시합니다. 이 위젯은 고객 프로필 자산 데이터에 자동으로 연결하여 고객 소유 제품 및 서비스를 보여 줍니다. ### 특성 + 모든 고객 자산 레코드 보기 + 자산 데이터 정렬 및 필터링 + 표시된 자산 필드 사용자 지정 + 세부 자산 정보 액세스 Customer Profiles Asset 객체에 대한 자세한 내용은 [Customer Profiles의 표준 자산에 객체 유형 매핑](object-type-mapping-standard-asset.md) 섹션을 참조하세요. # 사용자 지정 위젯 특정 비즈니스 요구 사항에 맞게 처음부터 맞춤형 대시보드 구성 요소를 생성합니다. 사용자 지정 위젯을 사용하면 사전 정의된 데이터 없이 고유한 시각화를 구축할 수 있습니다. ![\[프로필 탐색기 레이아웃에 고객 위젯을 추가합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/custom-widgets-1.png) ## 사용 가능한 사용자 지정 구성 요소 + [표](#table-widget) + [키-값 페어:](#key-value-pair) + [주요 지표](#key-metric) + [도넛 차트](#donut-chart) ## 사용자 지정 위젯 빌드 **각 사용자 지정 위젯은 다음과 같이 구성할 수 있습니다.** + 사용자 지정 데이터 소스 + 사용자 지정 디스플레이 + 사용자 지정 필드 + 사용자 지정 항목 상호 작용 ## 표 사용자 지정 테이블 구성 요소는 상호 작용 및 구성을 위한 고급 기능과 함께 테이블 형식으로 데이터를 표시할 수 있는 유연한 구성 옵션을 제공합니다. ### 특성 1. **열 구성** + 사용자 지정 열 헤더 정의 + 각 열에 대한 데이터 지정 + 데이터 형식 지정 옵션 설정 + 열 배치 정의 1. **필터링** + 테이블 내에서 항목을 빠르게 필터링 1. **연결** + 리소스 링크 연결 + 다음에 대한 원활한 탐색: + Segments + 계산된 속성 + 새 탭에서 열기 + **외부 URL 링크** + 행 항목 값을 선택할 수 있는 URL로 변환 + 새 탭에서 열기 + 행 데이터를 기반으로 동적으로 링크 생성 + 서랍 보기 링크 + 측면 서랍에서 세부 정보 열기 + 페이지를 나가지 않고 전체 레코드 세부 정보 보기 1. 데이터 구성 + 그룹화 + 특정 필드 이름을 기준으로 행 그룹화 + 영구 그룹 설정 + 정렬 + 열 필드를 기준으로 정렬 + 오름차순 정렬 + 영구 정렬 설정 **그림 1** ![\[사용자 지정 테이블 위젯 편집 예제.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/table-features-1.png) **그림 2** ![\[또 다른 사용자 지정 테이블 위젯 편집 예제입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/table-features-2.png) ### 구성의 예 ``` { "Type": "Table", "Props": { "ColumnDefinitions": [ { "Header": "Table column header" "Cell": { "Content": { "Props": { "Variant": "Link", "LinkOptions": { "LinkType": "Drawer" } }, "Type": "TextContent", "Children": ["string"] } }, } ] } } ``` ## 키-값 페어: 키 값 페어 구성 요소를 사용하면 유연하고 읽기 쉬운 형식으로 관련 데이터 포인트의 구성된 디스플레이를 생성할 수 있습니다. ### 개요 사용자 지정 키-값 관계를 정의하여 동적 데이터 표시를 생성합니다. 이 구성 요소는 다음과 같은 속성 페어를 표시하는 데 특히 유용합니다. + 사용자 지정 세부 정보 + 계정 정보 ### 특성 1. **대화형 링크 옵션** + 리소스 링크 연결 + 관련 리소스에 직접 연결 + 다음에 대한 원활한 탐색: + 계산된 속성 + Segments + 새 탭에서 열기 + 외부 URL 링크 + 항목 값을 선택할 수 있는 URLs로 변환 + 새 탭에서 열기 + 서랍 보기 링크 + 측면 서랍에서 세부 정보 열기 + 페이지를 나가지 않고 전체 세부 정보 보기 1. 열 구성 + 키-값 페어의 1\$14개 열 정의 1. 논리적 그룹화에서 페어 구성 **그림 1** ![\[사용자 지정 키 값 페어 위젯 편집 예제.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/key-value-pair-features-1.png) **그림 2** ![\[또 다른 사용자 지정 키 값 페어 위젯 편집 예제입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/key-value-pair-features-2.png) ### 구성의 예 ``` { "Type": "KeyValuePair", "Id": "UniqueId", "Props": { "Columns": 2, "Items": [ { "Label": { "Content": { "Type": "TextContent", "Id": "UniqueId", "Props": { "FontWeight": "bold" }, "Children": ["Profile id"] } }, "Value": { "Content": { "Type": "TextContent", "Id": "UniqueId", "Props": {}, "Children": ["[string]"] } } } ] } } ``` **참고** 이 구성 요소는 현재 UI 빌더에서 `ProfileObjects`를 지원하지 않습니다. ## 주요 지표 주요 지표 구성 요소를 사용하면 중요한 비즈니스 지표, KPI' 및 중요 통계를 쉽게 이해할 수 있는 형식으로 눈에 띄게 표시할 수 있습니다. ### 개요 중요한 데이터 포인트, 추세 또는 상태 표시기를 강조 표시하는 고가시성 지표 디스플레이를 생성합니다. 이 구성 요소는 다음을 보여 주는 데 적합합니다. + 성과 지표 + 중요 측정 + 상태 요약 + 추세 지표 ### 특성 1. **대형 디스플레이 텍스트** 1. **지표 형식** 1. **대화형 링크 옵션** + 리소스 링크 연결 + 관련 리소스에 직접 연결 + 다음에 대한 원활한 탐색: + 계산된 속성 + Segments + 새 탭에서 열기 + 외부 URL 링크 + 항목 값을 선택할 수 있는 URLs로 변환 + 새 탭에서 열기 + 서랍 보기 링크 + 측면 서랍에서 세부 정보 열기 + 페이지를 나가지 않고 전체 세부 정보 보기 1. **지표 레이아웃 구성** **그림 1** ![\[사용자 지정 주요 지표 위젯 편집 예제.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/key-metric-features-1.png) **그림 2** ![\[또 다른 사용자 지정 주요 지표 위젯 편집 예제입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/key-metric-features-2.png) ### 구성의 예 ``` { "Type": "KeyMetrics", "Props": { "MetricDefinitions": [ { "MetricLabel": "Total Revenue", "MetricValue": { "Content": { "Type": "TextContent", "Props": { "Format": "USD", "FontSize": "large", "FontWeight": "bold" }, "Children": ["[string]"] } }, "Columns": 1 } ] } } ``` **참고** 이 구성 요소는 현재 UI 빌더에서 `ProfileObjects`를 지원하지 않습니다. ## 도넛 차트 도넛 차트 구성 요소를 사용하면 원형 도넛 차트를 통해 감정 점수를 시각화할 수 있습니다. ### 개요 사용자 지정 점수 기준을 정의하여 동적 감정 시각화를 생성합니다. 이 구성 요소는 다음을 표시하는 데 특히 유용합니다. + 성공 지표 + 달성률 + 위험 평가 + 성과 지표 ### 특성 1. 감정 분석 옵션 + 긍정적인 감정 + 0부터 시작 + 기준을 기준으로 성과를 추적합니다. + 사용자 지정 포인트 값 + 색상으로 구분된 세그먼트 + 충족되지 않은 조건의 경우 회색 + 성공률 백분율을 표시합니다. + 부정적인 감정 + 최대값부터 시작 + 공제 추적: + 색상으로 구분된 세그먼트 + 포인트 감소 시스템 + 나머지 값은 녹색 + 최종 점수를 표시합니다. 1. 계산된 속성 값 1. 연산자 옵션 + 같음 + 같지 않음 + 보다 큼 + 보다 작음 1. 값 조건 1. 조건당 할당된 포인트 **그림 1: 긍정적인 감정 예제** ![\[긍정적인 감정 위젯 편집 예제.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/donut-chart-features-1.png) **그림 2: 부정적인 감정 예제** ![\[부정적인 감정 위젯 편집 예제.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/donut-chart-features-2.png) ### 구성의 예 ``` { "Type": "DonutChart", "Props": { "Variant": "PositiveSentiment", "ConditionDefinitions": [ { "Title": "Customer Satisfaction", "Color": "#4CAF50", "CalculatedAttribute": "satisfaction_score", "Operator": "GREATER_THAN", "ValueCondition": 8, "Points": 10 } ] } } ``` **참고** **Donuts는 현재 계산된 속성만 데이터 소스로 지원합니다.** **모든 조건 정의에는 제목, 색상, 계산된 속성, 연산자, 값 조건 및 점 값이 포함되어야 합니다.** # 에이전트 Workspace에 프로필 탐색기 추가 기본적으로 적절한 [보안 프로필 권한이](enabling-profile-explorer.md) 있는 사용자는 Amazon Connect 관리자 웹 사이트에서 프로필 탐색기를 볼 수 있습니다. 에이전트가 에이전트 Workspace에서 프로필 탐색기에 액세스할 수 있도록 할 수도 있습니다. 이 주제에서는 이를 수행하는 방법을 설명합니다. 다음 이미지는 에이전트 Workspace에서 프로필 탐색기의 예제를 보여 줍니다. ![\[에이전트 Workspace, 프로필 탐색기 탭.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/profile-explorer-agent-workspace.png) ## 에이전트와 공유할 프로필 탐색기 레이아웃 생성 다음은 대략적인 개요입니다. 1. 프로필 탐색기 레이아웃을 생성할 수 있는 [보안 프로필 권한](enabling-profile-explorer.md)이 있는지 확인합니다. 1. [Amazon Connect Customer Profiles 프로필 탐색기 시작하기](getting-started-profile-explorer.md)의 지침에 따라 에이전트와 공유할 레이아웃을 생성하고 저장합니다. ## Amazon Connect에 프로파일 탐색기를 통합으로 추가 1. Amazon Connect 콘솔의 왼쪽 탐색에서 다음 이미지와 같이 **통합**을 선택합니다. ![\[Amazon Connect 콘솔, 통합 메뉴 항목.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/integrations.png) 1. **통합** 페이지에서 **통합 추가**를 선택합니다. 1. **통합 추가** 페이지의 **기본 정보** 섹션에서 다음 필드를 작성합니다. 1. **표시 이름**: 애플리케이션의 기억하기 쉬운 이름입니다. **이 이름은 에이전트 Workspace의 탭에서 에이전트에게 표시됩니다**. 보안 프로필에도 표시됩니다. 나중에 돌아와서 이 이름을 변경할 수 있습니다. 1. **통합 식별자**: 통합에 고유한 공식 이름입니다. 액세스 URL당 통합이 하나만 있는 경우 액세스 URL의 오리진을 사용하는 것이 좋습니다. 이 이름은 변경할 수 없습니다. 1. **설명(선택 사항)**: 필요에 따라 이 애플리케이션에 대한 설명을 입력할 수 있습니다. 이 설명은 에이전트에게 표시되지 않습니다. 1. **통합 유형**: **표준 애플리케이션을** 선택합니다. 1. **연락처 범위**: **연락처별**을 선택합니다. 수신 통화 지원에 필요한 설정입니다. 1. **초기화 타임아웃**: 워크스페이스와의 연결을 설정할 수 있는 밀리초 단위의 최대 시간입니다. 다음 이미지는 이러한 필드의 구성을 보여 줍니다. 초기화 제한 시간은 5초로 설정됩니다. ![\[에이전트 Workspace의 프로필 탐색기에 대해 구성된 기본 정보 섹션입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/add-integration.png) 1. **액세스** 섹션에서 다음 필드를 완료합니다. 1. **액세스 URL**: 애플리케이션이 호스팅되는 URL입니다. 로컬 호스트가 아닌 경우 URL은 https로 시작하는 보안 URL이어야 합니다. **중요** URL에는 `?_appLayoutMode=embedded`가 포함되어야 합니다. 예제: `https://{CONNECT_INSTANCE}/customer-profiles/profile-explorer?_appLayoutMode=embedded` `?_appLayoutMode=embedded`를 포함하지 않으면 Amazon Connect 관리자 웹 사이트의 왼쪽 탐색이 에이전트 워크스페이스에 나타납니다. 이 필드에 허용되는 항목에 대한 자세한 내용은 [통합](3p-apps.md#onboard-3p-apps-how-to-integrate) 섹션을 참조하세요. 1. **승인된 오리진 - 선택 사항**: 액세스 URL과 다른 경우 허용해야 하는 URL을 허용 목록에 추가합니다. 로컬 호스트가 아닌 경우 URL은 https로 시작하는 보안 URL이어야 합니다. 1. **권한** 및 **프레임 구성**이라는 다음 두 섹션을 완료하는 것은 선택 사항이며 프로필 탐색기를 에이전트 Workspace에 추가할 필요가 없습니다. 이러한 섹션에 대한 자세한 내용은 [통합](3p-apps.md#onboard-3p-apps-how-to-integrate) 섹션을 참조하세요. 1. **인스턴스 연결**: 에이전트가 사용 중인 인스턴스를 선택합니다. 이 계정 리전 내의 모든 인스턴스(들)에이 통합에 대한 액세스 권한을 부여할 수 있습니다. 1. **통합 추가**(Add Integrations)를 선택합니다. ## 에이전트에게 새 보안 프로필에 대한 권한 할당 이 단계에서는 새 통합에 액세스하고 Profile 탐색기에 권한을 볼 수 있는 권한을 에이전트에 할당해야 합니다. 1. Amazon Connect 관리자 웹 사이트에서 **에이전트** 보안 프로필로 이동합니다. 1. **보안 프로필 편집** 페이지에서 다음 권한을 할당합니다. + **Customer Profiles** - **프로필 탐색기** - **보기** + **에이전트 애플리케이션** - **통합 이름** - **액세스** 다음 이미지는 **프로파일 탐색기**라는 새 통합에 추가된 권한의 예를 보여줍니다. ![\[새 통합에 대한 보안 프로필 권한입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/profile-explorer-securityperms.png) ## 에이전트에게 새 애플리케이션을 고정하도록 지시합니다. 일반적인 통신 방법을 사용하여 에이전트에게 새 애플리케이션을 에이전트 Workspace에 고정하도록 지시합니다. 이렇게 하면 워크스페이스 인스턴스에서 프로파일 탐색기에 액세스할 수 있습니다. + 에이전트 Workspace에서 추가 아이콘을 선택한 후 다음 이미지와 같이 **탭 고정**을 선택합니다. ![\[에이전트 Workspace, 탭 고정 옵션.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/pin-tab.png) ## 지원되는 기능 위의 단계를 완료하면 프로파일 탐색기는 수신 고객 응대에 대한 조회를 지원합니다. 다음 모듈을 지원합니다. + 전화 및 채팅: 전체 지원 + 사용자 지정 연락처 속성: 프로필 탐색기가 읽는 사용자 정의 속성에 대한 전체 지원입니다. 흐름 내에서 사용자 정의 속성을 설정하여 모든 고객 사용 사례를 지원할 수 있습니다. 예제: ``` { "profileSearchKey": "_phone", "profileSearchValue": "" } ``` 자세한 내용은 [고객 프로필 자동 채우기](auto-pop-customer-profile.md) 단원을 참조하십시오. # 예측 인사이트(미리 보기) *예측 인사이트*(미리 보기)는 인공 지능을 사용하여 고객을 위한 맞춤형 제품 및 콘텐츠 추천을 생성하는 Amazon Connect Customer Profiles의 기능입니다. 고객 상호 작용 데이터를 분석하여 Predictive Insights는 모든 고객 접점에서 더 관련성이 높은 경험을 제공하는 데 도움이 됩니다. ## 예측 인사이트 작동 방식 Predictive Insights(미리 보기)는 AI 모델을 사용하여 고객 행동 패턴을 분석하고 실시간 권장 사항을 생성합니다. 서비스는 구매 기록 및 브라우징 활동과 같은 고객 상호 작용 데이터를 처리하여 패턴과 기본 설정을 식별합니다. + **1단계: **기존 데이터 커넥터를 사용하여 프로필에 상호 작용 데이터 추가를 통해 고객 상호 작용 데이터로 AI 모델 훈련 + **2단계:** Customer Profiles가를 통해 항목 데이터에 액세스할 수 있도록 S3에 항목 카탈로그 추가 AWS Management Console + **3단계:** 추천 유형(유사 항목, 자주 페어링되는 항목, 인기 항목)을 정의하여 추천 생성 + **4단계:** 에이전트 Workspace, 흐름 및 Connect AI 에이전트를 포함하여 Amazon Connect 에코시스템에 권장 사항 적용 ## 사전 조건 + **고객 프로필에서 데이터 스토어 활성화** Customer Profiles를 사용하여 AI 모델을 훈련하려면 데이터 스토어를 활성화해야 합니다. 자세한 내용은 Customer Profile Data Store에서 세부 정보를 참조하세요. + **KMS** 에서 데이터를 암호화하도록 Customer Profiles를 구성했습니다 AWS KMS key. + **보안 프로필** 예측 인사이트가 활성화된 상태에서 보기(예측 인사이트 나열 및 보기), 생성(권장 사항 생성), 삭제(권장 사항 삭제) 및 편집(권장 사항 업데이트) 권한을 지원하도록 보안 프로필을 구성했습니다. ## 예측 인사이트 사용의 이점 예측 인사이트를 사용하면 다음과 같은 몇 가지 주요 이점이 있습니다. + 맞춤형 추천으로 고객 경험 개선 + 관련 제품 제안을 통해 판매 기회 확대 + 관련 권장 사항을 자동으로 표시하여 에이전트 시간 절약 + 모든 고객 접점에서 일관된 권장 사항 제공 + 고객 행동 변화에 따라 실시간으로 제안 사항 업데이트 # 예측 인사이트 시작하기 Predictive Insights 사용을 시작하려면 다음 단계를 따르세요. **Topics** + [1단계: 고객 프로필에 상호 작용 데이터 추가](#add-interaction-data) + [2단계: 항목 카탈로그 데이터 추가](#add-item-catalog-data) + [3단계: 예측 인사이트 생성](#create-predictive-insights) + [4단계: 고객 참여 채널에서 예측 인사이트 사용](#use-across-customer-engagement-channels) ## 1단계: 고객 프로필에 상호 작용 데이터 추가 Customer Profiles의 기존 데이터 커넥터를 활용하여 상호 작용 데이터를 표준 웹 분석 객체에 매핑할 수 있습니다. 자세한 내용은 [Web Analytics 객체에 대한 객체 유형 매핑](standard-loyalty-promotion-object-mapping-web-analytics.md) 단원을 참조하십시오. ## 2단계: 항목 카탈로그 데이터 추가 표준 카탈로그 데이터를 사용하여 도메인 내 카탈로그의 개별 제품을 나타낼 수 있습니다. 이 카탈로그 데이터는 도메인 수준에서 존재하며 특정 고객 프로필과 연결되지 않습니다. 개인화 기능에 활용할 수 있는 제품의 구조화된 표현 역할을 합니다. 카탈로그 정보를 수집 및 유지 관리하기 위한 유연한 옵션을 제공하는 데이터 커넥터를 사용하여 제품 또는 항목 정보를 도메인 객체로 Customer Profiles로 가져와서 제품 데이터를 시스템 내에서 최신 상태로 유지하고 액세스할 수 있도록 할 수 있습니다. 자세한 내용은 [항목 카탈로그의 객체 유형 매핑](standard-loyalty-promotion-object-mapping-item-catalog.md) 단원을 참조하십시오. ## 3단계: 예측 인사이트 생성 Amazon Connect를 사용하면 특정 제품 권장 사항에 맞는 특수 AI 모델을 구축하고 배포할 수 있습니다. 이러한 모델은 Connect 웹 UI를 통해 구성하거나 고유한 비즈니스 시나리오에 맞게 APIs 통해 프로그래밍 방식으로 구성할 수 있습니다. Predictive Insights는 몇 가지 유형의 권장 사항을 제공합니다. 1. **권장 사항** - 특정 사용자에 맞는 맞춤형 권장 사항을 제공합니다. 권장 사항은 클릭스트림 이벤트, 구매 이벤트, 사용된 콘텐츠 등과 같은 사용자의 과거 동작을 기반으로 합니다. 1. **유사 항목** - 생성형 AI를 사용하여 카탈로그의 기존 항목과 테마적으로 유사한 항목을 찾습니다. 고객이 사용자에게 대체 항목 추천을 제공하려는 업셀링 또는 대체 사용 사례에 적합합니다. 1. **자주 페어링되는 항목** - 카탈로그의 기존 항목과 자주 상호 작용하는 항목을 권장합니다. 교차 판매 또는 보완 항목 추천 사용 사례에 적합합니다. 1. **인기 항목 ** - 사용자가 가장 일반적으로 상호 작용하는 항목을 추천하도록 설계되었습니다. 1. **현재 추세** - 최근 기간 동안 참여 속도가 가장 크게 증가하는 항목을 권장합니다. 사용자 상호 작용에서 바이러스가 발생하는 항목을 표시하도록 설계되었습니다. **참고** Predictive Insights를 사용한 AI 모델 활성화는 미리 보기에서 사용할 수 있습니다. 향후 추가 요금이 적용될 수 있습니다. **권장 사항 유형별 항목 제한** 다음 표에서는 사용된 권장 사항 유형에 따라 권장 사항 생성에 고려되는 최대 항목 수를 설명합니다. | **권장 사항 유형** | **설명** | **제한** | | --- | --- | --- | | 추천 제품 | 예측 인사이트에 고려되는 최대 항목 수 | 4천만 | | 유사한 항목 | 예측 인사이트에 고려되는 최대 항목 수 | 1천만 | | 기타 모든 비즈니스 시나리오 | 예측 인사이트에 고려되는 최대 항목 수 | 750,000 | ## 4단계: 고객 참여 채널에서 예측 인사이트 사용 ### Connect 흐름에서 고객 프로필 권장 사항 사용 이 섹션에서는 고객 프로필 추천 받기 흐름 블록을 사용하여 프로필에 대한 AI 기반 추천을 실시간으로 생성하여 고객 응대 중에 사용자 경험을 강화하는 방법을 설명합니다. **흐름 블록 속성** **프로필 추천 가져오기** 흐름 블록에는 구성할 수 있는 다음과 같은 속성이 있습니다. 1. **프로필 ID(필수):** 이 블록이 작동하려면 프로필 ID가 필요합니다. **프로필 권장 사항 가져오기** 흐름 블록은 여기에 제공된 프로필 ID에 대한 권장 사항을 생성합니다. 프로필 ID를 수동으로 입력하거나 속성에 저장된 사전 정의된 값을 사용할 수 있습니다. 사전 정의된 값을 사용하는 경우 이전 프로필 **가져오기** 블록을 사용하여 프로필 ID를 제공해야 합니다. 후속 블록에서 권장 사항을 생성하기 전에 **프로필 가져오기** 블록을 사용하여 특정 프로필을 정확히 찾아야 합니다. 1. **추천자 이름(필수):** 이 블록이 작동하려면 추천자 이름이 필요합니다. 지정된 프로필 ID에 대한 추천을 생성하는 데 사용할 추천자의 이름입니다. 활성 상태인 추천만 사용하여 추천을 생성할 수 있습니다. 1. **최대 결과(필수):** 지정된 프로필 ID에 대해 생성할 최대 권장 사항 수입니다. 권장 사항의 범위는 1\$13개입니다. 1. **권장 사항 속성(필수):** 고객 응대 속성에 유지할 추천 응답의 속성을 정의합니다. 1. **항목 ID:** 지정된 프로필 ID에 대한 권장 사항을 생성하기 위한 추가 컨텍스트로 제공되는 항목 ID입니다. 항목 ID는 “*유사 항목” *또는 “*자주 페어링되는 항목” *추천자 유형을 사용할 때만 필요합니다. 프로필 ID를 수동으로 입력하거나 속성에 저장된 사전 정의된 값을 사용할 수 있습니다. 사전 정의된 값을 사용하는 경우 앞의 **계산된 속성 가져오기** 블록을 사용하여 항목 ID를 제공해야 합니다. **계산된 속성 가져오기** 블록을 사용하여 후속 블록에서 권장 사항을 생성하기 전에 특정 항목 ID를 정확히 찾아냅니다. **흐름 블록 브랜치** **프로필 추천 가져오기** 흐름 블록은 연락처를 다음 브랜치로 라우팅할 수 있습니다. 1. **성공: ** 제공된 프로필 ID에 대한 권장 사항이 성공적으로 생성되었습니다. 선택한 권장 사항 속성이 \$1.Customer.Recommendations 연락처 속성에 유지되었습니다. 1. **오류:** 권장 사항을 생성하려고 시도하는 동안 오류가 발생했습니다. 이는 시스템 오류 또는 **프로필 권장 사항 가져오기** 블록이 구성된 방식 때문일 수 있습니다. 1. **찾을 수 없음:** 권장 사항을 생성할 수 없습니다. **블록의 권장 사항 사용** 권장 사항 응답은 \$1.Customer.Recommendations 연락처 속성 JSONPath에 권장 사항 객체의 JSON 목록으로 유지됩니다. 각 권장 사항 객체에는 선택한 **권장 사항 속성**이 포함됩니다. Lambda 함수의 다음 샘플 Python 코드 조각은 프로파일 권장 사항 **가져오기 블록에서 권장 사항을** 변환하고 후속 블록에서 권장 사항을 사용할 수 있도록 다른 연락 속성으로 유지하는 데 사용할 수 있는 방법을 보여줍니다. ``` import boto3 import json # Handle lambda request def lambda_handler(event, context): print("Contact flow data: ", event) # Transform recommendations recommendations = event['Details']['Parameters']['Recommendations'] contact_attributes = {} for i, rec in enumerate(recommendations): contact_attributes.update(flatten(rec, i)) # Set contact attributes using each recommendation attribute value print("Setting contact attributes: ", contact_attributes) try: client = boto3.client('connect', region_name="us-west-2") client.update_contact_attributes( InstanceId=event['Details']['ContactData']['InstanceARN'].rsplit('/', 1)[1], InitialContactId=event['Details']['ContactData']['InitialContactId'], Attributes=contact_attributes ) print("Contact attributes set successfully.") except Exception as e: print("Error setting contact attributes: ", e) # Success response return { 'statusCode': 200, 'body': json.dumps('Success') } # Flatten a nested object into a simple string:string object def flatten(recommendation, index): flat = {} for key, value in recommendation.items(): if isinstance(value, dict): flat.update(flatten(value, index)) else: flat[f"Rec{index}_{key}"] = str(value) return flat ``` **프로필 추천 받기** 블록으로 흐름을 설정한 후에는 이를 사용하여 고객 응대 중에 고객을 위한 추천을 생성할 수 있습니다. ### 아웃바운드 캠페인에서 고객 프로필 권장 사항 사용 Predictive Insights를 Amazon Connect 아웃바운드 캠페인과 통합하여 이메일 및 SMS 채널을 통해 맞춤형 추천을 제공할 수 있습니다. 이벤트 트리거 캠페인을 생성할 때 캠페인과 연결된 고객 프로필에 대한 AI 기반 추천을 자동으로 생성하도록 추천 섹션을 구성할 수 있습니다. 이 통합은 Web Analytics 객체 매핑을 이벤트 범주로 사용하여 고객 상호 작용 데이터를 캡처합니다. 이를 통해 추천 엔진은 고객 행동에 따라 관련성이 높고 타겟팅된 제안을 제공할 수 있습니다. 이벤트 트리거 캠페인에서 권장 사항을 구성하는 step-by-step 지침은 섹션을 참조하세요[이벤트 트리거를 사용하여 아웃바운드 캠페인 생성](how-to-create-campaigns-using-event-triggers.md). ### 판매 권장 사항을 위한 Connect AI 에이전트 설정 Amazon Q in Connect는 새로운 "오케스트레이션" 에이전트 유형을 통해 에이전트 기능을 개선합니다. 이 기능은 항목 추천을 제공할 수 있는 Sales AI 에이전트를 생성하는 데 특히 유용하며, 업셀링 및 크로스셀링 시나리오에서 특히 유용합니다. **시작하기** 구현을 시작하려면에 액세스 AWS Management Console 하고 Amazon Connect로 이동합니다. 액세스 URL을 통해 Connect 인스턴스에 로그인한 후 왼쪽 메뉴에서 Amazon Q를 찾아 AI 에이전트를 선택합니다. QiC 페이지의 AI 에이전트에서 사전 구성된 AI 에이전트 유형 오케스트레이션(SalesAgent) 초안 상태를 확인할 수 있습니다. 이 템플릿에는 1P 도구에 필요한 모든 구성과 권장 사항 프롬프트 예제가 포함되어 있습니다. **사용자 지정 에이전트 생성** 사용자 지정 판매 에이전트를 생성하려면 먼저 오케스트레이션 유형의 새 AI 에이전트를 생성하고 기존 SalesAgent 템플릿에서 복사합니다. 이 프로세스는 템플릿의 모든 도구 및 구성을 새 에이전트로 전송합니다. **에이전트 사용자 지정** 에이전트의 프롬프트를 업데이트할 때 관리자는 두 가지 기본 옵션을 사용할 수 있습니다. 기존 에이전트 프롬프트를 판매 에이전트 프롬프트에 추가하고 식별 지침을 추가하거나, SalesAgent 프롬프트를 제거하고 현재 게시된 에이전트를 기반으로 새 오케스트레이션 프롬프트를 생성하고 판매 에이전트 프롬프트를 추가하여 새로 시작할 수 있습니다. 이러한 유연성을 통해 특정 비즈니스 요구 사항 및 도메인 요구 사항에 맞는 맞춤형 솔루션을 사용할 수 있습니다. **흐름 구성 및 통합** 에이전트 구성을 완료하고 게시한 후 다음 단계에서는 흐름 아래에 Amazon Lex 봇을 생성합니다. 생성된 Lex 봇과 함께 GetCustomerInput 블록을 포함하도록 인바운드 흐름을 업데이트해야 하며, 추가 옵션에서 새 SalesAgent를 선택해야 합니다. 프로필 ID 검색을 위한 Customer Profile 흐름 블록과 고객 응대 속성 설정 흐름 블록을 모두 추가하여 CustomerId를 프로필 ID의 키로 설정하고 값을 \$1Customer.ProfileId로 설정해야 합니다. 이 구현은 고객 입력이 Lex 봇의 QIC 에이전트로 원활하게 전달되도록 채팅 고객 응대와 음성 통화를 모두 지원합니다. 이 포괄적인 설정을 통해 Amazon Connect 환경 내에서 AI 기반 판매 권장 사항 및 업셀링 기회를 사용할 수 있습니다. 시스템의 유연성을 통해 지능형 영업 지원의 핵심 기능을 유지하면서 특정 업계 요구 사항에 따라 사용자 지정할 수 있습니다. 이 솔루션은 AI 기반 권장 사항으로 고객 상호 작용을 향상하여 궁극적으로 보다 효과적인 영업 및 고객 서비스 운영을 지원하기 위한 프레임워크를 제공합니다. 관리자는 도메인별 지침을 추가하고 비즈니스 요구 사항에 맞게 권장 유형을 사용자 지정하여 구현을 더욱 세분화할 수 있습니다. ### 에이전트 지원에 사용할 SalesAgent 구성 에이전트 Workspace의 Q in Connect 채팅 위젯 내에서 사용할 SalesAgent를 구성할 수 있습니다. 이렇게 하려면 두 가지 주요 사항을 수정해야 합니다. 1. 고객 응대 기록에 액세스하기 위한 지침으로 AIAgent 프롬프트를 업데이트합니다. 1. 프롬프트 편집기에서 SalesAgent와 연결된 프롬프트를 열고 프롬프트를 업데이트하여에서 액세스할 수 있는 연락처의 트랜스크립트에 액세스하는 지침을 추가합니다.` {{$.transcript}} ` 1. 다음은 SalesAgent 프롬프트에 추가할 수 있는 샘플 프롬프트입니다. ``` **IMPORTANT** **Guide on how to process requests and information:** - The messages section contains YOUR conversation with the customer service agent - Respond to the agent's questions/requests in the messages section - The transcript below is background information about the agent's conversation with their customer - Do not respond directly to the customer - you are helping the AGENT Background context from agent-customer conversation. The following transcript is for your information ONLY. Do not directly respond to messages in this conversation, but instead look at the messages section for what the agent requests you to do. IF YOU REFERENCE ANY INFORMATION FROM THIS SECTION: You should indicate so by saying "According to your conversation with the customer ..." {{$.transcript}} ``` 1. AIAgent를 새 프롬프트 버전으로 업데이트하고이 에이전트를 사용하여 기본 구성 → 에이전트 지원 사용 사례를 업데이트합니다. **참고** 둘 다 프롬프트를 약간 수정해야 하므로 셀프 서비스용 Sales AIAGent와 에이전트 지원 사용 사례 2개를 사용하는 것이 좋습니다. 또한 에이전트를 복제하고 프롬프트 버전을 변경하고 기본 구성을 업데이트하여 각 사용 사례에 맞게 AI 에이전트를 수정하도록 할 수 있습니다. 1. 고객 응대 인바운드 흐름을 업데이트합니다. 1. GetCustomerInput 블록을 제거하고 대신 Connect 어시스턴트 흐름 블록을 추가합니다. 1. 흐름 블록 구성을 AIAssistant ARN으로 채우고 적절한 AIAGent를 선택합니다. 이제이 흐름을 일반 인바운드로 사용할 수 있으며 Q in Connect 채팅 위젯은 사용자의 요청에 도움이 되는 권장 사항을 제공할 수 있어야 합니다. ## 데이터 고려 사항 다음 섹션에서는 사용 사례를 일치시키고 예측 인사이트의 데이터 준비 상태를 평가하는 방법에 대한 지침을 제공합니다. ### 사용 사례를 예측 인사이트와 일치시켰나요? Predictive Insights 개인화 유형은 다음과 같은 사용 사례를 해결할 수 있습니다. + 사용자를 위한 개인 맞춤형 추천 생성 + 유사 항목 또는 관련 항목 추천 + 유행 항목 또는 인기 항목 추천 + 관련성을 기준으로 항목 재정렬 ### 항목 상호 작용 데이터가 충분합니까? 모든 사용 사례 및 개인 맞춤 유형에 대해 각각 두 개 이상의 상호 작용이 있는 25명의 고유 사용자에 대해 최소 1,000개의 항목 상호 작용이 있어야 합니다. 품질 추천의 경우, 각 2번 이상의 항목 상호 작용을 갖는 1,000명 이상의 사용자로부터 50,000건 이상의 항목 상호 작용을 갖는 것이 좋습니다. ### 실시간 이벤트 스트리밍 아키텍처가 마련되어 있습니까? 실시간 이벤트를 Connect Customer Profiles로 스트리밍할 수 있는 경우 실시간 개인 맞춤을 활용할 수 있습니다. 일부 개인화 유형을 사용하면 Predictive Insights는 사용자의 최신 활동에서 학습하고 애플리케이션을 사용할 때 권장 사항을 업데이트할 수 있습니다. ### 데이터가 예측 인사이트에 최적화되어 있나요? 데이터에서 다음 사항을 확인하는 것이 좋습니다. + 누락된 값이 있는지 확인합니다. 레코드 중 최소 70%에 모든 속성에 대한 데이터를 포함시키는 것이 좋습니다. null 값을 70% 이상 완료할 수 있는 열을 사용하는 것이 좋습니다. + 일관되지 않은 명명 규칙, 항목의 중복 범주, 데이터세트의 ID 불일치, ID 중복과 같은 데이터의 부정확성이나 문제를 수정합니다. 이러한 문제는 추천에 부정적인 영향을 미치거나 예기치 않은 동작으로 이어질 수 있습니다. 예를 들어 데이터에 "N/A"와 "해당 없음"이 모두 있지만 "N/A"만 기준으로 추천을 필터링할 수 있습니다. "해당 없음"으로 표시된 항목은 필터를 통해 제거되지 않습니다. + 항목, 사용자 또는 작업이 여러 범주를 가질 수 있는 경우(예: 장르가 여러 개 있는 영화) 범주별 값을 하나의 속성으로 결합하고 \$1 연산자를 사용하여 각 값을 구분합니다. 예를 들어 영화의 GENRES 데이터는 액션 \$1 어드벤처 \$1 스릴러일 수 있습니다. + 한 열에 사용할 수 있는 범주가 1000개를 넘지 않도록 합니다(열에 필터링 용도로만 사용되는 데이터가 포함된 경우 제외). # Amazon Connect Customer Profiles API 사용 도메인과 프로필을 프로그래밍 방식으로 관리하는 방법에 대한 자세한 내용은 [Amazon Connect Customer Profiles API 참조](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html)를 참조하세요. ## ListObjectTypeAttributeValues API ListObjectTypeAttributeValues API는 지정된 속성에 대한 최신 고유 값에 대한 액세스를 제공하므로 객체 유형 내에서 실시간 데이터 검증 및 일관성 검사에 유용합니다. 이 API는 도메인 전체에서 작동하며 사용자 지정 객체 유형과 표준 객체 유형을 모두 지원합니다. API는 객체 유형 이름, 속성 이름 및 도메인 이름을 입력 파라미터로 받아 약 350KB의 스토리지 한도까지 값을 반환합니다. **참고:** + 필드당 최대 350KB의 속성 값을 저장하므로 가장 최근 값을 우선시합니다. 이 한도에 도달하면 새 항목을 위한 공간을 확보하기 위해 이전 값이 자동으로 제거됩니다. ## GetObjectTypeAttributeValues API GetObjectTypeAttributeValues API는 특정 객체 유형 내의 속성에 대한 통계 인사이트를 제공하지만 데이터 스토어가 활성화된 도메인에서만 사용할 수 있습니다. 이 API는 일일 계산을 수행하여 속성 값에 대한 통계 정보를 제공하므로 데이터의 패턴과 추세를 이해하는 데 도움이 됩니다. 통계 계산은 하루에 한 번 수행되므로 속성 데이터 특성에 대한 일관된 스냅샷을 제공합니다. **참고:** + 두 가지 시나리오에서 null 값을 받게 됩니다. + 데이터 볼트를 활성화한 후 첫 번째 기간 동안(1일 1회 발생하는 계산 주기가 발생하지 않는 한). + 숫자 값을 포함하지 않는 속성의 경우. Customer Profiles를 자체 에이전트 애플리케이션에 통합할 때는 CustomerProfileJS 오픈 소스 라이브러리를 사용하는 것이 좋습니다. 자세한 내용은 [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles)에서 CustomerProfilesJS 리포지토리를 참조하세요. 기존 앱을 Amazon Connect와 통합하는 방법에 대한 자세한 내용은 [Amazon Connect 스트림](https://github.com/aws/amazon-connect-streams)을 사용하세요. Contact Control Panel(CCP) 구성 요소를 앱에 포함할 수 있습니다. # Amazon Connect Customer Profiles의 IPv6 지원 이해 ## 퍼블릭 연결 모든 Amazon Connect Customer Profiles API IPv4 및 IPv6 직접 호출을 완전히 지원합니다. ``` profile.Region.api.aws ``` **예**: ``` profile.us-east-1.api.aws ``` AWS CLI의 경우 다음 엔드포인트를 명시적으로 사용해야 합니다. ``` aws customer-profiles list-domains \ --endpoint https://profile.us-east-1.api.aws \ --region us-east-1 ``` 이전 API는 여전히 이전 버전과의 호환성으로 사용할 수 있습니다. IPv4 통화만 지원합니다. ``` profile.Region.amazonaws.com ``` **예**: ``` profile.us-east-1.amazonaws.com ``` ## 프라이빗 연결 Amazon VPC 콘솔이나 AWS Command Line Interface(AWS CLI)를 사용하여 Amazon Connect Customer Profiles 서비스에 대한 VPC 엔드포인트를 생성할 수 있습니다. 자세한 내용은AWS PrivateLink 사용 설명서의 [인터페이스 엔드포인트 생성](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html)을 참조하세요. 다음 서비스 이름을 사용하여 Amazon Connect Customer Profiles에 대한 VPC 엔드포인트를 생성합니다. ``` com.amazonaws.Region.profile ``` **예**: ``` com.amazonaws.us-east-1.profile ``` 엔드포인트에 대해 프라이빗 DNS를 활성화하는 경우 profile.us-east-1.api.aws와 같이 리전에 대해 지원되는 IPv4 및 IPv6 DNS 이름을 사용하여 Amazon Connect Customer Profiles에 API 요청을 할 수 있습니다. 또는 리전의 이전 DNS 이름도 IPv4로만 지원됩니다. **예**: ``` profile.us-east-1.amazonaws.com ``` # 예: 프로그래밍 방식으로 S3를 Amazon Connect Customer Profiles와 통합 Customer Profiles [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html) API를 사용하여 S3, Salesforce, Marketo 등에 대한 통합을 프로그래밍 방식으로 생성할 수 있습니다. 이 주제에서는 현재 지원되는 최소값인 15분의 동기화 간격으로 S3 통합을 생성하는 방법을 보여 줍니다. ## 1단계: JSON 파일 생성 다음 내용의 JSON 파일을 생성합니다. ``` { "DomainName": "your-domain", "ObjectTypeName": "your-object-name", "FlowDefinition": { "FlowName": "your-flow-name", "KmsArn": "the key ARN is the same as your domain's key", "Description": "Created by Customer Profiles", "TriggerConfig": { "TriggerType": "Scheduled", "TriggerProperties": { "Scheduled": { "ScheduleExpression": "rate(15minutes)", "DataPullMode": "Incremental", "ScheduleStartTime": 1634244800.435, "FirstExecutionFrom": 1594166400 } } }, "SourceFlowConfig": { "ConnectorType":"S3", "SourceConnectorProperties": { "S3": { "BucketName": "your-bucket", "BucketPrefix": "your-prefix" } } }, "Tasks": [ {"TaskType":"Filter","SourceFields":["colA","colB"],"ConnectorOperator":{"S3":"PROJECTION"}}, {"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colA","TaskProperties":{},"SourceFields":["colA"],"TaskType":"Map"}, {"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colB","TaskProperties":{},"SourceFields":["colB"],"TaskType":"Map"} ] } } ``` 고유한 값으로 JSON을 사용자 지정하려면 다음 지침을 따르세요. + `FlowName`: [a-zA-Z0-9][\$1w\$1@\$1.-]\$1 문자열일 수 있습니다. + `ScheduleStartTime`: Epoch 시간 기준 현재 `DateTime` \$1 5분으로 설정합니다. + `FirstExecutionFrom`: S3로 이동하여 파일 날짜를 확인하고 가장 오래된 날짜 이전 날짜를 사용합니다. + `Tasks`: `TaskType`을 정의합니다. `Sourcefields` 필드에 해당 배열의 CSV에 있는 모든 열을 입력해야 합니다. 그런 다음 해당 배열의 각 항목에 대해 `ConnectorOperator`를 지정해야 합니다. 이 예제는 두 개의 열(`colA` 및 `colB`)이 있는 CSV 문서를 위한 것입니다. ## 2단계: PutIntegration API 호출 값을 사용하여 JSON 파일을 만들고 사용자 지정한 후에는 다음 예와 같이 [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html) API를 호출합니다. ``` aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2 ``` `PutIntegration`의 응답은 흐름 URI를 반환합니다. 예제: ``` { "DomainName": "testDomain", "Uri": "arn:aws:appflow:us-west-2:9999999999999:flow/Customer_Profiles_testDomain_S3_Salesforce-Account_1634244122247", "ObjectTypeName": "your objec type", "CreatedAt": "2021-10-14T13:51:57.748000-07:00", "LastUpdatedAt": "2021-10-14T13:51:57.748000-07:00", "Tags": {} } ``` ## 3단계: Amazon AppFlow StartFlow API 호출 흐름 URI를 사용하여 Amazon AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html) API를 호출할 수 있습니다. 예제: ``` aws appflow start-flow —flow-name uri --region us-west-2 ```