기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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)