本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon Connect Customer Profiles 中的物件類型映射定義詳細資訊
物件類型對應定義有兩個部分：欄位定義和索引鍵定義。
**提示**
若要了解如何建立物件類型對應器，請參閱此部落格文章：[Unify and organize customer information with Amazon Connect Customer Profiles with the pre-built Amazon S3 connector](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 上觀看這部影片：[How to Integrate Customer Profile Data into your Contact Center Experiences](https://www.youtube.com/watch?v=LLIEwFel_7c&t=1767s)。
## 欄位定義詳細資訊
欄位定義會定義欄位的來源、目的地 (目標) 和類型。例如：
```
"Fields": {
"{fieldName}": {
"Source": "{source}",
"Target": "{target}",
"ContentType": "{contentType}"
}, ...
}, ...
```
+ `Source`：這可以是欄位的 JSON 存取子，也可以是用於產生欄位值的 Handlebar 巨集。
被解析的來源物件被命名為 ` _source`，因此來源欄位中的所有欄位都需要以此字串開頭。僅支援 `_source` 物件。
使用 Handlebar 巨集解決方案來產生常數，並將多個來源物件欄位合併為單一欄位。這對於索引非常有用。
+ `Target`：指定標準物件類型中此欄位資料的對應位置。
填入標準設定檔可讓您將從任何資料來源擷取的資料與以客戶設定檔為基礎建置的應用程式一起使用，而無需對所擷取資料的格式有任何特定知識。
此欄位為選用欄位。您可能只想要定義欄位，以便將它們包含在索引鍵中。
此欄位的格式永遠是 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}", ...]
}], ...
}, ...
```
索引鍵名稱是網域的全域名稱。如果您有兩個索引鍵，在兩個不同的物件類型對應中具有相同名稱：
+ 這些索引鍵應該佔用相同的命名空間
+ 它們可用於將不同物件之間的設定檔連結在一起。如果它們在物件之間相符，則客戶設定檔會將這兩個物件放在同一個設定檔中。
以另一種方式來表達：索引鍵在網域中應具有相同的索引鍵名稱，若且唯若相同的值意味著它們是相關的。例如，某種物件類型中指定的電話號碼會與另一種物件類型中指定的相同電話號碼相關。針對從 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 標記電話號碼。這表示電話號碼將被視為唯一識別符。如果客戶設定檔取得兩個擁有相同電話號碼的聯絡人，則這些聯絡人將會合併至單一設定檔內。
| 識別符名稱 | Description |
| --- | --- |
| AIR\$1PREFERENCE | 此識別符表示此索引鍵可唯一識別航空偏好設定。指定此識別符時，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何航空偏好設定。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1BOOKING | 此識別符表示此索引鍵可唯一識別航空預訂內容。指定此識別符後，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何航空預訂內容。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1SEGMENT | 此識別符表示此索引鍵唯一識別航空業客群。指定此識別符後，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何航空業客群。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1PREFERENCE | 此識別符表示此索引鍵可唯一識別住宿偏好設定。指定此識別符時，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何住宿偏好設定。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1STAY\$1REVENUE | 此識別符表示此索引鍵唯一識別飯店住宿收入。指定此識別符時，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何飯店住宿收入。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1RESERVATION | 此識別符表示此索引鍵唯一識別飯店住宿預訂。指定此識別符時，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何飯店住宿預訂。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY | 此識別符表示此索引鍵唯一識別忠誠度。指定此識別符時，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何忠誠度。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1TRANSACTION | 此識別符表示此索引鍵唯一識別忠誠度交易。指定此識別符時，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何忠誠度交易。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1PROMOTION | 此識別符表示此索引鍵唯一識別忠誠度促銷活動。指定此識別符時，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何忠誠度促銷活動。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| UNIQUE | 每個物件類型必須只有一個索引來指定此識別符。此索引鍵可用來唯一識別物件類型的物件，以便擷取物件，或在需要時在稍後更新已提交的物件。 構成 UNIQUE 索引鍵的所有欄位都需要在提交新物件時指定，否則該物件會被拒絕。 |
| PROFILE | 此識別符表示此索引鍵可唯一識別設定檔。指定此識別符時，表示在擷取期間，客戶設定檔會尋找與此索引鍵關聯的任何設定檔。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| LOOKUP\$1ONLY | 此識別符表示擷取物件後未儲存索引鍵。索引鍵僅用於在擷取期間決定設定檔。 索引鍵值在擷取期間不與設定檔關聯，表示它無法用於搜尋，或將稍後擷取的物件與同一索引鍵進行比對。 您無法將索引鍵同時指定為 `UNIQUE` 識別符和 `LOOKUP_ONLY` 識別符。 如果至少有一個其他索引鍵具有 `PROFILE` 識別符，但沒有 `NEW_ONLY` 或 `LOOKUP_ONLY` 識別符時，您才能將 `PROFILE` 與 `LOOKUP_ONLY` 一起使用。唯一例外是 `_profileId` 索引鍵，它可以單獨擁有 `PROFILE` 和 `LOOKUP_ONLY` 識別符組合。 |
| NEW\$1ONLY | 如果設定檔在物件擷取之前尚未存在，則索引鍵會與該設定檔關聯。否則，該索引鍵僅用於比對物件和設定檔。 您無法將索引鍵同時指定為 `UNIQUE` 識別符和 `NEW_ONLY` 識別符。 如果至少有一個其他索引鍵具有 `PROFILE` 識別符，但沒有 `NEW_ONLY` 或 `LOOKUP_ONLY` 識別符時，您才能將 `PROFILE` 與 `NEW_ONLY` 一起使用。 |
| SECONDARY | Customer Profiles 比對物件和設定檔時，會先查詢一切沒有 SECONDARY 識別符的 PROFILE 索引鍵。這些索引鍵會優先考慮。只有在使用這些索引鍵找不到相符的設定檔時，才會考慮 SECONDARY 索引鍵。 |
| ASSET | 此識別符表示此索引鍵可唯一識別資產。指定此識別符後，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何資產。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| ORDER | 此識別符表示此索引鍵可唯一識別訂單。指定此識別符時，表示在擷取期間，客戶設定檔會尋找與此索引鍵關聯的任何訂單。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
| CASE | 此識別符表示此金鑰唯一識別案例。指定此識別符時，表示在擷取期間，Customer Profiles 會尋找與此索引鍵關聯的任何案例。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/standard-identifiers.html) |
## 相容的識別符
![\[矩陣，其中顯示不同資料類型的允許和限制識別符和金鑰名稱。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/standard-identifiers-compatibility-image.png)
# Customer Profiles 如何處理索引鍵定義
當 Customer Profiles 擷取自訂物件映射時，會處理索引鍵定義。下圖顯示如何處理索引鍵定義中的標準識別符，以決定要將物件指派給哪個設定檔。
![\[流程圖，其中顯示用於指派或佇列物件的設定檔索引鍵檢查程序。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/customer-profiles-template1.png)
# Customer Profiles 如何將索引鍵新增至索引，以進行查詢
下圖顯示客戶設定檔如何處理標準識別符，以判斷是否保留索引鍵。
![\[檢閱流程圖，其中顯示根據查詢和新物件條件，在 Customer Profiles 中保留索引鍵的決策程序。\]](http://docs.aws.amazon.com/zh_tw/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)
+ [客戶設定檔中的 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 AppFlow 存取要求，來建立和刪除 Zendesk、Marketo、Salesforce 和 ServiceNow 與 Amazon Connect Customer Profiles 的整合：
+ appflow:CreateFlow
+ appflow:DeleteFlow
# Customer Profiles 中的 Amazon AppIntegrations 存取要求
使用以下 Amazon AppIntegrations 存取要求，來建立和刪除 Segment 和 Shopify 與 Amazon Connect Customer Profiles 的整合：
+ app-integrations:GetEventIntegration
+ app-integrations:ListEventIntegrationAssociations
+ app-integrations:CreateEventIntegrationAssociation
+ app-integrations:DeleteEventIntegrationAssociation
# 客戶設定檔中的 Amazon EventBridge 存取要求
使用以下 Amazon EventBridge 存取要求，來建立和刪除 Segment 和 Shopify 與 Amazon Connect Customer Profiles 的整合：
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Amazon Connect Customer Profiles 中的標準設定檔定義
下表列出 Customer Profiles 標準設定檔物件中的所有欄位。
| 標準設定檔欄位 | 資料類型 | Description |
| --- | --- | --- |
| ProfileId | String | 客戶設定檔的唯一識別符。 |
| AccountNumber | String | 您提供給客戶的唯一帳號。 |
| AdditionalInformation | String | 與客戶設定檔相關的任何其他資訊。 |
| PartyType | String | 用來描述客戶的設定檔類型。 有效值：INDIVIDUAL \$1 BUSINESS \$1 OTHER |
| BusinessName | String | 客戶的業務名稱。 |
| FirstName | String | 客戶的名字。 |
| MiddleName | String | 客戶的中間名。 |
| LastName | String | 客戶的姓氏。 |
| BirthDate | String | 客戶的出生日期。 |
| Gender | String | 客戶認同的性別。 |
| PhoneNumber | String | 尚未指定為行動電話號碼、住家或公司號碼的客戶電話號碼。 |
| MobilePhoneNumber | String | 客戶的行動電話號碼。 |
| HomePhoneNumber | String | 客戶的住家電話號碼。 |
| BusinessPhoneNumber | String | 客戶的公司電話號碼。 |
| EmailAddress | String | 尚未指定為個人或公司地址的客戶電子郵件地址。 |
| PersonalEmailAddress | String | 客戶的個人電子郵件地址。 |
| BusinessEmailAddress | String | 客戶的公司電子郵件地址。 |
| 地址 | 地址 | 與客戶相關聯，且非用於郵寄、送貨或帳單的一般地址。 |
| ShippingAddress | 地址 | 客戶的運送地址。 |
| MailingAddress | 地址 | 客戶的電子郵件地址。 |
| BillingAddress | 地址 | 客戶的帳單地址。 |
| 屬性 | 字串對字串對應 | 客戶設定檔屬性的鍵值對。 |
| ProfileType | String | 設定檔類型。 有效值：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 屬性符合搜尋值的設定檔。
## Address 資料類型
| 標準設定檔欄位 | 資料類型 | Description |
| --- | --- | --- |
| Address1 | String | 客戶地址的第一行。 |
| Address2 | String | 客戶地址的第二行。 |
| Address3 | String | 客戶地址的第三行。 |
| Address4 | String | 客戶地址的第四行。 |
| City | String | 客戶居住的城市。 |
| Country | String | 客戶居住的國家/地區。 |
| County | String | 客戶居住的縣。 |
| PostalCode | String | 客戶地址的郵遞區號。 |
| Province | String | 客戶居住的省份。 |
| State | String | 客戶居住的州。 |
## EngagementPreferences 資料類型
| 標準設定檔欄位 | 資料類型 | Description |
| --- | --- | --- |
| Email | ContactPreference 物件陣列 | 與電子郵件相關的聯絡偏好設定清單。 |
| Phone | ContactPreference 物件陣列 | 與電話相關的聯絡偏好設定清單。 |
## ContactPreference 資料類型
| 標準設定檔欄位 | 資料類型 | Description |
| --- | --- | --- |
| KeyName | String | 可供搜尋的客戶設定檔唯一識別符。 |
| KeyValue | String | 用來根據 keyName 查詢設定檔的索引鍵值。 |
| ProfileId | String | 客戶設定檔的唯一識別符。 |
| ContactType | String | 用於參與的聯絡類型。有效值：PhoneNumber \$1 MobilePhoneNumber \$1 HomePhoneNumber \$1 BusinessPhoneNumber \$1 EmailAddress \$1 PersonalEmailAddress \$1 BusinessEmailAddress |
# 在 Amazon Connect Customer Profiles 中，將 Salesforce 物件映射至標準設定檔
本主題列出 Salesforce 物件中的哪些欄位會映射到客戶設定檔中標準設定檔物件中的欄位。
## 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
+ Phone
+ Fax
+ AccountNumber
+ Website
+ PhotoUrl
+ Sic
+ Industry
+ AnnualRevenue
+ NumberOfEmployees
+ Ownership
+ TickerSymbol
+ Description
+ Rating
+ Site
+ 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 物件中欄位的子集會對應到客戶設定檔中的標準設定檔物件。
下表列出了哪些欄位可以從 Salesforce-Account 物件對應到標準設定檔。(此表格包含已設定為包含 Person 欄位之 Salesforce 執行個體的對應。)
| Salesforce-Account 來源欄位 | 標準設定檔目標欄位 |
| --- | --- |
| Id | Attributes.sfdcAccountId |
| 名稱 | BusinessName |
| Phone | 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 Customer Profiles 關聯。
| 標準索引名稱 | Salesforce-Account 來源欄位 |
| --- | --- |
| \$1salesforceAccountId | Id |
例如，您可以使用 `_salesforceAccountId` 作為索引鍵名稱，搭配 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API 來尋找設定檔。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Salesforce-Account`，以尋找與特定設定檔關聯的 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
+ Phone
+ Fax
+ MobilePhone
+ HomePhone
+ OtherPhone
+ AssistantPhone
+ ReportsToId
+ Email
+ Title
+ Department
+ AssistantName
+ LeadSource
+ Birthdate
+ Description
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ LastActivityDate
+ LastCURequestDate
+ LastCUUpdateDate
+ LastViewedDate
+ LastReferencedDate
+ EmailBouncedReason
+ EmailBouncedDate
+ IsEmailBounced
+ PhotoUrl
+ Jigsaw
+ JigawContactId
+ CleanStatus
+ IndividualId
## 將 Salesforce-Contact 物件對應到標準設定檔
Salesforce-Contact 物件中欄位的子集會對應到客戶設定檔中的標準設定檔物件。下表列出了哪些欄位可以從 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 |
| Phone | PhoneNumber |
| HomePhone | HomePhoneNumber |
| MobilePhone | MobilePhoneNumber |
| Email | EmailAddress |
| Birthdate | BirthDate |
Salesforce 物件中的 Salesforce-Contact 客戶資料會使用下表中的索引與 Amazon Connect Customer Profiles 關聯。
| 標準索引名稱 | Salesforce-Contact 來源欄位 |
| --- | --- |
| \$1salesforceContactId | Id |
| \$1salesforceAccountId | AccountId |
例如，您可以使用 `_salesforceAccountId` 和 `_salesforceContactId` 作為索引鍵名稱，搭配 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API 來尋找設定檔。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Salesforce-Contact`，以尋找與特定設定檔關聯的 Salesforce-Contact 物件。
# 在 Amazon Connect Customer Profiles 中，將 Zendesk 物件映射至標準設定檔
本主題列出 Zendesk 物件中的哪些欄位映射到客戶設定檔中標準設定檔的欄位。
## Zendesk-users 物件
以下是 Zendesk-users 物件中所有欄位的清單。
+ id
+ url
+ external\$1id
+ email
+ active
+ chat\$1only
+ customer\$1role\$1id
+ role\$1type
+ 詳細資訊
+ last\$1login\$1at
+ locale
+ locale\$1id
+ moderator
+ notes
+ only\$1private\$1comments
+ default\$1group\$1id
+ phone
+ shared\$1phone\$1number
+ photo
+ restricted\$1agent
+ role
+ shared
+ 標籤
+ signature
+ suspended
+ ticket\$1restriction
+ time\$1zone
+ two\$1factor\$1auth\$1enabled
+ user\$1fields
+ verified
+ report\$1csv
+ created\$1at
+ updated\$1at
## 將 Zendesk 使用者對應到標準設定檔
Zendesk-users 物件中的欄位子集會對應到客戶設定檔中的標準設定檔。下表列出了可從 Zendesk-users 物件對應到標準設定檔的欄位。
| Zendesk-users 來源欄位 | 標準設定檔目標欄位 |
| --- | --- |
| id | Attributes.ZendeskUserId |
| external\$1id | Attributes.ZendeskExternalId |
| email | EmailAddress |
| phone | PhoneNumber |
Zendesk 物件中的 Zendesk-users 客戶資料與使用下列索引與 Amazon Connect Customer Profiles 關聯。
| 標準索引名稱 | Zendesk-user 來源欄位 |
| --- | --- |
| \$1zendeskUserId | Id |
| \$1zendeskExternalId | external\$1id |
例如，您可以使用 `_zendeskUserId` 和 `_zendeskExternalId` 作為索引鍵名稱，並搭配 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API 來尋找 Amazon Connect Customer Profiles。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Zendesk-users`，以尋找與特定客戶設定檔關聯的 Zendesk-users 物件。
# 在 Amazon Connect Customer Profiles 中，將 Marketo 物件映射至標準設定檔
本主題列出 Marketo 物件中的哪些欄位映射到客戶設定檔標準設定檔物件中的欄位。
## Marketo-leads 物件
以下是 Marketo-leads 物件中所有欄位的清單
+ id
+ firstName
+ lastName
+ middleName
+ email
+ phone
+ mobilePhone
+ billingStreet
+ billingCity
+ billingState
+ billingCountry
+ billingPostalCode
+ address
+ 城市
+ state
+ 國家/地區
+ postalcode
+ gender
+ dateOfBirth
## 將 Marketo-leads 對應到標準設定檔
Marketo-leads 物件中的欄位子集會對應到標準設定檔。
| Marketo-leads 來源欄位 | 標準設定檔目標欄位 |
| --- | --- |
| id | Attributes.MarketoLeadId |
| sfdcAccountId | Attributes.sfdcAccountId |
| sfdcContactId | Attributes.sfdcContactId |
| firstName | FirstName |
| lastName | LastName |
| middleName | MiddleName |
| email | 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 |
| 城市 | Address.City |
| state | Address.State |
| 國家/地區 | Address.Country |
| postalcode | Address.PostalCode |
| gender | Gender |
| dataOfBirth | BirthDate |
Marketo-leads 客戶資料會使用下表中的索引與 Amazon Connect Customer Profiles 關聯。
| 標準索引名稱 | Marketo-leads 來源欄位 |
| --- | --- |
| \$1marketoLeadId | id |
| \$1salesforceAccountId | sfdcAccountId |
| \$1salesforceContactId | sfdcContactId |
例如，您可以使用 `_marketoLeadId`、`_salesforceAccountId` 和 `_salesforceContactId` 作為索引鍵名稱，並搭配 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API 來尋找 Amazon Connect Customer Profiles。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Marketo-leads`，以尋找與特定客戶設定檔關聯的 Marketo-leads 物件。
# 在 Amazon Connect Customer Profiles 中，將 ServiceNow 物件映射至標準設定檔物件
本主題列出 ServiceNow 物件中的哪些欄位對應到 Amazon Connect Customer Profiles 標準設定檔物件中的欄位。
## Servicenow-sys\$1user 物件
以下是 Servicenow-sys\$1user 物件中所有欄位的清單
+ sys\$1id
+ active
+ building
+ calendar\$1integration
+ 城市
+ company
+ cost\$1center
+ 國家/地區
+ date\$1format
+ default\$1perspective
+ department
+ edu\$1status
+ email
+ 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
+ name
+ notification
+ password\$1needs\$1reset
+ phone
+ photo
+ preferred\$1language
+ roles
+ 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 物件中欄位的子集會對應到客戶設定檔中的標準設定檔物件。
下表列出哪些欄位可以從 Servicenow-sys\$1users 物件對應到標準設定檔。
| Servicenow-sys\$1users 來源欄位 | 客戶設定檔目標欄位 |
| --- | --- |
| sys\$1id | Attributes.ServiceNowSystemId |
| first\$1name | FirstName |
| last\$1name | LastName |
| middle\$1name | MiddleName |
| gender | Gender |
| email | EmailAddress |
| phone | PhoneNumber |
| home\$1phone | HomePhoneNumber |
| mobile\$1phone | MobilePhoneNumber |
| street | Address.Address1 |
| 城市 | Address.City |
| state | Address.State |
| 國家/地區 | Address.Country |
| zip | Address.PostalCode |
來自 Servicenow 物件的 Servicenow-sys\$1user 客戶資料會使用下表中的索引與 Amazon Connect Customer Profiles 關聯。
| 標準索引名稱 | Servicenow-sys\$1user 來源欄位 |
| --- | --- |
| \$1serviceNowSystemId | sys\$1id |
例如，您可以使用 `_serviceNowSystemId` 和 `_serviceNowIncidentId` 作為索引鍵名稱，並搭配 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API 來尋找 Amazon Connect Customer Profiles。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Servicenow-sys_user`，以尋找與特定設定檔關聯的 Servicenow-sys\$1user 物件。
# 在 Amazon Connect Customer Profiles 中，將 Segment 物件映射至標準設定檔物件
本主題列出 Segment 物件中的哪些欄位對應到 Amazon Connect Customer Profiles 標準設定檔物件中的欄位。
## Segment-Identity 物件
以下是 Segment-Identity 物件中所有欄位的清單。
+ userId
+ 常用欄位 - 請參閱 Segment 文件中的 [Spec：常用欄位](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-Identity 對應到標準設定檔物件
Segment-Identity 物件中欄位的子集會對應到客戶設定檔中的標準設定檔物件。
下表列示了可以從 Segment-Identity 物件對應到標準設定檔的欄位。
| 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-Identity 客戶資料會使用下列索引與 Amazon Connect Customer Profiles 關聯。
| 標準索引名稱 | Segment-Identify 來源欄位 |
| --- | --- |
| \$1segmentUserId | userId |
例如，您可以使用 `_segmentUserId` 作為索引鍵名稱，並搭配 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API 來尋找 Amazon Connect Customer Profiles。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Segment-Identify`，以尋找與特定設定檔關聯的 Segment-Identity 物件。
# 在 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
+ email
+ 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
+ 標籤
+ tax\$1exempt
+ tax\$1exemptions
+ total\$1spent
+ updated\$1at
+ verified\$1email
## 將 Shopify-Customer 物件對應到標準設定檔
Shopify-Customer 物件中欄位的子集會對應到客戶設定檔中的標準設定檔物件。
下表列出了哪些欄位可以從 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 Customer Profiles 關聯。
| 標準索引名稱 | Shopify-Customer 來源欄位 |
| --- | --- |
| \$1shopifyCustomerId | id |
例如，您可以使用 `_shopifyCustomerId` 作為索引鍵名稱，並搭配 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API 來尋找 Amazon Connect Customer Profiles。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為`Shopify-Customer`，以尋找與特定設定檔關聯的 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 AppIntegrations 存取要求，來建立和刪除 Shopify 與 Amazon Connect Customer Profiles 的整合：
+ app-integrations:GetEventIntegration
+ app-integrations:ListEventIntegrationAssociations
+ app-integrations:CreateEventIntegrationAssociation
+ app-integrations:DeleteEventIntegrationAssociation
# Amazon EventBridge 存取要求
使用以下 Amazon EventBridge 存取要求，來建立和刪除 Shopify 與 Amazon Connect Customer Profiles 的整合：
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Customer Profiles 標準訂單物件欄位
下表列出 Customer Profiles 標準訂單物件中的所有欄位。
| 標準訂單欄位 | 資料類型 | Description |
| --- | --- | --- |
| OrderId | String | 標準訂單的唯一識別符。 |
| CustomerEmail | String | 客戶的電子郵件地址。 |
| CustomerPhone | String | 客戶的電話號碼。 |
| CreatedDate | String | 訂單建立日期。 |
| UpdatedDate | String | 訂單更新日期。 |
| ProcessedDate | String | 訂單處理日期。 |
| ClosedDate | String | 訂單關閉日期。 |
| CancelledDate | String | 訂單取消日期。 |
| CancelReason | String | 訂單取消原因。 |
| Name | String | 訂單名稱。 |
| AdditionalInformation | String | 與訂單有關的任何其他資訊。 |
| 閘道 | String | 訂單的付款方式。 |
| 狀態 | String | 訂單狀態。 |
| StatusCode | String | 訂單的狀態代碼。有效值：DRAFT \$1 ACTIVATED |
| StatusUrl | String | 訂單的狀態 URL。 |
| CreditCardNumber | String | 客戶的信用卡末四碼。 |
| CreditCardCompany | String | 客戶的信用卡公司。 |
| FulfillmentStatus | String | 訂單履行狀態。 |
| TotalPrice | String | 訂單總額。 |
| TotalTax | String | 訂單總稅額。 |
| TotalDiscounts | String | 訂單總折扣。 |
| TotalItemsPrice | String | 訂單總項目額。 |
| TotalShippingPrice | String | 訂單總運費。 |
| TotalTipReceived | String | 訂單收到的小費總額。 |
| Currency | String | 訂單所用貨幣。 |
| TotalWeight | String | 訂單總重量。 |
| BillingAddress | OrderAddress | 客戶的帳單地址。 |
| ShippingAddress | OrderAddress | 客戶的運送地址。 |
| OrderItems | OrderItem 清單 | 訂單項目。 |
| 屬性 | 字串對字串對應 | 標準訂單屬性的鍵值對。 |
標準訂單物件會依據下表的索引鍵編製索引。
| 標準索引名稱 | 標準訂單欄位 |
| --- | --- |
| \$1orderId | OrderId |
例如，您可以使用 `_orderId` 作為索引鍵名稱，搭配 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 來尋找具有與搜尋值相符訂單 ID 之訂單的設定檔。您可以使用 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `_order`，以尋找與特定設定檔關聯的標準訂單物件。
## OrderAddress 資料類型
| 標準訂單欄位 | 資料類型 | Description |
| --- | --- | --- |
| Name | String | 與訂單地址相關聯的名稱。 |
| Address1 | String | 訂單地址的第一行。 |
| Address2 | String | 訂單地址的第二行。 |
| Address3 | String | 訂單地址的第三行。 |
| Address4 | String | 訂單地址的第四行。 |
| City | String | 訂單地址的城市。 |
| County | String | 訂單地址的郡/縣。 |
| State | String | 訂單地址的州別。 |
| Province | String | 訂單地址的省份。 |
| Country | String | 訂單地址的國家。 |
| PostalCode | String | 訂單地址的郵遞區號。 |
## OrderItem 資料類型
| 標準訂單欄位 | 資料類型 | Description |
| --- | --- | --- |
| Title | String | 訂單項目的標題。 |
| Price | String | 訂單項目的價格。 |
| 數量 | String | 訂單項目的數量。 |
# 在 Amazon Connect Customer Profiles 中，將 Shopify 物件映射至標準訂單
本主題列出 Shopify 物件中的哪些欄位會對應到客戶設定檔中標準訂單物件中的欄位。
## Shopify-DraftOrder 物件
如需 Shopify-DraftOrder 物件中所有欄位的清單，請參閱 Shopify 文件中的 [DraftOrder 物件](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object)。
## 將 Shopify-DraftOrder 物件對應到標準訂單
Shopify-DraftOrder 物件中欄位的子集會對應到客戶設定檔中的標準訂單物件。
下表列出了哪些欄位可以從 Shopify-DraftOrder 物件對應到標準訂單。
如果來源中存在 `order_status_url`，則 `StatusCode` 為 `ACTIVATED`。否則 `StatusCode` 為 `DRAFT`。
| Shopify-DraftOrder 來源欄位 | 標準訂單目標欄位 |
| --- | --- |
| id | Attributes.ShopifyOrderId |
| customer.id | Attributes.ShopifyCustomerId |
| note | AdditionalInformation |
| email | CustomerEmail |
| currency | Currency |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
| name | Name |
| 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 來源欄位 |
| --- | --- |
| \$1shopifyOrderId | id |
例如，您可以使用 `_shopifyOrderId` 作為 `ObjectFilter.KeyName`，搭配 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API 來尋找標準訂單。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Shopify-DraftOrder`，以尋找與特定設定檔關聯的 Shopify-DraftOrder 物件。
## Shopify-Order 物件
如需 Shopify-Order 物件中所有欄位的清單，請參閱 Shopify 文件中的[訂單物件](https://shopify.dev/api/admin-rest/2021-10/resources/order#resource_object)。
## 將 Shopify-Order 物件對應到標準訂單
Shopify-Order 物件中的欄位的子集會對應到客戶設定檔中的標準訂單物件。
下表列出了哪些欄位可以從 Shopify-Order 物對應到標準訂單。
如果來源中存在 `order_status_url`，則 `StatusCode` 為 `ACTIVATED`。否則 `StatusCode` 為 `DRAFT`。
| Shopify-Order 來源欄位 | 標準訂單目標欄位 |
| --- | --- |
| id | Attributes.ShopifyOrderId |
| customer.id | Attributes.ShopifyCustomerId |
| cancelled\$1at | CancelledDate |
| cancel\$1reason | CancelReason |
| closed\$1at | ClosedDate |
| created\$1at | CreatedDate |
| currency | Currency |
| email | CustomerEmail |
| financial\$1status | 狀態 |
| order\$1status\$1url | StatusCode |
| fulfillment\$1status | FulfillmentStatus |
| 閘道 | 閘道 |
| name | 名稱 |
| note | AdditionalInformation |
| order\$1status\$1url | StatusUrl |
| phone | CustomerPhone |
| processed\$1at | 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 來源欄位 |
| --- | --- |
| \$1shopifyOrderId | id |
例如，您可以使用 `_shopifyOrderId` 作為 `ObjectFilter.KeyName`，搭配 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API 來尋找標準訂單。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Shopify-Order`，以尋找與特定設定檔關聯的 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 欄位 | 資料類型 | Description |
| --- | --- | --- |
| CommunicationRecordId | String | 標準通訊記錄的唯一識別符。 |
| Channel | String | 用於聯絡您的聯絡中心的方式。例如：VOICE、CHAT、EMAIL |
| ConnectInstanceArn | String | AWS Connect 執行個體的 ARN。 |
| CreatedDate | String | 指出通訊記錄建立時間的時間戳記。 |
| UpdatedDate | String | 指出通訊記錄最後更新時間的時間戳記。 |
| LastEventType | String | 此通訊所擷取最後一個事件的事件類型。 |
| 行銷活動 | 行銷活動 | 與此通訊相關的行銷活動詳細資訊。 |
| Endpoint | Endpoint | 用於此通訊之端點的相關資訊。 |
| 事件 | Map | 事件映射，其中索引鍵是事件類型，例如已傳送、已開啟或已點選的電子郵件。這會追蹤此通訊期間所發生每個唯一事件類型的最後一個事件。 |
| 屬性 | Map | 標準通訊記錄屬性的鍵值對。 |
標準通訊記錄物件會依據下表的索引鍵編製索引。
| 標準索引名稱 | 標準通訊記錄欄位 |
| --- | --- |
| \$1communicationRecordId | CommunicationRecordId |
例如，您可以使用 `_communicationRecordId` 作為索引鍵名稱，搭配 [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html) API 來尋找具有與搜尋值相符 `CommunicationRecordId` 之通訊記錄的設定檔。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `_communicationRecord`，以尋找與特定設定檔關聯的標準 `communicationRecord` 物件。
## Campaign 資料類型
| 欄位 | 資料類型 | Description |
| --- | --- | --- |
| CampaignId | String | 對外行銷活動的唯一 ID。 |
| CampaignName | String | 對外行銷活動的名稱。 |
| CampaignRunId | String | 行銷活動特定執行的唯一 ID。 |
| CampaignActivityId | String | 行銷活動內的活動唯一 ID。 |
| SegmentArn | String | 使用者區段的 ARN。 |
## Endpoint 資料類型
| 欄位 | 資料類型 | Description |
| --- | --- | --- |
| EndpointAddress | String | 端點的地址 (例如電子郵件地址、電話號碼)。 |
| EndpointType | String | 端點的類型，例如預設電子郵件或商業電子郵件。 |
## Event 資料類型
| 欄位 | 資料類型 | Description |
| --- | --- | --- |
| UpdatedDate | String | 指出通訊事件發生時間的時間戳記。 |
| EventId | String | 每個通訊事件的唯一識別符。 |
| EventType | String | 特定的通訊事件類型。 |
| 屬性 | Map | 事件類型特有的屬性鍵值對。 |
# 在 Amazon Connect Customer Profiles 中，將 Campaign 物件映射至標準通訊記錄
本主題列出 Campaign 物件中的哪些欄位會映射到 Customer Profiles 中標準通訊記錄物件中的欄位。
## Campaign-Email 物件
如需 Campaign-Email 物件中所有欄位的清單，請參閱 Amazon SES 文件中的[電子郵件物件](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 |
| 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 終端使用者簡訊 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 |
| 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 最終使用者傳訊簡訊文件中的[語音物件](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 |
| 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 |
| 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 AppFlow 存取要求，來建立和刪除 Salesforce 與 Amazon Connect Customer Profiles 的整合：
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Amazon Connect Customer Profiles 中的標準資產定義
下表列出 Customer Profiles 標準資產物件中的所有欄位。
| 標準資產欄位 | 資料類型 | Description |
| --- | --- | --- |
| AssetId | String | 標準資產的唯一識別符。 |
| AssetName | String | 資產的名稱。 |
| SerialNumber | String | 資產的序號。 |
| ModelNumber | String | 資產的模型號碼。 |
| ModelName | String | 資產的模型名稱。 |
| ProductSKU | String | 資產的庫存單位。 |
| PurchaseDate | String | 資產的購買日期。 |
| UsageEndDate | String | 資產的使用結束日期。 |
| 狀態 | String | 資產的狀態。 |
| Price | String | 資產的價格。 |
| 數量 | String | 資產的數量。 |
| Description | String | 資產的說明。 |
| AdditionalInformation | String | 任何與資產相關的其他資訊。 |
| 資料來源 | String | 資產的資料來源。 |
| 屬性 | 字串對字串對應 | 標準資產屬性的鍵值對。 |
標準資產物件會依據下表的索引鍵編製索引。
| 標準索引名稱 | 標準資產欄位 |
| --- | --- |
| \$1assetId | AssetId |
| \$1assetName | AssetName |
| \$1serialNumber | SerialNumber |
例如，您可以使用 `_assetName` 作為索引鍵名稱，搭配 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 來尋找具有與搜尋值相符資產名稱之資產的設定檔。您可以使用 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `_asset`，以尋找與特定設定檔關聯的標準資產物件。
# 在 Customer Profiles 中將 Salesforce 物件映射到標準資產
本主題列出 Salesforce 物件中的哪些欄位會對應到客戶設定檔標準資產物件中的欄位。
## Salesforce-Asset 物件
以下是 Salesforce-Asset 物件中所有欄位的清單。
+ Id
+ ContactId
+ AccountId
+ ParentId
+ RootAssetId
+ Product2Id
+ ProductCode
+ IsCompetitorProduct
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ IsDeleted
+ 名稱
+ SerialNumber
+ InstallDate
+ PurchaseDate
+ UsageEndDate
+ LifecycleStartDate
+ LifecycleEndDate
+ 狀態
+ Price
+ 數量
+ Description
+ OwnerId
+ AssetProvidedById
+ AssetServiceById
+ IsInternal
+ AssetLevel
+ StockKeepingUnit
+ HasLifecycleManagement
+ CurrentMrr
+ CurrentLifecycleEndDate
+ CurrentQuantity
+ CurrentAmount
+ LastViewedDate
+ LastReferencedDate
## 將 Salesforce-Asset 物件對應到標準資產
Salesforce-Asset 物件欄位中的子集會對應到客戶設定檔標準資產物件。
下表列出了哪些欄位可以從 Salesforce-Asset 物件對應到標準資產。
| Saleforce-Asset 來源欄位 | 標準資產目標欄位 |
| --- | --- |
| Id | Attributes.sfdcAssetId |
| ContactId | Attributes.sfdcContactId |
| AccountId | Attributes.sfdcAccountId |
| SerialNumber | SerialNumber |
| StockKeepingUnit | ProductSKU |
| UsageEndDate | UsageEndDate |
| 狀態 | 狀態 |
| Price | Price |
| 數量 | 數量 |
| Description | Description |
Salesforce 物件中的銷售資產客戶資料會使用下表中的索引，與 Amazon Connect 標準資產關聯。
| 標準索引名稱 | Salesforce-Asset 來源欄位 |
| --- | --- |
| \$1salesforceAssetId | Id |
| \$1salesforceContactId | ContactId |
| \$1salesforceAccountId | AccountId |
例如，您可以使用 `_salesforceAssetId` 和 `_salesforceAccountId` 作為 `ObjectFilter.KeyName`，搭配 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API 來尋找標準資產。您可以使用 [ListProfile 物件](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Salesforce-Asset`，以尋找與特定設定檔關聯的 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 AppFlow 存取要求，來建立和刪除 Zendesk 和 ServiceNow 與 Amazon Connect Customer Profiles 的整合：
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Customer Profiles 標準案例物件欄位
下表列出 Customer Profiles 標準案例物件中的所有欄位。
| 標準案例欄位 | 資料類型 | Description |
| --- | --- | --- |
| CaseId | String | 標準案例的唯一識別符。 |
| Title | String | 案件標題 |
| 摘要 | String | 案件摘要。 |
| 狀態 | String | 案件的狀態。 |
| Reason | String | 案件的原因。 |
| CreatedBy | String | 案件的建立者。 |
| CreatedDate | String | 案例的建立日期。 |
| UpdatedDate | String | 案例的更新日期。 |
| ClosedDate | String | 案件的結束日期。 |
| AdditionalInformation | String | 與案件有關的任何其他資訊。 |
| 資料來源 | String | 案例的資料來源。 |
| 屬性 | 字串對字串對應 | 標準案例屬性的鍵值對。 |
標準案例物件會依據下表的索引鍵編製索引。
| 標準索引名稱 | 標準案例欄位 |
| --- | --- |
| \$1caseId | CaseId |
例如，您可以使用 `_caseId` 作為索引鍵名稱，搭配 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 來尋找具有與搜尋值相符案例 ID 之案例的設定檔。您可以使用 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `_case`，以尋找與特定設定檔關聯的標準案例物件。
# 在 Amazon Connect Customer Profiles 中，將 Zendesk 物件映射至標準案例
本主題列出 Zendesk 物件中的哪些欄位對應到客戶設定檔標準案例中的欄位。
## Zendesk-tickets 物件
以下是在 Zendesk-tickets 物件中所有欄位的清單。
+ id
+ url
+ type
+ subject
+ raw\$1subject
+ description
+ priority
+ status
+ recipient
+ 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
+ 標籤
+ 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 物件中欄位的子集會對應到客戶設定檔中的標準案例。下表列出了哪些欄位可以從 Zendesk-tickets 物件對應到標準案例。
| Zendesk-tickets 來源欄位 | 標準案例目標欄位 |
| --- | --- |
| requester\$1id | Attributes.ZendeskUserId |
| id | Attributes.ZendeskTicketId |
| subject | Title |
| description | Summary |
| status | 狀態 |
| requester\$1id | CreatedBy |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
Zendesk 物件中的 ZENDESK 客戶資料使用下列索引與 Amazon Connect 標準案例關聯。
| 標準索引名稱 | Zendesk-tickets 來源欄位 |
| --- | --- |
| \$1zendeskUserId | requester\$1id |
| \$1zendeskTicketId | id |
例如，您可以使用 `_zendeskUserId` 和 `_zendeskTicketId` 作為 `ObjectFilter.KeyName`，並搭配 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API 來尋找標準案例。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Zendesk-tickets`，以尋找與特定設定檔關聯的 Zendesk-tickets 物件。
# 在 Amazon Connect Customer Profiles 中，將 ServiceNow 物件映射至標準案例
本主題列出 ServiceNow 物件中的哪些欄位對應到 Amazon Connect Customer Profiles 中標準案例中的欄位。
## Servicenow-task 物件
以下是 Servicenow-task 物件中所有欄位的清單。
+ sys\$1id
+ active
+ 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
+ comments\$1and\$1work\$1notes
+ company
+ contact\$1type
+ contract
+ correlation\$1display
+ active
+ correlation\$1id
+ delivery\$1plan
+ delivery\$1task
+ description
+ due\$1date
+ escalation
+ expected\$1start
+ follow\$1up
+ group\$1list
+ impact
+ knowledge
+ location
+ made\$1sla
+ number
+ opened\$1at
+ opened\$1by.display\$1value
+ order
+ parent
+ priority
+ reassignment\$1count
+ service\$1offering
+ short\$1description
+ sla\$1due
+ state
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ active
+ 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 物件中欄位的子集會對應到客戶設定檔中的標準案例。
下表列出哪些欄位可以從 Servicenow-task 物件對應到標準案例。
| Servicenow-task 來源欄位 | 標準案例目標欄位 |
| --- | --- |
| sys\$1id | Attributes.ServiceNowTaskId |
| opened\$1by.link | Attributes.ServiceNowSystemUserId |
| short\$1description | Title |
| description | Summary |
| 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 |
例如，您可以使用 `_serviceNowTaskId` 和 `_serviceNowSystemId` 作為 `ObjectFilter.KeyName`，並搭配 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API 來尋找標準案例。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Servicenow-task`，以尋找與特定設定檔關聯的 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 物件中欄位的子集會對應到客戶設定檔中的標準案例。
下表列出哪些欄位可以從 Servicenow-incident 物件對應到標準案例。
| Servicenow-Incident 來源欄位 | 標準案例目標欄位 |
| --- | --- |
| sys\$1id | Attributes\$1ServiceNowIncidentId |
| caller\$1id.link | Attributes\$1ServiceNowSystemUserId |
| incident\$1status | 狀態 |
| caller\$1id.link | CreatedBy |
| resolved\$1at | ClosedDate |
| category | Reason |
使用下表中的索引，來自 Servicenow 物件的 Servicenow-incident 客戶資料與 Amazon Connect 標準案例關聯。
| 標準索引名稱 | Servicenow 來源欄位 |
| --- | --- |
| \$1serviceNowIncidentId | sys\$1id |
| \$1serviceNowSystemId | caller\$1id.link |
例如，您可以使用 `_serviceNowIncidentId` 和 `_serviceNowSystemId` 作為 ObjectFilter.KeyName 搭配 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API 來尋找標準案例。您可以使用 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `Servicenow-incident`，以尋找與特定設定檔關聯的 Servicenow-incident 物件。
# 標準航空偏好設定的物件類型映射
本章節的主題提供標準航空偏好設定的定義。
**Topics**
+ [Customer Profiles 標準航空偏好設定物件欄位](standard-air-preference-object-fields.md)
# Customer Profiles 標準航空偏好設定物件欄位
下表列出 Customer Profiles 標準航空偏好設定物件中的所有欄位。
**航空偏好設定**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| PreferenceId | String | 標準航空偏好設定的唯一識別符 |
| Name | String | 偏好設定的名稱 |
| CreatedDate | String | 偏好設定的建立日期 |
| CreatedBy | String | 建立者的識別符 |
| UpdatedDate | String | 上次更新日期 |
| UpdatedBy | String | 上次更新人員的識別符 |
| StartDate | String | 偏好設定開始日期 |
| EndDate | String | 偏好設定結束日期 |
| 狀態 | String | 偏好設定的目前狀態 |
| ReferenceId | String | 偏好物件的 ID |
| ReferenceType | String | 偏好物件的類型 |
| TravelType | String | 旅程類型 (例如，直飛航班) |
| 轉移 | String | 偏好的轉機類型 |
| ArrivalAirport | String | 偏好抵達機場 |
| ArrivalTerminal | String | 偏好的抵達機場航廈 |
| DepartureAirport | String | 偏好出發機場 |
| DepartureTerminal | String | 偏好的出發機場航廈 |
| HomeAirport | String | 母國機場 |
| CheckInChannel | String | 入住辦理模式 |
| CheckInChannelDevice | String | 用於辦理入住的裝置 |
| Language | Language | 通訊偏好語言的詳細資訊 |
| Seat | Seat | 座位選擇的詳細資訊 |
| Journey | Journey | 旅程偏好設定 |
| Accessibility | Accessibility | 無障礙要求的詳細資訊 |
| Insurance | Insurance | 保險詳細資訊 |
| Interest | Interest | 興趣詳細資訊 |
| Loyalty | Loyalty | 忠誠度詳細資訊 |
| Dining | Dining | 餐飲偏好設定 |
| MediaEntertainment | MediaEntertainment | 媒體和娛樂偏好設定 |
| PaymentForm | PaymentForm | 付款方式偏好設定 |
| PetInfo | PetInfo | 寵物詳細資訊 |
| SpecialRequest | SpecialRequest | 特殊要求詳細資訊 |
| TicketDistribution | TicketDistribution | 分票偏好設定 |
| Marketing | Marketing | 行銷活動偏好設定 |
| Medical | Medical | 醫療相關偏好設定 |
| Baggage | Baggage | 行李相關偏好設定 |
| ContactDetail | ContactDetail | 偏好設定中的聯絡人詳細資訊 |
| ContactDetailAddress | ContactDetailAddress | 聯絡人詳細資訊的地址 |
| ContactDetailCommunication | ContactDetailCommunication | 通訊偏好設定 |
| 屬性 | Map | 航空偏好設定的屬性鍵值對 |
標準航空偏好設定物件會依據下表的索引鍵編製索引。
**標準索引欄位**
| 標準索引名稱 | 標準偏好設定記錄欄位 |
| --- | --- |
| \$1airPreferenceId | PreferenceId |
| \$1airReferenceId | ReferenceId |
例如，您可以使用 `_airPreferenceId` 作為索引鍵名稱，搭配 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 來尋找具有與搜尋值相符偏好設定 ID 之航空偏好設定的設定檔。您可以使用 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `_airPreference`，以尋找與特定設定檔關聯的標準航空偏好設定物件。
**ContactDetail 資料類型**
| 標準 airPreference 欄位 | 資料類型 | 說明 |
| --- | --- | --- |
| Type | String | 聯絡類型 (例如個人、緊急) |
| PreferenceLevel | String | 此聯絡的優先順序層級 |
| PhoneNumber | String | 電話號碼 |
| 關係 | String | 與設定檔的關係 |
| EmailAddress | String | 電子郵件地址 |
| EmailLanguage | String | 聯絡詳細資訊電子郵件通訊的偏好語言 |
| PhoneLanguage | String | 聯絡詳細資訊電話通訊的偏好語言 |
**ContactDetailAddress 資料類型**
| 標準 airPreference 欄位 | 資料類型 | 說明 |
| --- | --- | --- |
| Type | String | 聯絡人的地址類型 |
| Address1 | String | 聯絡人地址的第一行。 |
| Address2 | String | 聯絡人地址的第二行。 |
| Address3 | String | 聯絡人地址的第三行。 |
| Address4 | String | 聯絡人地址的第四行。 |
| City | String | 聯絡人地址的城市。 |
| Country | String | 聯絡人地址的國家。 |
| County | String | 聯絡人地址的郡/縣。 |
| PostalCode | String | 聯絡人地址的郵遞區號。 |
| Province | String | 聯絡人地址的省份。 |
| State | String | 聯絡人地址的州別。 |
**ContactDetailCommunication 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Method | String | 通訊方式 (例如 SMS、電子郵件) |
| PreferenceLevel | String | 通訊方式的偏好程度 |
**Language 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| PhoneLanguage | String | 電話通訊的偏好語言 |
| EmailLanguage | String | 電子郵件通訊的偏好語言 |
| InPersonLanguage | String | 實體溝通的偏好語言 |
| PreferenceLevel | String | 語言的偏好程度 |
**Seat 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| PreferenceLevel | String | 座位偏好設定的優先順序 |
| Direction | String | 偏好的座位方向 (例如前、後) |
| Location | String | 偏好的座位位置 (例如靠窗、靠走道) |
| 位置 | String | 座位位置 (例如左、右) |
| Row | String | 想要的座位列 |
| ClassOfService | String | 艙等 (例如經濟艙、商務艙) |
| NeighborFree | String | 無鄰座的偏好設定 |
| Infant | String | 嬰兒座位的偏好設定 |
| ExtraSeat | String | 額外座位的偏好設定 |
**Journey 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| MaxConnections | String | 允許的最多轉機次數 |
| PreferredAirline | String | 偏好的航空公司 |
| UpgradeAuction | String | 選擇加入升級競拍賣 |
| FlightTime | String | 偏好的飛行時間 |
| FlightMaxDuration | String | 偏好的旅程連續時長上限 |
**Accessibility 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Wheelchair | String | 輪椅無障礙資訊 |
| Bathroom | String | 浴室無障礙資訊 |
| Assistance | String | 協助資訊 |
| DisabilityType | String | 失能相關資訊 |
| SupportAnimal | String | 輔助動物資訊 |
| ProximityToFacilities | String | 需要靠近設施 |
**Insurance 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Name | String | 保險商或方案名稱 |
| PreferenceLevel | String | 保險的偏好程度 |
**Interest 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Name | String | 特定感興趣的領域 |
| PreferenceLevel | String | 此興趣的優先順序 |
**Loyalty 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Name | String | 忠誠度計劃的名稱 |
| MembershipId | String | 忠誠度計劃中的會員 ID |
| PreferenceLevel | String | 忠誠度計劃的偏好程度 |
**Dining 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| MealType | String | 偏好的餐飲類型 |
| FavoriteCuisine | String | 最愛的美饌類型 |
| Beverage | String | 偏好的飲料 |
| DietaryRestriction | String | 餐飲限制 |
| AllergyInfo | String | 過敏相關詳細資訊 |
| PreferenceLevel | String | 餐飲的偏好程度 |
**媒體和娛樂資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Name | String | 偏好的娛樂名稱 |
| PreferenceLevel | String | 媒體/娛樂的偏好程度 |
**PaymentForm 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Name | String | 付款方式名稱 |
| Type | String | 付款類型 (例如信用卡、PayPal) |
| PreferenceLevel | String | 付款方式的偏好程度 |
| UsageContext | String | 該付款方式的使用時機 |
**PetInfo 資料類型**
| 標準 airPreference 欄位 | 資料類型 | 說明 |
| --- | --- | --- |
| Type | String | 寵物類型 |
| PreferenceLevel | String | 寵物的偏好程度 |
**SpecialRequest 資料類型**
| 標準 airPreference 欄位 | 資料類型 | 說明 |
| --- | --- | --- |
| Type | String | 特殊要求的類型 |
| Name | String | 要求名稱或說明 |
| PreferenceLevel | String | 要求的優先順序層級 |
**TicketDistribution 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| PreferenceLevel | String | 分票的偏好程度 |
| Method | String | 票證交付方式 (例如電子郵件、實體票證) |
| TicketTime | String | 票證交付的偏好時間 |
**Marketing 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| ChannelType | String | 行銷管道的類型 (例如 SMS、電子郵件) |
| OptIn | String | 行銷活動的選擇加入狀態 |
| Frequency (頻率) | String | 行銷通訊的頻率 |
| StartDate | String | 行銷活動偏好設定的開始日期 |
| EndDate | String | 行銷活動偏好設定的結束日期 |
**Medical 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Oxygen | String | (由航空公司提供、乘客自有、濃縮器等) |
| MedicalEquipment | String | 醫療設備的詳細資訊 (例如 CPAP 機器、氧氣濃縮器)。 |
| Assistance | String | 說明旅客在旅途中是否需要一般醫療協助 (例如機上支援、藥物協助)。 |
| Stretcher | String | 旅客在飛行期間是否需要擔架；通常用於醫療運輸情況。 |
| WheelChair | String | 輪椅詳細資訊 (非溢漏式電池、濕電池、固定、需要斜板、需要上下樓輔助、由航空公司提供等) |
**Baggage 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Animal | String | 說明旅客是否攜帶輔助動物或寵物，以及相關規格或限制 (例如手拿、寵物籠) |
| BaggageType | String | 說明偏好的行李類型 (例如僅限手提、託運、超大行李)。 |
| Assistance | String | 說明旅客是否需要協助運送或管理其行李，例如機場運輸服務或路邊包車協助。 |
| PreferenceLevel | String | 行李欄位的偏好程度 |
# 標準住宿偏好設定的物件類型映射
本章節的主題提供標準住宿偏好設定的定義。
**Topics**
+ [Customer Profiles 標準住宿偏好設定物件欄位](standard-hotel-preference-object-fields.md)
# Customer Profiles 標準住宿偏好設定物件欄位
下表列出 Customer Profiles 標準住宿偏好設定物件中的所有欄位。
**住宿偏好設定**
| 標準 hotelPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| PreferenceId | String | 標準住宿偏好設定的唯一識別符 |
| Name | String | 偏好設定的名稱 |
| CreatedDate | String | 偏好設定的建立日期 |
| CreatedBy | String | 建立者的識別符 |
| UpdatedDate | String | 上次更新日期 |
| UpdatedBy | String | 上次更新人員的識別符 |
| StartDate | String | 偏好設定開始日期 |
| EndDate | String | 偏好設定結束日期 |
| 狀態 | String | 偏好設定的目前狀態 |
| Smoking | String | 吸菸偏好設定 |
| CleaningTime | String | 清理時間 |
| CheckInType | String | 入住辦理類型 |
| CheckOutType | String | 退房辦理類型 |
| ReferenceId | String | 偏好物件的 ID |
| ReferenceType | String | 偏好物件的類型 |
| Location | Location | 飯店房間位置的偏好設定 |
| Bedding | Bedding | 寢具偏好設定 |
| Tour | Tour | 導覽偏好設定 |
| ContactDetail | ContactDetail | 偏好設定中的聯絡人詳細資訊 |
| ContactDetailAddress | ContactDetailAddress | 聯絡人詳細資訊的地址 |
| ContactDetailCommunication | ContactDetailCommunication | 通訊偏好設定 |
| Language | Language | 語言偏好設定 |
| CarRental | CarRental | 汽車租賃偏好設定 |
| Accessibility | Accessibility | 無障礙偏好設定 |
| Interest | Interest | 興趣相關詳細資訊 |
| Loyalty | Loyalty | 忠誠度偏好設定 |
| Dining | Dining | 餐飲偏好設定 |
| MediaEntertainment | MediaEntertainment | 媒體和娛樂偏好設定 |
| PaymentForm | PaymentForm | 付款方式偏好設定 |
| PetInfo | PetInfo | 寵物資訊偏好設定 |
| SpecialRequest | SpecialRequest | 特殊要求的詳細資訊 |
| Marketing | Marketing | 行銷活動偏好設定 |
| Medical | Medical | 醫療偏好設定 |
| Baggage | Baggage | 行李偏好設定 |
| 屬性 | Map | 住宿偏好設定的屬性鍵值對 |
標準住宿偏好設定物件會依據下表的索引鍵編製索引。
**標準索引欄位**
| 標準索引名稱 | 標準偏好設定記錄欄位 |
| --- | --- |
| \$1hotelPreferenceId | PreferenceId |
| \$1hotelReferenceId | ReferenceId |
例如，您可以使用 `_hotelPreferenceId` 作為索引鍵名稱，搭配 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 來尋找具有與搜尋值相符偏好設定 ID 之住宿偏好設定的設定檔。您可以使用 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)，並將 `ProfileId` 和 `ObjectTypeName` 設定為 `_hotelPreference`，以尋找與特定設定檔關聯的標準住宿偏好設定物件。
**ContactDetail 資料類型**
| 標準 airPreference 欄位 | 資料類型 | 說明 |
| --- | --- | --- |
| Type | String | 聯絡類型 (例如個人、緊急) |
| PreferenceLevel | String | 此聯絡的優先順序層級 |
| PhoneNumber | String | 電話號碼 |
| 關係 | String | 與設定檔的關係 |
| EmailAddress | String | 電子郵件地址 |
| EmailLanguage | String | 聯絡詳細資訊電子郵件通訊的偏好語言 |
| PhoneLanguage | String | 聯絡詳細資訊電話通訊的偏好語言 |
**ContactDetailAddress 資料類型**
| 標準 airPreference 欄位 | 資料類型 | 說明 |
| --- | --- | --- |
| Type | String | 聯絡人的地址類型 |
| Address1 | String | 聯絡人地址的第一行。 |
| Address2 | String | 聯絡人地址的第二行。 |
| Address3 | String | 聯絡人地址的第三行。 |
| Address4 | String | 聯絡人地址的第四行。 |
| City | String | 聯絡人地址的城市。 |
| Country | String | 聯絡人地址的國家。 |
| County | String | 聯絡人地址的郡/縣。 |
| PostalCode | String | 聯絡人地址的郵遞區號。 |
| Province | String | 聯絡人地址的省份。 |
| State | String | 聯絡人地址的州別。 |
**ContactDetailCommunication 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| Method | String | 通訊方式 |
| PreferenceLevel | String | 通訊方式的偏好程度 |
| Frequency (頻率) | String | 通訊頻率 |
**Language 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| PhoneLanguage | String | 偏好的通話語言 |
| EmailLanguage | String | 偏好的電子郵件語言 |
**CarRental 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| 廠商 | String | 偏好的租車廠商 |
| VehicleType | String | 偏好的車輛類型 |
| PreferenceLevel | String | 汽車租賃的偏好程度 |
**Location 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| PreferredFloor | String | 房間樓層的偏好設定 |
| ElevatorProximity | String | 靠近電梯的偏好設定 |
| QuietZone | String | 安靜區域的偏好設定 |
| LobbyProximity | String | 靠近大廳的偏好設定 |
| 檢視 | String | 想要的房間景觀 |
| RoomType | String | 偏好房型 |
| PreferenceLevel | String | 位置的偏好程度 |
**Bedding 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| BedType | String | 偏好床型 |
| MattressType | String | 偏好床墊類型 |
| PillowType | String | 偏好枕頭類型 |
| NumberOfPillows | String | 偏好的枕頭數量 |
| BeddingMaterial | String | 寢具材料 |
| Allergy | String | 過敏相關寢具偏好設定 |
**Tour 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| City | String | 偏好的旅遊城市 |
| Cultural | String | 文化導覽興趣 |
| Adventure | String | 冒險旅程興趣 |
| Nightlife | String | 夜生活探索興趣 |
| GuideLanguage | String | 旅遊導覽的偏好語言 |
| StartTime | String | 偏好的導覽開始時間 |
| GroupSize | String | 偏好的導覽團體規模 |
| PreferenceLevel | String | 導覽偏好的重要性 |
**Accessibility 資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Wheelchair | String | 輪椅無障礙資訊 |
| Bathroom | String | 浴室無障礙資訊 |
| Assistance | String | 協助資訊 |
| DisabilityType | String | 失能相關資訊 |
| SupportAnimal | String | 輔助動物資訊 |
| ProximityToFacilities | String | 需要靠近設施 |
**Interest 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| NameOfInterest | String | 興趣的名稱 |
| PreferenceLevel | String | 興趣的偏好程度 |
**Loyalty 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| LoyaltyName | String | 忠誠度計劃的名稱 |
| MembershipId | String | 忠誠度會員資格 ID |
| PreferenceLevel | String | 忠誠度的偏好程度 |
| PriorityServices | String | 優先服務的偏好設定 |
**Dining 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| MealType | String | 偏好的餐飲類型 |
| FavoriteCuisine | String | 最愛的美饌偏好 |
| Beverage | String | 飲料偏好設定 |
| DietaryRestriction | String | 餐飲限制 |
| AllergyInfo | String | 過敏相關資訊 |
| PreferenceLevel | String | 餐飲的偏好程度 |
**MediaEntertainment 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| Name | String | 偏好的媒體或娛樂名稱 |
| PreferenceLevel | String | 媒體或娛樂的偏好程度 |
**PaymentForm 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| Name | String | 與付款方式相關的名稱 |
| Type | String | 付款方式類型 |
| PreferenceLevel | String | 付款方式的偏好程度 |
| UsageContext | String | 該付款方式的使用時機 |
**PetInfo 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| Type | String | 寵物類型 |
| PreferenceLevel | String | 寵物的偏好程度 |
**特殊要求資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| Type | String | 特殊要求的類型 |
| Name | String | 特殊要求的名稱 |
| PreferenceLevel | String | 要求的偏好程度 |
**Marketing 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| ChannelType | String | 行銷管道的類型 (例如 SMS、電子郵件) |
| OptIn | String | 行銷活動的選擇加入狀態 |
| Frequency (頻率) | String | 行銷通訊的頻率 |
| StartDate | String | 行銷活動偏好設定的開始日期 |
| EndDate | String | 行銷活動偏好設定的結束日期 |
**Medical 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| Oxygen | String | 氧氣供應偏好設定 |
| MedicalEquipment | String | 醫療設備的詳細資訊 |
| Assistance | String | 所需醫療協助類型 |
| Stretcher | String | 擔架使用者需求 |
| WheelChair | String | 所需輪椅類型和協助 |
**Baggage 資料類型**
| 標準 hotelPreference 欄位 | Type | 說明 |
| --- | --- | --- |
| Bicycle | String | 自行車行李需求 |
| BaggageType | String | 行李詳細資訊 (例如重荷行李) |
| Courier | String | 快遞相關行李偏好設定 |
| Fragile | String | 易碎項目偏好設定 |
| 偏好程度 | String | 行李偏好程度 |
# 標準航空預訂的物件類型映射
本章節的主題提供標準航空預訂的定義。
**Topics**
+ [Customer Profiles 標準航空預訂物件欄位](standard-air-booking-object-fields.md)
# Customer Profiles 標準航空預訂物件欄位
下表列出 Customer Profiles 標準航空預訂物件中的所有欄位。
**AirBooking**
| 標準 airBooking 欄位 | Type | 說明 |
| --- | --- | --- |
| BookingId | String | 標準航空預訂的唯一識別符 |
| ContextId | String | 用於追蹤預訂來源的內容特定識別符 |
| PreferenceRef | String | 參照預訂偏好設定物件的識別符 |
| BookingName | String | 與預訂相關的名稱 |
| PassengerIndex | String | 預訂中乘客的索引 |
| TravellerId | String | 預訂相關旅客的唯一識別符 |
| GroupBooking | String | 說明該預訂是否為團體預訂 |
| NumberOfPassengers | String | 預訂中乘客的總數 |
| NumberOfAdults | String | 預訂中成人的總數 |
| NumberOfChildren | String | 預訂中孩童的總數 |
| ProcessedDate | String | 預訂處理日期 |
| CreatedDate | String | 預訂建立日期 |
| CreatedBy | String | 建立者的身分 |
| UpdatedDate | String | 上次更新日期 |
| UpdatedBy | String | 上次更新預訂者的識別符 |
| 狀態 | String | 目前的預訂狀態 |
| PriorityStatus | String | 預訂的優先順序層級 |
| ReservationStatus | String | 預訂的保留狀態 |
| MarketingCode | String | 代表行銷活動來源或行銷活動的代碼 |
| MarketingName | String | 行銷活動名稱 |
| TravelAgent | String | 預訂相關旅行社 |
| TravelAgency | String | 旅行社名稱 |
| TravelCorpNumber | String | 公司客戶號碼 |
| Booker | String | 說明該人員是否為進行預訂的人員 |
| AdditionalInformation | String | 其他資訊 (不限格式) |
| Email | String | 取得旅遊日更新的聯絡電子郵件 |
| PhoneNumber | String | 取得旅遊日更新的聯絡電話 |
| CancelledDate | String | 取消預訂的日期 (如適用) |
| Diplomat | String | 說明其外交身分 |
| Child | String | 說明該乘客是否為孩童 |
| Disabled | String | 說明失能狀態 |
| Oxygen | String | 表示需要氧氣支援 |
| PetOnly | String | 該預訂僅用於運送寵物 |
| CancellationCharge | String | 取消費用 (若適用)。0 表示不收費 |
| Refundable | String | 預訂退款相關詳細資訊 |
| Inventory | Inventory | 預訂清查詳細資訊 |
| Loyalty | Loyalty | 預訂忠誠度詳細資訊 |
| Channel | Channel | 預訂管道詳細資訊 |
| Payment | Payment | 預訂付款詳細資訊 |
| BillingAddress | 地址 | 預訂的帳單地址詳細資訊 |
| Price | Price | 預訂價格詳細資訊 |
| PaymentStatus | PaymentStatus | 預訂的付款狀態 |
| 屬性 | Map | 自訂或延伸屬性 |
**標準索引欄位**
| 標準索引名稱 | 標準偏好設定記錄欄位 |
| --- | --- |
| \$1airBookingId | BookingId |
| \$1airPreferenceRef | PreferenceRef |
**Loyalty 資料類型**
| 標準 airBooking 欄位 | Type | 說明 |
| --- | --- | --- |
| ProgramName | String | 忠誠度計劃的名稱 |
| MembershipId | String | 忠誠度計劃會員號碼 |
| Tier | String | 忠誠度會員資格等級 |
**Channel 資料類型**
| 標準 airBooking 欄位 | Type | 說明 |
| --- | --- | --- |
| CreationChannelId | String | 用來建立預訂的管道 ID |
| LastUpdatedChannelId | String | 用來更新預訂的管道 ID |
| Method | String | 管道使用方式 (例如網站、應用程式、電話) |
**Payment 資料類型**
| 標準 airBooking 欄位 | Type | 說明 |
| --- | --- | --- |
| Type | String | 付款方式類型 (例如卡片、折價券) |
| CreditCardToken | String | 用於安全參考的字符化卡片 |
| CreditCardType | String | 使用的卡片類型 |
| CreditCardExpiration | String | 卡片到期日期 |
| Cvv | String | CVV 號碼 |
| NameOnCreditCard | String | 持卡人名稱 |
| RoutingNumber | String | 銀行匯款路徑號碼 (如適用) |
| AccountNumber | String | 銀行帳戶號碼 (如適用) |
| VoucherId | String | 用於付款的折價券 |
| DiscountCode | String | 已套用的促銷折扣代碼 |
| DiscountPercent | String | 套用至款項的折扣百分比 |
**帳單地址資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Address1 | String | 客戶地址的第一行。 |
| Address2 | String | 客戶地址的第二行。 |
| Address3 | String | 客戶地址的第三行。 |
| Address4 | String | 客戶地址的第四行。 |
| City | String | 客戶地址的城市。 |
| Country | String | 客戶地址的國家。 |
| County | String | 客戶地址的郡/縣。 |
| PostalCode | String | 客戶地址的郵遞區號。 |
| Province | String | 客戶地址的省份。 |
| State | String | 客戶地址的州別。 |
**Price 資料類型**
| 標準 airBooking 欄位 | Type | 說明 |
| --- | --- | --- |
| TotalPrice | String | 預訂總價格 |
| BasePrice | String | 預訂基本價格 |
| TravellerPrice | String | 每位旅客所支付的價格 |
| DiscountAmount | String | 套用至基本票價的折扣 |
| Currency | String | 付款貨幣 |
**付款狀態資料類型**
| 標準 airBooking 欄位 | Type | 說明 |
| --- | --- | --- |
| PaidAt | String | 付款完成時的時間戳記 |
| AwaitingPayment | String | 表示付款審核中 |
| RequiredBy | String | 付款到期日期 |
**Inventory 資料類型**
| 標準 airBooking 欄位 | Type | 說明 |
| --- | --- | --- |
| Seats | String | 預訂座位總數 |
# 標準航空客群的物件類型映射
本章節的主題提供標準航空客群的定義。
**Topics**
+ [Customer Profiles 標準航空客群物件欄位](standard-air-segment-object-fields.md)
# Customer Profiles 標準航空客群物件欄位
下表列出 Customer Profiles 標準航空客群物件中的所有欄位。
**航空客群**
| 標準 airSegment 欄位 | Type | 說明 |
| --- | --- | --- |
| SegmentId | String | 標準航空客群的唯一識別符 |
| BookingRef | String | 預訂參考識別符 |
| SegmentName | String | 客群名稱/說明 |
| PassengerIndex | String | 乘客的索引號碼 |
| SegmentIndex | String | 客群的索引號碼 |
| SeatSelection | String | 選位詳細資訊 |
| NumberOfPassengers | String | 乘客總數 |
| NumberOfLegs | String | 飛行趟數 |
| Tier | String | 乘客層級/狀態等級 |
| Origin | String | 出發機場代碼 |
| OriginCountryCode | String | 出發國家代碼 |
| Dest | String | 目的地機場代碼 |
| DestCountryCode | String | 目的地國家代碼 |
| ProcessedDate | String | 客群處理日期 |
| CreatedDate | String | 記錄建立日期 |
| CreatedBy | String | 記錄建立者 |
| UpdatedDate | String | 記錄上次更新日期 |
| UpdatedBy | String | 記錄上次更新者 |
| 狀態 | String | 客群的目前狀態 |
| FlightNumber | String | 航班號碼 |
| Carrier | String | 航空公司代碼 |
| CarrierType | String | 航空公司類型 |
| IsInternational | String | 說明該航班是否為國際線 |
| IsEticket | String | 說明是否為電子票證 |
| IsArmed | String | 說明是否為武裝乘客 |
| LapInfant | String | 不佔位嬰兒的詳細資訊 |
| Pet | String | 指出是否攜帶寵物 |
| PrisonerOrGuard | String | 指出監禁或戒護狀態 |
| Child | String | 說明乘客是否為孩童 |
| Married | String | 指出是否已婚 |
| CheckinEligible | String | 表示入住資格 |
| InEligibleReason | String | 不符合入住資格的原因 |
| UnEscortedMinor | String | 表示無陪同未成年人的狀態 |
| PremiumAccess | String | 表示為付費資格購買 |
| MissingData | String | 表示遺失的資料 |
| CurrentClassOfService | String | 目前的服務等級 |
| BookedClassOfService | String | 原始預訂的服務等級 |
| CodeShare | String | 表示共掛航班 |
| ReverseCodeShare | String | 表示反向班號共用 |
| MarketCarrierCode | String | 銷售航空公司代碼 |
| OpCarrierCode | String | 航空公司代碼 |
| InConnection | String | 進站航班詳細資訊 |
| OutConnection | String | 出站航班詳細資訊 |
| MilesToEarn | String | 可賺取的里程數 |
| 持續時間 | String | 飛行持續時間 |
| DurationTimeUnit | String | 持續時間的時間單位 |
| 距離 | String | 飛行距離 |
| DistanceUnit | String | 飛行距離的距離單位 |
| SellType | String | 表示這是否為強賣 |
| GoShow | String | 表示這是否為即時搭機 |
| Incapacitated | String | 指出乘客是否無行為能力 |
| Upgraded | String | 指出該航班是否已升等 |
| Downgraded | String | 指出該航班是否已降等 |
| BaggageInsurance | String | 行李保險 |
| MaxAllowedBaggage | String | 允許的行李上限 |
| BaggageQuantity | String | 行李數量 |
| BaggageFee | String | 總行李費用 |
| 抵達 | 站點 | 客群的抵達詳細資訊 |
| 出發 | 站點 | 客群的出發詳細資訊 |
| Seat | Seat | 座位詳細資訊 |
| Priority | Priority | 優先順序詳細資訊 |
| Doc | Doc | 旅行隨附文件的資訊 |
| Baggage | 行李清單 | 行李詳細資訊 |
| Pets | 寵物清單 | 寵物詳細資訊 |
| OtherServices | 其他服務清單 | 其他服務詳細資訊 |
| 屬性 | Map | 其他屬性 |
**標準索引欄位**
| 標準索引名稱 | 標準偏好設定記錄欄位 |
| --- | --- |
| \$1airSegmentId | SegmentId |
| \$1airBookingRef | BookingRef |
**Baggage 資料類型**
| 標準 airSegment 欄位 | Type | 說明 |
| --- | --- | --- |
| Id | String | 行李識別符 |
| TagNumber | String | 行李標籤號碼 |
| DepartureDate | String | 出發日期 |
| BaggageType | String | 行李類型 |
| Weight (粗細) | String | 行李重量 |
| Length | String | 行李長度 |
| Width | String | 行李寬度 |
| Height | String | 行李高度 |
| PriorityBagDrop | String | 行李優先放置服務 |
| PriorityBagReturn | String | 行李優先取回服務 |
| HandsFreeBaggage | String | 免持行李服務 |
| Fee | String | 行李費用 |
| IsGateBag | String | 表示登機門檢查行李 |
| IsHeavy | String | 表示重荷行李 |
**Seat 資料類型**
| 標準 airSegment 欄位 | Type | 說明 |
| --- | --- | --- |
| SeatNumber | String | 座位號碼 |
| SeatZone | String | 座位區域 |
| SeatType | String | 座位類型 |
| Price | String | 座位價格 |
| NeighborFree | String | 指出鄰座是否為空位 |
| UpgradeAuction | String | 表示是否可以競價升等 |
| Available | String | 表示座位是否開放 |
| ExtraSeat | String | 表示額外座位 |
| AdditionalInformation | String | 額外座位資訊 |
**Port 資料類型**
| 標準 airSegment 欄位 | Type | 說明 |
| --- | --- | --- |
| Location | String | 位置名稱 |
| Code | String | 機場代碼 |
| 終端機 | String | 機場航廈 |
| Country | String | 機場國家 |
| Date | String | Date |
| 時間 | String | 時間 |
| EstimatedTime | String | 預估時間 |
| ScheduledTime | String | 排定時間 |
**Priority 資料類型**
| 標準 airSegment 欄位 | Type | 說明 |
| --- | --- | --- |
| TransactionId | String | 交易識別碼 |
| PriorityServiceType | String | 優先服務的類型 |
| LoungeAccess | String | 表示於機場大廳取得 |
| Price | String | 優先服務價格 |
| AdditionalInformation | String | 額外優先資訊 |
**Pet 資料類型**
| 標準 airSegment 欄位 | Type | 說明 |
| --- | --- | --- |
| Species | String | 寵物種類 |
| Breed | String | 寵物品種 |
| Weight (粗細) | String | 寵物重量 |
| WeightUnit | String | 重量計算單位 |
| TransportType | String | 寵物運輸類型 |
**OtherService 資料類型**
| 標準 airSegment 欄位 | Type | 說明 |
| --- | --- | --- |
| ServiceType | String | 服務類型 |
| Description | String | 服務說明 |
| Price | String | 服務價格 |
**Doc 資料類型**
| 標準 airSegment 欄位 | Type | 說明 |
| --- | --- | --- |
| DocType | String | 文件類型 |
| DocTypeNeeded | String | 指出是否為必要文件 |
| Nationality | String | 文件上的國籍 |
| DateOfBirth | String | 出生日期 |
| AppId | String | 應用程式識別符 |
| AgentId | String | 客服人員識別符 |
| VerifiedDateTime | String | 文件驗證時間 |
# 標準飯店預訂的物件類型映射
本章節的主題提供標準飯店預訂的定義。
**Topics**
+ [Customer Profiles 標準飯店預訂物件欄位](standard-hotel-reservation-object-fields.md)
# Customer Profiles 標準飯店預訂物件欄位
下表列出 Customer Profiles 標準飯店預訂物件中的所有欄位。
**飯店預訂**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| ReservationId | String | 標準飯店預訂的唯一識別符 |
| ConfirmationNumber | String | 飯店或預訂引擎提供的確認號碼 |
| PreferenceRef | String | 參照預訂偏好設定物件的識別符 |
| 狀態 | String | 預訂的目前狀態 (例如已確認、已取消) |
| TripType | String | 旅遊目的或性質 (例如休閒、商務) |
| BrandCode | String | 代表飯店品牌的代碼 |
| HotelCode | String | 識別特定飯店的代碼 |
| PhoneNumber | String | 預訂聯絡人電話號碼 |
| EmailAddress | String | 預訂聯絡人電子郵件地址 |
| GroupId | String | 將預訂連結至團體預訂的 ID |
| ContextId | String | 用於追蹤預訂來源的內容特定識別符 |
| ProcessedDate | String | 處理預訂時的時間戳記 |
| CreatedDate | String | 建立預訂時的時間戳記 |
| CreatedBy | String | 建立預訂的使用者/系統識別符 |
| UpdatedDate | String | 上次更新預訂時的時間戳記 |
| UpdatedBy | String | 更新預訂的使用者/系統識別符 |
| AgentId | String | 處理預訂的客服人員 ID |
| Reserver | String | 表示該設定檔是否為預訂人 |
| SameDayRate | String | 表示是否在同一天進行預訂 |
| Refundable | String | 指出預訂是否可退款 |
| CancellationCharge | String | 取消費用 (若適用)。0 表示不收費 |
| TransactionId | String | 交易的唯一識別符 |
| AmountPerNight | String | 房間每晚金額 |
| AdditionalNote | String | 特殊備註或指示 |
| NumberOfNights | String | 預訂天數 |
| NumberOfGuests | String | 預訂貴賓總數 |
| TotalAmountBeforeTax | String | 稅前總費用 |
| TotalAmountAfterTax | String | 稅後總費用 |
| Checkout | CheckOut | 結帳詳細資訊 |
| Loyalty | Loyalty | 忠誠度詳細資訊 |
| Room | Room | 房間詳細資訊 |
| CheckIn | CheckIn | 入住辦理詳細資訊 |
| Payment | Payment | 付款詳細資訊 |
| Currency | Currency | 貨幣詳細資訊 |
| Cancellation | Cancellation | 取消詳細資訊 |
| Channel | Channel | 管道詳細資訊 |
| RatePlan | RatePlan | 計費方案詳細資訊 |
| Guests | Guests | 貴賓詳細資訊 |
| 服務 | 服務清單 | 服務清單 |
| 屬性 | Map | 其他屬性 |
**標準索引欄位**
| 標準索引名稱 | 標準偏好設定記錄欄位 |
| --- | --- |
| \$1hotelReservationId | ReservationId |
| \$1hotelPreferenceRef | preferenceRef |
**Checkout 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| Early | String | 已排程或要求提早結帳 |
| Late | String | 已排程或要求延後結帳 |
| Self | String | 已排程或要求自助結帳 |
| Date | String | 預訂的結帳日期 |
**Loyalty 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| ProgramName | String | 忠誠度計劃的名稱 |
| MembershipId | String | 忠誠度計劃中的會員 ID |
| Tier | String | 忠誠度層級 |
**Room 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| TypeCode | String | 房間類型/類別的代碼 |
| TypeName | String | 房型名稱 |
| TypeDesc | String | 房型描述 |
| Number | String | 指派的房號 |
| Capacity | String | 房間容納人數上限 |
| AccessibilityType | String | 無障礙功能 |
| SmokingAllowed | String | 表示是否可以在房間內抽菸 |
**CheckIn 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| Date | String | 預訂的入住日期 |
| DigitalKey | String | 表示是否已提供數位房間鑰匙 |
| Early | String | 指出是否已要求提早入住 |
| Late | String | 指出是否已要求延後入住 |
| RoomKeys | String | 提供的房間鑰匙數量 |
| UserSelectedRoom | String | 如果房客自己選擇房間，則為 true |
**Payment 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| Type | String | 付款方式類型 (例如信用卡、金融卡、折價券) |
| CreditCardToken | String | 字符化的信用卡號碼 |
| CreditCardType | String | 信用卡類型 (例如 Visa、Amex) |
| CreditCardExpiration | String | 信用卡到期日 |
| Cvv | String | 卡片驗證值 |
| NameOnCreditCard | String | 信用卡上的姓名 |
| RoutingNumber | String | 銀行匯款路線號碼 |
| AccountNumber | String | 銀行帳戶號碼 |
| VoucherId | String | 折價券識別符 (如適用) |
| DiscountCode | String | 已套用的折扣代碼 |
| DiscountPercent | String | 已套用的折扣百分比 |
**Currency 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| Code | String | 貨幣的 ISO 代碼 (例如 USD) |
| Name | String | 貨幣全名 (例如美元) |
| Symbol | String | 貨幣符號 (例如 \$1) |
**Cancellation 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| Reason | String | 取消原因 |
| Comment | String | 其他取消備註 |
**Channel 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| CreationChannelId | String | 預訂管道的 ID |
| LastUpdatedChannelId | String | 上次更新預訂的管道 ID |
| Method | String | 預訂方法 (例如網站、行動應用程式) |
**RatePlan 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| Code | String | 預訂計費方案的代碼識別符 |
| Name | String | 預訂計費方案的名稱 |
| Description | String | 計費方案的說明 |
**Service 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| ServiceType | String | 服務類型 (例如 SPA、早餐) |
| Description | String | 服務說明 |
| Cost | String | 服務費用 |
**Guest 資料類型**
| 標準 hotelReservation 欄位 | Type | 說明 |
| --- | --- | --- |
| Adults | String | 成人人數 |
| Children | String | 孩童人數 |
# 標準忠誠度的物件類型映射
本章節的主題提供標準忠誠度的定義。
**Topics**
+ [Customer Profiles 標準忠誠度物件欄位](standard-loyalty-object-fields.md)
# Customer Profiles 標準忠誠度物件欄位
下表列出 Customer Profiles 標準忠誠度物件中的所有欄位。
**Loyalty**
| 標準 loyalty 欄位 | Type | 說明 |
| --- | --- | --- |
| LoyaltyId | String | 標準忠誠度的唯一識別符 |
| ProgramId | String | 忠誠度計劃的識別符 |
| MembershipId | String | 計劃中的替代識別符 |
| ProgramName | String | 忠誠度計劃的名稱 |
| Group | String | 忠誠度計劃的群組或類別 |
| Channel | String | 存取忠誠度計劃的管道 |
| CreatedDate | String | 忠誠度帳戶的建立日期 |
| EnrollmentDate | String | 計劃的註冊日期 |
| CreatedBy | String | 建立忠誠度帳戶的使用者或系統 |
| UpdatedDate | String | 上次更新忠誠度帳戶的日期 |
| LastUpdatedBy | String | 上次更新忠誠度帳戶的使用者或系統 |
| UpgradeDate | String | 上次升級方案的日期 |
| RenewalDate | String | 忠誠度會員資格的續約日期 |
| AdditionalInformation | String | 任何其他資訊 |
| EmailAddress | String | 客戶的電子郵件地址 |
| EmailAddressVerified | String | 標示是否已驗證電子郵件的旗標 |
| PhoneNumber | String | 客戶的電話號碼 |
| PhoneNumberVerified | String | 表示是否已驗證電話號碼的旗標 |
| 狀態 | String | 忠誠度帳戶的目前狀態 |
| Tier | Tier | 層級詳細資訊 |
| Points | Points | 點數詳細資訊 |
| PointExpirations | PointExpiration 清單 | 點數過期詳細資訊 |
| Payment | Payment | 付款詳細資訊 |
| PaymentInformation | PaymentInformation | 付款資訊詳細資訊 |
| BillingAddress | 忠誠度地址 | 地址詳細資訊 |
| 屬性 | Map | 未涵蓋的其他屬性 |
**標準索引欄位**
| 標準索引名稱 | 標準偏好設定記錄欄位 |
| --- | --- |
| \$1loyaltyId | LoyaltyId |
| \$1loyaltyMembershipId | membershipId |
**忠誠度地址資料類型**
| 標準 airPreference 欄位 | 資料類型 | Description |
| --- | --- | --- |
| Address1 | String | 客戶地址的第一行。 |
| Address2 | String | 客戶地址的第二行。 |
| Address3 | String | 客戶地址的第三行。 |
| Address4 | String | 客戶地址的第四行。 |
| City | String | 客戶居住的城市。 |
| Country | String | 客戶居住的國家/地區。 |
| County | String | 客戶居住的縣。 |
| PostalCode | String | 客戶地址的郵遞區號。 |
| Province | String | 客戶居住的省份。 |
| State | String | 客戶居住的州。 |
**Tier 資料類型**
| 標準 loyalty 欄位 | Type | 說明 |
| --- | --- | --- |
| CurrentTier | String | 客戶目前的忠誠度層級 |
| NextTier | String | 客戶的下一個可能層級 |
| PointsToNextTier | String | 達到下一個層級所需的點數 |
**Points 資料類型**
| 標準 loyalty 欄位 | Type | 說明 |
| --- | --- | --- |
| Points.Unit | String | 點數計算單位 |
| Points.Lifetime | String | 獲得的終身點數總數 |
| Points.Balance | String | 目前的點數餘額 |
| Points.Redeemed | String | 已兌換的總點數 |
**PointExpiration 資料類型**
| 標準 loyalty 欄位 | Type | 說明 |
| --- | --- | --- |
| Points | String | 點數即將到期 |
| Date | String | 點數的過期日期 |
**Payment 資料類型**
| 標準 loyalty 欄位 | Type | 說明 |
| --- | --- | --- |
| Type | String | 付款類型 |
| CreditCardToken | String | 字符化信用卡參考號碼 |
| CreditCardType | String | 信用卡類型 (例如 Visa) |
| CreditCardExpiration | String | 信用卡到期日 |
| Cvv | String | 卡片驗證值 |
| NameOnCreditCard | String | 卡片上的名稱 |
| RoutingNumber | String | 銀行匯款路線號碼 |
| AccountNumber | String | 銀行帳戶號碼 |
| VoucherId | String | 折價券識別符 |
**PaymentInformation 資料類型**
| 標準 loyalty 欄位 | Type | 說明 |
| --- | --- | --- |
| Schedule | String | 付款排程 |
| LastPaymentDate | String | 上次付款日期 |
| NextPaymentDate | String | 下次付款日期 |
| NextBillAmount | String | 下次帳單金額 |
| CurrencyCode | String | 貨幣代碼 (例如 USD) |
| CurrencyName | String | 貨幣全名 |
| CurrencySymbol | String | 貨幣符號 (例如 \$1) |
# 標準忠誠度交易的物件類型映射
本章節的主題提供標準忠誠度交易的定義。
**Topics**
+ [Customer Profiles 標準忠誠度交易物件欄位](standard-loyalty-transaction-object-fields.md)
# Customer Profiles 標準忠誠度交易物件欄位
下表列出 Customer Profiles 標準忠誠度交易物件中的所有欄位。
**忠誠度交易**
| 標準 loyaltyTransaction 欄位 | Type | 說明 |
| --- | --- | --- |
| TransactionId | String | 標準忠誠度交易的唯一識別符。 |
| TransactionName | String | 交易名稱或標籤。 |
| TransactionType | String | 交易類型 (例如獲得、兌換、調整)。 |
| ProgramRef | String | 相關忠誠度計劃的參考號碼。 |
| MembershipRef | String | 交易所使用忠誠度會員資格參考號碼。 |
| PromotionRef | String | 影響此交易的促銷活動參考號碼。 |
| CreatedDate | String | 交易建立日期。 |
| TransactionDate | String | 交易發生日期。 |
| Industry | String | 交易相關產業 (例如航空公司、旅宿業)。 |
| Location | String | 交易發生位置。 |
| CreatedBy | String | 交易建立者的識別符。 |
| UpdatedDate | String | 交易上次更新的日期。 |
| UpdatedBy | String | 交易上次更新者的識別符。 |
| 狀態 | String | 交易的目前狀態。 |
| AccrualType | String | 累積方式 (手動、自動等)。 |
| Category | String | 交易類別 (例如航班、住宿)。 |
| Channel | String | 啟動交易的管道 (例如線上、實體)。 |
| ProductId | String | 繫結至交易的產品或服務之識別符。 |
| Amount | String | 交易的花費或交易金額。 |
| OriginValue | String | 任何轉換或抵銷前的原始值。 |
| OriginValueCurrency | String | 原始交易值所用貨幣。 |
| OriginValueOffset | String | 調整促銷活動、退款等的原始值。 |
| PointsEarned | String | 從此交易獲得的總點數。 |
| PointOffset | String | 已調整的點數 (例如獎勵點數、處罰點數)。 |
| QualifyingPointsEarned | String | 計入層級資格的點數。 |
| TierBefore | String | 交易前的客戶層級。 |
| TierAfter | String | 交易後的客戶層級。 |
| Brand | String | 交易相關品牌。 |
| Description | String | 交易的敘述性描述。 |
| AdditionalInformation | String | 交易相關其他資訊 (自由格式)。 |
| PaymentMethod | String | 所使用付款方式 (例如卡片、折價券)。 |
| PointTransfer | PointTransfer | 點數轉移詳細資訊 |
| 屬性 | Map | 其他屬性。 |
**標準索引欄位**
| 標準索引名稱 | 標準偏好設定記錄欄位 |
| --- | --- |
| \$1loyaltyTransactionId | TransactionId |
**PointTransfer 資料類型**
| 標準 loyaltyTransaction 欄位 | Type | 說明 |
| --- | --- | --- |
| TransferId | String | 轉移交易的識別碼。 |
| SourceProgramId | String | 來源忠誠度計劃的 ID。 |
| DestinationProgrmId | String | 目的地忠誠度計劃的 ID。 |
| SourceMembershipId | String | 來源計劃中的會員 ID。 |
| DestinationMembershipId | String | 目的地計劃中的會員 ID。 |
| PointsTransferred | String | 從來源計劃扣除的點數。 |
| PointsReceived | String | 計入目的地計劃的點數。 |
# 標準忠誠度促銷活動的物件類型映射
本章節的主題提供標準忠誠度促銷活動的定義。
使用
**Topics**
+ [Customer Profiles 標準忠誠度促銷活動物件欄位](standard-loyalty-promotion-object-fields.md)
# Customer Profiles 標準忠誠度促銷活動物件欄位
下表列出 Customer Profiles 標準忠誠度促銷活動物件中的所有欄位。
**忠誠度促銷活動**
| 標準 loyaltyPromotion 欄位 | Type | 說明 |
| --- | --- | --- |
| PromotionId | String | 標準忠誠度促銷活動的唯一識別符。 |
| PromotionName | String | 顯示促銷活動的名稱。 |
| PromotionType | String | 促銷活動類型或類別 (例如獎勵、提升層級、折價券)。 |
| ProgramType | String | 指出該促銷活動所繫結的忠誠度計劃類型。 |
| ProgramRef | String | 相關忠誠度計劃的參考 ID。 |
| PartnerId | String | 參與促銷活動之合作夥伴組織的參考 ID。 |
| PartnerNumber | String | 合作夥伴相關識別符或號碼。 |
| Tier | String | 促銷活動的目標層級或受其影響的層級。 |
| StartDate | String | 促銷活動開始日期。 |
| EnrolledDate | String | 使用者註冊促銷活動的日期。 |
| EndDate | String | 促銷活動結束日期。 |
| Amount | String | 促銷活動相關金額或點數。 |
| Period | String | 促銷活動期間 (例如每週、每月、以行銷活動為基礎)。 |
| 狀態 | String | 促銷活動的目前狀態 (例如開放中、過期、已完成)。 |
| CreatedDate | String | 促銷活動記錄的建立日期。 |
| CreatedBy | String | 建立促銷活動記錄的使用者或系統。 |
| UpdatedDate | String | 促銷活動記錄上次更新日期。 |
| UpdatedBy | String | 上次更新促銷活動的使用者或系統。 |
| CampaignRef | String | 此促銷活動所屬活動的外部參考號碼。 |
| AdditionalInformation | String | 促銷活動相關其他備註或行銷副本。 |
| TriggerLimit | TriggerLimit | 觸發限制的詳細資訊 |
| Usage | Usage | 用量詳細資訊 |
| Rules | Rules | 促銷活動規則詳細資訊 |
| Incentive | Incentive | 促銷活動獎勵詳細資訊 |
| 屬性 | Map | 其他中繼資料或計劃特定值。 |
**標準索引欄位**
| 標準索引名稱 | 標準偏好設定記錄欄位 |
| --- | --- |
| \$1loyaltyPromotionId | PromotionId |
**Rules 資料類型**
| 標準 loyaltyPromotion 欄位 | Type | 說明 |
| --- | --- | --- |
| Name | String | 促銷活動規則中的規則名稱。 |
| Description | String | 促銷活動規則中的規則說明。 |
**Incentive 資料類型**
| 標準 loyaltyPromotion 欄位 | Type | 說明 |
| --- | --- | --- |
| Type | String | 獎勵類型 (例如獎勵點數、折價券、層級升級)。 |
| Value | String | 獎勵的值，例如點數或折價金額。 |
| 單位 | String | 獎勵值的單位 (例如點數、百分比、美元)。 |
**TriggerLimit 資料類型**
| 標準 loyaltyPromotion 欄位 | Type | 說明 |
| --- | --- | --- |
| Times | String | 促銷活動可以觸發的次數。 |
| Interval | String | 觸發限制的間隔。 |
**Usage 資料類型**
| 標準 loyaltyPromotion 欄位 | Type | 說明 |
| --- | --- | --- |
| UsageProgressPercent | String | 促銷活動使用量的進度百分比。 |
| UsageCompleted | String | 已完成的使用量數量。 |
| UsageTarget | String | 目標使用量。 |
# Web Analytics 物件的物件類型映射
**WebAnalytics 標準物件結構描述**
| 欄位 | Type | 說明 |
| --- | --- | --- |
| 事件屬性 |
| EventId | String | Web 分析事件的唯一識別符。 |
| EventType | String | Web 分析事件的類型，例如 - Page View、表單提交、按一下按鈕、s提取主線\$1u0000搜尋列互動、應用程式錯誤提示、購物車互動、購買、捲動等。 |
| EventTimestamp | Number | 事件的 Epoch 毫秒時間戳記。 |
| EventDuration | Number | EventDuration 代表使用者在特定互動期間花費的時間量，以秒為單位。常見的使用案例包括：檢視產品所花費的時間、特定頁面上的瀏覽工作階段長度、功能所花費的時間等。 |
| EventValue | Number | EventValue 是數值屬性，代表互動事件的值或重要性。常見使用案例包括：交易事件的購買金額、產品評分的評分值、影片檢視的完成百分比等。 |
| 工作階段屬性 |
| Session.Id | String | 工作階段的唯一識別符。 |
| Session.StartTimestamp | Number | Epoch 毫秒表示工作階段的開始時間戳記。 |
| 頁面/畫面屬性 |
| Page.Title | String | 行動應用程式的 Web 應用程式/畫面名稱標題。 |
| Page.Location | String | 網頁的 URL。對於行動裝置，可能是螢幕的深層連結或路由。 |
| Page.Referrer | String | 上一個畫面/頁面。 |
| Page.Category | String | 畫面/頁面的邏輯分組。可能有助於將巢狀 URLs/應用程式位置分組。 |
| HTML/DOM 元素 |
| Element.Id | String | HTML 元素 ID |
| Element.Type | String | 元素類型 - 按鈕、錨點連結、等 |
| Element.Classes | String | 元素的 CSS 樣式類別 |
| Element.Text | String | 元素文字 （適用於按鈕、輸入欄位預留位置等）。 |
| Element.AltText | String | HTML 元素的 AltText （通常用於影像）。 |
| Element.Source | String | 影片、影像等的來源 |
| 表格 |
| Form.Id | String | 輸入表單的唯一識別符 |
| Form.Name | String | 表單的名稱 |
| Form.Length | String | 表單中的輸入欄位數目。 |
| Form.ValidationErrors | Number | 表單中的驗證錯誤數目。 |
| Form.FieldsCompleted | Number | 完成的欄位數量。 |
| Form.FieldsRequired | Number | 必要欄位的數量。 |
| 搜尋 |
| Search.Query | String | 輸入中使用的查詢字串 |
| Search.TotalMatchingResults | Number | 搜尋結果的總數。 |
| Search.ResultsPerPage | Number | 每頁顯示的結果數量。 |
| Search.CurrentResultsPage | Number | 使用者正在檢視的目前結果頁面。 |
| Search.FilterExpression | String | 使用的任何其他篩選條件表達式。 |
| Search.SortCriteria | String | 排序搜尋結果的條件。例如 - 相關性、價格等。 |
| Search.SortOrder | String | 搜尋結果的排序順序 - 遞增/遞減。 |
| 項目/項目清單 |
| 項目 | 項目 | 事件中的聚焦項目，指出新增至購物車的項目、檢視的項目等。 |
| ItemsList | List- | 事件中的項目聚焦清單，指出購買的項目、購物車中的項目、項目搜尋結果等。 |
| 項目印象 |
| AdditionalItemImpressions | List
- | 其他項目印模清單 |
| 購物車 |
| Cart.Id | String | 購物車的唯一識別符。 |
| Cart.ItemsCount | Number | 購物車中的項目數量。 |
| Cart.Currency | String | 購物車值的貨幣。 |
| Cart.Value | Number | 購物車中項目的貨幣值。 |
| 訂單資訊 |
| OrderId | String | 訂單的唯一識別符。我們只會將訂單識別符存放在此處，與訂單相關的其他資訊會存放在標準訂單物件中。 |
| 裝置 |
| DeviceId | String | 使用者裝置的唯一識別符。 |
| 捲動屬性 |
| Scroll.DepthPercentage | String | 垂直捲動深度百分比。這有助於了解使用者捲動網頁的程度。 |
| Scroll.PositionX | Number | 從左側以像素為單位的水平捲動位置。 |
| Scroll.PositionY | Number | 從頂端以像素為單位的垂直捲動位置。 |
| 錯誤 |
| Error.Description | String | 錯誤的簡短描述。 |
| Error.Type | String | 使用者輸入錯誤/伺服器錯誤。 |
| 使用者 |
| User.Id | String | 使用者的唯一識別符 |
| User.AnonymousId | String | 匿名 UserId。當使用者未登入時，這會是指派給使用者uniqueId。 |
| User.IsReturning | String | 布林值，指出使用者是否正在重新檢視。 |
| User.IsLoggedIn | String | 指出使用者是否登入的布林值。 |
| 活動位置 |
| Location.Country | String | 使用者活動國家/地區。 |
| Location.State | String | 使用者活動狀態。 |
| 位置.省 | String | 使用者活動省份。 |
| Location.County | String | 使用者活動郡。 |
| Location.City | String | 使用者活動城市。 |
| Location.Latitude | String | 使用者活動位置座標 |
| Location.Longitude | String | 使用者活動位置座標 |
| 應用程式屬性 |
| Application.Name | String | 應用程式名稱。 |
| Application.Version | String | 如果裝置是 Mobile，我們可以在此處擷取應用程式版本。使用者也可以考慮將此用於人口 A/B 測試或實驗屬性。 |
| Application.Environment | String | 應用程式環境，例如 - Beta、Gamma、Prod。 |
| 自訂屬性 |
| 屬性 | Map | 要新增至事件的任何自訂屬性或中繼資料。 |
**WebAnalytics 項目物件結構描述**
| 欄位 | Type | 說明 |
| --- | --- | --- |
| Id | String | 項目的唯一識別符。 |
| Title | String | 項目的標題。 |
| Category | String | 項目的類別。 |
| Value | String | 項目的貨幣值。 |
| Currency | String | 項目的貨幣。 |
| 數量 | Number | 項目的數量。 |
| ImpressionType | String | 識別事件印模類型的字串。例如 - 精選、贊助、最佳挑選等。 |
| ImpressionId | String | 用於唯一識別印模的字串識別符。 |
**裝置標準物件結構描述**
| 欄位 | Type | 說明 |
| --- | --- | --- |
| DeviceId | String | 裝置的唯一識別符。 |
| Type | String | 裝置類型 （例如桌上型電腦、行動裝置） |
| 模型 | String | 裝置模型，例如 - Macbook Pro/Air、IPhone 16 等。 |
| 製造商 | String | 裝置製造商。 |
| OperatingSystem | String | 指出 Windows、MacOs、IOS、Android。 |
| OperatingSystemVersion | String | 作業系統版本 |
| ScreenWidth | Number | Screen ViewPort 的寬度 |
| ScreenHeight | Number | Screen ViewPort 的高度 |
| 瀏覽器 | String | 使用者與之互動的瀏覽器名稱。 |
| BrowserVersion | String | 瀏覽器版本 |
| Locale | String | 裝置或應用程式地區設定。 |
| 屬性 | Map | 裝置的任何自訂屬性。 |
# Item Catalog 的物件類型映射
| 欄位 | Type | 說明 |
| --- | --- | --- |
| Id | String | 目錄中項目的唯一識別符。 |
| Name | String | 項目的名稱 |
| Code | String | 目錄項目的程式碼 |
| Type | String | 目錄項目的類型 |
| Category | String | 目錄中項目的類別 |
| Description | String | 項目描述 |
| AdditionalInformation | String | 與該項目有關的任何其他資訊。 |
| ImageLink | String | 連結至項目的影像 |
| 連結 | String | 項目 URL |
| Price | String | 項目的價格 |
| CreatedAt | Long | 建立項目的 Epoch 時間戳記 |
| UpdatedAt | Long | 已更新項目的 Epoch 時間戳記 |
| 屬性 | Map | 其他項目屬性 |
**注意**
您只能透過 APIs刪除網域物件類型。在先刪除所有建議者之後，您可以刪除項目目錄整合。這可防止資料相依性問題。
**刪除的步驟：**
1. 刪除您網域中的所有現有推薦者
2. 導覽至項目目錄整合。
3. 選取刪除選項。
# 標準飯店住宿收入的物件類型映射
本章節的主題提供標準飯店住宿收入的定義。
**Topics**
+ [Customer Profiles 標準飯店住宿收入物件欄位](standard-hotel-stay-revenue-object-fields.md)
# Customer Profiles 標準飯店住宿收入物件欄位
下表列出 Customer Profiles 標準飯店住宿收入物件中的所有欄位。
**飯店住宿收入**
| 標準 hotelStayRevenue 欄位 | Type | 說明 |
| --- | --- | --- |
| StayRevenueId | String | 標準飯店住宿收入的唯一識別符。 |
| CurrencyCode | String | 貨幣的 ISO 代碼 (例如 USD) |
| CurrencyName | String | 貨幣全名 (例如美元) |
| CurrencySymbol | String | 貨幣符號 (例如 \$1) |
| ReservationId | String | 飯店預訂的唯一識別符 |
| GuestId | String | 訪客的唯一識別符 |
| LastUpdatedOn | String | 上次更新住宿記錄的時間戳記 |
| CreatedOn | String | 建立住宿記錄的時間戳記 |
| LastUpdatedBy | String | 上次更新住宿記錄的使用者/系統識別符 |
| CreatedBy | String | 建立住宿記錄的使用者/系統識別符 |
| StartDate | String | 住宿開始日期 |
| HotelCode | String | 識別特定飯店的代碼 |
| Type | String | 收入類型 (例如房價、雜費、稅金) |
| Description | String | 收入項目說明 |
| Amount | String | 收入項目的金額 |
| ProcessedDate | String | 處理收入的日期 |
| 狀態 | String | 收入項目的狀態 |
| 屬性 | Map | 其他中繼資料或計劃特定值。 |
**標準索引欄位**
| 標準索引名稱 | 標準偏好設定記錄欄位 |
| --- | --- |
| \$1hotelStayRevenueId | StayRevenueId |