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