本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 配置定義
<a name="layout-definition"></a>

了解 Profile Explorer 配置的結構和元件。

**Topics**
+ [

# 運作方式
](how-it-works.md)
+ [

# 小工具
](widgets.md)

# 運作方式
<a name="how-it-works"></a>

Profile Explorer 提供各種小工具來顯示客戶資訊，配置會儲存為 JSON 定義，代表儀表板的完整結構和組態。視覺化配置中的每個小工具和元件都對應至此定義中的特定 JSON 區塊。

## 核心元件
<a name="core-components"></a>

配置定義中的每個元件都由五個常見元素組成：
+ **類型**
  + 定義元件類別
  + 決定元件的轉譯方式
  + 範例：BoardItem、Table、KeyValuePair
+ **Id**
  + 每個元件的唯一識別符
  + 用於追蹤和更新元件
  + 在建置器中建立元件時會自動產生
+ **屬性**
  + 元件特定屬性
  + 控制外觀和行為
  + 包含組態設定
+ **子系**
  + 巢狀元件或內容
  + 定義階層關係
  + 可以包含多個子元件
+ **DataSource**
  + 指定資料來源
  + 定義資料擷取參數
  + 控制元件的資料繫結

## 配置元件定義範例
<a name="example-layout-component-definition"></a>

以下是儀表板資料表元件的範例 JSON 結構：

```
{
    "Id": "unique-identifier",
    "Type": "BoardItem",
    "Props": {},
    "Children": [
        {
            "Id": "unique-identifier",
            "Type": "Table",
            "Props": {},
            "Children": [
                {
                    "Id": "unique-identifier",
                    "Type": "TextContent",
                    "Props": {},
                    "Children": ["string"]
                }
            ]
        }
    ],
    "DataSource": [
        {
            "Type": "source-type",
            "Params": {}
        }
    ]
}
```

## 動態資料組態
<a name="dynamic-data-configuration"></a>

Profile Explorer 使用範本表達式，在您的元件中動態存取和顯示 Customer Profiles 資料。

### 單一值支援
<a name="single-value-support"></a>

對於金鑰值對和金鑰指標等元件，您可以存取：

#### 標準設定檔資訊
<a name="standard-profile-information"></a>

```
{{Customer.<StandardProfileInfo>}}
```

使用範例：
+ `{{Customer.FirstName}}`
+ `{{Customer.LastName}}`
+ `{{Customer.PhoneNumber}}`

#### 計算屬性
<a name="calculated-attributes"></a>

```
{{Customer.CalculatedAttributes.<attributeDefinitionName>}}
```

使用範例：
+ `{{Customer.CalculatedAttributes._cases_count}}`
+ `{{Customer.CalculatedAttributes._new_customer}}`

### 表格式資料支援語法
<a name="tabular-data-support-syntax"></a>

#### 計算屬性
<a name="calculated-attributes-tabular"></a>

```
{{Customer.CalculatedAttributes.DisplayName}}
```

```
{{Customer.CalculatedAttributes.CalculatedAttributeDefinitionName}}
```

#### 客群
<a name="segments"></a>

```
{{Customer.CalculatedAttributes.DisplayName}}
```

```
{{Customer.CalculatedAttributes.SegmentDefinitionName}}
```

#### 設定檔物件
<a name="profile-objects"></a>

```
{{Customer.ObjectAttributes.<objectTypeName>.<fieldName>}}
```

**使用範例**：
+ `{{Customer.ObjectAttributes.CTR.contactId}}`
+ `{{Customer.ObjectAttributes.Order.orderId}}`

### 實作範例
<a name="implementation-examples"></a>

#### 單一值元件
<a name="single-value-component"></a>

```
{
    "Type": "KeyValuePair",
    "Props": {
        "Items": [
            {
                "Label": {
                    "Content": {
                        "Type": "TextContent",
                        "Children": ["Customer Name"]
                    }
                },
                "Value": {
                    "Content": {
                        "Type": "TextContent",
                        "Children": ["{{Customer.FirstName}}"]
                    }
                }
            }
        ]
    }
}
```

#### 表格式元件
<a name="tabular-component"></a>

