本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon Connect Customer Profiles 中的物件類型映射
物件類型映射會告訴客戶設定檔如何擷取特定類型的資料。它向 Customer Profiles 提供必要資訊，例如：
+ 應如何從物件填入資料並擷取至標準設定檔物件。
+ 物件中的哪些欄位應該建立索引，以及應該如何使用這些欄位將此類型的物件指派給特定設定檔。
本章節的主題提供資訊和步驟，協助您設定物件類型映射，包括如何建立物件類型映射、映射定義詳細資訊，以及關鍵概念和術語。
**Topics**
+ [客戶物件類型映射的術語和概念](customer-profiles-terminology.md)
+ [建立物件類型映射](create-object-type-mapping.md)
+ [Amazon Connect Customer Profiles 中的物件類型映射定義詳細資訊](object-type-mapping-definition-details.md)
+ [Customer Profiles 中物件類型的其他屬性](additional-properties-object-types.md)
+ [推斷的設定檔](inferred-profiles.md)
+ [聯絡人記錄範本](ctr-contact-record-template.md)
+ [在 Customer Profiles 中，將聯絡人記錄與使用 \$1phone 索引鍵找到的一個設定檔建立關聯](auto-associate-profile-using-phone-profile-key.md)
+ [Amazon Connect Customer Profiles 中的物件類型映射範例](examples-object-type-mappings.md)
+ [Amazon Connect Customer Profiles 中的隱含設定檔物件類型](implicit-profile-object-types.md)
+ [生成式 AI 支援的資料映射](genai-powered-data-mapping.md)
+ [Customer Profiles 資料限制](customer-profiles-data-limits.md)
# 客戶物件類型映射的術語和概念
下列術語和概念對於您了解自訂物件類型對應非常重要：
**標準設定檔物件**
*標準設定檔物件*是所有設定檔包含的預先定義物件。
標準設定檔物件包含標準欄位，例如電話號碼、電子郵件地址、姓名和其他標準資料。無論來源為何 (例如 Salesforce、ServiceNow 或 Marketo)，都可以使用標準格式擷取此資料。
**設定檔物件**
*設定檔物件*是關於設定檔已知資訊的單一單位。例如，有關電話、票證、案例，甚至網站點擊流記錄的資訊。
單一設定檔物件最多可達 250 KB，而且可以是任何結構化 JSON 文件。
+ 每個設定檔物件都有一個類型。例如，設定檔物件可以是 Amazon Connect 聯絡人記錄、ServiceNow Users 或 Marketo Leads。
+ 類型會參照物件類型對應。
+ 物件類型對應會定義如何將該特定物件擷取至客戶設定檔。
**設定檔**
*設定檔*包含特定客戶或聯絡人的所有已知資訊。它包括單一標準設定檔物件和任意數目的其他設定檔物件。
**物件類型映射**
*物件類型對映*會告訴客戶設定檔如何擷取特定類型的資料。它向客戶設定檔提供下列資訊：
+ 應如何從物件填入資料並擷取至標準設定檔物件。
+ 物件中的哪些欄位應該建立索引，以及應該如何使用這些欄位將此類型的物件指派給特定設定檔。
**映射範本**
*對映範本*是包含在客戶設定檔服務中的預先定義物件類型對映。
Customer Profiles 包括 Amazon Connect 聯絡人記錄、Salesforce Accounts、ServiceNow Users 和 Marketo Leads 的對應範本。如需可用對映範本的完整清單，請使用 [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html) API。
透過對應範本，您可以快速擷取眾所周知來源的資料，而無需指定任何其他資訊。
# 建立 Amazon Connect Customer Profiles 中的物件類型映射
物件類型對應可告知客戶設定檔如何從來源應用程式 (例如 Salesforce、Zendesk 或 S3) 內嵌特定類型的資料至統一的標準設定檔物件中。然後，您可以使用 [Amazon Connect 客服人員應用程式](customer-profile-access.md) 向客服人員顯示該物件中的資料 (例如，客戶地址和電子郵件)。
物件類型對應會提供客戶設定檔下列資訊：
+ 應如何從物件填入資料並擷取至標準設定檔物件。
+ 物件中的哪些欄位應該建立索引，以及應該如何使用這些欄位將此類型的物件指派給特定設定檔。
建立物件類型對應的方法有兩種：
+ 使用 Amazon Connect 主控台。使用者介面可讓您輕鬆存取資料對映功能。例如，您可以新增自訂屬性，並定義聯絡人模型的搜尋和唯一識別符。不必寫程式！
+ 使用客戶設定檔 API。如需詳細資訊，請參閱 [Amazon Connect Customer Profiles API Reference](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html)。
本主題介紹如何使用 Amazon Connect 主控台建立對應。
## 使用 Amazon Connect 主控台建立資料對映
Amazon Connect 提供無程式碼的體驗，可將自家開發和第三方應用程式的客戶資料與 Amazon S3、Salesforce、ServiceNow、Zendesk 和 Marketo 對應。
若要建立資料對映，您可以定義描述自訂設定檔物件外觀的物件類型對應。此對應定義了如何使用資料中的欄位來填入標準設定檔中的欄位，或如何使用這些欄位將資料指派給特定設定檔。
### 步驟 1：設定資料對映
1. 在 [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/) 開啟 Amazon Connect 主控台。
1. 在執行個體頁面上，選擇執行個體別名。執行個體別名也是您的**執行個體名稱**，它會出現在您的 Amazon Connect URL 中。下圖顯示 **Amazon Connect 虛擬聯絡中心執行個體**頁面，其中包含執行個體別名周圍的方塊。
![\[Amazon Connect 虛擬聯絡中心執行個體頁面，即執行個體別名。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/instance.png)
1. 在導覽窗格中，選擇**客戶設定檔**、**資料對映**。
1. 選擇**建立資料對映**以便開始。
1. 在**設定資料對映**頁面的**描述**區段中，新增可協助您識別此對映的來源或用途的名稱。這是物件類型的中繼資料。
1. 在**資料來源**區段中：
1. 選擇資料來自何處，例如 Salesforce 或 Zendesk。Amazon Connect 會根據您的選擇，根據預先定義的範本自動選擇可用的目的地。
1. 選擇來源物件。這會用來建立統一的設定檔。
1. 在**對映目標**區段中，選擇您要用來建立統一客戶設定檔的資料。此資訊可以浮現在您的流程和客服人員中，使得與聯絡人的互動個人化。
如需受支援對映目的地的詳細資訊，請參閱 [關於 Amazon Connect 中的映射目的地](about-mapping-destinations.md)。
1. 在**其他選項**區段中，您可以選擇停止建立新設定檔的時間，以及保留這些設定檔的時間長度。這些選項可協助您管理成本。
**注意**
在預設情況下，網域保留期間為 366 天。若要變更網域上設定的保留期限，請使用 [UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html) API。
1. 如果您選擇 S3 以外的來源，請在**建立連線***應用程式*區段中，選擇現有的 Amazon AppFlow 或 Amazon EventBridge 連線來連接您的資料，或建立新的連線。您可以輸入有關此資料來源帳戶的詳細資訊，以建立新連線。
建立連線後，您將選擇要從資料來源擷取的物件。
1. 選擇**下一步**。
### 步驟 2：對應屬性
在**對映*類型*屬性**頁面上，您會看到根據對映目的地填入預先定義範本的欄位對映表格。例如，它填滿了客戶、產品、案例或訂單屬性。您可以選擇屬性 (例如 AccountNumber)，然後選擇不同的目的地，或輸入您自己的自訂屬性，來變更預先定義的範本。
下圖顯示頁面範例，其中包含範本中的客戶屬性。
![\[Amazon Connect 導覽選單，映射客戶屬性頁面。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/customer-profiles-data-mapping-2.png)
您可以移除不想在客戶設定檔中填入的內容、變更來源，以及新增自訂屬性。
此對應會使用您的資料來源來填入客戶聯絡資訊，例如客戶設定檔中的電話號碼。它使用標準設定檔範本中的屬性。
**提示**
如果您選擇新增自訂屬性，目的地一律會新增字首 `Attributes.`。這使 Amazon Connect 能夠識別出它是一個自訂屬性。
![\[客戶屬性映射介面，其中顯示映射至目的地欄位的來源欄位。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/custom-attribute-cp.png)
客服人員現在可以在**其他資訊**標籤下的「Connect 客服人員應用程式」中按字母順序排序檢視。您可以使用下列格式，為每個要向客服人員顯示的屬性建立您選擇的名稱：`/^Attributes\.[a-zA-Z0-9]+(?:[ _\-]+[a-zA-Z0-9]+)*$/`
所有擷取的自訂屬性都會顯示在 Connect 客服人員應用程式中。如果您不希望向客服人員顯示特定資訊，請不要在此時擷取自訂屬性。
### 步驟 3：指定識別符
在**指定識別碼**頁面上，完成下列各節。視您要對應的資料而定，這些資料可能並非全部都會出現在您的頁面上。
**注意**
名稱 `_profileId`、`_orderId`、`_caseId` 和 `_assetId` 係保留供內部使用。如果您決定使用這些名稱作為識別碼名稱之一，則必須將其聲明為 `LOOKUP_ONLY`，這意味著我們的系統不會保存它們以比對設定檔、標準資產、標準訂單、標準案例，或保存它們以搜索您的個人資料、資產、案例或訂單。如果您希望這些索引鍵可用於搜尋和比對，您必須重新命名您的索引鍵。如需 `LOOKUP_ONLY` 標準識別碼的詳細資訊，請參閱 [Customer Profiles 中，索引鍵上設定屬性的標準識別符](standard-identifiers.md)。
+ **唯一識別碼**：您的資料必須具有唯一識別碼，以避免在擷取資料時發生錯誤。此識別符也稱為唯一索引鍵。Customer Profiles 使用它來區分此資料與其他資料來源物件，並為搜尋和更新資料建立索引。
只能有一個唯一識別符。
+ **客戶識別碼**：您的資料必須至少有一個客戶識別碼，以避免在擷取時發生錯誤。該識別符也稱為設定檔索引鍵。
Customer Profiles 會使用它來判斷資料案例是否與現有設定檔相關聯，還是透過搜尋此識別符的其他設定檔來建立新的設定檔。
您可以擁有多個客戶識別符。
**提示**
客服人員可以使用 Agent Workspace 中的任何客戶識別符來尋找互動中屬於客戶的設定檔。
+ **產品識別碼**：您的資料必須至少有一個產品識別碼，以避免在擷取時發生錯誤。該識別符也稱為資產索引鍵。
Customer Profiles 使用它來區分此資料與其他客戶產品購買資料。它還用於透過搜索此識別符的其他設定檔，以確定資料是否可與現有設定檔關聯或用於建立新設定檔。
您可以擁有多個產品識別符。
+ **案例識別碼**：您的資料必須至少有一個案例識別碼，以避免在擷取時發生錯誤。該識別符也稱為案例索引鍵。
Customer Profiles 使用它來區分此資料與其他與其他客戶案例資料。它還用於透過搜索此識別符的其他設定檔，以確定資料是否可與現有設定檔關聯或用於建立新設定檔。
您可以有多個案例識別符。
+ **訂單識別碼**：您的資料必須至少有一個訂單識別碼，以避免擷取時發生錯誤。該識別符也稱為訂單索引鍵。
Customer Profiles 使用它來區分此資料與其他客戶訂單資料。它還用於透過搜索此識別符的其他設定檔，以確定資料是否可與現有設定檔關聯或用於建立新設定檔。
您可以有多個訂單識別符。
+ **其他搜尋屬性 – 選用**：您可以在資料來源物件中選擇要索引以供搜尋的屬性。預設情況下，您的所有識別符都會建置索引。
**提示**
如果資料來源物件中的搜尋屬性大部分包含相同的值，可能導致資料擷取速度變慢。建議您在資料來源物件中建立不重複的搜尋屬性。
+ **資料物件時間戳記**：當啟用身分解析以合併類似設定檔時，資料物件時間戳記會用於解決設定檔衝突。當兩個或兩個以上的類似設定檔具有衝突的記錄時，將會使用具有最近更新時間戳記的設定檔中的記錄。
您可以在物件中選擇一個屬性，以便參考物件上次更新的時間。
### 步驟 4：檢閱和建立
建立資料對映之後，您可以選擇**新增資料來源整合**，以使用此物件類型。
![\[Amazon Connect Customer Profiles 介面，其中顯示範例資料映射詳細資訊和整合狀態。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/customer-profiles-data-mapping-3.png)
# 關於 Amazon Connect 中的映射目的地
映射目的地是您從來源到 Amazon Connect 中已定義之標準定義的映射。
下表列出支援的映射目的地。
| 來源物件 | 目的地：客戶、產品、訂單、案例 |
| --- | --- |
| S3 | 任何 |
| Salesforce-Account | 客戶 |
| Salesforce-Contact | 客戶 |
| Salesforce-Asset | 產品 |
| Zendesk-users | 客戶 |
| Marketo-leads | 客戶 |
| Servicenow-sys\$1user | 客戶 |
| Segment-Identify | 客戶 |
| Segment-Customer | 客戶 |
| Shopify-Customer | 客戶 |
| Shopify-DraftOrder | 順序 |
| Zendesk-tickets | 案例 |
| Servicenow-task | 案例 |
| Servicenow-incident | 案例 |
# Customer Profiles 的物件類型映射要求
您的物件類型映射中必須包含下列資訊，以便客戶設定檔可以處理傳入資料：
+ 擷取物件中應對應到標準設定檔，或用於將資料指派給設定檔的所有欄位的定義。這會告訴客戶設定檔，擷取**來源**物件中的哪些欄位應映射到標準設定檔物件中的指定欄位。
+ 應該為自訂資料中的來源物件中的哪些欄位建立索引，以及如何建立。
當客戶設定檔擷取來源資料時，索引欄位會決定下列項目：
+ 特定物件所屬的設定檔。
+ 哪些物件彼此相關，應該放在同一設定檔中。例如，聯絡人記錄中的帳戶號碼或聯絡人 ID。
+ 可以使用哪些值來尋找設定檔。例如，聯絡人的名稱可以編製索引。這將允許客服人員找到屬於具有特定名稱之客戶的所有設定檔。
## 索引鍵要求
您必須至少定義一個索引鍵。Customer Profiles 使用此索引鍵將您的自訂設定檔物件映射至設定檔。
自訂設定檔物件對應還需要至少一個可唯一識別物件的索引鍵，以便透過指定此欄位的相同值來更新物件 (這些要求可以透過單一索引鍵滿足)。
每個索引鍵可以由一個或多個欄位組成。
## 欄位要求
欄位定義指定如何從來源物件讀取該欄位名稱的值。欄位定義也會指定欄位中儲存的資料類型。
物件類型名稱可以是任何字母數字字串或 '-' 和 '\$1' 字元，但不能以 '\$1' 字元開頭 (用於保留的標準物件類型)。
# 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 |
# Customer Profiles 中物件類型的其他屬性
屬性類型會定義應該使用哪個金鑰來加密物件類型的任何資料。
有一個選項可以定義是否能夠透過擷取此物件來建立新的設定檔。通常，當擷取的物件與現有設定檔不相符時，只要此選項為真，就會建立新的設定檔。如果不是 true，則會建立擷取的物件，並將其寫入網域無效字母佇列。
它也包含此物件類型的資料在客戶設定檔中應該保留的時間長度。
**注意**
個別物件的保留是在擷取資料時設定的。變更特定物件類型的保留只會套用至要擷取的新資料。它不適用於已經擷取的現有資料。
**注意**
如果此物件與現有設定檔相符，則不會覆寫透過 API 呼叫或客服人員工作區手動填入的欄位，以防止自動擷取覆寫手動欄位。
例如，假設客服人員在客服人員工作區中使用「John」這個名字手動建立一個設定檔。系統會擷取標準設定檔「名字」欄位的物件映射資料。如果此物件與設定檔相關，則不會覆寫「John」這個名字。
# 推斷的設定檔
如果擷取沒有欄位的物件建立了設定檔，則此新設定檔的標準設定檔物件為空白。這個空的標準設定檔物件是**推斷的設定檔**。
建立推論的設定檔時，以下兩個欄位會從設定檔物件移植至標準物件 (如果可用)。
+ 擷取的物件中如果有以 `EMAIL_ADDRESS` 內容類型定義的任何欄位，則此值會填入標準設定檔的 `EmailAddress` 欄位中。
+ 擷取的物件中如果有任何 `PHONE_NUMBER` 內容類型的欄位，則此值會填入標準設定檔的 `PhoneNumber` 欄位中。
即使欄位沒有在欄位定義中定義的目標，這些欄位的值也會填入標準設定檔中。
若要進一步了解聯絡人記錄範本類型，以及如何調整網域所使用的範本，請參閱 [聯絡人記錄範本使用範例](ctr-contact-record-template.md#ctr-contact-record-template-usage-examples)。
# Amazon Connect Customer Profiles 中的聯絡人記錄範本
聯絡人記錄作為設定檔物件，可以捕獲來自各種聯絡人事件 (例如通話或聊天) 的基本中繼資料。它在記錄和分析與客戶的互動方面具有至關重要的作用。
當聯絡事件發生時，有三種不同的預設範本，可以應用於您的網域。這些範本可作為組態選項，用來控制聯絡人事件在系統內的處理方式。每個範本都會定義特定的規則和動作，讓您根據業務需求量身打造聯絡人事件的處理方式。
**Topics**
+ [建立推論的設定檔和自動關聯設定檔 (CTR-NoInferred)](#ctr-contact-record-template-no-inferred)
+ [僅自動關聯設定檔 (CTR-AutoAssociateOnly)](#ctr-contact-record-template-auto-associate)
+ [僅建立推斷的設定檔 (CTR)](#ctr-contact-record-template-inferred-only)
+ [聯絡人記錄範本使用範例](#ctr-contact-record-template-usage-examples)
+ [如何在 AWS 主控台更新聯絡人記錄類型](#ctr-contact-record-template-usage-examples-console)
+ [自動將名稱從電子郵件聯絡人新增至設定檔](#add-email-names-to-profile)
## 建立推論的設定檔和自動關聯設定檔 (CTR-NoInferred)
**Description**
使用 CTR-NoInferred 範本並發生聯絡事件 (例如通話) 時，就會啟動特定程序來處理資料。一開始，系統會使用 `_ctrContactId` 索引鍵來搜尋與聯絡人事件關聯的現有設定檔。如果找到相符的設定檔，聯絡人事件將自動與該設定檔關聯。但是，如果使用 `_ctrContactId` 索引鍵找不到現有的設定檔，系統會繼續使用名為 `_phone` 的次要索引鍵來搜尋設定檔。此索引鍵是用於根據與聯絡人事件關聯的電話號碼找到現有的設定檔。找到相符的設定檔時，聯絡人事件將自動與該設定檔關聯。
如果 `_ctrContactId` 索引鍵和 `_phone` 索引鍵都不產生現有的設定檔，則系統會建立新的推斷設定檔。然後，此推斷的設定檔會填入來自聯絡人事件的中繼資料，以確保資訊會擷取並儲存在系統中。
此程序可確保有效處理聯絡人事件、促進與現有設定檔的自動關聯，並在必要時建立推斷的設定檔。組織可以利用這些機制，維護客戶互動的全面記錄，並有效地管理系統內的聯絡人事件資料。
建議使用 CTR-NoInferred 範本作為預設行為，因為它具有顯著的優點，特別是在減少重複的設定檔時
![\[聯絡人記錄 CTR-NoInferred 範本圖表。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/ctr-contact-record-template-no-inferred.png)
## 僅自動關聯設定檔 (CTR-AutoAssociateOnly)
**Description**
CTR-AutoAssociateOnly 範本的功能與 CTR-NoInferred 範本類似，但有一個重要的區別：當找不到現有的設定檔進行自動關聯時，它不會建立推斷的設定檔。
發生聯絡事件 (例如通話) 時，CTR-AutoAssociateOnly 範本會利用 `_ctrContactId` 索引鍵來搜尋符合的現有設定檔。如果找到設定檔，則聯絡人事件會自動與該設定檔關聯。
但是，如果使用 `_ctrContactId` 索引鍵找不到現有的設定檔，範本會採用使用 `_phone` 索引鍵的次要搜尋機制。它會搜尋與聯絡人事件相同電話號碼關聯的現有設定檔。如果找到相符的設定檔，則聯絡人事件會自動與該設定檔關聯。
使用 CTR-AutoAssociateOnly 範本的目的在於啟用與現有設定檔的自動關聯，同時保持對設定檔建立的嚴格控制。與 CTR-NoInferred 範本不同，此範本可防止在找不到相符項目時建立推論的設定檔。它可確保只能手動建立設定檔，為組織提供更大程度的設定檔管理控制和準確性。
通過使用 CTR-AutoAssociateOnly 範本，組織既能遵守有關設定檔建立的特定規則，又可以利用自動關聯。這種方法可以簡化聯絡人事件處理，以及對設定檔生態系統的精確控制，進而確保準確的資料表示，並促進有效的客戶管理。
![\[聯絡人記錄 CTR-AutoAssociateOnly 範本圖表。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/ctr-contact-record-template-auto-associate.png)
## 僅建立推斷的設定檔 (CTR)
**Description**
CTR 範本僅依賴 `_ctrContactId` 索引鍵來搜索現有的設定檔，而且如果找到相符的設定檔，會自動將聯絡人事件與設定檔關聯。但是，在找不到現有設定檔的情況下，範本會建立推斷的設定檔，並將聯絡人事件中繼資料填入。
雖然此行為可確保即使沒有預先存在的設定檔存在，也可能會擷取聯絡人事件，但可能會導致建立大量的推斷設定檔。如此豐富的推斷設定檔可能會導致系統內設定檔重複的問題。
為了解決此問題並促進更好的設定檔管理實務，我們強烈建議使用 CTR-NoInferred 範本作為預設選項。透過使用 CTR-NoInferred 範本，系統即可免於建立推論的設定檔，從而減少重複設定檔的出現。此範本可讓您更精簡且有效率地處理聯絡人事件，進而改善資料的完整性和準確性。
透過採用 CTR-NoInferred 範本作為預設選項，組織可以將其設定檔管理程序最佳化、減少重複資料，並確保更可靠地呈現客戶互動。
![\[聯絡人記錄 CTR 範本圖。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/ctr-contact-record-template-inferred-only.png)
## 聯絡人記錄範本使用範例
**Amazon Connect 管理員網站**
+ 在 Amazon Connect 管理員網站中，建立新網域時，您可以選擇所需的 CTR 行為。這可以透過 **設定檔建立和自動關聯** 區段中可用的選項按鈕選項來完成。同樣地，當選擇現有網域時，選項按鈕選項也會反映先前與該網域關聯的行為。
+ 編輯目前啟用的網域時，「網域詳細資訊」頁面會在 **設定檔建立和自動關聯** 區段中顯示目前套用的行為。選擇此區段標題中的 **編輯** 按鈕，系統會將您重新導向至 **編輯** **設定檔建立和自動關聯** 頁面。在這裡，您可以根據需求選擇不同的行為。
+ 或者，如果您正在從**資料對映**頁面檢視 CTR 對映，則可選擇**變更範本**按鈕。此動作也會帶您前往 **編輯** **設定檔建立和自動關聯** 頁面，您可以在其中選擇符合您需求的不同行為。
這些選項為您提供了管理網域 CTR 行為的靈活性，使您可以根據特定的偏好或不斷變化的業務需求輕鬆自訂和修改設定。
**AWS CLI**
+ 若要使用 **CTR-NoInferred** 範本，請在 CLI 上執行下列命令：
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles and auto-associates profiles" --template-id CTR-NoInferred `
+ 若要使用 **CTR-AutoAssociateOnly** 範本，請在 CLI 上執行下列命令：
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Auto-associate with profiles only" --template-id CTR-AutoAssociateOnly `
+ 若要使用 **CTR** 範本，請在 CLI 上執行下列命令：
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles only" --template-id CTR `
**API**
如需有關使用 API 的資訊，請參閱 [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
## 如何在 AWS 主控台更新聯絡人記錄類型
1. 在 Customer Profiles 主控台選取 **Customer Profiles 網域**區段中的**檢視詳細資訊**。
![\[在 Customer Profiles 網域選擇檢視詳細資訊。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-1.png)
1. 在**網域詳細資訊**頁面上，選擇**設定檔建立和自動關聯**區段的**編輯**。
![\[在設定檔建立和自動關聯區段中選擇編輯。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-2.png)
1. 選取您要套用至網域的聯絡人記錄行為，然後選擇**儲存**。
![\[選取您要套用至網域的聯絡人記錄行為，然後選擇儲存。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-3.png)
## 自動將名稱從電子郵件聯絡人新增至設定檔
您可以設定流程，將電子郵件聯絡人的名稱填入到客戶的設定檔。使用 [客戶設定檔](customer-profiles-block.md) 區塊，其設定為使用[更新設定檔](customer-profiles-block.md#customer-profiles-block-properties-update-profile)動作。
# 在 Customer Profiles 中，將聯絡人記錄與使用 \$1phone 索引鍵找到的一個設定檔建立關聯
您可以自動將聯絡人記錄與使用 `_phone` 索引鍵找到的一個設定檔關聯。
**範例**
在網域中，`CreateProfile` API 會建立下列設定檔：
```
{
"FirstName": "John",
"LastName": "Doe",
"PhoneNumber": "+11234567890"
}
```
當使用預設 CTR 範本從 `PhoneNumber` \$111234567890 接收來電時，聯絡人記錄將不會自動與上述設定檔關聯，除非客服人員已將聯絡人記錄與同一來電者手動關聯到上述設定檔。如果沒有手動或自動關聯聯絡人記錄，客戶設定檔會建立一個推斷的設定檔，其中包含聯絡人記錄中的資訊。
若要自動將上述設定檔與聯絡人記錄關聯，而無需客服人員手動介入，您可以使用 CTR-NoInferred 範本。使用 CTR-NoInferred 範本時，若從 `PhoneNumber`\$111234567890 接收到來電，聯絡人記錄會使用 `_phone` 設定檔索引鍵自動與上述設定檔關聯。
在兩種情況下，Customer Profiles 將*不會*自動使聯絡人記錄與設定檔關聯：
+ 如果使用 `_phone` 設定檔索引鍵找到多個設定檔，則客戶設定檔無法將聯絡人記錄與唯一的設定檔關聯，且此要求會被拒絕。
+ 如果 `_phone` 設定檔索引鍵找不到設定檔，則客戶設定檔將建立推斷的設定檔。
若要使用 CTR-NoInferred 範本來取代預設的 CTR 範本，請在 CLI 上執行下列命令：
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "No inferred contact record profiles" --template-id CTR-NoInferred`
若要還原為預設行為，請在 CLI 上執行下列命令：
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Revert to inferred contact record profiles" --template-id CTR`
# Amazon Connect Customer Profiles 中的物件類型映射範例
## 產生設定檔的物件類型對應
下列範例顯示填入標準設定檔的資料。
以下是傳入的物件：
```
{
"account": 1234,
"email": "john@examplecorp.com",
"address": {
"address1": "Street",
"zip": "Zip",
"city": "City"
},
"firstName": "John",
"lastName": "Doe"
}
```
下列程式碼展示傳入物件對映到標準設定檔物件，並針對 `PersonalEmailAddress`、`fullName` 和 `accountId` (唯一索引鍵) 建立索引。
```
{
"Fields": {
"accountId": {
"Source": "_source.account",
"Target": "_profile.AccountNumber",
"ContentType": "NUMBER"
},
"shippingAddress.address1": {
"Source": "_source.address.address1",
"Target": "_profile.ShippingAddress.Address1"
},
"shippingAddress.postalCode": {
"Source": "_source.address.zip",
"Target": "_profile.ShippingAddress.PostalCode"
},
"shippingAddress.city": {
"Source": "_source.address.city",
"Target": "_profile.ShippingAddress.City"
},
"personalEmailAddress": {
"Source": "_source.email",
"Target": "_profile.PersonalEmailAddress",
"ContentType": "EMAIL_ADDRESS"
},
"fullName": {
"Source": "{{_source.firstName}} {{_source.lastName}}"
},
"firstName": {
"Source": "_source.firstName",
"Target": "_profile.FirstName"
},
"lastName": {
"Source": "_source.lastName",
"Target": "_profile.LastName"
}
},
"Keys": {
"_email": [
{
"FieldNames": ["personalEmailAddress"]
}
],
"_fullName": [
{
"FieldNames": ["fullName"]
}
],
"_account": [
{
"StandardIdentifiers": ["PROFILE","UNIQUE"],
"FieldNames": ["accountId"]
}
]
}
}
```
請注意，`email` 和 `fullname` 已編製索引，但它們不會用於搜尋設定檔。該帳戶是唯一索引鍵。需要指定物件。每當擷取具有相同帳戶 ID 的物件時，它都會以相同的帳號 ID 覆寫先前的物件。
標準設定檔物件中會填入數個欄位 (請參閱已定義 `Target` 的欄位)。
## 不填入標準設定檔的物件類型對應
此範例顯示更複雜的使用案例。它會擷取與設定檔相關的資料，但不一定會填入標準設定檔物件。
以下是傳入的物件：
```
{
"email": "john@examplecorp.com",
"timestamp": "2010-01-01T12:34:56Z",
"subject": "Whatever this is about",
"body": "Body of ticket"
}
```
以下是對應此資料的一種方法：
```
{
"Fields": {
"email": {
"Source": "_source.email",
"ContentType": "EMAIL_ADDRESS"
},
"timestamp": {
"Source": "_source.timestamp"
}
},
"Keys": {
"_email": [
{
"StandardIdentifiers": ["PROFILE","LOOKUP_ONLY"],
"FieldNames": ["email"]
}
],
"ticketEmail": [
{
"StandardIdentifiers": ["PROFILE","SECONDARY","NEW_ONLY"],
"FieldNames": ["email"]
}
],
"uniqueTicket": [
{
"StandardIdentifiers": ["UNIQUE"],
"FieldNames": ["email","timestamp"]
}
]
}
}
```
此範例會擷取資料，並在第一次查詢時擷取電子郵件地址。
+ 如果電子郵件地址與單一設定檔相符，則會用來將資料附加至該特定設定檔。票證的唯一識別符由電子郵件和時間戳組成，因為沒有其他唯一識別符存在。
+ 如果指定的電子郵件中沒有設定檔，則會建立一個新的設定檔，並填入單一欄位 `EmailAddress`。擷取的物件會附加至此新的**推論設定檔**。可以找到設定檔的兩個可搜尋索引鍵是 `_email` 和 `uniqueTicket`。
+ 如果指定的電子郵件地址存在多個設定檔，則會建立新的設定檔，以單一 `EmailAddress` 欄位填入，並將物件附加至此新設定檔。除了 `_email` 和 `uniqueTicket` 之外，此設定檔建立時還會定義 `ticketEmail` 索引鍵。該電子郵件中的任何後續票證都會指派給此一新的**推斷設定檔**。原因是 ` _email` 索引鍵參照到三個設定檔，因此被丟棄，但是 `ticketEmail` 索引鍵僅參照單一設定檔 (新的推斷設定檔)，並且仍然有效。
+ 在建立新的**推論設定檔**的情況下，會從建立該設定檔的第一個物件填入 `EmailAddress` 欄位。
# Amazon Connect Customer Profiles 中的隱含設定檔物件類型
您可以使用符合範本 ID 名稱的任何物件類型 (如 [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html) API 所傳回)，而無需明確定義它。物件類型將完全符合此物件類型的範本定義。如果定義了明確的物件類型，它會取代隱含的物件類型。
隱含的物件類型包含在 [ListProfileObjectTypes](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypes.html) API 中，或由 [GetProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetProfileObjectType.html) 作業傳回，但是如果您想要移除從該物件類型擷取的所有資料，仍然可以刪除它們。
# Amazon Connect 中，生成式 AI 支援的資料映射
Amazon Connect Customer Profiles 提供生成式 AI 支援的客戶資料映射功能，可大幅減少建立統一設定檔所需的時間，讓您能夠協助提供更個人化的客戶體驗。
使用此功能時，當聯絡中心管理員從 Adobe Analytics、Salesforce 或 Amazon Simple Storage Service (S3) 等 70\$1 個可用無程式碼資料連接器中新增客戶資料時， Amazon Connect Customer Profiles 會分析來自這些來源的資料，以自動判斷如何將不同來源之間存在不同格式的資料組織和合併到其中的統一設定檔 Amazon Connect。聯絡中心管理員就可以查看並完成客戶設定檔的設定，讓他們可以提供客服人員相關的客戶資續，並動態個人化 IVR 和聊天機器人，以提高客戶滿意度和客服人員生產力。
生成式 AI 支援的客戶資料映射可在下列區域中使用：
+ 美國東部 (維吉尼亞北部)
+ 美國西部 (奧勒岡)
+ 非洲 (開普敦)
+ 亞太地區 (新加坡)
+ 亞太地區 (雪梨)
+ 亞太地區 (東京)
+ 亞太地區 (首爾)
+ 加拿大 (中部)
+ 歐洲 (法蘭克福)
+ 歐洲 (倫敦)
## 設定生成式 AI 支援的資料對映
1. 開啟 Amazon Connect 客戶設定檔主控台。
1. 在 **資料來源整合** 索引標籤，選擇 **新增資料來源整合**。
1. 設定連線。從有所有支援連接器可用的下拉式清單中選擇資料來源。
![\[從有所有支援連接器可用的下拉式清單中選擇資料來源。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/genai-augmented-data-mapping-1.png)
1. 地圖資料。選擇自動產生資料對映的選項，或選擇已存在的對映範本或從頭開始建立對映範本。
![\[地圖資料。選擇自動產生資料對映的選項，或選擇已存在的對映範本或從頭開始建立對映範本。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/genai-augmented-data-mapping-2.png)
1. 查看對映摘要。查看顯示所有客戶屬性的自動產生對映結果摘要。編輯擷取的金鑰，並在開始資料擷取前確認。如需詳細了解欄位映射和金鑰，請參閱 [Amazon Connect Customer Profiles 中的物件類型映射定義詳細資訊](object-type-mapping-definition-details.md)。
![\[查看對映摘要。查看顯示所有客戶屬性的自動產生對映結果摘要。編輯擷取的金鑰，並在開始資料擷取前確認。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/genai-augmented-data-mapping-3.png)
## 運作方式
該系統分四個階段工作。第一階段，「客戶設定檔」會擷取來源屬性，如果有，會從您的資料來源取樣資料，然後決定最適合目標的物件類型。對於 Amazon S3 資料來源，在所選 Amazon S3 儲存貯體和前置詞中找到的第一個 CSV 檔案將作為範例資料使用。對於其他資料來源，客戶設定檔會透過 AppFlow 擷取來源屬性。第二階段，利用大型語言模型 (LLM) 進一步處理每個自訂屬性並對映到標準客戶設定檔屬性。第三階段會再次使用 LLM，以選擇可以座為金鑰的合適屬性，例如客戶識別碼。最後，第四階段，時間戳記格式偵測器解析時間戳記以保持記錄的正確時間順序。在合併預測結果後，系統可以在 20 秒內產生最多 120 個屬性的對映。
## 生成式 AI 支援的資料對映疑難排解
以下各節顯示您可能遇到的可能錯誤訊息。它還提供了每個問題的原因和解決方案。
### 錯誤：無法剖析物件字串至 JSON
請求中的物件字串不是有效的 JSON。查看請求中的物件字串，並確認其是有效的 JSON。
### 錯誤：「objects」值無法滿足限制條件：成員的長度必須小於或等於 5
請求中有太多物件。請求中最多允許五個物件。將物件數量減少到五個以下。
### 錯誤：超過 120 個屬性上限
一個 JSON 物件最多允許 120 個屬性，包括巢狀 JSON 屬性。刪除一些不需要從 JSON 物件對映的屬性。
![\[一個 JSON 物件最多允許 120 個屬性，包括巢狀 JSON 屬性。刪除一些不需要從 JSON 物件對映的屬性。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/genai-augmented-data-mapping-breached-limit.png)
### 警告：我們找不到區分您的資料的**唯一金鑰**。我們找不到可識別您的設定檔的**設定檔金鑰**。
模型在指定物件中找不到有效的物件類型。按照建議變更輸入或使用手動對映方法。
![\[模型在指定物件中找不到有效的物件類型。按照建議變更輸入或使用手動對映方法。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/genai-augmented-data-mapping-unique-key-warning.png)
# Amazon Connect Customer Profiles 資料限制
Amazon Connect Customer Profiles 可讓您自訂資料上線，方法是針對不同用於建立統一設定檔的客戶資料類型設定資料擷取限制。設定資料映射限制，讓您優先考慮要跨映射擷取的資料量。每個設定檔的所有映射預設上限為 1000。
**注意**
資料限制是估計值，可能略有不同，在單一設定檔的高擷取期間，任一方向均可能有數單位誤差。
## 如何設定 Customer Profiles 資料限制
1. 開啟 Amazon Connect 客戶設定檔主控台。
1. 選擇**資料限制**索引標籤來設定資料物件的限制。
![\[前往 [資料限制] 索引標籤來設定資料物件的限制。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/customer-profiles-data-limits-setup-1.png)
1. 將游標暫留在所需資料物件限制，然後選擇編輯圖示。
![\[將游標暫留在所需資料物件限制，然後選擇編輯圖示。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/customer-profiles-data-limits-setup-2.png)
1. 輸入限制，然後選擇核取記號圖示以儲存或更新限制。
![\[影像會顯示您輸入的新限制，並反白顯示用於儲存或更新限制的核取記號圖示。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/customer-profiles-data-limits-setup-3.png)
## 如何清除 Customer Profiles 資料限制
1. 選取您要清除其限制的資料物件選項按鈕。然後，您可以選擇**清除限制**。
![\[反白顯示資料限制頁面上資料物件左側的選項按鈕。在此選取選項按鈕，您就可以為物件資料限制啟用清除按鈕。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/customer-profiles-data-limits-clear-1.png)
1. 輸入*確認*以清除您所選資料物件限制值。
![\[彈出式方塊，要求您確認是否要清除資料物件的限制值。您可以以小寫英文字母輸入「confirm」來確認清除動作。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/customer-profiles-data-limits-clear-2.png)