```
{
    "Type": "Table",
    "Props": {
        "ColumnDefinitions": [
            {
                "Cell": {
                    "Content": {
                        "Type": "TextContent",
                        "Children": ["{{Customer.ObjectAttributes.CTR.contactId}}"]
                    }
                },
                "Header": "Contact ID"
            }
        ]
    }
}
```

**注意**  
請確定您參考的屬性、物件和客群在您的 Customer Profiles 組態中，然後再將它們用於您的配置中。

# 小工具
<a name="widgets"></a>

探索 Profile Explorer 中可用的不同小工具類型。

## 概觀
<a name="widgets-overview"></a>

Profile Explorer 中的小工具是從配置定義的 JSON 元件建置的複合元素。雖然這些小工具代表複雜的 JSON 結構，但我們的 UI 建置器會自動處理技術合成，使儀表板管理簡單明瞭且易於使用。

**Topics**
+ [

## 概觀
](#widgets-overview)
+ [

## 可用的小工具
](#available-widgets)
+ [

# 預設小工具
](default-widgets.md)
+ [

# 自訂小工具
](custom-widgets.md)

## 可用的小工具
<a name="available-widgets"></a>
+ 預設小工具
  + [生成式 AI 摘要](default-widgets.md#generative-ai-summary)
  + [客戶資訊](default-widgets.md#customer-information)
  + [計算屬性](default-widgets.md#calculated-attribute)
  + [聯絡人](default-widgets.md#contacts)
  + [案例](default-widgets.md#cases-cp)
  + [訂單](default-widgets.md#orders-cp)
  + [資產](default-widgets.md#assets-cp)
+ 自訂小工具
  + [資料表](custom-widgets.md#table-widget)
  + [鍵值對](custom-widgets.md#key-value-pair)
  + [金鑰指標](custom-widgets.md#key-metric)
  + [甜甜圈圖](custom-widgets.md#donut-chart)

# 預設小工具
<a name="default-widgets"></a>

Profile Explorer 有一組預先設定的小工具，旨在順暢地與 Customer Profiles 資料搭配使用。這些預設小工具以最少的設定提供立即值，讓您只需按幾下滑鼠就能建置複雜的儀表板。

![\[在 Explorer 配置中新增預設小工具。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/default-widgets-1.png)


## 現成小工具
<a name="ready-to-use-widgets"></a>
+ [生成式 AI 摘要](#generative-ai-summary)
+ [客戶資訊](#customer-information)
+ [計算屬性](#calculated-attribute)
+ [聯絡人](#contacts)
+ [案例](#cases-cp)
+ [訂單](#orders-cp)
+ [資產](#assets-cp)

**注意**  
雖然這些小工具已預先設定，您仍然可以進行自訂，更符合您的特定需求。這些小工具可以作為起點，以便您輕鬆上手。

## 生成式 AI 摘要
<a name="generative-ai-summary"></a>

Profile Explorer 提供預設 AI 客戶深入分析，產生強調關鍵行為模式的簡潔摘要、根據互動歷史提供個人化的客戶深入分析，並自客戶 360 資料提出可轉化為實際行動的建議。AI 產生的摘要會識別多個客戶接觸點的模式、提供每個客戶專屬的個人化行為解析，以及支援改善客戶體驗和提高忠誠度，以協助組織做出有資料為基礎的決策。

![\[生成式 AI 摘要小工具。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/generative-ai-summary-1.png)


## 客戶資訊
<a name="customer-information"></a>

客戶資訊小工具使用鍵值對元件，提供清晰且有條理的標準 Customer Profile 資料。此預設小工具會自動以容易掃描的格式顯示基本客戶資訊。

### 概觀
<a name="customer-information-overview"></a>

這個小工具利用鍵值對元件，在結構化配置中顯示客戶屬性。
+ 名字
+ 姓氏
+ 電子郵件地址
+ 電話號碼
+ 地址
+ 帳戶號碼
+ 設定檔 ID

### 資料
<a name="customer-information-data"></a>

小工具會自動連線至您的 Customer Profiles 網域，並從標準設定檔屬性提取資訊。基本功能不需要額外組態。

**注意**：雖然已經以標準設定檔屬性預先設定這個小工具，您可以根據您的需求，自訂標準設定檔中顯示的屬性。

#### 進一步了解
<a name="customer-information-learn-more"></a>
+ [標準設定檔定義](standard-profile-definition.md)
+ 鍵值對

## 計算屬性
<a name="calculated-attribute"></a>

您可以透過計算屬性小工具，顯示使用客戶設定檔計算屬性資料的關鍵指標元件。

### 概觀
<a name="calculated-attribute-overview"></a>

您可以透過計算屬性小工具，顯示使用客戶設定檔計算屬性資料的關鍵指標元件。

### 元件功能
<a name="component-features"></a>
+ 將計算指標顯示為單一值指標

### 範例使用案例可以是
<a name="example-use-cases"></a>
+ 已交付的行銷活動
+ 已開啟的案例
+ 平均通話時間
+ 管道偏好設定

### Configuration
<a name="configuration"></a>

只要選取您的計算屬性，然後選擇您偏好的顯示格式

**注意**  
須先在您的 Customer Profiles 網域中設定計算屬性，才能用於此小工具。

**進一步了解**
+ 金鑰指標
+ [設定計算屬性](customerprofiles-calculated-attributes-admin-website.md)

## 聯絡人
<a name="contacts"></a>

聯絡人小工具使用資料表 JSON 元件建置，以有組織的表格格式顯示您的 Customer Profiles 聯絡人物件資料。此小工具會自動連線至 Customer Profiles CTR 資料，顯示主要聯絡資訊和互動歷史記錄。

### 功能
<a name="contacts-features"></a>
+ 檢視所有客戶聯絡事件
+ 排序和篩選聯絡人記錄
+ 自訂顯示的聯絡欄位
+ 存取詳細的聯絡資訊

如需詳細了解 Customer Profiles CTR 物件，請參閱 [Amazon Connect Customer Profiles 中的聯絡人記錄範本](ctr-contact-record-template.md)

## 案例
<a name="cases-cp"></a>

案例小工具使用資料表 JSON 元件建置，以有組織的表格格式顯示您的 Customer Profiles 案例物件資料。此小工具會自動連線至 Customer Profiles 案例資料，顯示支援互動和案例管理詳細資訊。

### 功能
<a name="cases-features"></a>
+ 檢視所有客戶案例
+ 排序和篩選案例記錄
+ 自訂顯示的案例欄位
+ 存取詳細的案例資訊

如需詳細了解 Customer Profiles 案例物件，請參閱 [Customer Profiles 中標準案例的物件類型映射。](object-type-mapping-standard-case.md)。

## 訂單
<a name="orders-cp"></a>

訂單小工具使用資料表 JSON 元件建置，以有組織的表格格式顯示您的 Customer Profiles 訂單物件資料。此小工具會自動連線至 Customer Profiles 訂單資料，顯示購買歷史記錄和交易詳細資訊。

### 功能
<a name="orders-features"></a>
+ 檢視所有客戶訂單事件
+ 排序和篩選訂單記錄
+ 自訂顯示的訂單欄位
+ 存取詳細的訂單資訊

如需詳細了解 Customer Profiles 訂單物件，請參閱 [Amazon Connect Customer Profiles 中，標準訂單的物件類型映射](object-type-mapping-standard-order.md)

## 資產
<a name="assets-cp"></a>

資產小工具使用資料表 JSON 元件建置，以有組織的表格格式顯示您的 Customer Profiles 資產物件資料。此小工具會自動連線至 Customer Profiles 資產資料，顯示客戶自有的產品和服務。

### 功能
<a name="assets-features"></a>
+ 檢視所有客戶資產記錄
+ 排序和篩選資產資料
+ 自訂顯示的資產欄位
+ 存取詳細的資產資訊

如需詳細了解 Customer Profiles 資產物件，請參閱 [Customer Profiles 中標準資產的物件類型映射。](object-type-mapping-standard-asset.md)

# 自訂小工具
<a name="custom-widgets"></a>

從頭開始建立專屬儀表板元件，以符合您的特定商業需求。您可以透過自訂小工具，在沒有任何預先定義資料時建置唯一的視覺化效果。

![\[在 Profile Explorer 配置中新增客戶小工具。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/custom-widgets-1.png)


## 可用的自訂元件
<a name="available-custom-components"></a>
+ [資料表](#table-widget)
+ [鍵值對](#key-value-pair)
+ [金鑰指標](#key-metric)
+ [甜甜圈圖](#donut-chart)

## 建置自訂小工具
<a name="building-custom-widgets"></a>

**每個自訂小工具都可以設定：**
+ 自訂資料來源
+ 自訂顯示
+ 自訂欄位
+ 自訂項目互動

## 資料表
<a name="table-widget"></a>

自訂資料表元件有靈活的組態選項，以表格格式顯示您的資料，並提供互動和組織進階功能。

### 功能
<a name="table-features"></a>

1. **欄位組態**
   + 定義自訂欄位標頭
   + 為每欄指定資料
   + 設定資料格式選項
   + 定義欄位位置

1. **篩選**
   + 快速篩選資料表中的項目

1. **連結**
   + 連接資源連結
     + 順暢導覽至：
       + 客群
       + 計算屬性
     + 在新索引標籤中開啟
   + **外部 URL 連結**
     + 將列項目值轉換為您可以選擇的 URL
     + 在新索引標籤中開啟
     + 根據列資料動態產生連結
   + 抽屜檢視連結
     + 在側邊抽屜開啟詳細資訊
     + 檢視完整的記錄詳細資訊，而不離開頁面

1. 資料整理
   + 分組
     + 根據特定欄位名稱分組資料列
     + 長久的群組設定
   + 排序
     + 根據任何欄位排序
     + 遞增順序
     + 長久的排序設定

**圖 1**

![\[自訂資料表小工具編輯範例。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/table-features-1.png)


**圖 2**

![\[另一個自訂資料表小工具編輯範例。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/table-features-2.png)


### 範例組態
<a name="table-example-configuration"></a>

```
{
    "Type": "Table",
    "Props": {
        "ColumnDefinitions": [
            {
                "Header": "Table column header"
                "Cell": {
                    "Content": {
                        "Props": {
                            "Variant": "Link",
                            "LinkOptions": {
                                "LinkType": "Drawer"
                            }
                        },
                        "Type": "TextContent",
                        "Children": ["string"]
                    }
                },
            }
        ]
    }
}
```

## 鍵值對
<a name="key-value-pair"></a>

您可以透過鍵值對元件，以靈活且可讀取的格式建立相關資料點的整齊視圖。

### 概觀
<a name="key-value-pair-overview"></a>

定義自訂鍵值關係，來建立動態資料視圖。此元件特別適用於顯示屬性對，例如：
+ 客戶詳細資訊
+ 帳戶資訊

### 功能
<a name="key-value-pair-features"></a>

1. **互動式連結選項**
   + 連接資源連結
     + 直接連結至相關資源
     + 順暢導覽至：
       + 計算屬性
       + 客群
     + 在新索引標籤中開啟
   + 外部 URL 連結
     + 將項目值轉換為您可以選擇的 URL
     + 在新索引標籤中開啟
   + 抽屜檢視連結
     + 在側邊抽屜開啟詳細資訊
     + 檢視完整的詳細資訊，而不離開頁面

1. 欄位組態
   + 定義鍵值對的 1-4 欄

1. 在邏輯分組中整理配對

**圖 1**

![\[自訂鍵值對小工具編輯範例。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/key-value-pair-features-1.png)


**圖 2**

![\[另一個自訂鍵值對小工具編輯範例。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/key-value-pair-features-2.png)


### 範例組態
<a name="key-value-pair-example-configuration"></a>

```
{
    "Type": "KeyValuePair",
    "Id": "UniqueId",
    "Props": {
        "Columns": 2,
        "Items": [
            {
                "Label": {
                    "Content": {
                        "Type": "TextContent",
                        "Id": "UniqueId",
                        "Props": {
                            "FontWeight": "bold"
                        },
                        "Children": ["Profile id"]
                    }
                },
                "Value": {
                    "Content": {
                        "Type": "TextContent",
                        "Id": "UniqueId",
                        "Props": {},
                        "Children": ["[string]"]
                    }
                }
            }
        ]
    }
}
```

**注意**  
此元件目前不支援 UI 建置器中的 `ProfileObjects`。

## 金鑰指標
<a name="key-metric"></a>

金鑰指標元件可讓您以易於理解的格式，強調關鍵業務指標、KPI 和重要統計資料。

### 概觀
<a name="key-metric-overview"></a>

建立易見的指標視圖，強調重要的資料點、趨勢或狀態指示。此元件非常適合顯示：
+ 績效指標
+ 重要測量項目
+ 狀態摘要
+ 趨勢指標

### 功能
<a name="key-metric-features"></a>

1. **大型顯示文字**

1. **指標格式**

1. **互動式連結選項**
   + 連接資源連結
     + 直接連結至相關資源
     + 順暢導覽至：
       + 計算屬性
       + 客群
     + 在新索引標籤中開啟
   + 外部 URL 連結
     + 將項目值轉換為您可以選擇的 URL
     + 在新索引標籤中開啟
   + 抽屜檢視連結
     + 在側邊抽屜開啟詳細資訊
     + 檢視完整的詳細資訊，而不離開頁面

1. **整理指標配置**

**圖 1**

![\[自訂關鍵指標小工具編輯範例。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/key-metric-features-1.png)


**圖 2**

![\[另一個自訂關鍵指標小工具編輯範例。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/key-metric-features-2.png)


### 範例組態
<a name="key-metric-example-configuration"></a>

```
{
    "Type": "KeyMetrics",
    "Props": {
        "MetricDefinitions": [
            {
                "MetricLabel": "Total Revenue",
                "MetricValue": {
                    "Content": {
                        "Type": "TextContent",
                        "Props": {
                            "Format": "USD",
                            "FontSize": "large",
                            "FontWeight": "bold"
                        },
                        "Children": ["[string]"]
                    }
                },
                "Columns": 1
            }
        ]
    }
}
```

**注意**  
此元件目前不支援 UI 建置器中的 `ProfileObjects`。

## 甜甜圈圖
<a name="donut-chart"></a>

甜甜圈圖表元件可透過圓形的甜甜圈圖表，視覺化情緒評分。

### 概觀
<a name="donut-chart-overview"></a>

定義自訂評分條件，建立動態情緒視覺效果。此元件特別適用於顯示：
+ 成功指標
+ 達成率
+ 風險評估
+ 績效指標

### 功能
<a name="donut-chart-features"></a>

1. 情緒分析選項
   + 正面情緒
     + 從零開始
     + 根據條件追蹤進度：
       + 自訂點數值
       + 以顏色顯示的區段
       + 以灰色表示未滿足的條件
     + 顯示成功率百分比
   + 負面情緒
     + 從最大值開始
     + 追蹤推論：
       + 以顏色顯示的區段
       + 點數扣除系統
       + 綠色代表剩餘值
     + 顯示最終分數

1. 計算屬性值

1. 運算子選項
   + Equal To
   + Not Equal To
   + Greater Than
   + Less Than

1. 值條件

1. 每個條件的配置點

**圖 1：正面情緒範例**

![\[正面情緒小工具編輯範例。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/donut-chart-features-1.png)


**圖 2：負面情緒範例**

![\[負面情緒小工具編輯範例。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/donut-chart-features-2.png)


### 範例組態
<a name="donut-chart-example-configuration"></a>

```
{
    "Type": "DonutChart",
    "Props": {
        "Variant": "PositiveSentiment",
        "ConditionDefinitions": [
            {
                "Title": "Customer Satisfaction",
                "Color": "#4CAF50",
                "CalculatedAttribute": "satisfaction_score",
                "Operator": "GREATER_THAN",
                "ValueCondition": 8,
                "Points": 10
            }
        ]
    }
}
```

**注意**  
**甜甜圈圖目前僅支援作為資料來源的計算屬性。**
**所有條件定義都必須包含標題、顏色、計算屬性、運算子、值條件和點數值。**