本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 Amazon Connect Customer Profiles
为了帮助客服人员提供更高效、更个性化的客户服务，Amazon Connect 允许您将来自外部应用程序（例如 Salesforce、Zendesk 或其他客户关系管理 (CRM) 产品）的信息与来自的联系历史记录相结合。 ServiceNow Amazon Connect这样会创建一份客户资料，该客户资料将座席在客户互动期间所需的全部信息集中在一个位置。
通过客户信息（包括其产品、案例和联系人历史记录）的单一视图，座席可以快速确认客户的身份并确定呼叫或聊天的原因。
目前，Amazon Connect Customer Profiles 的使用符合 [GDPR](https://aws.amazon.com/compliance/gdpr-center) 要求，并且正在等待由 Amazon Connect 持有的其他认证。
下图显示了 Agent Workspace；出于本文档的编写目的，提供了一个 Amazon Connect Customer Profiles 图片。Agent Workspace 专为实现高效的多任务处理而设计，可同时处理呼叫、聊天和任务，同时允许在同一个浏览器窗口中快速访问客户资料信息。
![\[座席应用程序中的“客户资料”选项卡。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-concepts-intro3.png)
1. **案例**：状态、参考编号、标题、来源、更新日期，以及与从 Zendesk 等第三方应用程序提取的案例以及 ServiceNow使用案例创建和管理的案例相关的更多信息。 Amazon Connect
1. **更多信息**：客户定义的[资料](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html)的*属性*字段中包含的其他信息，以及额外资料信息，例如手机号码和配送地址。这些信息将按字母顺序排序，以帮助座席快速找到所需的信息。
1. **联系人历史记录**：该客户过去联系您的联系中心的日期、时间和时长。
1. **产品购买历史**：可以在此处填写客户购买的所有资产。这些数据是从您已与 Customer Profiles [集成的](integrate-external-apps-customer-profiles.md)外部应用程序（例如 Salesforce 或 Zendesk）中提取的。
# Amazon Connect 中的客户资料是什么？
*客户资料*是一种记录，用于存储联系人历史记录以及有关客户的信息，例如账号、其他信息、出生日期、电子邮件地址、多个地址、姓名和贸易方类型。*基于账户的配置文件*预计具有基础子配置文件。
启用 Amazon Connect Customer Profiles 后，系统会为每位联系人创建一份唯一的客户资料。这使您可以免费创建一份客户资料，该客户资料将座席在客户互动期间所需的全部信息集中在一个位置。
要访问流中的客户资料，请使用[客户资料](customer-profiles-block.md)数据块。[座席访问客户资料](customer-profile-access.md)（在其 Agent Workspace 中）。
您可以使用 Customer Profiles 的付费功能，通过[从外部应用程序提取数据](integrate-external-apps-customer-profiles.md)来丰富您的客户资料。有关详细信息，请参阅[定价](https://aws.amazon.com/connect/pricing/)。
您还可以使用 [Amazon Connect](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html) 客户档案向客户资料添加自定义字段和对象 APIs。
## 客户资料数据是如何存储的？
Amazon Connect 将联系人历史记录存储在唯一的客户资料中。它解析从外部应用程序提取的数据，并将其存储为客户资料属性。
Amazon Connect 不会替换或更新外部应用程序中的数据。如果删除了数据来源，则来自外部应用程序的数据将不再出现在每个语音联系人的客户资料中。
有关如何保护客户资料数据的信息，请参阅[Amazon Connect 中的数据保护](data-protection.md)。
有关如何访问存储在客户资料中的数据的更多信息，请参阅[访问 Agent Workspace 中的 Customer Profiles](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profile-access.html) 或[使用 Customer Profiles API](https://docs.aws.amazon.com/connect/latest/adminguide/use-customerprofiles-api.html)。
# 为您的 Amazon Connect 实例启用 Customer Profiles
Amazon Connect 可提供预构建的集成，以便您可以将来自多个外部应用程序的客户信息与来自 Amazon Connect 的联系人历史记录快速相结合。这让您能够创建一份客户资料，以便将座席在客户互动期间所需的全部信息都集中在一个位置。
## 开始前的准备工作
下面大致介绍了关键概念，并提供了设置过程中系统将提示您输入的信息。
### 关于 Customer Profiles 域
当您启用 Amazon Connect Customer Profiles 后，您可以创建一个 Customer Profiles 域：一个用于存储所有数据（例如客户资料、对象类型、资料密钥和加密密钥）的容器。以下是创建 Customer Profiles 域的相关指导：
+ 每个 Amazon Connect 实例只能与一个域关联。
+ 您可以创建多个域，但它们之间不会共享外部应用程序集成或客户数据。
+ 您创建的所有外部应用程序集成均处于域级别。所有与域关联的 Amazon Connect 实例均会继承该域的集成。
+ 通过选择其他域，您可以随时将 Amazon Connect 实例的关联从当前域更改为新域。但是，不建议这样做，因为来自较早域的客户资料不会移至新域。
### 数据存储
数据存储是客户档案数据的长期数据存储。它存储了过去 10 年中更新的客户档案数据。它是用于分段的数据，由 Spark SQL 和预测性见解提供支持，必须启用才能使用这些功能。它不用于计算计算属性或填充代理工作区。
### 您希望如何命名您的 Customer Profiles 域？
启用客户资料时，系统会提示您提供一个对您有意义的友好域名，例如您的组织名称，例如 *CustomerProfiles-ExampleCorp*。您可以随时使用 API 更改此友好名称。
### 数据存储
数据存储是由 Spark SQL 和预测性见解支持的分段所必需的服务托管数据存储，必须启用数据存储才能使用这些功能。它不用于计算计算属性或填充代理工作区。
启用数据存储后，它会自动将您获取的内容存储到客户资料中。启用数据存储后，您无法禁用此功能。要从数据存储中删除数据，您可以使用 DeleteProfile API 或删除对象类型或客户资料域。
### 您是否要使用死信队列？
死信队列用于报告与处理来自外部应用程序的数据相关联的错误。
亚马逊 AppFlow 负责连接外部应用程序以及将数据从该应用程序转移到 Amazon Connect 客户档案。然后，Amazon Connect 会处理相应文件。
+ 如果在连接期间或将数据传输到 Amazon Connect 时发生错误，Amazon AppFlow 会显示错误，但不会将错误写入死信队列。
例如，处理错误可能是外部数据与指定的架构不匹配，或外部数据的格式不正确（目前仅支持 JSON）。
+ 如果 Amazon Connect 在处理文件时遇到错误，它会将错误写入您的死信队列。稍后您可以查看该队列并尝试重新处理错误。
+ 您可能会在域定义的死信队列中找到 SQS 消息，其中包括错误消息和对象。
| **错误消息** | **建议** |
| --- | --- |
| 配置文件对象中不存在 UNIQUE 密钥或 PROFILE 密钥 | 修改数据映射或对象，确保对象中存在数据映射中标记为 UNIQUE 和 PROFILE 的密钥。有关如何进行设置，请参阅[**数据映射页面**](customer-profiles-object-type-mapping.md)。 |
| 每秒在配置文件上摄取的对象过多 | 短时间内分配给同一配置文件的对象过多。您可以重新收录对象或增加两次调用 API 之间的等待时间。 PutProfileObject |
| 客户档案无法载入对象，原因是该区域中 EncryptionKey EncryptionKey 不存在，客户档案没有使用权限，或者 EncryptionKey 没有权限 GenerateDataKey | 检查您的 KMS 权限，确保 Customer Profiles 具有所需的访问权限。按照[**启用 Customer Profiles，指定死信队列和 KMS 密钥**](#enable-customer-profiles-step1)部分。 |
| KMS 密钥无效 | 检查您的 KMS 权限，确保 Customer Profiles 具有所需的访问权限。按照[**启用 Customer Profiles，指定死信队列和 KMS 密钥**](#enable-customer-profiles-step1)部分。 |
| 由于 KMS 密钥无效，Customer Profiles 无法摄取对象 | 检查您的 KMS 权限，确保 Customer Profiles 具有所需的访问权限。按照[**启用 Customer Profiles，指定死信队列和 KMS 密钥**](#enable-customer-profiles-step1)部分。 |
| 您的数据包含大于 \$1 字节的配置文件对象 | 删除任何不必要的字段并减少数据大小，直到数据大小低于错误信息中提到的指定限制。 |
| 此对象的所有密钥都绑定到多个配置文件 | 修改数据映射或对象，确保对象中至少有 1 个 PROFILE 密钥绑定到小于或等于 1 个现有配置文件。 |
当您启用 Customer Profiles 时，可以选择将 Amazon SQS 队列指定为死信队列。如果您选择此选项，请将以下资源策略添加到 Amazon SQS，以便 Customer Profiles 有权向该队列发送消息：
```
{
"Sid": "Customer Profiles SQS policy",
"Effect": "Allow",
"Principal": {
"Service": "profile.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "arn:aws:sqs:region:accountID:YourQueueName"
}
```
为防止出现混淆代理安全问题，请参阅 [Amazon Connect Customer Profiles 跨服务混淆座席问题防范](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service)，了解要应用的策略示例。
Step-by-step 有关创建死信队列的说明将在本主题的后面部分提供。[启用 Customer Profiles，并指定死信队列和 KMS 密钥](#enable-customer-profiles-step1)
### 创建 KMS 密钥以供 Customer Profiles 用于加密数据（必需）
**注意**
要保持对客户资料的访问权限 APIs，使用客户资料的实体`profile` APIs 必须在 IAM 策略中拥有明确`kms:Decrypt`的`kms:GenerateDataKey`权限。这样，对于从与 Customer Profiles 相关的 API 中检索到的资源，此类实体可以将 `kms:Decrypt` 和 `kms:GenerateDataKey` 用于与这些资源关联的 KMS 密钥。
启用客户资料时，系统会提示您创建或提供 AWS Key Management Service [KMS 密钥](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys)。 Step-by-step有关创建 KMS 密钥的说明将在本主题的后面部分提供[启用 Customer Profiles，并指定死信队列和 KMS 密钥](#enable-customer-profiles-step1)。
Customer Profiles 的所有静态数据均使用您选择的 KMS 密钥进行加密。您的客户托管密钥由您创建、拥有和管理。您可以完全控制 KMS 密钥（AWS KMS 收费）。
如果选择设置由其他人担任管理员的 KMS 密钥，则该密钥必须具有允许对 Customer Profiles 服务主体拥有 `kms:GenerateDataKey`、`kms:CreateGrant` 和 `kms:Decrypt` 权限的策略。有关如何更改密钥策略的信息，请参阅《 AWS Key Management Service 开发人员指南》中的[更改密钥策略](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html)。此外，为防止跨服务模拟，请参阅[跨服务混淆了副手预防 AWS](cross-service-confused-deputy-prevention.md)，了解您应该应用的策略示例。
## 启用 Customer Profiles，并指定死信队列和 KMS 密钥
**数据存储**
选择是否启用数据存储。需要使用由 Spark SQL 和预测性见解支持的分段。如果您在创建域时选择不启用数据存储，则可以在创建并使用该域后将其启用。启用数据存储后，您无法将其关闭。
您可以通过单击 “客户资料” 页面蓝色横幅中的启用按钮来启用数据存储（左侧面板 > **客户档案**）。创建域名后，您将看到此蓝色横幅。
数据存储需要客户托管密钥 (CMK)，如果您尚未为域启用客户托管密钥 (CMK)，则会提示您创建客户托管密钥 (CMK)。
**重要**
使用 Data Vault 时，客户档案会按对象类型存储您的数据，并使用您的 AWS KMS 密钥对其进行加密。客户配置文件通过以下方式对您的对象类型名称进行标准化：
将名称转换为小写
将连字符-转换为下划线 \$1
将 “标准” 附加到任何客户配置文件标准对象类型
将 “域名” 附加到任何客户资料域对象类型
将 “domain\$1standard” 附加到任何客户配置文件标准域对象类型
如果客户资料检测到命名冲突，则无法启用数据存储。启用 Data Store 后，根据这些标准化规则，您无法创建与现有对象类型名称冲突的对象类型。
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
![\[“Amazon Connect 虚拟联系中心实例”页面, 实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/instance.png)
1. 在导航窗格中，选择 **Customer Profiles**。
**Customer Profiles 域**页面列出了可供集成的应用程序。在下图中，该页面显示尚未启用任何 Customer Profiles 域。
![\[“Customer Profiles”页面，“启用 Customer Profiles”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-domains-page.png)
1. 选择**启用 Customer Profiles** 以开始使用。
1. 在 **Customer Profiles 启用**页面上，选择**创建新域**。**在 “指定域**” 下，输入对您有意义的友好名称，例如您的组织名称，例如 *CustomerProfiles-ExampleCorp*。
![\[“Customer Profiles 启用”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-domain.png)
1. 在**指定死信队列**下，选择是否将失败事件发送到死信队列。如果您想了解摄取失败的数据，这一点很有帮助。它还为您提供了将来重试这些失败的数据摄取的选项。
以下是创建死信队列的步骤：
+ 在 **Customer Profiles 启用**页面上，选择**创建新的或选择现有的 SQS 队列**，然后选择**创建新的死信队列**。
![\[“创建新的或选择现有的 SQS 队列”选项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-create-dlq-choose.png)
+ 您的浏览器中会打开一个用于 Amazon SQS 控制台的新选项卡。选择**创建队列**。
+ 在**创建队列**页面上，选择**标准**，然后为您的队列指定一个名称。
![\[“创建队列”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-create-dlq-name.png)
+ 在**访问策略**部分，选择**高级**。
此时将显示版本名称、策略 ID 和声明。如有必要，请更新此部分，以便仅向相应的角色授予访问权限。
+ 在“声明”部分的末尾（下图第 15 行），在 \$1 之后添加一个逗号，然后按 `Enter`。
![\[“访问策略”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-create-dlq-statement.png)
+ 然后复制并粘贴以下代码：
```
{
"Sid": "Customer Profiles SQS policy",
"Effect": "Allow",
"Principal": {
"Service": "profile.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "arn:aws:sqs:region:accountID:YourQueueName"
}
```
+ 要*YourQueueName*用您的信息替换*region**accountID*、和，请复制并粘贴第 14 行中的`Resource`信息。
![\[“访问策略”部分，资源信息。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-create-dlq-copyandpaste.png)
+ 选择**创建队列**。
+ 返回到浏览器中用于 Amazon Connect 控制台的选项卡，**Customer Profiles 启用**页面。单击或点击**选择现有的 SQS 队列**框，从下拉列表中选择您刚刚创建的队列。
![\[下拉列表中的 SQS 队列。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-create-dlq-final.png)
1. 在**指定 KMS 密钥**下，创建或输入您自己的 AWS KMS key 以进行加密。以下是创建您的 AWS KMS key的步骤：
+ 在 **Customer Profiles 启用**页面上，选择**创建 AWS KMS key**。
![\[“Customer Profiles 启用”页面，“创建 AWS KMS key ”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-create-kms-key.png)
+ 浏览器中将打开一个显示“密钥管理服务 (KMS) 控制台”的新选项卡。在**配置密钥**页面上，选择**对称**，然后选择**下一步**。
![\[“配置密钥”页面，“对称”选项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
+ 在**添加标签**页面上，为密钥添加名称和描述，然后选择**下一步**。
![\[“添加标签”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-create-kms-key-add-labels.png)
+ 在**定义密钥管理权限**页面上，选择**下一步**。
+ 在**定义密钥使用权限**页面上，选择**下一步**。
+ 在**审核和编辑密钥策略**页面上，选择**完成**。
在以下示例中，密钥的名称以 **bcb6fdd** 开头：
![\[“客户托管密钥”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-create-kms-key-note-key.png)
+ 返回到浏览器中用于 Amazon Connect 控制台的选项卡，**Customer Profiles 启用**页面。单击或点击**指定 KMS 密钥**框，以使您创建的密钥显示在下拉列表中。选择您创建的密钥。
![\[“指定 KMS 密钥”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-create-kms-key-choose-key.png)
1. 在**数据存储**下，选择是否启用数据存储。需要使用由 Spark SQL 和预测性见解支持的分段。如果您在创建域时选择不启用数据存储，则可以在创建并使用该域后将其启用。启用数据存储后，您无法将其关闭。
如果您的现有域没有数据存储，则可以通过单击 “客户资料” 页面蓝色横幅中的启用按钮将其启用（左侧面板 > 客户档案）
数据存储需要客户托管密钥 (CMK)，如果您尚未为域启用客户托管密钥 (CMK)，则会提示您创建客户管理密钥 (CMK)。
1. 选择**提交**。已完成的页面与下图类似。它显示了 Customer Profiles 域的名称、死信队列和 KMS 密钥。
![\[已完成的“Customer Profiles 域”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-final.png)
完成了！Amazon Connect Customer Profiles 已启用。现在，对于加入的每个新联系人，Amazon Connect 都会创建一个客户资料记录。然后，它会跟踪相应电话号码（语音）或电子邮件地址（聊天）的联系人历史记录。
您的座席可以[创建新的客户资料](ag-cp-create.md)并查看客户的联系记录。
## 后续步骤
1. [通过座席应用程序启用 Customer Profiles](customer-profile-access.md)。
1. [为座席分配访问座席应用程序中客户资料的权限](assign-security-profile-customer-profile.md)。
1. [与用于分析客户资料数据的外部应用程序集成（可选）](integrate-external-apps-customer-profiles.md)。
1. [启用身份解析以识别两个或更多相似的资料并将其合并](use-identity-resolution.md)。
# 行业资源模板入门
Amazon Connect Customer Profiles 提供了行业资源模板，有助于您快速设置您的域，其中包含针对特定行业量身定制的计算的属性、客户细分和配置文件浏览器布局。
## 开始前的准备工作
在启用行业资源模板之前，请确保您具有：
+ 启用了 Customer Profiles 的 Amazon Connect 实例
+ 在您的 Customer Profiles 域中创建资源的适当权限
## 关于行业资源模板
启用行业模板后，Customer Profiles 会自动在您的域中创建以下资源：
+ 计算的属性定义：从您的客户数据派生的预定义属性
+ 客户细分定义：基于共同特征的客户分组
+ 配置文件浏览器布局：用于可视化客户信息的自定义控制面板视图
这些资源旨在协助您快速从客户数据中获取价值，而无需手动创建每个资源。
## 启用行业资源模板
1. 在 Customer Profiles 主页上，找到“行业模板”部分。
+ 如果这是您第一次设置 Customer Profiles，页面顶部会显示一则通知。
![\[如果您是第一次使用客户配置文件，则会显示启用模板的横幅。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-industry-resource-templates-1.png)
+ 如果您在您的域中已有资源，则已启用的模板列表将显示在“行业模板”部分中。
![\[如果您之前使用过客户配置文件，则行业模板部分会显示已启用的模板列表。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-industry-resource-templates-2.png)
1. 要启用模板，请选择**启用模板**。
1. 在**选择模板**下拉列表中，选择与您的业务最匹配的行业：
+ **航空**：适用于航空旅行业
+ **酒店**：适用于酒店业
1. 查看将在**查看资源**部分中创建的资源。
![\[查看将创建的资源。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-industry-resource-templates-3.png)
1. 选择**启用模板**。
1. 等待创建资源。在资源创建过程中，请务必保持浏览器选项卡处于打开状态。
1. 完成后，您将看到一条确认消息，并且该模板将显示在“行业模板”部分，其中包含创建的资源数量。
![\[将显示成功创建横幅。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-industry-resource-templates-4.png)
## 行业模板创建的资源
### 航空业模板
#### 计算的属性
航空业模板可创建跨多个类别的计算的属性：
**航空业计算的属性**
| 计算的属性名称 | 显示名称 | 说明 | 对象类型 |
| --- | --- | --- | --- |
| air\$1airPreference\$1departure\$1airport\$1last\$1occurrence | 首选出发机场 | 返回客户的最近配置的首选出发机场。 | \$1airPreference |
| air\$1airPreference\$1arrival\$1airport\$1last\$1occurrence | 首选到达机场 | 返回客户的最近配置的首选到达机场。 | \$1airPreference |
| air\$1airPreference\$1travel\$1type\$1last\$1occurrence | 首选旅行类型 | 返回客户的最近配置的首选旅行类型。 | \$1airPreference |
| air\$1airPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | 营销选择加入偏好 | 返回客户的最近配置的营销选择加入设置。 | \$1airPreference |
| air\$1airPreference\$1language\$1in\$1person\$1language\$1last\$1occurrence | 首选面对面语言 | 返回客户的最近首选的面对面互动语言。 | \$1airPreference |
| air\$1airPreference\$1seat\$1location\$1last\$1occurrence | 首选座位位置 | 返回客户的最近选择的座位位置偏好。 | \$1airPreference |
| air\$1airPreference\$1home\$1airport\$1last\$1occurrence | 首选家乡机场 | 返回客户的最近指定的家乡机场。 | \$1airPreference |
| air\$1airPreference\$1dining\$1dietary\$1restriction\$1last\$1occurrence | 首选饮食限制 | 返回客户的最近指定的饮食限制。 | \$1airPreference |
| air\$1airBookings\$1number\$1of\$1passengers\$1average | 每次预订的平均乘客人数 | 返回客户的各次预订的平均乘客人数。 | \$1airBooking |
| air\$1airBookings\$1price\$1total\$1price\$1average | 平均预订价格 | 返回客户的所有预订的平均费用。 | \$1airBooking |
| air\$1airBookings\$1count | 预订次数 | 返回客户预订的次数。 | \$1airBooking |
| air\$1airSegments\$1flight\$1delay\$1time\$1sum | 航班延误总时长 | 返回客户经历的航班延误总时长。 | \$1airSegment |
| air\$1airSegments\$1cancelled\$1flights\$1count\$130\$1days | 过去 30 天内取消的航班数量 | 返回最近 30 天内取消的客户航班的数量。 | \$1airSegment |
| air\$1airSegments\$1delayed\$1flights\$1count\$130\$1days | 过去 30 天内的延误航班数量 | 返回最近 30 天内延误的客户航班的数量。 | \$1airSegment |
| air\$1airSegments\$1completed\$1flights\$1count\$130\$1days | 过去 30 天内完成的航班数量 | 返回最近 30 天内完成的客户航班的数量。 | \$1airSegment |
| air\$1airSegments\$1completed\$1flights\$1count\$11\$1year | 过去一年完成的航班数量 | 返回过去一年内完成的客户航班的数量。 | \$1airSegment |
| air\$1airSegment\$1departure\$1date\$1last\$1occurrence | 上一次航班出发日期 | 返回客户的最近一次航班的出发日期。 | \$1airSegment |
| air\$1airSegments\$1miles\$1to\$1earn\$1sum | 总飞行里程 | 返回客户的所有飞行距离的总和（以英里为单位）。 | \$1airSegment |
| air\$1airSegments\$1miles\$1to\$1earn\$1sum\$11\$1year | 去年的飞行里程 | 返回客户去年飞行的飞行里程总和。 | \$1airSegment |
| air\$1airSegments\$1business\$1first\$1class\$1count | 豪华舱航班数量 | 返回预订为商务舱或头等舱的客户航段次数。 | \$1airSegment |
| air\$1loyalties\$1points\$1redeemed\$1sum | 兑换的忠诚度积分总数 | 返回所有客户忠诚度计划中兑换的积分总和。 | \$1loyalty |
| air\$1loyalties\$1count | 忠诚度会员数量 | 返回客户持有的忠诚度计划会员资格的数量。 | \$1loyalty |
| air\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | 距下一等级的积分 | 返回客户达到下一个忠诚度等级所需的最新积分记录。 | \$1loyalty |
| air\$1loyalty\$1points\$1balance\$1last\$1occurrence | 当前的忠诚度积分余额 | 返回客户最新的忠诚度积分余额。 | \$1loyalty |
| air\$1loyalty\$1membership\$1id\$1last\$1occurrence | 当前忠诚度会员 ID | 返回客户最近的忠诚度会员标识符。 | \$1loyalty |
| air\$1loyalty\$1program\$1name\$1last\$1occurrence | 当前忠诚度计划名称 | 返回客户最近的忠诚度计划名称。 | \$1loyalty |
| air\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | 最近的忠诚度注册日期 | 返回客户最近的忠诚度计划注册日期。 | \$1loyalty |
| air\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | 当前忠诚度等级 | 返回客户最近的忠诚度计划等级状态。 | \$1loyalty |
| air\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | 高级会员数量 | 返回银牌客户忠诚度计划的数量 | \$1loyalty |
| air\$1loyaltyPromotions\$1count | 忠诚度促销次数 | 返回客户收到的忠诚度促销总数。 | \$1loyaltyPromotion |
#### Segments
航空业模板创建以下客户细分：
+ [航空业] 营销订阅用户
+ [航空业] 过去 30 天内取消航班的客户
+ [航空业] 过去 30 天内航班延误的客户
+ [航空业] 过去 30 天内完成航班的客户
+ [航空业] 休眠会员
#### 配置文件浏览器布局
使用布局名称 `DEMO-Airline-Layout` 创建演示配置文件浏览器布局，该布局由以下小组件组成：
+ 客户详情和联系人信息
+ 忠诚度计划状态和积分
+ 最近的预订和航班
+ 客户偏好
+ 客户价值指标
+ 客户满意度指标
### 酒店业模板
#### 计算的属性
酒店业模板可创建跨多个类别的计算的属性：
**酒店业计算的属性**
| 计算的属性名称 | 显示名称 | 说明 | 对象类型 |
| --- | --- | --- | --- |
| hotel\$1hotelPreference\$1location\$1room\$1type\$1last\$1occurrence | 首选房型 | 返回客户的最近配置的首选房型。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1cleaning\$1time\$1last\$1occurrence | 首选清洁时间 | 返回客户的最近配置的房间清洁时间首选项。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1location\$1view\$1last\$1occurrence | 首选房景 | 返回客户的最近配置的房景首选项。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1check\$1in\$1type\$1last\$1occurrence | 首选入住方式 | 返回客户的最近配置的入住方式首选项。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1check\$1out\$1type\$1last\$1occurrence | 首选退房方式 | 返回客户的最近配置的退房方式首选项。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1special\$1request\$1last\$1occurrence | 上次特殊要求类型 | 返回客户的最近请求的特殊住宿类型。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1interest\$1name\$1of\$1interest\$1max\$1occurrence | 最常见的兴趣 | 返回客户的最常表达的兴趣或便利设施首选项。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | 营销选择加入偏好 | 返回客户的最近配置的营销选择加入设置。 | \$1hotelPreference |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1average | 平均住宿时长 | 返回所有客户酒店预订的平均住宿时长。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum\$11\$1year | 过去一年的总晚数 | 返回过去一年中所有客户预订的总住宿晚数。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum | 总住宿晚数 | 返回所有客户酒店预订的总住宿晚数。 | \$1hotelReservation |
| hotel\$1hotelReservation\$1room\$1type\$1name\$1last\$1occurrence | 上次预订的房型 | 返回客户的最近预订的房型。 | \$1hotelReservation |
| hotel\$1hotelReservation\$1channel\$1method\$1last\$1occurrence | 上次使用的预订渠道 | 返回客户的最近用于预订酒店的渠道。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1count | 预订数量 | 返回客户的酒店预订数量。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1average | 平均预订支出 | 返回每次酒店预订的平均税后支出金额。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1sum | 酒店总支出 | 返回所有客户酒店预订的税后总支出金额。 | \$1hotelReservation |
| hotel\$1hotelReservation\$1number\$1of\$1guests\$1max\$1occurrence | 最常见的组规模 | 返回客户的在所有住宿中最常预订的宾客人数。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1business\$1travel\$1count | 商务旅行次数 | 返回标记为商务旅行的客户预订的次数。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1missed\$1checkin\$1count | 未办理入住次数 | 返回客户未办理入住的预订次数。 | \$1hotelReservation |
| hotel\$1hotelReservation\$1cancelled\$1count | 取消的预订数量 | 返回客户取消的酒店预订数量。 | \$1hotelReservation |
| 酒店\$1 \$1amount\$1 hotelStayRevenues sum | 产生的总收入 | 返回所有客户酒店住宿产生的总收入。 | \$1hotelStayRevenue |
| 酒店\$1 \$1金额\$1平均 hotelStayRevenues | 每次住宿的平均收入 | 返回针对客户的所有入住计算的平均收入金额。 | \$1hotelStayRevenue |
| 酒店\$1 \$1最大金额 hotelStayRevenues | 最高收入金额 | 返回任何客户住宿产生的最大单笔收入金额。 | \$1hotelStayRevenue |
| hotel\$1 \$1revenue\$1type\$1max\$1发生hotelStayRevenue次数 | 最常见的收入来源 | 返回客户酒店住宿中产生的最常见的收入类型。 | \$1hotelStayRevenue |
| hotel\$1loyalties\$1points\$1redeemed\$1sum | 兑换的忠诚度积分总数 | 返回所有客户忠诚度计划中兑换的积分总和。 | \$1loyalty |
| hotel\$1loyalties\$1count | 忠诚度会员数量 | 返回客户持有的忠诚度计划会员资格的数量。 | \$1loyalty |
| hotel\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | 距下一等级的积分 | 返回客户达到下一个忠诚度等级所需的最新积分记录。 | \$1loyalty |
| hotel\$1loyalty\$1points\$1balance\$1last\$1occurrence | 当前的忠诚度积分余额 | 返回客户最新的忠诚度积分余额。 | \$1loyalty |
| hotel\$1loyalty\$1membership\$1id\$1last\$1occurrence | 当前忠诚度会员 ID | 返回客户最近的忠诚度会员标识符。 | \$1loyalty |
| hotel\$1loyalty\$1program\$1name\$1last\$1occurrence | 当前忠诚度计划名称 | 返回客户最近的忠诚度计划名称。 | \$1loyalty |
| hotel\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | 最近的忠诚度注册日期 | 返回客户最近的忠诚度计划注册日期。 | \$1loyalty |
| hotel\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | 当前忠诚度等级 | 返回客户最近的忠诚度计划等级状态。 | \$1loyalty |
| hotel\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | 高级会员数量 | 返回银牌客户忠诚度计划的数量 | \$1loyalty |
| hotel\$1loyaltyPromotions\$1count | 忠诚度促销次数 | 返回客户收到的忠诚度促销总数。 | \$1loyaltyPromotion |
#### Segments
酒店业模板创建客户细分，例如：
+ [酒店业] 偏好营销订阅用户
+ [酒店业] 独自旅行者
+ [酒店业] 夫妻或情侣旅行者
+ [酒店业] 家庭或团体旅行者
+ [酒店业] 30 天后即将预订的客户
#### 配置文件浏览器布局
显示以下内容的自定义布局：
+ 客户详情和联系人信息
+ 房间偏好
+ 住宿历史记录
+ 收入信息
+ 忠诚度状态
## 禁用行业模板
您可以禁用行业模板以将其创建的资源从您的域中移除。要禁用模板：
1. 在 Customer Profiles 主页上，找到“行业模板”部分。
1. 找到要禁用的模板，然后选择**禁用**操作。
1. 查看确认消息并选择**确认**以禁用该模板。
**重要**
禁用模板后，将从您的域中删除该模板创建的所有资源。如果这些资源中的任何资源用于客户细分、出站活动或联系流，则禁用模板可能会对其产生影响。
在禁用模板之前，请查看正在使用的资源以了解其潜在影响。
## 问题排查
**行业模板故障排除**
| 错误 | 建议 |
| --- | --- |
| 模板资源创建失败 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/getting-started-industry-resource-templates.html) |
| 创建的资源不显示在配置文件浏览器中 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/getting-started-industry-resource-templates.html) |
| 无法启用多个模板 | 每个域都可以启用多个行业模板。如果您遇到问题，请检查是否未达到域的资源限制。 |
| 需要删除模板资源 | 目前，入门功能未提供自动删除由模板创建的所有资源的方式。您可以通过各自的管理页面手动删除各个资源。 |
## 后续步骤
启用行业模板后，您可以：
+ 导航到配置文件浏览器以查看新布局的实际运行情况
+ 查看和编辑计算的属性以更好地满足您的特定需求
+ 在 Amazon Connect 中管理客户细分
+ 根据业务需求编辑配置文件浏览器布局
+ 将外部应用程序与 Amazon Connect Customer Profiles 集成以开始填充配置文件
# 在座席工作区中访问 Amazon Connect Customer Profiles
启用 Amazon Connect 客户档案后，客服人员可以开始与客户互动并访问[客户信息](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles.html)以提供个性化服务。本主题介绍如何访问 Amazon Connect 代理工作区。
**提示**
确保您的座席在其安全配置文件中拥有**客户资料**权限，以便他们可以访问 Customer Profiles。有关更多信息，请参阅 [Amazon Connect Customer Profiles 的安全配置文件权限](assign-security-profile-customer-profile.md)。
## 选项 1：在 CCP 中使用客户档案 out-of-the-box
Customer Profiles 已经嵌入在联系人控制面板 (CCP) 旁边。您的代理可以在同一个浏览器窗口中访问CCP、客户档案和案例管理，方法 Amazon Connect是登录他们的 Amazon Connect 实例并选择位于右上角的座**席工作区**按钮，如下图所示。
![\[Customer Profiles 页面和突出显示的按钮，用于打开 Agent Workspace。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-agent-workspace-open.png)
**注意**
您还可以使用以下 URL 访问 Agent Workspace：
**https://*instance name*.my.connect.awsagent-app-v/2/**
如果您使用 **awsapps.com** 域访问您的实例，请使用以下 URL：
**https://*instance name*.awsapps。 com/connect/agent-app-v2/**
有关查找实例名称的帮助，请参阅 [查找您的 Amazon Connect 实例名称](find-instance-name.md)。
以下是 Customer Profiles 在 Agent Workspace 中具体外观的示例。
![\[Agent Workspace 中的“Customer Profiles”选项卡和联系人控制面板。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-agent-app.png)
## 选项 2：将 Customer Profiles 嵌入到自定义 Agent Workspace 中
嵌入联系人控制面板 (CCP) 时，可以选择显示或隐藏预构建的联系人控制面板用户界面。例如，您可能需要开发一个自定义 Agent Workspace，该工作区具有您设计的用户界面，并带有用于接听和拒绝呼叫的自定义按钮。或者，您可能需要将 Amazon Connect 中包含的预构建的联系人控制面板嵌入到另一个自定义应用程序中。
无论您是显示预构建的联系人控制面板用户界面，还是将其隐藏起来然后构建您自己的，您都可以使用 [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) 库将联系人控制面板和 Customer Profiles 嵌入到座席的工作区中。这样，Amazon Connect Streams 就可以初始化，座席可以连接到 Amazon Connect 和 Customer Profiles 并对其进行身份验证。
有关嵌入 Customer Profiles 的信息，请参阅 [CCP、Customer Profiles 和 Wisdom 的初始化](https://github.com/amazon-connect/amazon-connect-streams/blob/master/Documentation.md#initialization-for-ccp-customer-profiles-and-wisdom)。
要在使用客户资料中的原始数据时构建自己的控件，请参阅有关如何使用 CustomerProfiles JS 开源库的 [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles) 文档。
**提示**
当您自定义座席的工作区时，您可以确定座席用于访问其 Agent Workspace 的 URL，它可能与 Amazon Connect 提供的 URL 有很大不同。例如，您的 URL 可能是 https://example-corp.com/agent-support-app。
# 自动填充 Customer Profiles
默认情况下，Amazon Connect Customer Profiles 使用以下值在其用户界面中搜索和自动填充客户资料：
+ 对于语音联系人：电话号码
+ 对于聊天联系人：电子邮件
它通过使用 Customer Profiles 流数据块自动填充客户资料。要自定义此行为，请将[设置联系属性](set-contact-attributes.md)数据块（见下文）用于以下联系人属性
| 属性 | 说明 | Type | JSONPath 参考 |
| --- | --- | --- | --- |
| profileSearchKey | 要用于搜索资料的属性的名称。 | 用户定义 | 不适用 |
| profileSearchValue | 您要搜索的密钥值，例如客户名称或账号。 | 用户定义 | 不适用 |
例如，要按电子邮件搜索聊天联系人，您可以将 `profileSearchKey` 属性设置为 `_email` 搜索键，并提供电子邮件值作为 `profileSearchValue`。
如果您在资料对象中定义了自定义键，则也可以通过这些搜索键进行搜索。要确保您的自定义键可搜索，请参阅[键定义详细信息](object-type-mapping-definition-details.md#key-definition-details)。
下图显示了如何可在[设置联系属性](set-contact-attributes.md)数据块中使用这些属性。
![\[“设置联系属性”数据块的属性页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-attributes1.png)
## 自动将客户资料与联系人关联
默认情况下，座席需要在验证客户身份后手动将客户资料与联系人相关联。要将此行为更改为根据电话号码自动将联系人与资料相关联，请参阅[将 Contact Record 与 Customer Profiles 中使用 \$1phone 密钥找到的一个配置文件相关联](auto-associate-profile-using-phone-profile-key.md)。
如果多个资料与联系人的电话号码匹配，则会向座席显示多个匹配的资料。座席需要选择要与联系人关联的资料。
# Amazon Connect Customer Profiles 的安全配置文件权限
为座席的安全配置文件分配权限，以便他们执行搜索配置文件和查看客户详细信息、将联系人记录与配置文件关联、编辑配置文件以及创建和保存新配置文件等任务。本节中的主题通过更新座席、流和计算的属性的权限来协助您分配权限。如果您在更新权限时碰巧遇到错误，还有一些信息可以帮助您解决问题。
**Topics**
+ [更新座席的 Customer Profiles 权限](security-profile-customer-profile-agent.md)
+ [更新流的 Customer Profiles 权限](security-profile-customer-profile-contact-flows.md)
+ [更新计算的属性的权限](security-profile-customer-profile-calc-attribs.md)
+ [客户细分的安全配置文件权限](security-profile-customer-profile-segmentation.md)
+ [出错时分配新的 Customer Profiles 权限](security-profile-customer-profile-issues.md)
# 更新座席的 Customer Profiles 权限
根据需要为座席的安全配置文件分配以下**客户配置文件**权限：
+ **查看**：使座席能够查看客户资料应用程序。他们可以：
+ 查看在座席应用程序中自动填充的资料。
+ 搜索配置文件。
+ 查看存储在客户资料中的详细信息（例如，姓名、地址）。
+ 将联系人记录与资料相关联，如下图所示。
![\[座席工作区中的“客户配置文件”选项卡，“关联”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-associate.png)
+ **编辑**：允许座席编辑客户资料中的详细信息（例如，更改地址）。默认情况下，它们会继承**查看**权限。
+ **创建**：允许座席创建和保存新的资料。默认情况下，它们会继承**查看**权限，但不会继承**编辑**权限。
有关如何为现有安全配置文件添加更多权限的信息，请参阅[在 Amazon Connect 中更新安全配置文件](update-security-profiles.md)。
默认情况下，**管理员**安全配置文件已具有执行所有客户配置文件活动的权限。
# 更新流的 Customer Profiles 权限
1. 转到“安全配置文件”页面，选择要编辑的安全配置文件，或者选择**添加新的安全配置文件**。
![\[“安全配置文件”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png)
1. 选择“客户配置文件”的**查看**权限。
![\[在安全配置文件页面中选择查看权限。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-2.png)
1. 选择**保存**。现在，您可以导航到**用户管理**部分，并将此安全配置文件提供给您选择的用户。
# 更新 Amazon Connect Customer Profiles 中计算的属性的权限
1. 转到“安全配置文件”页面，选择要编辑的安全配置文件，或者选择**添加新的安全配置文件**。
![\[“安全配置文件”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png)
1. 为计算的属性选择**全部**或**查看**、**编辑**、**创建**和**删除**权限。
![\[在安全配置文件控制台中选择查看、编辑、创建和删除权限。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/security-profile-customer-profile-calc-attribs-2.png)
1. 选择**保存**。现在，您可以导航到**用户管理**部分，并将此安全配置文件提供给您选择的用户。
# 分配安全配置文件权限以管理客户细分
根据需要为用户的安全配置文件分配以下客户细分权限。有关安全配置文件的更多详细信息，请参阅 [Amazon Connect 和联系人控制面板 (CCP) 访问的安全配置文件](connect-security-profiles.md)。
1. 转到“安全配置文件”页面，选择要编辑的安全配置文件，或者选择**添加新的安全配置文件**。
![\[“安全配置文件”页面，“Customer Profiles”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-1.png)
1. 为客户细分选择**全部**或**查看**、**创建**、**删除**和**导出**权限。
![\[“客户细分”权限设置为“全部”。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-2.png)
1. 选择**保存**。现在，您可以导航到**用户管理**部分，并将此安全配置文件提供给您选择的用户。
# 出错时分配新的 Customer Profiles 权限
1. 要在任何后端出现 403 禁止呼叫错误时更新权限 APIs，请导航到 “ Amazon Connect 客户档案” 控制台的 “域” 部分，然后选择 “**查看详情**”。
![\[Amazon Connect 客户资料控制台的域部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-1.png)
1. 在查看域详细信息部分中选择**更新权限**。
![\[如果需要更新任何未完成的权限，则此处会显示“更新权限”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-2.png)
1. 完成此操作后，权限将成功更新，**更新权限**按钮将不再显示在域详细信息部分中。这将缓解 403 禁止的错误问题，您将能够成功调用 API。
![\[操作成功完成后，“更新权限”按钮将消失。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-3.png)
# Amazon Connect Customer Profiles 数据到期
如果配置文件未在指定的时间内更新，则该配置文件将到期。这将导致配置文件被清理并从 Customer Profiles 域中移除。
Customer Profiles 数据的到期时间可以分为两个不同的类别：
## 通过以下方式创建的个人资料 CreateProfile
使用 `CreateProfile` API 创建的配置文件将根据客户资料域**DefaultExpirationDays**上分配的时间戳过期。如果未配置到期时间，则默认为 365 天。
## 通过以下方式创建或更新的个人资料 PutProfileObject
使用创建或更新的配置文件`PutProfileObject`将始终遵循与其关联的对象类型上**ExpirationDays**定义的配置文件。如果未在对象类型上定义到期时间，则将使用 Customer Profiles 域的到期日期。最后，如果两者均未提供，则配置文件或配置文件对象将在默认 365 天后到期。
## 思维模型可视化
![\[显示 Customer Profiles 的到期逻辑的流程图。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-expiration-model.png)
## 导入配置文件到期
如果使用“客户细分导入”将配置文件导入到客户配置文件域中，则其到期将分为两种不同的情况。
1. **调用时过期的明确定义 CreateUploadJob**
默认情况下，如果未执行任何更新，则使用“客户细分导入”所导入的配置文件将在 14 天后到期。这个数字[可以使用 API 定义](customer-segments-imported-files.md#set-profile-expiry)，也可以在导入创建期间在 Amazon Connect 管理网站上定义，最长为 90 天。
1. **从之前的导入作业中导入 Customer Profiles 域中已经存在的配置文件**
如果运行了两个导入作业，并且发现了重复的配置文件，则客户配置文件将始终遵循最长的到期时间。
# 在 Amazon Connect 中使用身份解析合并相似的配置文件
*相似的资料*是指两个或更多资料被确定为适用于同一个联系人。当跨多个通道和应用程序为同一客户捕获客户记录，并且这些客户记录不共享一个公共唯一标识符时，可能会有多个资料。
身份解析会自动查找相似的资料并帮助您整合它们。该功能每周运行一次身份解析作业，该作业执行以下步骤：
1. [自动资料匹配](how-identity-resolution-works.md#auto-profile-matching)
1. 根据您的合并标准[自动合并相似资料](how-identity-resolution-works.md#auto-profile-merging)
每次身份解析作业运行时，它都会在 **Customer Profiles** 页面上显示指标。这些指标显示了它审查的资料数量、找到的匹配组数以及合并的资料数。
启用身份解析可能会收取额外费用。有关更多信息，请参阅 [Amazon Connect 定价](https://aws.amazon.com/connect/pricing/)。
![\[Amazon Connect Customer Profiles 页面，“启用身份解析”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
# 为您的 Amazon Connect Customer Profiles 域启用身份解析
**重要**
Amazon Connect 使用座席工作区时，案例与 Amazon Connect 客户档案身份解析不完全兼容。以下是合并配置文件后现有案例会发生的情况：
合并后，案例保持与其原始配置文件 ID 相关联。
案例不会跨合并的配置文件自动整合。
目前尚不支持将现有案例与另一个配置文件重新关联的方法。如果您需要手动合并案例，请使用[CreateCase](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html)和[CreateRelatedItem](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateRelatedItem.html)作为解决方法。
当启用身份解析时，需要指定以下信息：
+ 身份解析作业每周运行一次的时间。默认情况下，它于 UTC 时间周六午夜 12 点运行。
+ Amazon S3 存储桶，身份解析作业应在其中写入自动资料匹配过程的结果。如果您没有 S3 存储桶，则可以选择在启用过程中创建一个。
您可以查询 Amazon S3 存储桶或使用 [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API 根据[置信度分数](how-identity-resolution-works.md#confidence-score)筛选结果。
启用身份解析后，您将会看到用于为可选的自动合并过程[创建合并标准](create-consolidation-criteria.md)的选项。
**启用身份解析**
1. 您必须为您的实例启用 Customer Profiles 域。有关说明，请参阅[为您的 Amazon Connect 实例启用 Customer Profiles](enable-customer-profiles.md)。
1. 在导航窗格中，选择 **Customer Profiles**。
1. 在**身份解析**部分，选择**启用身份解析**。
![\[Amazon Connect Customer Profiles 页面，“启用身份解析”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
1. 在**身份解析**弹出框中，选择**启用身份解析**。
![\[Amazon Connect Customer Profiles 页面，“启用身份解析”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-ir-2.png)
1. 在**启用身份解析**页面上，指定您希望身份解析作业运行的日期和时间。
1. 如果您想查看 Amazon S3 存储桶 IDs 中匹配的个人资料，请选择 “**写入与 Amazon S3 匹配的个人资料 ID**”。否则，您可以使用 [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API 来查看匹配的配置文件。
**注意**
如果您自动启用合并，则不会收到匹配的配置文件。 IDs
1. 指定身份解析作业应在其中写入资料匹配项的 Amazon S3 存储桶。
建议应用策略以防止出现混淆代理安全问题。有关更多信息和示例策略，请参阅 [Amazon Connect Customer Profiles 跨服务混淆座席问题防范](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service)。
1. 完成后，选择**启用身份解析**。启用身份解析后，将启用基于规则的匹配和基于机器学习的匹配。您可以从“身份解析”页面禁用其中一项或两项。有关更多信息，请参阅 [禁用 Amazon Connect Customer Profiles 中的身份解析指标](disable-identity-resolution.md)。
1. 基于规则的身份解析匹配：
1. 启用与新域的基于规则的匹配功能后，如果您设置了集成并且集成正在运行，则匹配将立即启动。
1. 启用与现有域的基于规则的匹配功能后，匹配过程将在一小时内启动。
1. 基于机器学习的身份解析匹配：
1. 启用身份解析功能后，身份解析作业将在 24 小时内首次运行。
**注意**
在新的 Customer Profiles 域上首次运行身份解析作业之前，建议检查您的资料指标，以确保已创建资料。否则，将不会返回任何匹配结果。
1. 您可能需要为自动合并匹配资料设置合并标准。如果是这样，请参阅[在 Amazon Connect 中设置身份解析的合并标准](create-consolidation-criteria.md)。
# 在 Amazon Connect 中设置身份解析的合并标准
**注意**
您必须[启用身份解析](#create-consolidation-criteria)，才能使用 Amazon Connect 管理员控制台访问用于创建合并标准的选项。
当身份解析作业检测到相似的资料时，该过程可以根据您指定的合并标准自动将它们合并到统一的资料中。
系统将在匹配组中的所有相似资料中比较您选择的属性，以实现完全匹配。例如，如果在条件中将 `email` 指定为属性，则匹配组中具有完全相同 `email address` 值的所有相似资料将合并到一个统一资料中。
**提示**
如果您想设置自己的合并逻辑，请使用 [MergeProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MergeProfiles.html)API。
## 限制
您可以从[标准资料](standard-profile-definition.md)中选择任何属性来比较相似的资料。例如，您可以选择电话号码、电子邮件地址和姓名以及自定义属性。
您最多可以指定：
+ 10 个合并标准
+ 每个标准 20 个属性
## 创建严格标准的提示
为了更高效地确定唯一资料并避免合并非重复项的资料，建议执行以下步骤：
+ 选择能够唯一标识客户且不同客户之间不太可能相同的属性，例如账号或某种形式的政府 ID。
+ 避免使用单一属性标准。选择多个属性以创建属性组合，从而提高目标定位。例如：
+ 带有**名字**、**中间名**、**姓氏**的**电话号码**
比
+ 单独使用**电话号码**或
+ 单独使用**名字、中间名、姓氏**的组合更符合标准
+ 如果适用，请选择特定属性组中的所有属性。例如，如果要使用姓名，请选择所有相关的姓名属性：**名字、中间名、姓氏**。如果要使用企业地址，请选择所有相关的企业地址属性。
+ 在标准中加入以下可能唯一标识客户的属性之一，以及其他属性：
+ 账号
+ Phone number（电话号码）
+ 电子邮件地址
## 如何设置自动合并标准
在设置自动合并的合并标准之前，建议您先查看[自动合并过程的工作原理](how-identity-resolution-works.md#consolidation-criteria-how-it-works)。
1. 启用身份解析后，在**身份解析**页面上，您可以选择设置自动合并标准。选择**创建合并标准**。
1. 如果您收到**缺少时间戳**对话框，建议您在继续操作之前向自定义对象类型添加新的时间戳属性。请参阅[资料冲突缺少时间戳](#missing-timestamp-for-profile-conflicts)。
1. 在**资料冲突**部分，选择当两个或更多记录存在冲突时应如何解决资料冲突。
1. 在**合并标准**部分，创建一个或多个标准。建议每个标准至少包含两个或更多属性。
## 资料冲突缺少时间戳
如果您有自定义对象类型映射，则会显示**缺少时间戳**消息。
使用 [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API 向您的自定义对象类型添加以下新属性：
+ `Fields.sourceLastUpdatedTimestamp`
+ `sourceLastUpdatedTimestampFormat`
如果未指定时间戳属性，则可以继续创建合并标准，但是，系统会使用将记录摄取到 Customer Profiles 中的默认时间戳。建议在创建合并标准之前添加新属性。
如果您已经定义自定义对象类型并想要更新自定义对象类型，我们每周都会运行定期回填以使用 `Fields.sourceLastUpdatedTimestamp` 更新您的现有资料。选择加入定期回填：
1. 使用 [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API 更新您的自定义配置文件对象类型。
1. 更新自定义资料对象类型后，打开 [支持 工单](https://console.aws.amazon.com/support/home)，我们将为您安排回填。定期回填的运行将持续到 2022 年 2 月底。
或者，您可以删除并重新创建使用自定义对象类型的域名。 ingestion/connector 将使用您的更新对象类型重新摄取您的所有数据并从中解析 `Fields.sourceLastUpdatedTimestamp`。
## 示例：如何应用标准示例
在此示例中，有三个标准：
+ **解决资料冲突**设置为**使用上次更新的时间戳**。这意味着，当两个字段的值相互冲突时，身份解析将使用上次更新的时间戳来确定要使用哪个值。
+ 标准 1：
+ 名字、姓氏
+ 电子邮件
+ 标准 2：
+ Phone number（电话号码）
这些标准适用于以下资料：
+ 资料 A
+ John Doe [上次更新时间 **05:00**a]
+ doefamily@anyemail.com [上次更新时间 **05:00**a]
+ 555-555-5555 [上次更新时间 **07:00**a]
+ 资料 B
+ John Doe [上次更新时间 **04:00**a]
+ doefamily@anyemail.com [上次更新时间 **06:00**a]
+ 555-555-555**6** [上次更新时间 *04:00*a]
+ 资料 C
+ **Jane** Doe [上次更新时间 **06:00**a]
+ doefamily@anyemail.com [上次更新时间 **07:00**a]
+ 555-555-5555 [上次更新时间 **06:00**a]
以下是应用标准 1 时的结果：
+ 资料 A 和 B 合并 = 资料 AB
这将产生资料 AB，如下所示：
+ John Doe [上次更新时间 **05:00**a]
+ doefamily@anyemail.com [上次更新时间 **07:00**a]
+ 555-555-555**5** [上次更新时间 **06:00**a]
由于电话号码之间存在冲突，因此身份解析使用上一个时间戳来选择 555-555-555 号码。
接下来，应用标准 2。以下为结果：
+ 资料 AB 和 C 合并 = 资料 ABC
这将产生资料 ABC，如下所示：
+ **Jane** Doe [上次更新时间 **06:00**a]
+ doefamily@anyemail.com [上次更新时间 **07:00**a]
+ 555-555-555**5** [上次更新时间 **07:00**a]
身份解析使用资料 C 中的名字、姓氏和电子邮件，因为它们具有最新的时间戳。
# Amazon Connect 中身份解析的机器学习
Amazon Connect 中身份解析会自动查找相似的资料并帮助您整合它们。本节的主题介绍了如何设置机器学习匹配功能以合并重复的配置文件，这是自动合并过程的一部分。
**Topics**
+ [机器学习身份解析的工作原理](how-identity-resolution-works.md)
+ [设置用于身份解析的机器学习](setup-machine-learning-matching.md)
# Amazon Connect 中机器学习身份解析的工作原理
本主题介绍身份解析如何执行自动资料匹配，以及如果已设置身份解析，则它如何自动合并相似资料。
## 自动资料匹配
为了识别相似的资料，身份解析使用机器学习来查看每个资料中的以下个人身份信息 (PII) 属性：
+ 姓名：审查所有姓名的相似度，包括名字、中间名和姓氏。
+ 电子邮件：审查所有电子邮件地址的相似度，包括个人电子邮件和企业电子邮件。它们不区分大小写。
+ 电话号码：审查所有电话号码和格式的相似度，包括家庭电话、移动电话和企业电话。
+ 地址：审查所有地址类型和格式的相似度，包括企业地址、邮寄地址、配送地址和账单地址。
+ 出生日期：审查所有出生日期和格式的相似度。
它使用此信息来创建相似资料的匹配组。
### 匹配组
匹配组由代表客户的所有相似资料组成。每个匹配组均包含以下信息：
+ 匹配 ID，用于唯一标识代表联系人的两个或更多相似资料的组
+ 比赛组 IDs 中的个人资料数量
+ 与匹配组关联的置信度分数
### 置信度分数
自动匹配过程运行后，您可以查询 S3 存储桶或使用 [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API 根据置信度分数筛选结果。例如，您可以筛选出高置信度匹配项以进行进一步审查。
置信度分数是一个介于 0 和 1 之间的数字，它表示将资料分配给匹配组的置信级别。分数为 1 可能表示完全匹配。
## 自动合并相似的资料
匹配资料后，身份解析作业可以选择根据您的标准合并相似的资料。如果您删除或更新标准，则更新的标准将在下次运行中应用于相似的资料。
**重要**
您无法撤消合并过程。我们强烈建议在运行 Identity Resolution Job 之前，使用 [GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html)API 对自动合并过程进行试运行。
**注意**
合并两个配置文件时，通过 API 调用或座席工作区手动填充的配置文件字段不会被从集成或自定义对象类型映射中自动摄取的配置文件字段覆盖。
例如，假设代理在座席工作区中手动创建了带有 FirstName “John” 的配置文件。另一个配置文件是使用 S3 与 FirstName “Peter” 的集成创建的。如果这些配置文件自动合并， FirstName “John” 将被保留。
### 自动合并过程的工作原理
+ **合并标准中的所有选定属性都与 `AND` 标准相关联，并在合并之前进行精确值比较**。
+ 例如，当在标准中指定了多个属性（如 `email address` 和 `phone number`）时，将合并匹配组中具有完全相同的 `email address` 和 `phone number` 值的所有相似资料。
+ 如果匹配组中的一个或多个相似资料对标准中的一个或多个属性具有不同的值或缺失值，将合并相似资料。
例如，一个匹配组可能是五个相似的资料，其中三个资料合并在一起，因为这三个资料符合相应标准。其他两个资料未合并，因为它们不符合相应标准。
+ **从标准 1 开始，按优先级顺序评估多个标准**。
+ 应用合并标准的顺序。它从作为最高优先级的标准 1 开始，到作为最低优先级的标准 10 结束。
+ 在身份解析作业应用一个标准后，它会将下一个标准应用于合并的资料和匹配组中其余的相似资料。
+ 最多可有 10 个合并标准。
+ **每个标准均独立运行，并与其他条件一起作为 `OR` 运行**。
+ 如果您有多个标准，则在身份解析作业进入下一个标准之前，将按优先级顺序分别应用每个标准。
+ 所有标准均按您列出的顺序应用。合并匹配组中的一个或多个相似资料是失败还是成功，都无关紧要。
+ **默认情况下，资料冲突按新近性进行管理**。
+ 当匹配组中两个或更多相似的资料满足合并标准时，将通过比较构成相似资料的资料属性的每个值来创建所生成的合并资料。
+ 每个属性的值可能完全匹配。在这种情况下，可以为该属性选择任何值。
+ 如果两个或更多构成相似资料的值之间存在冲突，则选择最近更新的属性。
例如，如果 Jane Doe 在构成相似资料的 `Address` 属性中有三个不同的值，则身份解析会选择最新的地址来创建统一的资料。
+ 默认情况下，使用**上次更新的时间戳**来确定最近更新的记录。
+ **资料冲突按源对象类型和新近性进行管理**。
+ 您还可以更改冲突解决的默认行为，以选择来自特定源的相似构成资料作为事实来源，从而为冲突解决提供信息。
+ 如果要指定用于资料冲突的数据源，则可以选择其中一种对象类型作为数据源，前提是选择**具有上次更新时间戳的源**。
+ 指定对象类型中最近更新的记录用于解决资料冲突。
+ **上次更新的时间戳标识最近更新的记录**。
+ 与源记录的对象类型关联的时间戳属性用于标识最近更新的记录。
+ 如果时间戳属性不适用于对象类型，则使用将记录摄取到您的 Customer Profiles 域的时间戳。
+ 如果您有自定义对象类型，则需要添加时间戳。参阅[资料冲突缺少时间戳](create-consolidation-criteria.md#missing-timestamp-for-profile-conflicts)了解更多信息。
+ **合并操作是一个单向过程，无法撤消**。
+ 在开始合并过程之前，请仔细选择您的标准。有关更多信息，请参阅 [创建严格标准的提示](create-consolidation-criteria.md#tips-for-creating-consolidation-criteria)。
+ 使用 [GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html)API 测试身份解析的自动合并设置，无需合并数据。
有关显示如何应用标准的示例，请参阅[示例：如何应用标准示例](create-consolidation-criteria.md#criteria-examples)。
# 在 Amazon Connect 中设置身份解析的机器学习
## 编辑机器学习匹配运行计划
![\[编辑机器学习匹配运行计划。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/machine-learning-ir-edit-run-schedule.png)
## 编辑机器学习合并匹配项
![\[编辑机器学习合并匹配项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/machine-learning-ir-edit-merge-matches.png)
## 编辑机器学习匹配位置
![\[编辑机器学习匹配位置。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/machine-learning-ir-edit-match-location.png)
# Amazon Connect 中基于规则的身份解析匹配
AC 中身份解析会自动查找相似的配置文件并帮助您整合它们。本节主题介绍如何设置基于规则的身份解析解决方案，以合并重复的配置文件，这是自动合并过程的一部分。
**Topics**
+ [基于规则的身份解析的工作原理](how-rule-based-identity-resolution-works.md)
+ [设置基于规则的身份解析匹配](setup-rule-based-matching.md)
+ [设置用于基于规则的身份解析的匹配规则](setup-matching-rule-examples.md)
# Amazon Connect 中基于规则的身份解析的工作原理
本主题介绍基于规则的身份解析如何执行自动资料匹配，以及它如何自动合并相似资料。
## 自动资料匹配
为了识别相似的资料，基于规则的身份解析使用[匹配的规则属性](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html)列表来匹配每个资料。中最多支持 15 个 MatchingRule 属性[MatchingRules](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html#customerprofiles-Type-RuleBasedMatchingRequest-MatchingRules)。
### 匹配规则
以下是可以使用的[ MatchingRule](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html)属性列表。您最多可以配置 15 个匹配的规则级别。对于每个匹配规则，您可以在每个资料中使用以下个人身份信息 (PII) 属性：
+ **AccountNumber**
+ **Address.Address**：将检查中指定的所有地址[属性类型选择器](#rule-based-attribute-type-selector)是否相似，包括地址、、 BusinessAddress和 MaillingAddress ShippingAddress
+ **Address.City**：将检查中指定的所有地址[属性类型选择器](#rule-based-attribute-type-selector)是否相似，包括地址、、 BusinessAddress和 MaillingAddress ShippingAddress
+ **Address.Countr** y：对[属性类型选择器](#rule-based-attribute-type-selector)中指定的所有地址进行相似性审查，包括地址、、 BusinessAddress和 MaillingAddress ShippingAddress
+ **Address.Cou** nty：将检查中指定的所有地址[属性类型选择器](#rule-based-attribute-type-selector)是否相似，包括地址、、 BusinessAddress和 MaillingAddress ShippingAddress
+ **地址。 PostalCode**: 将检查中指定的所有地址[属性类型选择器](#rule-based-attribute-type-selector)是否相似，包括地址、 BusinessAddress MaillingAddress、和 ShippingAddress
+ **Address.Stat** e：对中[属性类型选择器](#rule-based-attribute-type-selector)指定的所有地址进行相似性审查，包括地址、、 BusinessAddress和 MaillingAddress ShippingAddress
+ **Address.P** rovince：对[属性类型选择器](#rule-based-attribute-type-selector)中指定的所有地址进行相似性审查，包括地址、、 BusinessAddress和 MaillingAddress ShippingAddress
+ **PhoneNumber**：检查中指定的电话号码[属性类型选择器](#rule-based-attribute-type-selector)是否相似，包括 PhoneNumber HomePhoneNumber、和。 MobilePhoneNumber
+ **EmailAddress**：对中指定的所有电子邮件地址进行相似性审查，包括 EmailAddress BusinessEmailAddress、和 [属性类型选择器](#rule-based-attribute-type-selector) PersonalEmailAddress
+ **BirthDate**
+ **BusinessName**
+ **FirstName**
+ **LastName**
+ **MiddleName**
+ **Gender**
+ **任何带有*属性* 前缀的自定义资料属性**
按优先级处理匹配规则。例如，第一个规则应该是您要定义的最优化的规则，并应使用它来获得最准确的结果。
### 属性类型选择器
属性类型选择器包含基于规则的身份解析的重要配置信息，有助于资料匹配。这将有助于您跨属性类型微调资料比较，并选择要在每种类型中进行匹配的主要属性。在此功能中，您可以灵活地配置三种不同的属性类型，从而实现对匹配过程的精确控制。
+ **电子邮件类型**
+ 您可以选择 EmailAddress BusinessEmailAddress、和 PersonalEmailAddress
+ **PhoneNumber type**
+ 您可以选择 PhoneNumberNumber HomePhoneNumber、和 MobilePhoneNumber
+ **地址类型**
+ 您可以从 “地址”、 BusinessAddress MaillingAddress、“和” 中进行选择 ShippingAddress
您可以选择`ONE_TO_ONE`或`MANY_TO_MANY`作为 AttributeMatchingModel. 选择 `MANY_TO_MANY` 时，系统可以跨属性类型的子类型匹配属性。例如，如果配置文件 A 的 EmailAddress 字段值和配置文件 B 的 BusinessEmailAddress 字段值匹配，则两个配置文件在 EmailAddress 类型上匹配。选择 `ONE_TO_ONE` 时，只有当子类型完全匹配时，系统才能匹配。例如，只有当配置文件 A 的 EmailAddress 字段值和配置文件 B 的 EmailAddress 字段值匹配时，两个配置文件才会在 EmailAddress 类型上匹配。
**用于匹配的最高允许规则级别**
您可以配置要用于匹配类似资料的最高规则级别。例如，如果用于匹配的最高允许规则级别为 5，则系统将找不到使用规则级别 6 的相似资料。
### 匹配组
匹配组由代表客户的所有相似资料组成。每个匹配组均包含以下信息：
+ 匹配 ID，用于唯一标识代表联系人的两个或更多相似资料的组
+ 比赛组 IDs 中的个人资料数量
### 匹配状态
+ **等待**
配置基于规则的匹配规则后的第一个状态。如果它是现有域，则基于规则的身份解析将等待 1 小时后再创建匹配规则。如果它是新域，则系统将跳过**等待**阶段。
+ **进行中**
系统正在创建基于规则的匹配规则。在此状态下，系统正在评估现有数据，您无法再更改基于规则的匹配配置。
+ **活动**
规则已准备就绪，可供使用。您可以在状态处于**活动**状态后的第二天更改规则。
### 自动匹配过程的工作原理
使用基于规则的匹配规则创建新的 Amazon Connect Customer Profiles 域后，基于规则的身份解析将根据您在摄取资料时指定的规则匹配相似的资料。如果您更新基于规则的匹配的配置，则 Customer Profiles 将在一小时内开始使用新配置重新评估您域中的资料。
如果您启用与现有域基于规则的匹配，则系统将进入**等待**状态，并将在一小时内开始使用新配置评估域中的现有资料。完成资料评估所需的时间取决于存在多少资料。
+ **默认情况下，如果未指定自定义规则，将应用默认规则。**
+ 如果您未提供自定义匹配规则，Amazon Connect Customer Profiles 将提供默认匹配规则。您可以在此处查看自定义匹配规则。
+ **所有记录都将通过基于规则的匹配规则的验证。**
+ 系统会评估每个匹配的规则级别，直到确定匹配项或达到用于匹配的最高允许规则级别。评估过程从规则级别 1 开始，在该级别分析记录。如果未发现匹配组，系统将继续评估后续规则级别，搜索匹配组，直至找到匹配项或达到用于匹配的最高允许规则级别。
+ **单个匹配规则级别中的所有属性均使用 *AND* 关系进行连接**
+ 当单个规则级别中存在多个属性时，它们将通过 AND 关系互连。在资料匹配期间，所有属性值必须一致，才能将资料分配到同一个匹配组。例如，只有当所有属性的值都相同时，才会将资料视为匹配项并分组在一起以进行进一步处理。
+ **属性类型选择器中的所有属性均使用 *OR* 关系进行连接**
+ 当在属性类型选择器中指定属性时，相同类型的属性通过 OR 关系进行链接。例如，考虑使用 HomePhoneNumber 和 BusinessPhoneNumber 的 PhoneNumber Type。在这种情况下，如果两个配置文件 HomePhoneNumber或对 BusinessPhoneNumber 齐，则可以匹配它们。因此，匹配过程允许根据家庭或企业电话号码进行灵活匹配。
+ **最终会对匹配结果进行优化。**
+ 由于系统中的资料匹配具有近乎实时的性质，因此有可能可在较低（优化程度较低）的规则级别上找到与您的资料对应的匹配组。但是，如果在更高（更为优化）的规则级别上有匹配项，则系统会将资料分配到该特定组。
**注意**
当身份解析执行基于规则的匹配时，处理您所配置规则的顺序取决于数据的摄取方式。例如，如果您配置规则 1 和 2，则可能先处理规则 2，然后再处理规则 1。处理顺序可能会发生更改，但最终结果将始终相同。
## 自动合并相似的资料
配置文件匹配后，Identity Resolution Job 可以选择根据[MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html)您在基于规则的匹配配置中指定的配置文件合并相似的配置文件。
**重要**
您无法撤消合并过程。建议仅先开启匹配，然后使用 ListMatches 和来评估匹配结果 GetSimiliarProfiles APIs。您可以通过[MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html)使用 [UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html)API 进行设置来启用合并。
**注意**
合并两个配置文件时，通过 API 调用或座席工作区手动填充的配置文件字段不会被从集成或自定义对象类型映射中自动摄取的配置文件字段覆盖。
例如，假设代理在座席工作区中手动创建了带有 FirstName “John” 的配置文件。另一个配置文件是使用 S3 与 FirstName “Peter” 的集成创建的。如果这些配置文件自动合并， FirstName “John” 将被保留。
# 在 Amazon Connect 中设置基于匹配规则的身份解析
本主题提供了编辑基于规则的匹配属性类型、基于规则的匹配规则、基于规则的匹配合并规则和基于规则的匹配位置的步骤说明。还说明了如何重置基于规则的匹配规则。
## 编辑基于规则的匹配属性类型
![\[编辑基于规则的匹配属性类型。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/rule-based-edit-attribute-types.png)
## 编辑基于规则的匹配规则
![\[编辑基于规则的匹配规则。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/rule-based-edit-matching-rules.png)
## 重置基于规则的匹配规则
![\[重置基于规则的匹配规则。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/rule-based-edit-reset-rules.png)
## 编辑基于规则的匹配合并规则
![\[编辑基于规则的匹配合并规则\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/rule-based-edit-merge-rules.png)
## 编辑基于规则的位置匹配
![\[编辑基于规则的位置匹配。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/rule-based-match-location.png)
# 在 Amazon Connect 中设置基于规则的身份解析匹配规则
## 限制
您可以从标准资料中选择任何属性来比较相似的资料。例如，您可以选择电话号码、电子邮件地址和姓名以及自定义属性。
您可以创建基于规则的匹配规则，但存在以下限制：
+ 15 个规则级别
+ 每个规则级别最多可以包含 15 个资料属性
## 提示
为了改善唯一资料的定位并避免合并非重复项的资料，建议使用以下提示：
+ 至少包含一个高基数属性，该属性可以唯一标识客户，并且不同客户之间不太可能相同，例如电话号码、电子邮件地址或账号。
+ 避免使用可能属于不同身份但没有高基数属性的资料属性。
+ 带有**名字**、**姓氏**的**电话号码**是比单独使用**名字**、**姓氏**的组合更严格的规则。
+ 如果在一个规则级别上，该规则的所有配置文件属性都是低基数属性（该属性可属于 500 多个不同的配置文件），Customer Profiles 不会尝试匹配相应配置文件。如果您在域创建过程中设置了 SQS 消息，则会在您的 DLQ 中收到以下 SQS 消息：
+ 规则级别 x 上的所有属性均与 500 多条记录相关联。
+ 务必先启用 “**仅**匹配”，检查匹配结果，只有在对匹配结果满意时**MaxAllowedRuleLevelForMerging**才通过设置来启用合并。
## 解决配置文件冲突以进行配置文件合并
您可以定义当两个或更多相似资料中属性的值不同（例如地址记录冲突）时要使用哪个记录。
**上次更新时间戳**
默认情况下，资料冲突按新近性进行管理。当两个或更多相似资料的值之间存在冲突时，将选择最近更新的属性。
**具有上次更新时间戳的源**
允许您确定来自特定对象类型的记录的优先级，作为管理资料冲突的数据源。当两个或更多相似资料的值之间存在冲突时，将从指定对象类型中选择最近更新的属性。
如果您的对象类型中未指定时间戳，则将使用记录摄取到 Customer Profiles 中的日期。如果您未设置任何集成，则带有上次更新时间戳的源不可用。添加集成时，您的对象类型将可用作此选项的源。
## 资料冲突缺少时间戳
如果您有自定义对象类型映射，则会显示“缺少时间戳”消息。
使用 [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API 向您的自定义对象类型添加以下新属性：
+ `Fields.sourceLastUpdatedTimestamp`
+ `sourceLastUpdatedTimestampFormat`
如果未指定时间戳属性，则可以继续创建合并标准，但是，系统会使用将记录摄取到 Customer Profiles 中的默认时间戳。建议在创建合并标准之前添加新属性。
如果您已经定义自定义对象类型并想要更新自定义对象类型，我们每周都会运行定期回填以使用 `Fields.sourceLastUpdatedTimestamp` 更新您的现有资料。要选择定期回填，请执行以下步骤：
1. 使用 [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API 更新您的自定义配置文件对象类型。
1. 更新您的自定义资料对象类型后，请打开 [AWS Support 工单](https://console.aws.amazon.com/support/home)。
1. AWS 将代表您安排回填。定期回填的运行将持续到 2022 年 2 月底。
或者，您可以先删除，然后重新创建使用自定义对象类型的域的摄取/连接器。将使用您的更新对象类型重新摄取您的所有数据并从中解析 `Fields.sourceLastUpdatedTimestamp`。
## 示例：匹配的工作原理
### ONE\$1TO\$1ONE 的示例
您可以选择 `ONE_TO_ONE` 作为 `AttributeMatchingModel`。选择 `ONE_TO_ONE` 时，只有当子类型完全匹配时，系统才能匹配。
**例如**：
您正在使用 `EmailAddress` 和 `BusinessEmailAddress` 来表示 `EmailAddress` 类型。`AttributeMatchingModel` 为 `ONE_TO_ONE`。
**您的匹配规则是**：
```
Rule Level 1: EmailAddress, LastName, FirstName
Rule Level 2: AccountNumber
```
```
Profile A:
EmailAddress: 1@email.com
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
```
Profile B:
EmailAddress: 2@email.com
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
由于 `EmailAddress` 类型、`LastName` 和 `FirstName` 匹配，因此配置文件 A 和配置文件 B 在规则级别 1 上匹配。
### MANY\$1TO\$1MANY 的示例
您可以选择 `MANY_TO_MANY` 作为 `AttributeMatchingModel`。选择 `MANY_TO_MANY` 时，系统可以跨属性类型的子类型匹配属性。
**例如**：
您正在使用 `EmailAddress` 和 `BusinessEmailAddress` 来表示 `EmailAddress` 类型。`AttributeMatchingModel` 为 `MANY_TO_MANY`。
**您的匹配规则是**：
```
Rule Level 1: EmailAddress, LastName, FirstName
Rule Level 2: AccountNumber
```
```
Profile A:
EmailAddress: 1@email.com (match with Profile B’s BusinessEmailAddress)
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
```
Profile B:
EmailAddress: 2@email.com
BusinessEmailAddress: 1@email.com (match with Profile A's EmailAddress)
LastName: Doe
FirstName: John
AccountNumber: account1234
```
由于 `EmailAddress` 类型、`LastName` 和 `FirstName` 匹配，因此配置文件 A 和配置文件 B 在规则级别 1 上匹配。
# 查看 Amazon Connect Customer Profiles 中的身份解析指标
每当身份解析匹配或合并资料时，有关相应过程的指标就会显示在 Customer Profiles 控制面板上。您可以在**身份解析**摘要页面上查看过去一周的指标。
每次运行身份解析作业时，都会生成以下指标：
+ **已找到匹配组**：已找到的匹配组数目。
+ 同时适用于基于机器学习和基于规则的身份解析。
+ **已合并配置文件**：已合并的资料数目。
+ 同时适用于基于机器学习和基于规则的身份解析。
+ **按规则匹配组**：每个规则级别创建的匹配组的数目。
+ 仅适用于基于规则的身份解析。
![\[Amazon Connect Customer Profiles 页面，“启用身份解析”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/ir-metrics-example-1.png)
![\[Amazon Connect Customer Profiles 页面，“启用身份解析”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
# 禁用 Amazon Connect Customer Profiles 中的身份解析指标
## 禁用基于机器学习的匹配
当您不再希望基于机器学习的匹配自动查找相似资料时，可以禁用基于机器学习的匹配。如果您有合并标准，则您的所有标准都将被删除，并且您的资料将不再自动合并。已经合并的资料将保持合并状态。
## 禁用基于规则的匹配
当您不再希望基于规则的匹配自动查找相似资料时，可以禁用基于规则的匹配。如果您有自定义匹配规则，则该匹配规则将被删除，您的资料将不再自动合并。已经合并的配置文件将保持合并状态。
# 使用 AWS 实体解析进行解决方案
Amazon Connect 客户档案提供*托管连接器*，允许您直接从 AWS 实体解析中导入匹配结果。这种集成允许您利用 AWS 实体解析的强大匹配功能，同时在 Amazon Connect 中维护您的客户档案。
AWS Entity Resolution 使用灵活的匹配技术（包括规则、机器学习或第三方数据提供商），帮助您匹配和链接各种数据源的相关记录。通过将实体解析结果关联到客户档案，您可以：
+ 更准确地整合来自多个系统的客户记录
+ 根据您的特定业务需求应用复杂的匹配逻辑
+ 利用来自各种应用程序和渠道的关联数据增强客户档案
+ 在整个组织中保持一致的客户观点
要开始使用带有客户资料的 AWS 实体解析，您需要先在 AWS 实体解析控制台中设置匹配的工作流程。[了解有关 AWS 实体解析](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-matching-workflow.html)的更多信息。
要进行此设置，您需要满足以下先决条件：
+ 启用了客户资料的激活 Amazon Connect 实例
+ 存储在亚马逊 S3 中的客户数据
+ 访问 AWS 实体解析的适当 IAM 权限
**要进行设置，请执行以下步骤：**
1. 创建客户资料域
+ 如果您还没有，请在您的 Connect 实例中创建客户档案域
+ 前往您的 Amazon Connect 控制台中的 “客户档案” 部分
+ 注意：创建域名后，您将看到 AWS 实体解析的新部分
1. 配置 AWS 实体解析
+ 在您的客户档案域中，找到 AWS 实体解析部分
+ 单击 “设置 AWS 实体解析”
+ 您将被重定向到 AWS 实体解析控制台。
+ 创建匹配的工作流程
+ 配置您的 S3 数据源
+ 定义匹配标准
+ 查看并激活您的匹配工作流程
1. 将实体解析结果与客户资料关联起来
+ 返回您的 “客户档案” 域
+ 选择您的实体解析工作流程
+ 配置如何合并匹配的记录
+ 启用集成
# 将外部应用程序与 Amazon Connect Customer Profiles 集成
Amazon Connect 提供了一组由亚马逊和 AppFlow 亚马逊提供支持的预建集成。 EventBridge启用 Amazon Connect Customer Profiles 后，您可以使用这些集成将来自外部应用程序（例如 Salesforce 或 Zendesk）的信息与来自 Amazon Connect 的联系人历史记录相结合。这样会创建一份客户资料，该客户资料将座席在客户互动期间所需的全部信息集中在一个位置。
您也可以在 Amazon 中使用客户档案 AppFlow。亚马逊 AppFlow 支持`CustomerProfiles`将其作为目的地。您可以使用 Amazon AppFlow APIs 将数据`CustomerProfiles`作为目标名称发送到客户资料中。
在开始之前，请确保您使用的是客户托管密钥。有关配置 KMS 密钥的更多信息，请参阅[创建 KMS 密钥以供 Customer Profiles 用于加密数据（必需）](enable-customer-profiles.md#enable-customer-profiles-awsmanagedkey)。
## 设置集成
您可以通过在下面选择最适合您的用例的方法，使用 Amazon Connect 中的特色应用程序或使用 Amazon 的外部应用程序 AppFlow 来设置集成。有关与 Slack 集成的更多详细信息，请参阅博客文章[使用 Amazon AppFlow 合并来自多个来源的数据，为联络中心代理建立统一的 Amazon Connect 客户档案](https://aws.amazon.com/blogs/contact-center/unified-customer-data/)。 ServiceNow
**Topics**
+ [设置集成](#setup-integrations-title-menu)
+ [在 Amazon Connect 中为精选应用程序设置集成](integrate-customer-profiles-appflow.md)
+ [使用 Amazon 为外部应用程序设置集成 AppFlow](integrate-external-applications-appflow.md)
+ [删除 Customer Profiles 或停止集成](delete-customer-profile-connection.md)
# 在 Amazon Connect 中为精选应用程序设置集成
这些集成使用 Amazon Connect 精选应用程序为 Amazon Connect Customer Profiles 提供定期更新。
## 开始前的准备工作
### 批量摄取数据
设置集成时，系统会提示您输入要回溯到多远的日期以摄取数据。如果您选择的日期是两个多月前，则 Customer Profiles 会通过创建多个流来自动启用批量摄取。它执行此操作是为了让您不必计算摄取数据所需的流数量。
启用自动批量摄取后，Customer Profiles 会执行以下操作：
+ 将批次大小设置为两个月。
+ 在出现暂时性故障后，在失败之前最多重试三次。
您可以使用 [CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html)API 来调用自己的批次大小。
### 为什么要求我选择或创建 IAM 角色？
对于 Salesforce、Marketo 和 ServiceNow，Customer Profiles 使用您的 IAM 角色创建多个工作流程来快速高效地摄取数据，从而帮助改善这些来源的历史采集。
对于这些源，如果您在**导入记录的日期**的日期选取器中选择的时间超过 60 天，则系统将提示您创建新的 IAM 角色或选择现有角色。此角色允许 Customer Profiles 管理您的集成。它为 Customer Profiles 提供了必要的权限，以更新和创建用于摄取数据的工作流程。该工作流完成后，Customer Profiles 会创建一个标准的持续集成，当您的新数据在源中更新时，它会摄取这些数据。
在控制台中创建的角色只能由在其中创建该角色的域使用。这是因为 Amazon Connect 会将该角色的访问权限限制为仅允许该域使用的 KMS 密钥。
有关更多信息，请参阅 [授予访问 Customer Profiles 执行角色的最低权限](#grant-least-privilege-cp)。
## 授予访问 Customer Profiles 执行角色的最低权限
如果您想创建自己的 IAM 角色，建议您使用以下代码中显示的权限将该角色限制为所需的最低权限。使用以下代码片段手动创建您的角色。使用您自己的 KMS 密钥并在需要时指定您所在区域。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:RequestTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:CreateFlow",
"appflow:TagResource",
"profile:TagResource",
"profile:PutIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "CreateFlowResources"
},
{
"Action": [
"appflow:UseConnectorProfile"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "UseConnectorResources"
},
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:ResourceTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:DescribeFlow",
"appflow:DescribeFlowExecutionRecords",
"appflow:DeleteFlow",
"appflow:StartFlow",
"appflow:StopFlow",
"appflow:UpdateFlow",
"profile:DeleteIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "AccessFlowResources"
},
{
"Action": [
"kms:CreateGrant",
"kms:ListGrants"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"appflow.us-east-1.amazonaws.com"
]
}
},
"Effect": "Allow",
"Sid": "KMSAppflow"
},
{
"Action": [
"kms:CreateGrant"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"profile.us-east-1.amazonaws.com"
]
},
"ForAllValues:StringEquals": {
"kms:GrantOperations": [
"Decrypt"
]
}
},
"Effect": "Allow",
"Sid": "KMSCustomerProfiles"
}
]
}
```
------
## 监控您的 Customer Profiles 集成
建立连接后，如果连接停止运行，请删除集成，然后重新建立集成。
## 如果没有发送对象该怎么办
如果对象发送失败，请选择**流详细信息**以详细了解出了什么问题。
您可能需要删除配置并重新连接到外部应用程序。
# 设置 Amazon Connect Cases 的集成
要更新 Amazon Connect 客户档案中的 Amazon Connect 案例数据并使用计算属性等功能，您可以使用亚马逊进行集成 AppIntegrations。首先设置案例事件流以将系统字段发送到 EventBridge 总线，然后使用 Amazon AppIntegrations 将这些事件转发到客户档案。
## 将数据从 Amazon Connect Cases 流式传输到 Event Bridge
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
![\[实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png)
1. 在导航窗格中选择**案例**，并从**域详细信息**部分记下案例域 ID。
![\[“案例”页面，“域详细信息”部分，一个箭头指向域 ID。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png)
1. 使用创建案例事件配置 AWS CLI，将 Amazon Connect 案例事件发送到您的 AWS 账户默认事件桥总线。
```
// set up Case Event Configuration including all system fields
aws connectcases put-case-event-configuration --domain-id --region --event-bridge "{
\"enabled\": true,
\"includedData\": {
\"caseData\": {
\"fields\": [
{
\"id\": \"status\"
},
{
\"id\": \"title\"
},
{
\"id\": \"summary\"
},
{
\"id\": \"reference_number\"
},
{
\"id\": \"created_datetime\"
},
{
\"id\": \"last_updated_datetime\"
},
{
\"id\": \"last_closed_datetime\"
},
{
\"id\": \"customer_id\"
}
]
}
}
}"
```
1. 打开您所在 AWS 地区的事件桥控制台。例如，[https://us-west-2.console.aws.amazon.com/events/家？ region=us-west-2\$1/eventbuses](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses)
1. 选择 **Create event bus (创建事件总线)**。
![\[Amazon EventBridge 控制台中的事件总线页面，“创建事件总线” 按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png)
1. 创建名称为 `connect-cases-to-customer-profiles` 的事件总线。
![\[“创建事件总线”页面，“名称”框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png)
1. 返回**默认事件总线**，创建名称为 `connect-cases-to-customer-profiles-rule` 的规则。
![\[默认事件总线，“创建规则”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png)
![\[“构建事件模式”步骤。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png)
+ Event Pattern 片段：
```
{
"source": ["aws.cases"],
"detail": {
"eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]
}
}
```
![\[“创建方法”部分、“自定义模式（JSON 编辑器）”选项、事件模式代码。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png)
+ 选择**跳过审查和创建**，然后选择**创建规则**。
![\[“跳至审核并创建”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png)
## 使用以下方法将事件桥案例数据提取到客户档案 AppIntegrations
1. 使用创建事件集成 AppIntegrations并记录 ARN 输出。 AWS CLI 这表示 Amazon Connect 实例可以使用的源数据。
```
aws appintegrations create-event-integration --region
--name Connect-Cases-Event-Integration
--event-bridge-bus connect-cases-to-customer-profiles --event-filter
"{\"Source\": \"aws.cases\" }"
--description "Event Integration for Cases Event Bus"
```
1. 使用 AWS CLI，使用 put-integration API 创建与客户档案的集成。这将启动数据流向 Customer Profiles，将占位符值替换为您的 Event Integration ARN 和 Customer Profile 域名。
```
aws customer-profiles put-integration --region
--domain-name
--uri --object-type-name Connect-case
```
## 验证您的 Cases 集成
1. 在 Amazon Connect Cases 中创建案例。
1. 事件传送应该几乎可以在瞬间完成，但要等一分钟才能传送并创建客户配置文件。
1. 使用 AWS CLI，在配置文件下找到 Connect-Case 对象，用正确的值替换占位符。
```
aws customer-profiles list-profile-objects --domain-name
--region
--object-type-name Connect-case --profile-id
```
1. 如果您在上述 API 调用的响应中找不到项目，则说明您的集成存在问题。故障排除：
1. 前往 Amazon EventBridge 控制台。
1. 检查是否 EventSource 处于活动状态，匹配项是否 EventBus 存在且正在运行。
1. 检查您的 Case Event Configuration 是否配置正确。
1. 如果这些方法奏效，请联系 支持 寻求帮助以调查问题。
# 设置 Amazon Connect 与 Salesforce、 ServiceNow、Marketo 或 Zendesk 的集成
要定期更新 Amazon Connect 客户档案，您可以使用亚马逊与 Salesforce ServiceNow、Marketo 或 Zendesk 集成。 AppFlow您首先在 Amazon Connect 和您选择的应用程序中设置连接，然后验证集成。
## 在 Amazon Connect 和 Salesforce、 ServiceNow、Marketo 或 Zendesk 中设置连接
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
![\[“Amazon Connect 虚拟联系中心实例”页面, 实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/instance.png)
1. 在导航窗格中，选择 **Customer Profiles**。
1. 在 **Customer Profiles 配置**页面上，选择**添加集成**，如下图所示。
![\[“Customer Profiles 配置”页面，“添加集成”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. 在**选择数据源**页面上，选择要从哪个外部应用程序中获取客户资料数据。您可以查看[集成要求](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html)，以更好地了解应用程序所需的连接要求。
![\[“选择数据源”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png)
1. 在**建立连接**页面上，选择以下选项之一：
+ **使用现有连接**：这允许您重复使用您可能在 AWS 账户中创建的现有 Amazon AppFlow 资源。
+ **创建新连接**：输入外部应用程序所需的信息。
![\[“建立连接”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png)
1. 在**集成选项**页面上，选择要摄取的源对象并选择其对象类型。
对象类型可存储您摄取的数据。它们还可定义来自集成的对象在摄取时如何映射到资料。Customer Profiles 提供了默认的对象类型模板，您可以使用这些模板来定义如何将源对象中的属性映射到 Customer Profiles 中的标准对象。您也可以使用从中创建的对象映射。[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)在为用户创建的数据映射添加或创建 Salesforce 集成时，您需要指定特定的数据映射，否则它将为对象类型选择 Salesforce 默认数据映射。您可以创建数据映射并在设置精选数据连接器时使用它。
![\[“集成选项”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-integration-options.png)
1. 对于**摄取开始日期**，Customer Profiles 开始摄取在此日期之后创建的记录。默认情况下，导入记录的日期设置为 30 天前。
1. 在**查看和集成**页面上，检查**连接状态**是否显示为**已连接**，然后选择**创建集成**。
![\[“查看和集成”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png)
1. 设置集成后，返回 **Customer Profiles 配置**页面，选择**查看对象**以查看正在批处理和发送哪些数据。目前，此流程会摄取在过去 30 天内创建或修改的记录。
![\[“Customer Profiles 配置”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-objects.png)
# 为 Segment 设置集成，以便定期更新 Amazon Connect Customer Profiles
要定期更新 Amazon Connect 客户档案，您可以使用亚马逊与 Segment 集成 AppFlow。您首先在 Amazon Connect 和 Segment 中设置连接，然后验证 Segment 集成。
## 在 Amazon Connect 和 Segment 中设置连接
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
![\[“Amazon Connect 虚拟联系中心实例”页面, 实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/instance.png)
1. 在导航窗格中，选择 **Customer Profiles**。
1. 在 **Customer Profiles 配置**页面上，选择**添加集成**。
![\[“Customer Profiles 配置”页面，“添加集成”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. 在**选择数据源**页面上，选择 **Segment**。查看**选择应用程序**页面上列出的应用程序要求。
![\[“选择数据源”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png)
1. 在**建立连接**页面上，选择以下选项之一：
+ **使用现有连接**：这允许您重复使用您可能在中创建的现有 Amazon EventBridge 资源 AWS 账户。
+ **创建新连接**：输入外部应用程序所需的信息。
![\[“建立连接”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png)
+ **连接名称**：提供您的连接的名称。连接名称由使用此连接的集成引用。
+ **连接 URL**：输入您的应用程序连接 URL。此 URL 用于深度链接到在外部应用程序中创建的对象。连接 URL 是应用程序网站上提供的 Segment 工作区 URL。
查找您的工作区 URL：
1. 登录您的 segment.com 账户。
1. 转至**设置**、**常规设置**。
1. 从浏览器中复制 URL。
1. 客户档案使用亚马逊 EventBridge 与细分市场集成。在**来源设置**页面上，将您的 AWS 账户 身份证复制到剪贴板，然后选择**登录到区段**来配置亚马逊 EventBridge。
1. 按照以下说明设置 Segment：
1. 登录 Segment。
1. 在您的应用程序中，选择一个来源，将目的地设置为 Amazon EventBridge。
1. 粘贴您的 AWS 账户 ID 并选择您所在 AWS 的地区。
1. 切换为**开启**，以激活您的合作伙伴事件源。
1. 转至**事件测试器**，发送测试事件以完成激活您的合作伙伴事件源。
1. **客户端 ID**：这是一个字符串，用于唯一区分外部应用程序中的客户端。此客户端 ID 是应用程序网站上提供的源名称。您可以使用指定的 ID 来标识您希望 Customer Profiles 从中摄取对象的客户端。
查找源 ID：
1. 转至**源**，然后选择源。
1. 转至**设置**、**API 密钥**。
1. 复制您的**源 ID**。
设置事件源目标后，返回 Customer Profiles 控制台并粘贴客户端 ID。
1. 您将会看到一条提示，指示 Amazon Connect 已成功连接到 Segment。
1. 在**集成选项**页面上，选择要摄取的源对象并选择其对象类型。
对象类型可存储您摄取的数据。它们还可定义来自集成的对象在摄取时如何映射到资料。Customer Profiles 提供了默认的对象类型模板，您可以使用这些模板来定义如何将源对象中的属性映射到 Customer Profiles 中的标准对象。您也可以使用从中创建的对象映射。[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[“集成选项”页面，“对象类型”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png)
1. 对于**摄取开始日期**，Customer Profiles 开始摄取在添加集成之后创建的记录。
**注意**
如果您需要历史记录，可以[使用 Amazon S3 作为集成源来导入历史记录](customer-profiles-object-type-mappings.md)。
1. 在**查看和集成**页面上，检查**连接状态**是否显示**已连接**，然后选择**添加集成**。
1. 设置集成后，返回 **Customer Profiles 配置**页面，**集成**页面将显示当前设置的集成。**上次运行**和**集成运行状况**目前不适用于此类集成。
![\[“Customer Profiles 配置”页面，“集成”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
要查看正在发送哪些数据，请选择“集成”和“\$1”，然后选择**查看对象**。
## 验证您的 Segment 集成
要执行此步骤，您需要满足以下先决条件：
+ 访问您的 Segment 工作区。
+ [访问 Amazon Connect 联系人控制面板](amazon-connect-contact-control-panel.md)。
**验证您的 Segment 集成**
1. 转到您的 Segment 工作区控制面板，然后选择**目标**。
![\[Segment 概述页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png)
1. 您将会看到在其中该 Segment 发送数据的目标的列表。选择客户资料的 EventBridge 目的地。
![\[“目标列表”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png)
1. 选择**事件测试器**选项卡。在此页面上，您将向 Customer Profiles 发送测试事件。该事件会被摄取并转换为客户资料，您可以在 Amazon Connect 座席应用程序中查看该资料。
![\[“事件测试器”选项卡。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png)
1. 选择**标识**作为事件类型，然后选择**事件生成器**作为输入方法。
1. 您可以指定**用户 ID** 和一些特性。座席可以在座席应用程序中搜索这些特性。
1. 选择**发送事件**。
1. 事件传送应该几乎可以在瞬间完成，但要等一分钟才能传送并创建客户资料。
1. 打开 Amazon Connect 座席应用程序。搜索您在**事件生成器**中输入的用户 ID。您应该能够看到带有用户 ID 和您输入的特性的客户资料。
1. 如果您看不到客户资料，则说明您的集成存在问题。故障排除：
1. 前往 Amazon EventBridge 控制台。
1. 检查是否 EventSource 处于活动状态，匹配项是否 EventBus 存在且正在运行。
如果这些方法奏效，请联系 支持 寻求帮助以调查问题。
## 监控您的 Customer Profiles 集成
建立连接后，如果连接停止运行，请删除集成，然后重新建立集成。
## 如果没有发送对象该怎么办
如果对象发送失败，请选择**流详细信息**以详细了解出了什么问题。
您可能需要删除配置并重新连接到外部应用程序。
# 为 Shopify 设置集成，以便定期更新 Amazon Connect Customer Profiles
要定期更新 Amazon Connect 客户资料，您可以使用亚马逊与 Shopify 集成 AppIntegrations。您首先在 Amazon Connect 和 Shopify 中设置连接，然后验证 Shopify 集成。
## 在 Amazon Connect 和 Shopify 中设置连接
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
![\[“Amazon Connect 虚拟联系中心实例”页面, 实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/instance.png)
1. 在导航窗格中，选择 **Customer Profiles**。
1. 在 **Customer Profiles 配置**页面上，选择**添加集成**。
![\[“Customer Profiles 配置”页面，“添加集成”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. 在**选择源**页面上，选择 **Shopify**。查看**选择应用程序**页面上列出的应用程序要求。
![\[“选择源”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png)
1. 在**建立连接**页面上，选择以下选项之一：
+ **使用现有连接**：这允许您重复使用您可能在中创建的现有 Amazon EventBridge 资源 AWS 账户。
+ **创建新连接**：输入外部应用程序所需的信息。
![\[“建立连接”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png)
+ **连接名称**：提供您的连接的名称。连接名称由使用此连接的集成引用。
+ **连接 URL**：输入您的应用程序连接 URL。此 URL 用于深度链接到在外部应用程序中创建的对象。连接 URL 是应用程序网站上提供的 Shopify Partner 应用程序 URL。
查找您的 Shopify Partner 应用程序 URL：
+ 登录您的 partners.shopify.com 账户。
+ 转至您的应用程序。
+ 从浏览器中复制 URL。
+ **客户端 ID**：输入您的应用程序客户端 ID。这是一个字符串，用于唯一区分外部应用程序中的客户端。此客户端 ID 是应用程序网站上提供的源名称。您可以使用此处指定的 ID 来标识您希望 Customer Profiles 从中摄取对象的客户端。按照源设置步骤操作后，您的客户端 ID 可能可用。
查找您的源名称：
+ 登录您的 partners.shopify.com 账户。
+ 转至您的应用程序。
+ 从您的 Amazon EventBridge 事件源中复制源名称。
1. 在**来源设置**页面上，将您的 AWS 账户 身份证复制到剪贴板，然后选择**登录 Shopify**。
1. 按照以下说明设置 Shopify：
1. 登录 partners.shopify.com。
1. 在 Amazon 下 EventBridge，选择**创建来源**。
1. 粘贴您的 AWS 账户 ID 并选择您所在 AWS 的地区。
1. 设置事件源目标后，返回 Customer Profiles。您将会看到一条提示，指示 Amazon Connect 已成功连接到 Shopify。
1. 在**集成选项**页面上，选择要摄取的源对象并选择其对象类型。
对象类型可存储您摄取的数据。它们还可定义来自集成的对象在摄取时如何映射到资料。Customer Profiles 提供了默认的对象类型模板，您可以使用这些模板来定义如何将源对象中的属性映射到 Customer Profiles 中的标准对象。您也可以使用从中创建的对象映射。[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[“集成选项”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png)
1. 对于**摄取开始日期**，Customer Profiles 开始摄取在添加集成之后创建的记录。
**注意**
如果您需要历史记录，可以[使用 Amazon S3 作为集成源来导入历史记录](customer-profiles-object-type-mappings.md)。
1. 在**查看和集成**页面上，检查**连接状态**是否显示**已连接**，然后选择**添加集成**。
**注意**
添加此集成后，您需要[设置 webhook 订阅](#shopify-webhook-subscriptions)以允许事件开始流入此集成。
![\[“查看和集成”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png)
1. 设置集成后，返回 **Customer Profiles 配置**页面，**集成**分区将显示当前设置的集成。**上次运行**和**集成运行状况**目前不适用于此类集成。
![\[“集成”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
要查看正在发送哪些数据，请选择“集成”，然后选择**查看对象**。
1. 转到下一步，使用 API 设置 **webhook 订阅**，以便事件可以开始流入此集成。
## 设置 webhook 订阅
1. 使用以下 URL 确保您的应用程序具有所需的权限：
```
https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}
```
其中：
+ `shop` 是您的 Shopify 商店的名称。
+ `api_key` 是您的 Shopify 应用程序的 API 密钥。您可以在 Shopify **应用程序**详细信息页面上找到此信息。
+ `scopes` 的值应为 `read_customers,read_orders,read_draft_orders`。
+ `redirect_uri` 是您在创建应用程序时为其指定的重定向 URI。出于我们的目的，它可以是任何有效的 URL。
+ `nonce` 可以是任何唯一值，用于标识来自其他人的给定授权请求。建议使用时间戳。
构建 URL 后，将其粘贴到浏览器中。将显示一个与下图类似的 installation/authorization 页面，要求商店所有者为定义的范围提供权限。
![\[用于安装和授权应用程序的 shopify 页面示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png)
1. 选择**安装未列出的应用程序**，以代表您的商店安装和授权应用程序。
您将进入您输入的重定向 URI，并将授权代码附加到重定向 URI 中作为查询参数。例如：
```
https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}×tamp=1409617544&state={nonce}&shop={shop_origin}&host={host}
```
1. 从此 URI 中复制 `authorization_code`。在后续步骤中，您将使用它来获取永久访问令牌。
1. 转到您用于进行 API 调用的任何工具。例如 [CURL](https://curl.se/) 或 [POSTMAN](https://www.postman.com/)。
1. 要获取永久访问令牌，向此端点发出对 Shopify `Admin` API 的 POST 请求：
```
https://{shop}.myshopify.com/admin/oauth/access_token
```
请求正文如下：
```
{
"code": "authorization_code_received_from_redirect_uri",
"client_id": "your_app_api_key",
"client_secret": "your_app_api_secret"
}
```
此请求返回以下响应：
```
{
"access_token": "permanent_access_token",
"scope": "read_customers,read_orders,read_draft_orders"
}
```
1. 记下 `access_token`。这是一个永久令牌，具有上一步中提供的范围。现在，您已准备好创建 webhook 订阅。
1. 对于以下 API 调用，请务必将 HTTP 标头键 `X-Shopify-Access-Token` 设置为从先前调用的响应中收到的 `access_token`。
1. 要设置 webhook 订阅，请对下一步中列出的每个 `topic` 值发出以下 POST 请求：
端点：`https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json`
请求正文：
```
{
"webhook": {
"topic": "replace_this_with_one_of_the_topics_in_the_list_below",
"address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration",
"format": "json"
}
}
```
1. 对于每个订阅，将 `topic` 的值替换为以下值：
+ `customers/create`
+ `customers/enable`
+ `customers/update`
+ `draft_orders/create`
+ `draft_orders/update`
+ `orders/cancelled`
+ `orders/create`
+ `orders/fulfilled`
+ `orders/paid`
+ `orders/partially_fulfilled`
+ `orders/updated`
现在，您已经准备好接收来自您的 Shopify 商店的事件。接下来，验证您的 Shopify 集成。
## 验证您的 Shopify 集成
1. 以管理员身份登录您的 Shopify 商店。
1. 在左侧导航菜单中，选择**客户**。
1. 选择**添加客户**。
1. 输入您的客户详细信息。请务必输入电话号码和电子邮件。这些信息不一定属于真实的客户。验证集成后，您将删除此客户输入条目。
1. 保存客户对象。
1. 事件传送应该几乎可以在瞬间完成，但要等一分钟才能传送并创建客户资料。
1. 打开 Amazon Connect 座席体验，然后通过您在 Shopify 商店中输入的电子邮件或电话号码查找用户。您应该能够看到具有相同电子邮件或电话号码的客户资料。
1. 如果您看不到客户资料，则说明您的集成存在问题。故障排除：
1. 前往 Amazon EventBridge 控制台。
1. 检查是否 EventSource 处于活动状态，匹配项是否 EventBus 存在且正在运行。
如果这些方法奏效，请联系 支持 寻求帮助以调查问题。
## 监控您的 Customer Profiles 集成
建立连接后，如果连接停止运行，请删除集成，然后重新建立集成。
## 如果没有发送对象该怎么办
如果对象发送失败，请选择**流详细信息**以详细了解出了什么问题。
您可能需要删除配置并重新连接到外部应用程序。
# 使用 Amazon 为外部应用程序设置集成 AppFlow
这些集成使用亚马逊 AppFlow 来定期更新 Amazon Connect 客户资料。以下步骤提供了有关如何使用 Amazon 配置您选择的连接器 AppFlow、配置数据映射以及配置集成以提取客户数据的指导。
有关亚马逊 AppFlow 定价的更多信息，请参阅亚马逊 AppFlow [定价](https://aws.amazon.com/appflow/pricing/)。
有关 Amazon AppFlow 支持的连接器的更多信息，请参阅[支持的源和目标应用程序](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html)。
## 开始前的准备工作
当您启用 Amazon Connect Customer Profiles 时，您将创建一个 Customer Profiles 域，该域是所有数据（如客户资料、对象类型、资料密钥和加密密钥）的容器。以下是创建客户资料域的指南：
+ 每个 Amazon Connect 实例只能与一个域关联。
+ 您可以创建多个域，但它们之间不会共享外部应用程序集成或客户数据。
+ 您创建的所有外部应用程序集成均处于域级别。所有与域关联的 Amazon Connect 实例均会继承该域的集成。
**先决条件：在您的 Amazon Connect 实例中启用客户资料**
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
1. 在导航窗格中，选择 **Customer Profiles**。
1. 选择“启用 Customer Profiles”
在表单中，您需要按照以下步骤填写所有必填字段，才能创建 Customer Profiles 域：
1. **域设置**。您可以创建新域并提供名称。
1. **加密**。在“指定 KMS 密钥”下，您可以通过选择现有 AWS KMS 密钥、创建新的 AWS KMS 密钥来启用加密，也可以选择**选择现有域**。
1. **错误报告**。您可以提供死信队列，这是处理客户资料错误的 SQS 队列
1. 选择**提交**，系统将使用您的实例的联系人历史记录信息创建客户资料。
### 使用 Amazon 设置外部应用程序 AppFlow
您可以按照以下步骤使用亚马逊，向 Amazon Connect 客户档案域添加外部应用程序集成。 AppFlow 在继续使用客户资料控制台之前，您必须先在 Amazon AppFlow 控制台中为数据源创建流程，并将 Amazon Connect 客户档案设置为目标。如果您在超过 14 天前创建了流，则该流已过期，您需要为集成创建一个新流。
您可以选择在摄取之前使用 CloudFormation `AWS::AppFlow::Flow Task`资源`Validate`时执行数据转换，例如`Arithmetic``Filter``Map``Map_all``Mask``Merge`、`Truncate`、、、、、、、和。
1. 登录您的 AWS 管理控制台，选择 Amazon AppFlow，然后选择**创建流程**。
![\[亚马逊 AppFlow 页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step1.png)
1. 输入流名称和可选的流描述。
![\[“流详细信息”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step2.png)
1. 您可以按原样保留 “**数据加密**” 部分，因为您的 Amazon Connect 客户档案域已有用于此流程的现有 AWS KMS 密钥。您可以选择创建标签，然后选择**下一步**。
![\[“数据加密”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step3.png)
1. 在**源名称**下拉列表中选择您所选的外部应用程序，然后选择下一个相关字段。例如，如果您想配置 Slack，请从**源名称**下拉列表中选择 Slack。然后，您可以选择现有的 Slack 流或创建新连接。
![\[“配置流”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step4.png)
1. 如果您选择创建新连接，则可以输入外部应用程序的详细信息，例如用户名、密码和子域。您也可以选择用于数据加密的 AWS KMS 密钥并输入连接名称来标识此连接。
![\[“连接到 Slack”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step5.png)
1. 如果您选择使用现有连接，则可以从下拉列表中选择特定的外部应用程序对象。例如，如果选择现有的 Slack 连接，则可以选择**对话**作为对象，然后选择要使用的特定 Slack 频道。
![\[“源详细信息”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step6.png)
1. 在**目标详细信息**部分，在下拉列表中选择 Amazon Connect 作为目标名称，然后选择在前一个先决条件步骤中创建的客户资料域。
![\[“目标详细信息”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step7.png)
1. 通过选择**按需运行**或**按计划时间运行流**来选择流触发器。选择**下一步**。
+ **按需运行**仅在触发流时运行流。
+ **按计划时间运行流**使用计划在特定时间运行流。计划频率限制为 5 分钟、15 分钟或 1 小时。
![\[“流触发器”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step8.png)
1. 在**映射方法**下选择**手动映射字段**。从外部应用程序中选择源字段，然后选择**直接映射字段**。
![\[“映射方法”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step9.png)
1. 查看并选择**创建流**。
有关在 Amazon AppFlow 控制台中创建流程的更多信息，请参阅在 A [mazon 中创建流程 AppFlow](https://docs.aws.amazon.com/appflow/latest/userguide/create-flow.html)。
有关在 Amazon 中设置外部应用程序和许多其他支持的应用程序的更多信息 AppFlow，请参阅[支持的亚马逊 AppFlow 源应用程序和目标应用程序](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html)。
### 设置数据映射以定义如何将外部应用程序数据映射到客户资料
设置Amazon AppFlow 集成后，您需要在客户档案中设置数据映射，以定义如何将来自外部应用程序的数据映射到客户档案。这样，您就可以自定义要用于构建统一客户资料的数据。请谨慎选择您的映射，因为在创建集成后您将无法选择其他映射。
有关数据映射的更多详细信息，请参阅[对象类型映射](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-object-type-mapping.html)。
1. 登录您的 AWS 管理控制台，选择 **Amazon Connect**。然后在您的连接实例别名下选择客户档案。
![\[“Amazon Connect Customer Profiles”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step1.png)
1. 选择**数据映射**，然后选择**创建数据映射**。提供数据映射名称和描述。
![\[“数据映射”选项卡，“创建数据映射”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2.png)
![\[“设置数据映射”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2_2.png)
1. 在**映射选项**下，可以选择您的**数据源**作为外部应用程序，选择在上一节中创建的**流名称**以及**数据定义方法**作为*映射目标*。在**映射目标**下，您可以选择要为统一的客户资料定义的客户数据类型。选择**下一步**。
![\[“映射选项”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step3.png)
1. 添加客户、产品、案例和订单属性以及源、目标和内容类型，然后选择**下一步**。
![\[“映射订单属性”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step4.png)
1. 在**指定标识符**下，您可以从数据源对象中选择各种属性，以帮助将您的数据与其他数据源对象区分开来。您可以从唯一标识符、客户标识符、产品标识符、案例标识符和订单标识符中选择属性。有关标识符的更多信息，请参阅[在 Customer Profiles 中设置密钥属性的标准标识符](standard-identifiers.md)。
![\[“标准标识符”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step5.png)
1. 查看并选择**创建数据映射**。数据映射状态将显示为*活动*。
![\[“步骤 6：指定标识符”页面上的标识符。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-mapping-step6.png)
### 设置集成以从外部应用程序摄取您的客户数据
完成外部应用程序的数据映射设置后，您将设置数据源集成以摄取客户数据。
1. 登录您的 AWS 管理控制台，选择 **Amazon Connect**，然后在您的连接实例别名下选择 Customer Profiles。
1. 在**数据源集成**分区下，选择**添加数据源集成**。
![\[“数据源集成”选项卡，“添加数据源集成”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step2.png)
1. 在**数据源**下拉列表下，选择外部应用程序，然后选择**下一步**。您还可以选择**创建新流程，这将在新**选项卡中打开Amaz AppFlow on控制台。
![\[“数据源”分区。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step3.png)
1. 在**流名称**下拉列表中，从数据源中选择要使用的流，然后选择**下一步**。
![\[选择流程名称以建立连接。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step4.png)
1. 在**数据映射**下拉列表中，选择对象的外部应用程序数据映射，以定义数据源如何映射到资料。选择**下一步**。
![\[“选择数据映射”页面，“映射”下拉框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step5.png)
1. 查看并选择**添加数据源集成**。在进入活动状态之前，外部应用程序的数据源集成最初将显示为待处理。
![\[“查看和集成”页面，“添加数据源集成”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step6.png)
### 在 Amazon Connect Customer Profile 座席 CCP 中查看统一的客户资料
现在，您的座席可以通过登录 Amazon Connect 座席 CCP 来查看从外部应用程序导入的客户数据。有关连接到 Amazon Connect 座席 CCP 的更多信息，请参阅[座席应用程序：一应俱全](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-contact-control-panel.html#use-agent-application)。
您的座席需要拥有相应的安全配置文件权限才能查看 Customer Profiles，并能够使用配置文件搜索栏中的密钥名称和值执行搜索。
有关安全配置文件权限的更多信息，请参阅[安全配置文件](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html)。
高级用户如果想建立自己的定制座席应用程序和嵌入式客户配置文件，可以使用 [StreamsJS](https://github.com/amazon-connect/amazon-connect-customer-profiles)，它能为座席应用程序提供更多定制功能。
# 删除 Customer Profiles 或停止集成
**注意**
删除映射只会删除与该特定映射相关联的对象和数据。如果有多个对象与一个资料相关联，则删除特定的映射可能无法清除资料数据。如果要删除特定数据，则需要删除相应的映射，但是如果您的资料包含来自其他映射的数据，则这些资料可能仍将存在。这样可能会导致针对现有资料产生额外费用。您可以使用[Amazon Connect 控制台](delete-customer-profiles-domain.md)或 [DeleteDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_DeleteDomain.html)API 删除域名和客户资料中的所有数据，包括所有个人资料。
**控制台方法**
+ **如果您想随时停止提取客户资料数据，请选择， integration/mapping 然后选择删除。**
+ 要删除集成、客户资料和所有客户资料数据，可以在 Amazon Connect 控制台中删除您的客户资料域。有关更多信息，请参阅 [删除 Amazon Connect Customer Profiles 域](delete-customer-profiles-domain.md)。
**API 方法**
+ 要删除特定集成的客户资料数据，请使用 `DeleteProfileObjectType` API。
+ 要删除集成、客户资料和所有客户资料数据，请使用 `DeleteDomain` API。
要重新启用客户资料数据的摄取，请再次执行设置步骤。
# Amazon Connect Customer Profiles 中的对象类型映射
对象类型映射会告知 Customer Profiles 如何摄取特定类型的数据。它为 Customer Profiles 提供基本信息，例如：
+ 应如何从对象填充数据并将其摄取到标准资料对象中。
+ 应该在对象中为哪些字段编制索引，以及然后应如何使用这些字段将此类对象分配给特定的资料。
本节的主题提供了帮助您设置对象类型映射的信息和步骤，包括如何创建对象类型映射、映射定义详细信息以及关键概念和术语。
**Topics**
+ [客户对象类型映射术语和概念](customer-profiles-terminology.md)
+ [创建对象类型映射](create-object-type-mapping.md)
+ [Amazon Connect Customer Profiles 中的对象类型映射定义详细信息](object-type-mapping-definition-details.md)
+ [Customer Profiles 中对象类型的其他属性](additional-properties-object-types.md)
+ [推断的资料](inferred-profiles.md)
+ [联系人录音模板](ctr-contact-record-template.md)
+ [将 Contact Record 与 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)
+ [生成式人工智能支持的数据映射](genai-powered-data-mapping.md)
+ [Customer Profiles 数据限制](customer-profiles-data-limits.md)
# 客户对象类型映射术语和概念
以下术语和概念对您了解自定义对象类型映射非常重要。
**标准资料对象**
*标准资料对象*是所有资料均包含的预定义对象。
标准资料对象包含标准字段，例如电话号码、电子邮件地址、姓名和其他标准数据。无论来源如何（例如，Salesforce 或 Marketo），都可以以标准格式检索这些数据。 ServiceNow
**资料对象**
*资料对象*是已知的有关资料的单一信息单元。例如，有关来自网站的电话、工单、案例甚至点击流记录的信息。
单个资料对象最大可为 250 KB，可以是任何结构化 JSON 文档。
+ 每个资料对象都有一个类型。例如，个人资料对象可以是 Amazon Connect 联系人记录、 ServiceNow 用户或 Marketo 潜在客户。
+ 类型指的是对象类型映射。
+ 对象类型映射定义应如何将该特定对象摄取到 Customer Profiles 中。
**配置文件**
*资料*包含有关特定客户或联系人的所有已知信息。它包括一个标准资料对象和任意数量的其他资料对象。
**对象类型映射**
*对象类型映射*会告知 Customer Profiles 如何摄取特定类型的数据。它为 Customer Profiles 提供以下信息：
+ 应如何从对象填充数据并将其摄取到标准资料对象中。
+ 应该在对象中为哪些字段编制索引，以及然后应如何使用这些字段将此类对象分配给特定的资料。
**映射模板**
*映射模板*是 Customer Profiles 服务中包含的预定义对象类型映射。
客户资料包括 Amazon Connect 联系人记录、Salesforce 账户、 ServiceNow 用户和 Marketo 潜在客户的映射模板。要查看可用映射模板的完整列表，请使用 [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)API。
使用映射模板，您无需指定任何其他信息即可快速从众所周知的源中摄取数据。
# 在 Amazon Connect Customer Profiles 中创建对象类型映射
对象类型映射会告知 Customer Profiles 如何将源应用程序（例如 Salesforce、Zendesk 或 S3）中的特定类型的数据摄取到统一的标准资料对象中。然后，您可以使用 [Amazon Connect 座席应用程序](customer-profile-access.md)向您的座席显示该对象中的数据（例如客户地址和电子邮件）。
对象类型映射为 Customer Profiles 提供以下信息：
+ 应如何从对象填充数据并将其摄取到标准资料对象中。
+ 应该在对象中为哪些字段编制索引，以及然后应如何使用这些字段将此类对象分配给特定的资料。
创建对象类型映射的方法有两种：
+ 使用 Amazon Connect 控制台。用户界面使数据映射功能易于访问。例如，您可以添加自定义属性，并定义联系模型的搜索和唯一标识符。无需编码！
+ 使用 Customer Profiles API。关更多信息，请参阅 [Amazon Connect Customer Profiles API 参考](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html)。
本主题说明了如何使用 Amazon Connect 控制台创建映射。
## 使用 Amazon Connect 控制台创建数据映射
Amazon Connect 为将来自本土应用程序和第三方应用程序的客户数据映射到亚马逊 S3、Salesforce ServiceNow、Zendesk 和 Marketo 提供了无代码体验。
要创建数据映射，您需要定义一个对象类型映射，该映射描述自定义资料对象的外观。此映射定义如何使用数据中的字段来填充标准资料中的字段，或者如何能够使用它们将数据分配给特定资料。
### 步骤 1：设置数据映射
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 在“实例”页面上，选择实例别名。实例别名也是您的**实例名称**，该名称显示在您的 Amazon Connect URL 中。下图显示了 **Amazon Connect 虚拟联系中心实例**页面，其中，实例别名周围有一个方框。
![\[“Amazon Connect 虚拟联系中心实例”页面, 实例别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/instance.png)
1. 在导航窗格中，依次选择 **Customer Profiles**、**数据映射**。
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 以外的来源，请在 “**与之建立连接***application*” 部分中，选择现有的 Amazon AppFlow 或 Amazon EventBridge 连接来连接您的数据，或者创建新的连接。您可以通过为该数据源输入有关您的帐户的详细信息来创建新的连接。
建立连接后，您将选择要从数据源中摄取的对象。
1. 选择**下一步**。
### 步骤 2：映射属性
在**映射*类型*属性**页面上，您将看到根据映射目标填充了预定义模板的字段映射表。例如，它填充了客户、产品、案例或订单属性。您可以通过选择一个属性（例如 AccountNumber）然后选择其他目的地来更改预定义的模板，也可以输入自己的自定义属性之一。
下图显示了使用模板中的客户属性填充的页面的示例。
![\[Amazon Connect 导航菜单，“映射客户属性”页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-data-mapping-2.png)
您可以删除不想在客户资料中填充的内容、更改源，并添加自定义属性。
此映射使用您的数据源填充客户联系信息，例如客户资料中的电话号码。它使用标准资料模板中的属性。
**提示**
如果您选择添加自定义属性，则目标将始终添加前缀 `Attributes.`。这使得 Amazon Connect 能够识别它是一个自定义属性。
![\[“客户属性映射”界面，显示映射到目标字段的来源字段。\]](http://docs.aws.amazon.com/zh_cn/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_cn/connect/latest/adminguide/images/customer-profiles-data-mapping-3.png)
# 关于 Amazon Connect 中的映射目的地
映射目标就是您从源到已在 Amazon Connect 中定义的标准定义的映射。
下表列出了支持的映射目标。
| 源对象 | 目标：客户、产品、订单、案例 |
| --- | --- |
| S3 | 任何 |
| Salesforce-Account | Customer |
| Salesforce-Contact | Customer |
| Salesforce-Asset | 产品 |
| Zendesk-users | Customer |
| Marketo-leads | Customer |
| Servicenow-sys\$1user | Customer |
| Segment-Identify | Customer |
| Segment-Customer | Customer |
| Shopify-Customer | Customer |
| Shopi-DraftOrder | Order |
| Zendesk-tickets | 案例 |
| Servicenow-task | 案例 |
| Servicenow-incident | 案例 |
# Customer Profiles 中的对象类型映射要求
以下信息需要位于您的对象类型映射中，以便 Customer Profiles 可以处理传入数据：
+ 摄取的对象中应映射到标准资料或用于将数据分配给资料的所有字段的定义。此信息会告知 Customer Profiles 应将摄取的**源**对象中的哪些字段映射到标准资料对象中的给定字段。
+ 应为自定义数据中源对象内的哪些字段编制索引以及如何编制索引。
当 Customer Profiles 摄取源数据时，索引字段将确定：
+ 特定对象属于哪个资料。
+ 哪些对象相互关联，应放置在同一个资料中。例如，联系记录中的账号或联系人 ID。
+ 可以使用哪些值来查找资料。例如，可以为联系人的姓名编制索引。这样将有助于座席查找属于具有特定名称的客户的所有资料。
## 键要求
您必须至少定义一个键。Customer Profiles 使用此键将您的自定义资料对象映射到资料。
自定义资料对象映射还需要至少一个唯一标识相应对象的键，这样就可以通过指定该字段的相同值来更新对象（可使用单个键来满足这些要求）。
每个键可以由一个或多个字段组成。
## 字段要求
字段定义指定如何从源对象读取该字段名称的值。字段定义还指定字段中存储的具体数据类型。
对象类型名称可以是任何字母数字字符串或“-”和“\$1”字符，它们也不能以“\$1”字符开头，该字符用于保留的标准对象类型。
# Amazon Connect Customer Profiles 中的对象类型映射定义详细信息
对象类型映射定义具有两个部分：字段定义和键定义。
**提示**
要了解如何创建对象类型映射器，请参阅此博客文章：[使用预先构建的 Amazon S3 连接器，通过 Amazon Connect Customer Profiles 统一和整理客户信息](https://aws.amazon.com/blogs/contact-center/unify-and-organize-customer-information-with-amazon-connect-customer-profiles-with-the-pre-built-amazon-s3-connector/)。或者，请观看此视频 YouTube：[如何将客户资料数据整合到您的联络中心体验](https://www.youtube.com/watch?v=LLIEwFel_7c&t=1767s)中。
## 字段定义详细信息
字段定义用于定义字段的源、目标和类型。例如：
```
"Fields": {
"{fieldName}": {
"Source": "{source}",
"Target": "{target}",
"ContentType": "{contentType}"
}, ...
}, ...
```
+ `Source`：这可以是字段的 JSON 访问器，也可以是用于生成字段值的 Handlebar 宏。
正在解析的源对象被命名为 ` _source`，因此源字段中的所有字段都需要以此字符串为前缀。仅支持 `_source` 对象。
使用 Handlebar 宏解决方案生成常量并将多个源对象字段组合成一个字段。这对于编制索引很有用。
+ `Target`：指定在标准对象类型中，该字段的数据应映射到何处。
通过填充标准资料，您可以将从任何数据源摄取的数据与基于 Customer Profiles 构建的应用程序结合使用，而无需具体了解所摄取数据的格式。
该字段是可选的。您可能想定义字段，仅仅是为了将其包含在键中。
此字段的格式始终为 JSON 访问器。唯一支持的目标对象是 `_profile`。
+ `ContentType`：支持以下值：STRING、NUMBER、PHONE\$1NUMBER、EMAIL\$1ADDRESS、NAME。如果未指定 `ContentType`，则会采用 STRING。
`ContentType` 用于确定如何为该值编制索引，以便座席可以对其进行搜索。例如，如果 `ContentType` 设置为 PHONE\$1NUMBER，则会处理电话号码，以便座席可以采用任何格式搜索该号码：字符串“\$115551234567”与“(555)-123-4567”匹配。
## 键定义详细信息
密钥包含一个或多个字段，这些字段共同定义了一个密钥，该密钥可用于使用 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API 搜索对象（或它们所属的配置文件）。也可以将键定义为唯一标识资料或唯一标识对象本身。
```
"Keys": {
"{keyName}": [{
"StandardIdentifiers": [...],
"FieldNames": [ "{fieldname}", ...]
}], ...
}, ...
```
键名称是域的全局名称。如果您有两个键，并且在两个不同的对象类型映射中具有相同的名称：
+ 这些密钥应该占用相同的命名空间
+ 它们可以用于潜在地将不同对象之间的资料链接在一起。如果它们在不同对象之间匹配，则 Customer Profiles 会将这两个对象放在同一个资料中。
换句话说：当且仅当相同的值意味着键相关时，键在域中应该具有相同的键名称。例如，在一种类型的对象中指定的电话号码将与在另一种类型的对象中指定的相同电话号码相关。为从 Salesforce 导入的对象指定的内部标识符可能与从 Marketo 导入的另一个对象无关（即使它们的值完全相同）。
密钥定义的使用方式有两种：
+ 在摄取期间，在 Customer Profiles 中，它们用于确定应将对象分配给哪个资料。
+ 它们允许您使用 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API 搜索密钥值并查找配置文件。
## 默认搜索密钥
默认搜索键（例如 `_phone` 和 `_email`）由[标准配置文件](standard-profile-definition.md)、[标准资产](standard-asset-definition.md)、[标准订单](standard-order-definition.md)和[标准案例](standard-case-definition.md)对象模板预定义。您可以在 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 中使用默认搜索密钥作为密钥名称来查找个人资料。
# 在 Customer Profiles 中设置密钥属性的标准标识符
标准标识符允许您设置键的属性。根据您希望在资料中摄取数据的方式，决定要使用哪些标识符。例如，您可以使用标识符 PROFILE 来标记电话号码。这意味着电话号码将被视为唯一标识符。如果 Customer Profiles 中有两个使用相同电话号码的联系人，则这些联系人将合并为一个资料。
| 标识符名称 | 说明 |
| --- | --- |
| AIR\$1PREFERENCE | 此标识符意味着此键唯一标识航空偏好。如果指定此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何航空偏好。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1BOOKING | 此标识符意味着此键唯一标识机票预订。如果指定此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何机票预订。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1SEGMENT | 此标识符意味着此键唯一标识航段。如果指定此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何航段。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1PREFERENCE | 此标识符意味着此键唯一标识酒店偏好。如果指定此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何酒店偏好。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/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_cn/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1RESERVATION | 此标识符意味着此键唯一标识酒店预订。如果指定此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何酒店预订。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY | 此标识符意味着此键唯一标识忠诚度。如果指定此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何忠诚度。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1TRANSACTION | 此标识符意味着此键唯一标识忠诚度交易。如果指定此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何忠诚度交易。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1PROMOTION | 此标识符意味着此键唯一标识忠诚度促销。如果指定此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何忠诚度促销。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/standard-identifiers.html) |
| UNIQUE | 此标识符必须由每种对象类型的一个索引指定。此键用于唯一标识相应对象类型的对象，以便获取它们或在需要时将来更新已提交的对象。 提交新对象时，需要指定构成 UNIQUE 键的所有字段，否则该对象将被拒绝。 |
| PROFILE | 此标识符意味着此键唯一标识资料。如果指定了此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何资料。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/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_cn/connect/latest/adminguide/standard-identifiers.html) |
| ORDER | 此标识符意味着此键唯一标识订单。如果指定了此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何订单。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/standard-identifiers.html) |
| CASE | 此标识符意味着此键唯一标识案例。如果指定了此标识符，则意味着在摄取过程中，Customer Profiles 会查找与此键关联的任何案例。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/standard-identifiers.html) |
## 兼容的标识符
![\[矩阵显示了对于不同的数据类型支持和限制的标识符和键名称。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/standard-identifiers-compatibility-image.png)
# Customer Profiles 如何处理密钥定义
当 Customer Profiles 摄取自定义对象映射时，它会处理键定义。下图显示了它如何处理键定义中的标准标识符以确定将对象分配给哪个资料。
![\[流程图显示了用于分配对象或对象排队的配置文件键检查过程。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-template1.png)
# Customer Profiles 如何将密钥添加到索引中用于查询
下图显示了 Customer Profiles 如何处理标准标识符以确定是否保留键。
![\[流程图显示了基于查找和新对象标准在 Customer Profiles 中保留键的决策过程。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-template2.png)
流程图显示以下步骤：
1. 键是否指定了 `LOOKUP_ONLY` 属性？
+ 如果为“是”，请不要保留键。
1. 如果为“否”，键是否指定了 `NEW_ONLY` 属性？
+ 如果为“否”，则将键保存在索引中以便用于查找。
1. 如果为“是”，则摄取对象是否会导致创建新的配置文件？
+ 如果为“是”，则将键保存在索引中以便用于查找。
+ 如果为“否”，则不要将键保留在索引中以备将来查找。
# 为 Amazon Connect Customer Profiles 中标准配置文件的对象类型映射
此部分中的主题提供了标准资料定义，以及从外部应用程序到标准资料的对象类型映射。
**Topics**
+ [亚马逊 AppFlow访问要求](appflow-access-requirements-profile.md)
+ [亚马逊 AppIntegrations 访问要求](standard-profile-appintegrations-requirements.md)
+ [客户资料中的亚马逊 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)
# 客户资料中的亚马逊 AppFlow 访问要求
使用以下亚马逊 AppFlow 访问要求来创建和删除 Zendesk、Marketo、Salesforce 以及 ServiceNow 与 Amazon Connect 客户档案的集成：
+ appflow：CreateFlow
+ appflow：DeleteFlow
# 客户资料中的亚马逊 AppIntegrations 访问要求
使用以下亚马逊 AppIntegrations 访问要求创建和删除与 Amazon Connect 客户资料的细分和 Shopify 集成：
+ 应用程序集成：GetEventIntegration
+ 应用程序集成：ListEventIntegrationAssociations
+ 应用程序集成：CreateEventIntegrationAssociation
+ 应用程序集成：DeleteEventIntegrationAssociation
# 客户资料中的亚马逊 EventBridge 访问要求
使用以下亚马逊 EventBridge 访问要求创建和删除与 Amazon Connect 客户资料的细分和 Shopify 集成：
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Amazon Connect Customer Profiles 中的标准配置文件定义
下表列出了 Customer Profiles 标准资料对象中的所有字段。
| 标准资料字段 | 数据类型 | 描述 |
| --- | --- | --- |
| ProfileId | 字符串 | 客户资料的唯一标识符。 |
| AccountNumber | 字符串 | 您提供给客户的唯一账号。 |
| AdditionalInformation | 字符串 | 与客户的资料相关的任何其他信息。 |
| PartyType | 字符串 | 用于描述客户的资料类型。 有效值：INDIVIDUAL \$1 BUSINESS \$1 OTHER |
| BusinessName | 字符串 | 客户的企业名称。 |
| FirstName | 字符串 | 客户的名字。 |
| MiddleName | 字符串 | 客户的中间名。 |
| LastName | 字符串 | 客户的姓氏。 |
| BirthDate | 字符串 | 客户的出生日期。 |
| 性别 | 字符串 | 客户标识的性别。 |
| PhoneNumber | 字符串 | 客户的电话号码，未指定为手机号码、家庭号码或企业号码。 |
| MobilePhoneNumber | 字符串 | 客户的手机号码。 |
| HomePhoneNumber | 字符串 | 客户的家庭电话号码。 |
| BusinessPhoneNumber | 字符串 | 客户的企业电话号码。 |
| EmailAddress | 字符串 | 客户的电子邮件地址，未指定为个人或企业地址。 |
| PersonalEmailAddress | 字符串 | 客户的个人电子邮件地址。 |
| BusinessEmailAddress | 字符串 | 客户的企业电子邮件地址。 |
| 地址 | 地址 | 与客户关联的非邮寄、配送或账单地址的通用地址。 |
| ShippingAddress | 地址 | 客户的配送地址。 |
| MailingAddress | 地址 | 客户的邮寄地址。 |
| BillingAddress | 地址 | 客户的账单地址。 |
| 属性 | String-to-string 地图 | 客户资料属性的键值对。 |
| ProfileType | 字符串 | 配置文件的类型。 有效值：PROFILE \$1 ACCOUNT\$1PROFILE |
| EngagementPreferences | EngagementPreferences | 客户或账户的互动偏好。 |
标准配置文件对象按下表中的密钥建立索引。
| 标准索引名称 | 标准资料字段 |
| --- | --- |
| \$1phone | PhoneNumber、 MobilePhoneNumber HomePhoneNumber、或 BusinessPhoneNumber |
| \$1email | EmailAddress PersonalEmailAddress、或 BusinessEmailAddress |
| \$1account | AccountNumber |
| \$1profileId | ProfileId |
| \$1fullName | "FirstName MiddleName LastName" |
例如，您可以在 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 中使用`_phone`作为密钥名称来查找 PhoneNumber、 MobilePhoneNumber HomePhoneNumber、或 BusinessPhoneNumber 属性与搜索值匹配的个人资料。
## 地址数据类型
| 标准资料字段 | 数据类型 | 说明 |
| --- | --- | --- |
| Address1 | 字符串 | 客户地址的第一行。 |
| Address2 | 字符串 | 客户地址的第二行。 |
| Address3 | 字符串 | 客户地址的第三行。 |
| Address4 | 字符串 | 客户地址的第四行。 |
| City | 字符串 | 客户居住的城市。 |
| Country | 字符串 | 客户居住的国家/地区。 |
| County | 字符串 | 客户居住的郡/县。 |
| PostalCode | 字符串 | 客户地址的邮政编码。 |
| Province | 字符串 | 客户居住的省份。 |
| State | 字符串 | 客户居住的州。 |
## EngagementPreferences 数据类型
| 标准资料字段 | 数据类型 | 说明 |
| --- | --- | --- |
| 电子邮件 | ContactPreference 对象数组 | 与电子邮件相关的联系偏好列表。 |
| Phone | ContactPreference 对象数组 | 与电话相关的联系偏好列表。 |
## ContactPreference 数据类型
| 标准资料字段 | 数据类型 | 描述 |
| --- | --- | --- |
| KeyName | 字符串 | 客户配置文件的可搜索的唯一标识符。 |
| KeyValue | 字符串 | 用于根据 keyName 查找配置文件的键值。 |
| ProfileId | 字符串 | 客户资料的唯一标识符。 |
| ContactType | 字符串 | 用于互动的联系类型。有效值： PhoneNumber MobilePhoneNumber \$1 HomePhoneNumber \$1 BusinessPhoneNumber \$1 EmailAddress \$1 PersonalEmailAddress \$1 BusinessEmailAddress |
# 将 Salesforce 对象映射到 Amazon Connect Customer Profiles 中的标准配置文件
本主题列出了 Salesforce 对象中的哪些字段映射到 Customer Profiles 中标准资料对象中的字段。
## Salesforce-Account 对象
以下是 Salesforce-Account 对象中所有字段的列表。您的 Salesforce-Account 对象中的字段可能会有所不同，具体取决于您的 Salesforce 实例的配置。
+ Id
+ IsDeleted
+ MasterRecordId
+ Name
+ Type
+ ParentId
+ BillingStreet
+ BillingCity
+ BillingState
+ BillingPostalCode
+ BillingCountry
+ BillingLatitude
+ BillingLongitude
+ BillingGeocodeAccuracy
+ BillingAddress.City
+ BillingAddress. 国家
+ BillingAddress.geocode 精度
+ BillingAddress. 纬度
+ BillingAddress. 经度
+ BillingAddress.postalcode
+ BillingAddress. state
+ BillingAddress. street
+ ShippingStreet
+ ShippingCity
+ ShippingState
+ ShippingPostalCode
+ ShippingCountry
+ ShippingLatitude
+ ShippingLongitude
+ ShippingGeocodeAccuracy
+ ShippingAddress.城市
+ ShippingAddress. 国家
+ ShippingAddress. 纬度
+ ShippingAddress. 经度
+ ShippingAddress.postalcode
+ ShippingAddress. state
+ ShippingAddress. street
+ Phone
+ Fax
+ AccountNumber
+ Website
+ PhotoUrl
+ Sic
+ Industry
+ AnnualRevenue
+ NumberOfEmployees
+ Ownership
+ TickerSymbol
+ 说明
+ 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 对象中的字段子集映射到 Customer Profiles 中的标准资料对象。
下表列出了哪些字段可以从 Salesforce-Account 对象映射到标准资料。（该表包括已配置为包含“人员”字段的 Salesforce 实例的映射。）
| Salesforce-Account 源字段 | 标准资料目标字段 |
| --- | --- |
| Id | 属性。 sfdcAccountId |
| Name | BusinessName |
| Phone | PhoneNumber |
| BillingStreet | BillingAddress.Address1 |
| BillingCity | BillingAddress.City |
| BillingState | BillingAddress.State |
| BillingCountry | BillingAddress. 国家 |
| BillingPostalCode | BillingAddress.PostalCode |
| ShippingStreet | ShippingAddress.Address1 |
| ShippingCity | ShippingAddress.City |
| ShippingState | ShippingAddress.State |
| ShippingCountry | ShippingAddress. 国家 |
| ShippingPostalCode | ShippingAddress.PostalCode |
| IsPersonAccount | PartyType |
| PersonMobilePhone | MobilePhoneNumber |
| PersonHomePhone | HomePhoneNumber |
| PersonEmail | PersonalEmailAddress |
| PersonMailingAddress.Street | MailingAddress.Address1 |
| PersonMailingAddress.City | MailingAddress.City |
| PersonMailingAddress.State | MailingAddress.State |
| PersonMailingAddress. 国家 | MailingAddress. 国家 |
| PersonMailingAddress.PostalCode | MailingAddress.PostalCode |
| PersonBirthDate | BirthDate |
| PersonOtherStreet | Address.Address1 |
| PersonOtherCity | Address.City |
| PersonOtherState | Address.State |
| PersonOtherCountry | Address.Country |
| PersonOtherPostalCode | 地址。 PostalCode |
| FirstName | FirstName |
| LastName | LastName |
| MiddleName | MiddleName |
| AccountNumber | AccountNumber |
Salesforce 对象中的 Salesforce-Account 客户数据使用下表中的索引与 Amazon Connect 客户资料相关联。
| 标准索引名称 | Salesforce-Account 源字段 |
| --- | --- |
| \$1salesforceAccountId | Id |
例如，您可以在 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API 中使用`_salesforceAccountId`作为密钥名称来查找配置文件。通过使用和设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API，您可以找到与特定配置文件关联的 Salesforce-Account 对象。`ProfileId` `ObjectTypeName` `Salesforce-Account`
## Salesforce-Contact 对象
以下是 Salesforce-Contact 对象中所有字段的列表。
+ Id
+ IsDeleted
+ MasterRecordId
+ Accountd
+ LastName
+ FirstName
+ Salutation
+ Name
+ OtherStreet
+ OtherCity
+ OtherState
+ OtherPostalCode
+ OtherCountry
+ OtherLatitude
+ OtherLongitude
+ OtherGeocodeAccuracy
+ OtherAddress.城市
+ OtherAddress. 国家
+ OtherAddress.geocode 精度
+ OtherAddress. 纬度
+ OtherAddress.postalcode
+ OtherAddress. state
+ OtherAddress. street
+ MailingStreet
+ MailingCity
+ MailingState
+ MailingPostalCode
+ MailingCountry
+ MailingLatitude
+ MailingLongitude
+ MailingGeocodeAccuracy
+ MailingAddress.城市
+ MailingAddress. 国家
+ MailingAddress.geocode 精度
+ MailingAddress. 纬度
+ MailingAddress. 经度
+ MailingAddress.postalcode
+ MailingAddress. state
+ MailingAddress. street
+ Phone
+ Fax
+ MobilePhone
+ HomePhone
+ OtherPhone
+ AssistantPhone
+ ReportsToId
+ 电子邮件
+ Title
+ Department
+ AssistantName
+ LeadSource
+ Birthdate
+ 说明
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ LastActivityDate
+ 最后CURequest日期
+ 最后CUUpdate日期
+ LastViewedDate
+ LastReferencedDate
+ EmailBouncedReason
+ EmailBouncedDate
+ IsEmailBounced
+ PhotoUrl
+ Jigsaw
+ JigawContactId
+ CleanStatus
+ IndividualId
## 将 Salesforce-Contact 对象映射到标准资料
Salesforce-Contact 对象中的字段子集映射到 Customer Profiles 中的标准资料对象。下表列出了哪些字段可以从 Salesforce-Contact 对象映射到标准资料对象。
| Salesforce-Contact 源字段 | 标准资料目标字段 |
| --- | --- |
| Id | 属性。 sfdcContactId |
| AccountId | 属性。 sfdcAccountId |
| LastName | LastName |
| FirstName | FirstName |
| MiddleName | MiddleName |
| OtherStreet | Address.Address1 |
| OtherCity | Address.City |
| OtherState | Address.State |
| OtherCountry | Address.Country |
| OtherPostalCode | 地址。 PostalCode |
| MailingStreet | MailingAddress.Address1 |
| MailingCity | MailingAddress.City |
| MailingState | MailingAddress.State |
| MailingCountry | MailingAddress. 国家 |
| MailingPostalCode | MailingAddress.PostalCode |
| Phone | PhoneNumber |
| HomePhone | HomePhoneNumber |
| MobilePhone | MobilePhoneNumber |
| 电子邮件 | EmailAddress |
| Birthdate | BirthDate |
Salesforce 对象中的 Salesforce-Contact 客户数据使用下表中的索引与 Amazon Connect 客户资料相关联。
| 标准索引名称 | Salesforce-Contact 源字段 |
| --- | --- |
| \$1salesforceContactId | Id |
| \$1salesforceAccountId | AccountId |
例如，您可以在 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API 中使用`_salesforceAccountId`和`_salesforceContactId`作为密钥名称来查找配置文件。通过使用和设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API，您可以找到与特定配置文件关联的 Salesforce-Contact 对象。`ProfileId` `ObjectTypeName` `Salesforce-Contact`
# 将 Zendesk 对象映射到 Amazon Connect Customer Profiles 中的标准配置文件
本主题列出了 Zendesk 对象中的哪些字段映射到 Customer Profiles 中标准资料中的字段。
## Zendesk-users 对象
以下是 Zendesk-users 对象中所有字段的列表。
+ id
+ url
+ external\$1id
+ email
+ active
+ chat\$1only
+ customer\$1role\$1id
+ role\$1type
+ details
+ last\$1login\$1at
+ locale
+ locale\$1id
+ moderator
+ notes
+ only\$1private\$1comments
+ default\$1group\$1id
+ phone
+ shared\$1phone\$1number
+ photo
+ restricted\$1agent
+ 角色
+ shared
+ 标签
+ signature
+ suspended
+ ticket\$1restriction
+ time\$1zone
+ two\$1factor\$1auth\$1enabled
+ user\$1fields
+ verified
+ report\$1csv
+ created\$1at
+ updated\$1at
## 将 Zendesk 用户映射到标准资料
Zendesk-users 对象中的字段子集映射到 Customer Profiles 中的标准资料。下表列出了哪些字段可以从 Zendesk-users 对象映射到标准资料。
| Zendesk-users 源字段 | 标准资料目标字段 |
| --- | --- |
| id | 属性。 ZendeskUserId |
| external\$1id | 属性。 ZendeskExternalId |
| 电子邮件 | EmailAddress |
| phone | PhoneNumber |
来自 Zendesk 对象的 Zendesk-users 客户数据使用以下索引与 Amazon Connect 客户资料相关联。
| 标准索引名称 | Zendesk-user 源字段 |
| --- | --- |
| \$1zendeskUserId | Id |
| \$1zendeskExternalId | external\$1id |
例如，您可以在 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API 中使用`_zendeskUserId`和`_zendeskExternalId`作为密钥名称来查找 Amazon Connect 客户档案。通过使用和设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API，您可以找到与特定客户资料关联的 Zendesk-Users 对象。`ProfileId` `ObjectTypeName` `Zendesk-users`
# 将 Marketo 对象映射到 Amazon Connect Customer Profiles 中的标准配置文件
本主题列出了 Marketo 对象中的哪些字段映射到 Customer Profiles 中标准资料对象中的字段。
## Marketo-leads 对象
以下是 Marketo-leads 对象中所有字段的列表
+ id
+ firstName
+ lastName
+ middleName
+ 电子邮件
+ phone
+ mobilePhone
+ billingStreet
+ billingCity
+ billingState
+ billingCountry
+ billingPostalCode
+ 地址
+ city
+ 状态
+ country
+ postalcode
+ gender
+ dateOfBirth
## 将 Marketo-leads 映射到标准资料
Marketo-leads 对象中的一部分字段映射到标准资料。
| Marketo-leads 源字段 | 标准资料目标字段 |
| --- | --- |
| id | 属性。 MarketoLeadId |
| sfdcAccountId | 属性。 sfdcAccountId |
| sfdcContactId | 属性。 sfdcContactId |
| firstName | FirstName |
| lastName | LastName |
| middleName | MiddleName |
| 电子邮件 | EmailAddress |
| phone | PhoneNumber |
| mobilePhone | MobilePhoneNumber |
| mobilePhone | MobilePhoneNumber |
| billingStreet | BillingAddress.Address1 |
| billingCity | BillingAddress.City |
| billingState | BillingAddress.State |
| billingCountry | BillingAddress. 国家 |
| billingPostalCode | BillingAddress.PostalCode |
| 地址 | Address.Address1 |
| city | Address.City |
| 状态 | Address.State |
| country | Address.Country |
| postalcode | 地址。 PostalCode |
| gender | Gender |
| dataOfBirth | BirthDate |
来自 Marketo 的 Marketo-leads 客户数据使用下表中的索引与 Amazon Connect 客户资料相关联。
| 标准索引名称 | Marketo-leads 源字段 |
| --- | --- |
| \$1marketoLeadId | id |
| \$1salesforceAccountId | sfdcAccountId |
| \$1salesforceContactId | sfdcContactId |
例如，您可以在 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API 中使用`_marketoLeadId``_salesforceAccountId`、和`_salesforceContactId`作为密钥名称来查找 Amazon Connect 客户资料。通过使用和`ObjectTypeName`设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API，您可以找到与特定客户资料关联的 Marketo-Lead `ProfileId` s 对象。`Marketo-leads`
# 将 ServiceNow 对象映射到 Amazon Connect 客户档案中的标准个人资料对象
本主题列出了 ServiceNow 对象中的哪些字段映射到 Amazon Connect 客户资料中标准配置文件对象中的字段。
## Servicenow-sys\$1user 对象
以下是 Servicenow-sys\$1user 对象中所有字段的列表
+ sys\$1id
+ active
+ building
+ calendar\$1integration
+ city
+ company
+ cost\$1center
+ country
+ date\$1format
+ default\$1perspective
+ department
+ edu\$1status
+ 电子邮件
+ employee\$1number
+ enable\$1multifactor\$1authn
+ failed\$1attempts
+ first\$1name
+ gender
+ home\$1phone
+ internal\$1integration\$1user
+ introduction
+ last\$1login
+ last\$1login\$1device
+ last\$1login\$1time
+ last\$1name
+ last\$1password
+ ldap\$1server
+ 地点
+ locked\$1out
+ manager
+ middle\$1name
+ mobile\$1phone
+ name
+ notification
+ password\$1needs\$1reset
+ phone
+ photo
+ preferred\$1language
+ 角色
+ schedule
+ source
+ 状态
+ 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
+ title
+ user\$1name
+ user\$1password
+ web\$1service\$1access\$1only
+ zip
## 将 Servicenow-sys\$1users 映射到标准资料对象
Servicenow-sys\$1users 对象中的字段子集映射到 Customer Profiles 中的标准资料对象。
下表列出了哪些字段可以从 Servicenow-sys\$1users 对象映射到标准资料。
| Servicenow-sys\$1users 源字段 | 客户资料目标字段 |
| --- | --- |
| sys\$1id | 属性。 ServiceNowSystemId |
| first\$1name | FirstName |
| last\$1name | LastName |
| middle\$1name | MiddleName |
| gender | Gender |
| 电子邮件 | EmailAddress |
| phone | PhoneNumber |
| home\$1phone | HomePhoneNumber |
| mobile\$1phone | MobilePhoneNumber |
| street | Address.Address1 |
| city | Address.City |
| 状态 | Address.State |
| country | Address.Country |
| zip | 地址。 PostalCode |
Servicenow 对象中的 Servicenow-sys\$1user 客户数据使用下表中的索引与 Amazon Connect 客户资料相关联。
| 标准索引名称 | Servicenow-sys\$1user 源字段 |
| --- | --- |
| \$1 serviceNowSystem 身份证 | sys\$1id |
例如，您可以在 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API 中使用`_serviceNowSystemId`和`_serviceNowIncidentId`作为密钥名称来查找 Amazon Connect 客户档案。你可以使用和设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 来查找与特定配置文件关联的 ServiceNow-sys\$1user 对象。`ProfileId` `ObjectTypeName` `Servicenow-sys_user`
# 将 Segment 对象映射到 Amazon Connect Customer Profiles 中的标准配置文件对象
本主题列出了 Segment 对象中的哪些字段映射到 Amazon Connect Customer Profiles 中标准资料对象中的字段。
## Segment-Identify 对象
以下是 Segment-Identify 对象中所有字段的列表。
+ userId
+ 常见字段 – 请参阅 Segment 文档中的[规范：常见字段](https://segment.com/docs/connections/spec/common/)
+ Segment 预留特性 – 请参阅 Segment 文档中的[特性](https://segment.com/docs/connections/spec/identify/#traits)
+ traits.address.street
+ traits.address.city
+ traits.address.state
+ traits.address.postalCode
+ traits.address.country
+ traits.age
+ traits.avatar
+ traits.birthday
+ traits.company.name
+ traits.company.id
+ traits.company.industry
+ traits.company.employee\$1count
+ traits.company.plan
+ traits.createdAt
+ traits.description
+ traits.email
+ traits.firstName
+ traits.gender
+ traits.id
+ traits.lastName
+ traits.name
+ traits.phone
+ traits.title
+ traits.username
+ traits.website
## 将 Segment-Identify 映射到标准资料对象
Segment-Identify 对象中的字段子集映射到 Customer Profiles 中的标准资料对象。
下表列出了哪些字段可以从 Segment-Identify 对象映射到标准资料。
| Segment-Identify 源字段 | 标准资料目标字段 |
| --- | --- |
| | 标准资料目标字段 |
| userId | 属性。 SegmentUserId |
| traits.company.name | BusinessName |
| traits.firstName | FirstName |
| traits.lastName | LastName |
| traits.birthday | BirthDate |
| traits.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 | 地址。 PostalCode |
### 示例
以下示例介绍了如何将源字段映射到目标字段。
```
"segmentUserId": {
"Source": "_source.detail.event.detail.userId",
"Target": "_profile.Attributes.SegmentUserId"
}
```
来自 Segment 对象中的 Segment-Identify 客户数据使用以下索引与 Amazon Connect 客户资料相关联。
| 标准索引名称 | Segment-Identify 源字段 |
| --- | --- |
| \$1segmentUserId | userId |
例如，您可以在 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API 中使用`_segmentUserId`作为密钥名称来查找 Amazon Connect 客户档案。通过使用和`ObjectTypeName`设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API，您可以找到与特定配置文件关联的区段识别对象。`ProfileId` `Segment-Identify`
# 将 Shopify 对象映射到 Amazon Connect Customer Profiles 中的标准配置文件对象
本主题列出了 Shopify 对象中的哪些字段映射到 Amazon Connect Customer Profiles 中标准资料对象中的字段。
## Shopify-Customer 对象
以下是 Shopify-Customer 对象中所有字段的列表。
+ accepts\$1marketing
+ accepts\$1marketing\$1updated\$1at
+ addresses
+ currency
+ created\$1at
+ default\$1address.address1
+ default\$1address.address2
+ default\$1address.city
+ default\$1address.company
+ default\$1address.country
+ default\$1address.country\$1code
+ default\$1address.country\$1name
+ default\$1address.customer\$1id
+ default\$1address.default
+ default\$1address.first\$1name
+ default\$1address.id
+ default\$1address.last\$1name
+ default\$1address.name
+ default\$1address.phone
+ default\$1address.province
+ default\$1address.province\$1code
+ default\$1address.zip
+ 电子邮件
+ first\$1name
+ id
+ last\$1name
+ last\$1order\$1id
+ last\$1order\$1name
+ metafield.key
+ metafield.value
+ metafield.namespace
+ metafield.value\$1type
+ marketing\$1opt\$1in\$1level
+ multipass\$1identifier
+ note
+ orders\$1count
+ phone
+ sms\$1marketing\$1consent.state
+ sms\$1marketing\$1consent.opt\$1in\$1level
+ sms\$1marketing\$1consent.consent\$1updated\$1at
+ sms\$1marketing\$1consent.consent\$1collected\$1from
+ 状态
+ 标签
+ tax\$1exempt
+ tax\$1exemptions
+ total\$1spent
+ updated\$1at
+ verified\$1email
## 将 Shopify-Customer 对象映射到标准资料
Shopify-Customer 对象中的字段子集映射到 Customer Profiles 中的标准资料对象。
下表列出了哪些字段可以从 Shopify-Customer 对象映射到标准资料。
| Shopify-Customer 源字段 | 标准资料目标字段 |
| --- | --- |
| id | 属性。 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 | 地址。 PostalCode |
### 示例
以下示例介绍了如何将源字段映射到目标字段。
```
"shopifyCustomerId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_profile.Attributes.ShopifyCustomerId"
}
```
来自 Shopify 对象中的 Shopify-Customer 客户数据使用以下索引与 Amazon Connect 客户资料相关联。
| 标准索引名称 | Shopify-Customer 源字段 |
| --- | --- |
| \$1shopifyCustomerId | id |
例如，您可以在 [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API 中使用`_shopifyCustomerId`作为密钥名称来查找 Amazon Connect 客户档案。你可以使用和设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 来查找与特定个人资料关联的 Shopify-Customer `ProfileId` 对象。`ObjectTypeName` `Shopify-Customer`
# 为 Amazon Connect Customer Profiles 中标准订单的对象类型映射
此部分中的主题提供了标准订单定义，以及从外部应用程序到标准订单的对象类型映射。
**Topics**
+ [亚马逊 AppIntegrations 访问要求](standard-order-appintegrations-requirements.md)
+ [亚马逊 EventBridge 访问要求](standard-order-eventbridge-requirements.md)
+ [标准订单定义](standard-order-definition.md)
+ [映射 Shopify 对象](mapping-shopify-objects-standard-order.html.md)
# 亚马逊 AppIntegrations 访问要求
使用以下亚马逊 AppIntegrations 访问要求创建和删除 Shopify 与 Amazon Connect 客户资料的集成：
+ 应用程序集成：GetEventIntegration
+ 应用程序集成：ListEventIntegrationAssociations
+ 应用程序集成：CreateEventIntegrationAssociation
+ 应用程序集成：DeleteEventIntegrationAssociation
# 亚马逊 EventBridge 访问要求
使用以下亚马逊 EventBridge 访问要求创建和删除 Shopify 与 Amazon Connect 客户资料的集成：
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Customer Profiles 标准订单对象字段
下表列出了 Customer Profiles 标准订单对象中的所有字段。
| 标准订单字段 | 数据类型 | 描述 |
| --- | --- | --- |
| OrderId | 字符串 | 标准订单的唯一标识符。 |
| CustomerEmail | 字符串 | 客户的电子邮件地址。 |
| CustomerPhone | 字符串 | 客户的电话号码。 |
| CreatedDate | 字符串 | 订单的创建日期。 |
| UpdatedDate | 字符串 | 订单的更新日期。 |
| ProcessedDate | 字符串 | 订单的处理日期。 |
| ClosedDate | 字符串 | 订单的关闭日期。 |
| CancelledDate | 字符串 | 订单的取消日期。 |
| CancelReason | 字符串 | 订单的取消原因。 |
| Name | 字符串 | 订单的名称。 |
| AdditionalInformation | 字符串 | 与订单相关的任何其它信息。 |
| 网关 | 字符串 | 订单的支付网关。 |
| Status | 字符串 | 订单的状态。 |
| StatusCode | 字符串 | 订单的状态代码。有效值：DRAFT \$1 ACTIVATED |
| StatusUrl | 字符串 | 订单的状态 URL。 |
| CreditCardNumber | 字符串 | 客户的信用卡最后四位数字。 |
| CreditCardCompany | 字符串 | 客户的信用卡公司。 |
| FulfillmentStatus | 字符串 | 订单的履约状态。 |
| TotalPrice | 字符串 | 订单的总价格。 |
| TotalTax | 字符串 | 订单的税金总额。 |
| TotalDiscounts | 字符串 | 订单的总折扣。 |
| TotalItemsPrice | 字符串 | 订单的总商品价格。 |
| TotalShippingPrice | 字符串 | 订单的总运费。 |
| TotalTipReceived | 字符串 | 订单收到的小费总额。 |
| 货币 | 字符串 | 订单的货币。 |
| TotalWeight | 字符串 | 订单的总重量。 |
| BillingAddress | OrderAddress | 客户的账单地址。 |
| ShippingAddress | OrderAddress | 客户的配送地址。 |
| OrderItems | OrderItem 清单 | 订单的商品。 |
| 属性 | String-to-string 地图 | 标准订单的属性的键值对。 |
标准订单对象按下表中的密钥建立索引。
| 标准索引名称 | 标准订单字段 |
| --- | --- |
| \$1orderId | OrderId |
例如，您可以在 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 中使用`_orderId`作为密钥名称来查找顺序与搜索值 OrderId 匹配的个人资料。您可以使用 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) 将`ProfileId`和`ObjectTypeName`设置为来查找与特定配置文件关联的标准订单对象`_order`。
## OrderAddress 数据类型
| 标准订单字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 名称 | 字符串 | 与订单地址关联的名称。 |
| Address1 | 字符串 | 订单地址的第一行。 |
| Address2 | 字符串 | 订单地址的第二行。 |
| Address3 | 字符串 | 订单地址的第三行。 |
| Address4 | 字符串 | 订单地址的第四行。 |
| City | 字符串 | 订单地址所在的城市。 |
| County | 字符串 | 订单地址所在的县。 |
| 州 | 字符串 | 订单地址所在的州。 |
| Province | 字符串 | 订单地址所在的省。 |
| Country | 字符串 | 订单地址所在的国家/地区。 |
| PostalCode | 字符串 | 订单地址的邮政编码。 |
## OrderItem 数据类型
| 标准订单字段 | 数据类型 | 说明 |
| --- | --- | --- |
| 标题 | 字符串 | 订单商品的标题。 |
| Price | 字符串 | 订单商品的价格。 |
| Quantity | 字符串 | 订单商品的数量。 |
# 将 Shopify 对象映射到 Amazon Connect Customer Profiles 中的标准订单
本主题列出了 Shopify 对象中的哪些字段映射到 Customer Profiles 中标准订单对象中的字段。
## Shopify DraftOrder -
有关 Shopify DraftOrder 对象中所有字段的列表，请参阅 Shopify 文档中的[ DraftOrder 对象](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object)。
## 将 Shopify DraftOrder 对象映射到标准订单
Shopify DraftOrder 对象中字段的子集映射到客户资料中的标准订单对象。
下表列出了哪些字段可以从 Shopify DraftOrder 对象映射到标准订单。
如果源中存在 `order_status_url`，则 `StatusCode` 为 `ACTIVATED`。否则 `StatusCode` 为 `DRAFT`。
| Shopify-DraftOrder 来源字 | 标准订单目标字段 |
| --- | --- |
| id | 属性。 ShopifyOrderId |
| customer.id | 属性。 ShopifyCustomerId |
| note | AdditionalInformation |
| 电子邮件 | CustomerEmail |
| currency | 货币 |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
| name | Name |
| status | Status |
| order\$1status\$1url | StatusCode |
| billing\$1address.address1 | BillingAddress.Address1 |
| billing\$1address.address2 | BillingAddress.Address2 |
| billing\$1address.city | BillingAddress.City |
| billing\$1address.zip | BillingAddress.PostalCode |
| billing\$1address.province | BillingAddress.省 |
| billing\$1address.country | BillingAddress. 国家 |
| 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.省 |
| shipping\$1address.country | ShippingAddress. 国家 |
| shipping\$1address.name | ShippingAddress.Name |
| invoice\$1url | StatusUrl |
| total\$1price | TotalPrice |
| total\$1tax | TotalTax |
| line\$1items[].title | OrderItems[]. 标题 |
| line\$1items[].price | OrderItems[] .Price |
| line\$1items[].quantity | OrderItems[]. 数量 |
### 示例
以下示例介绍了如何将源字段映射到目标字段。
```
"shopifyOrderId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_order.Attributes.ShopifyOrderId"
}
```
来自 Shopify 对象的 Shopify DraftOrder 客户数据使用以下索引与 Amazon Connect 标准订单相关联。
| 标准索引名称 | Shopify-DraftOrder 来源字 |
| --- | --- |
| \$1shopifyOrderId | id |
例如，您可以在 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 中`ObjectFilter.KeyName`使用 `_shopifyOrderId` as 来查找标准订单。您可以通过使用`ProfileId`和`ObjectTypeName`设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 来查找与特定个人资料关联的 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 对象中的字段子集映射到 Customer Profiles 中的标准订单对象。
下表列出了哪些字段可以从 Shopify-Order 对象映射到标准订单。
如果源中存在 `order_status_url`，则 `StatusCode` 为 `ACTIVATED`。否则 `StatusCode` 为 `DRAFT`。
| Shopify-Order 源字段 | 标准订单目标字段 |
| --- | --- |
| id | 属性。 ShopifyOrderId |
| customer.id | 属性。 ShopifyCustomerId |
| cancelled\$1at | CancelledDate |
| cancel\$1reason | CancelReason |
| closed\$1at | ClosedDate |
| created\$1at | CreatedDate |
| currency | 货币 |
| 电子邮件 | CustomerEmail |
| financial\$1status | Status |
| order\$1status\$1url | StatusCode |
| fulfillment\$1status | FulfillmentStatus |
| 网关 | 网关 |
| name | 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.省 |
| billing\$1address.country | BillingAddress. 国家 |
| 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.省 |
| shipping\$1address.country | ShippingAddress. 国家 |
| shipping\$1address.name | ShippingAddress.Name |
| line\$1items[].title | OrderItems[]. 标题 |
| line\$1items[].price | OrderItems[] .Price |
| line\$1items[].quantity | OrderItems[]. 数量 |
### 示例
以下示例介绍了如何将源字段映射到目标字段。
```
"shopifyOrderId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_order.Attributes.ShopifyOrderId"
}
```
来自 Shopify 对象中的 Shopify-Order 客户数据使用以下索引与 Amazon Connect 标准订单相关联。
| 标准索引名称 | Shopify-Order 源字段 |
| --- | --- |
| \$1shopifyOrderId | id |
例如，您可以在 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 中`ObjectFilter.KeyName`使用 `_shopifyOrderId` as 来查找标准订单。你可以使用将和设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 来查找与特定配置文件关联的 Shopify-Order `ProfileId` 对象。`ObjectTypeName` `Shopify-Order`
# 标准通信记录的对象类型映射
本节中的主题提供了标准通信记录定义，以及从活动事件到标准通信记录的对象类型映射。
**Topics**
+ [Customer Profiles 标准通信记录对象字段](customer-profiles-standard-communication-record-object-fields.md)
+ [将活动对象映射到 Amazon Connect Customer Profiles 中的标准通信记录](mapping-campaign-objects-to-the-standard-communication-record-in-amazon-connect-customer-profiles.md)
# Customer Profiles 标准通信记录对象字段
下表列出了 Customer Profiles 标准通信记录对象中的所有字段。
| 标准 communicationRecord 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| CommunicationRecordId | 字符串 | 标准通信记录的唯一标识符。 |
| 频道 | 字符串 | 用于联系您的联络中心的方法。例如：语音、聊天、电子邮件 |
| ConnectInstanceArn | 字符串 | Conn AWS ect 实例的 ARN。 |
| CreatedDate | 字符串 | 表示通信记录的创建时间的时间戳。 |
| UpdatedDate | 字符串 | 表示上次更新通信记录的时间戳。 |
| LastEventType | 字符串 | 为此通信摄取的上一个事件的事件类型。 |
| 活动 | 活动 | 与此通信关联的活动的详情。 |
| 端点 | 端点 | 有关用于此通信的端点的信息。 |
| Events | Map | 事件地图，其中键是事件类型，例如电子邮件已发送、打开或点击。这将跟踪在此通信期间发生的每种唯一事件类型的最后一个事件。 |
| 属性 | Map | 标准通信记录的属性的键值对。 |
标准通信记录对象按下表中的键编制索引。
| 标准索引名称 | 标准通信记录字段 |
| --- | --- |
| \$1communicationRecordId | CommunicationRecordId |
例如，您可以在 [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html)API 中使用`_communicationRecordId`作为密钥名称来查找具有与搜索值`CommunicationRecordId`匹配的通信记录的个人资料。通过使用`ProfileId`和`ObjectTypeName`设置为的 [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API，您可以找到与特定配置文件关联的标准`communicationRecord`对象`_communicationRecord`。
## 活动数据类型
| 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| CampaignId | 字符串 | 出站活动的唯一 ID。 |
| CampaignName | 字符串 | 出站活动的名称。 |
| CampaignRunId | 字符串 | 活动的特定运行的唯一 ID。 |
| CampaignActivityId | 字符串 | 活动内活动的唯一 ID。 |
| SegmentArn | 字符串 | 用户的客户细分的 ARN。 |
## 端点数据类型
| 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| EndpointAddress | 字符串 | 端点的地址（例如，电子邮件地址、电话号码）。 |
| EndpointType | 字符串 | 端点的类型，例如默认电子邮件或企业电子邮件。 |
## 事件数据类型
| 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| UpdatedDate | 字符串 | 表示发生通信事件时的时间戳。 |
| EventId | 字符串 | 每个通信事件的唯一标识符。 |
| EventType | 字符串 | 特定的通信事件类型。 |
| 属性 | Map | 事件类型特定的属性的键值对。 |
# 将活动对象映射到 Amazon Connect Customer Profiles 中的标准通信记录
本主题列出了活动对象中的哪些字段映射到 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 | 属性。 LastCampaignEventId |
| outbound\$1request\$1id | 属性。 OutboundCampaignRequestId |
| campaign\$1message\$1id | 属性。 CampaignMessageId |
| channel.name | 频道 |
| channel.subtype | 属性。 ChannelSubType |
| endpoint\$1address | 终端节点。 EndpointAddress |
| endpoint\$1type | 终端节点。 EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign\$1name | 竞选。 CampaignName |
| campaign\$1id | 竞选。 CampaignId |
| campaign\$1run\$1id | 竞选。 CampaignRunId |
| campaign\$1activity\$1id | 竞选。 CampaignActivityId |
| segment\$1arn | 竞选。 SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 UpdatedDate |
| campaign\$1event\$1id | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 EventId |
| campaign\$1event\$1type | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 EventType |
| email.bounce.bounceType | 事件。反弹。属性。 BounceType |
| email.bounce。 bounceSubType | 事件。反弹。属性。 BounceSubType |
| email.click.link | Events.Click.Attributes.Link |
| email.click.ipAddress | 事件。点击。属性。 IpAddress |
| email.open.ipAddress | 事件 > 打开 > 属性。 IpAddress |
| email.reject.reason | Events.Reject.Attributes.Reason |
| email.renderingFailure.templateName | 活动。 RenderingFailure。属性。 TemplateName |
| email.renderingFailure.errorMessage | 活动。 RenderingFailure。属性。 ErrorMessage |
| email.deliveryDelay.delayType | 活动。 DeliveryDelay。属性。 DelayType |
| email.complent。 complaintFeedbackType | 事件。投诉。属性。 ComplaintFeedbackType |
| email.complent。 complaintSubType | 事件。投诉。属性。 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 | 属性。 LastCampaignEventId |
| outbound\$1request\$1id | 属性。 OutboundCampaignRequestId |
| campaign\$1message\$1id | 属性。 CampaignMessageId |
| channel.name | 频道 |
| channel.subtype | 属性。 ChannelSubType |
| endpoint\$1address | 终端节点。 EndpointAddress |
| endpoint\$1type | 终端节点。 EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign\$1name | 竞选。 CampaignName |
| campaign.campaign\$1id | 竞选。 CampaignId |
| campaign.campaign\$1run\$1id | 竞选。 CampaignRunId |
| campaign\$1activity\$1id | 竞选。 CampaignActivityId |
| segment\$1arn | 竞选。 SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 UpdatedDate |
| campaign\$1event\$1id | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 EventId |
| campaign\$1event\$1type | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 EventType |
| sms.messageType | 活动。 \$1\$1campaign\$1event\$1type\$1\$1 .属性。 MessageType |
| sms.messageStatus | 活动。 \$1\$1campaign\$1event\$1type\$1\$1 .属性。 MessageStatus |
| 短信。 messageStatusDescription | 活动。 \$1\$1campaign\$1event\$1type\$1\$1 .属性。 MessageStatusDescription |
| 短信。 totalMessagePrice | 活动。 \$1\$1campaign\$1event\$1type\$1\$1 .属性。 TotalMessagePrice |
| 短信。 totalCarrierFee | 活动。 \$1\$1campaign\$1event\$1type\$1\$1 .属性。 TotalCarrierFee |
| 短信。 isoCountryCode | 活动。 \$1\$1campaign\$1event\$1type\$1\$1 .属性。 IsoCountryCode |
## Campaign-Telephony 对象
有关 Campaign-Telephony 对象中所有字段的列表，请参阅 AWS 最终用户消息 SM [S 文档中的 Voice 对象](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 | 属性。 LastCampaignEventId |
| outbound\$1request\$1id | 属性。 OutboundCampaignRequestId |
| campaign\$1message\$1id | 属性。 CampaignMessageId |
| channel.name | 频道 |
| channel.subtype | 属性。 ChannelSubType |
| endpoint.endpoint\$1address | 终端节点。 EndpointAddress |
| endpoint.endpoint\$1type | 终端节点。 EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign.campaign\$1name | 竞选。 CampaignName |
| campaign.campaign\$1id | 竞选。 CampaignId |
| campaign.campaign\$1run\$1id | 竞选。 CampaignRunId |
| campaign.campaign\$1activity\$1id | 竞选。 CampaignActivityId |
| campaign.segment\$1arn | 竞选。 SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 UpdatedDate |
| campaign\$1event\$1id | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 EventId |
| campaign\$1event\$1type | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 EventType |
| Voice.agentInfo。 connectedToAgent时间戳 | 活动。 \$1\$1campaign\$1event\$1type\$1\$1 .属性。 ConnectedToAgentTimestamp |
| 声音。 customerVoiceActivity。 greetingEndTimestamp | 活动。 \$1\$1campaign\$1event\$1type\$1\$1 .属性。 GreetingEndTimestamp |
| 声音。 answeringMachineDetection状态 | 活动。 \$1\$1campaign\$1event\$1type\$1\$1 .属性。 AnsweringMachineDetectionStatus |
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp |
## Campaign-Orchestration 对象
**将 Campaign-Orchestration 对象映射到标准通信记录**
Campaign-Orchestration 对象中的字段子集映射到 Customer Profiles 中的标准通信记录对象。
下表列出了哪些字段可以从 Campaign-Orchestration 对象映射到标准通信记录。
| Campaign-Orchestration 源字段 | 标准通信记录目标字段 |
| --- | --- |
| campaign\$1event\$1id | 属性。 LastCampaignEventId |
| channel.name | 频道 |
| channel.subtype | 属性。 ChannelSubType |
| instance\$1arn | ConnectInstanceArn |
| campaign.campaign\$1name | 竞选。 CampaignName |
| campaign.campaign\$1id | 竞选。 CampaignId |
| campaign.campaign\$1run\$1id | 竞选。 CampaignRunId |
| campaign.campaign\$1activity\$1id | 竞选。 CampaignActivityId |
| campaign.segment\$1arn | 竞选。 SegmentArn |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 UpdatedDate |
| campaign\$1event\$1id | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 EventId |
| campaign\$1event\$1type | 活动。 \$1\$1campaign\$1event\$1type\$1\$1。 EventType |
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp |
## 示例
以下示例介绍了如何将源字段映射到目标字段：
```
"channel": {
"source": "_source.engagement.channel.name",
"target": "_communicationRecord.Channel"
}
```
# Customer Profiles 中标准资产的对象类型映射
此部分中的主题提供了标准资产定义，以及从外部应用程序到标准资产的对象类型映射。
**Topics**
+ [亚马逊 AppFlow 访问要求](appflow-access-requirements-asset.md)
+ [标准资产定义](standard-asset-definition.md)
+ [将 Salesforce 对象映射到标准资产](mapping-salesforce-objects-to-asset.md)
# 客户资料中的亚马逊 AppFlow 访问要求
使用以下亚马逊 AppFlow 访问要求创建和删除 Salesforce 与 Amazon Connect 客户资料的集成：
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Amazon Connect Customer Profiles 中的标准资产定义
下表列出了 Customer Profiles 标准资产对象中的所有字段。
| 标准资产字段 | 数据类型 | 描述 |
| --- | --- | --- |
| AssetId | 字符串 | 标准资产的唯一标识符。 |
| AssetName | 字符串 | 资产的名称。 |
| SerialNumber | 字符串 | 资产的序列号。 |
| ModelNumber | 字符串 | 资产的型号。 |
| ModelName | 字符串 | 资产的模型名称。 |
| ProductSKU | 字符串 | 资产的库存单位。 |
| PurchaseDate | 字符串 | 资产的购买日期。 |
| UsageEndDate | 字符串 | 资产的使用结束日期。 |
| Status | 字符串 | 资产的状态。 |
| Price | 字符串 | 资产的价格。 |
| Quantity | 字符串 | 资产的数量。 |
| 说明 | 字符串 | 资产的描述。 |
| AdditionalInformation | 字符串 | 与资产相关的任何其他信息。 |
| DataSource | 字符串 | 资产的数据源。 |
| 属性 | String-to-string 地图 | 标准资产属性的键值对。 |
标准资产对象按下表中的密钥建立索引。
| 标准索引名称 | 标准资产字段 |
| --- | --- |
| \$1assetId | AssetId |
| \$1assetName | AssetName |
| \$1serialNumber | SerialNumber |
例如，您可以在 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 中使用`_assetName`作为密钥名称来查找其资产与搜索值 AssetName 匹配的个人资料。通过使用`ProfileId`和`ObjectTypeName`设置为的 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)，您可以找到与特定配置文件关联的标准资产对象`_asset`。
# 将 Salesforce 对象映射到 Customer Profiles 中的标准资产
本主题列出了 Salesforce 对象中的哪些字段映射到 Customer Profiles 中标准资产对象中的字段。
## Salesforce-Asset 对象
以下是 Salesforce-Asset 对象中所有字段的列表。
+ Id
+ ContactId
+ AccountId
+ ParentId
+ RootAssetId
+ Product2Id
+ ProductCode
+ IsCompetitorProduct
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ IsDeleted
+ Name
+ SerialNumber
+ InstallDate
+ PurchaseDate
+ UsageEndDate
+ LifecycleStartDate
+ LifecycleEndDate
+ Status
+ Price
+ 数量
+ 说明
+ OwnerId
+ AssetProvidedById
+ AssetServiceById
+ IsInternal
+ AssetLevel
+ StockKeepingUnit
+ HasLifecycleManagement
+ CurrentMrr
+ CurrentLifecycleEndDate
+ CurrentQuantity
+ CurrentAmount
+ LastViewedDate
+ LastReferencedDate
## 将 Salesforce-Asset 对象映射到标准资产
Salesforce-Asset 对象中的字段子集映射到 Customer Profiles 中的标准资产对象。
下表列出了哪些字段可以从 Salesforce-Asset 对象映射到标准资产。
| Saleforce-Asset 源字段 | 标准资产目标字段 |
| --- | --- |
| Id | 属性。 sfdcAssetId |
| ContactId | 属性。 sfdcContactId |
| AccountId | 属性。 sfdcAccountId |
| SerialNumber | SerialNumber |
| StockKeepingUnit | ProductSKU |
| UsageEndDate | UsageEndDate |
| Status | Status |
| Price | 价格 |
| Quantity | 数量 |
| 说明 | Description |
Salesforce 对象中的 Salesforce-Asset 客户数据使用下表中的索引与 Amazon Connect 标准资产相关联。
| 标准索引名称 | Salesforce-Asset 源字段 |
| --- | --- |
| \$1salesforceAssetId | Id |
| \$1salesforceContactId | ContactId |
| \$1salesforceAccountId | AccountId |
例如，您可以在 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 中`ObjectFilter.KeyName`使用`_salesforceAssetId`和`_salesforceAccountId`来查找标准资产。通过使用和设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API，您可以找到与特定配置文件关联的 Salesforce-Asset 对象。`ProfileId` `ObjectTypeName` `Salesforce-Asset`
# Customer Profiles 中标准案例的对象类型映射
此部分中的主题提供了标准案例定义，以及从外部应用程序到标准案例的对象类型映射。
**Topics**
+ [亚马逊 AppFlow 访问要求](appflow-access-requirements-case.md)
+ [标准案例定义](standard-case-definition.md)
+ [映射 Zendesk 对象](mapping-zendesk-objects-case.md)
+ [映射 ServiceNow 对象](mapping-servicenow-objects-standard-case.md)
# 客户资料中的亚马逊 AppFlow 访问要求
使用以下亚马逊 AppFlow 访问要求来创建和删除 Zendesk 以及与 Amazon Connect 客户资料的 ServiceNow 集成：
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Customer Profiles 标准案例对象字段
下表列出了 Customer Profiles 标准案例对象中的所有字段。
| 标准案例字段 | 数据类型 | 描述 |
| --- | --- | --- |
| CaseId | 字符串 | 标准案例的唯一标识符。 |
| 标题 | 字符串 | 案例的标题 |
| Summary | 字符串 | 案例的摘要。 |
| Status | 字符串 | 案件的状态。 |
| Reason | 字符串 | 案例的原因。 |
| CreatedBy | 字符串 | 案例的创建者。 |
| CreatedDate | 字符串 | 案例的创建日期。 |
| UpdatedDate | 字符串 | 案件的更新日期。 |
| ClosedDate | 字符串 | 案例的关闭日期。 |
| AdditionalInformation | 字符串 | 与案例相关的任何其他信息。 |
| DataSource | 字符串 | 案例的数据源。 |
| 属性 | String-to-string 地图 | 标准案例属性的键值对。 |
标准案例对象按下表中的密钥建立索引。
| 标准索引名称 | 标准案例字段 |
| --- | --- |
| \$1caseId | CaseId |
例如，您可以在 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 中使用`_caseId`作为密钥名称来查找大小写与搜索值 CaseId 匹配的个人资料。通过使用`ProfileId`和`ObjectTypeName`设置为的 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)，您可以找到与特定配置文件关联的标准案例对象`_case`。
# 将 Zendesk 对象映射到 Amazon Connect Customer Profiles 中的标准案例
本主题列出了 Zendesk 对象中的哪些字段映射到 Customer Profiles 中标准案例中的字段。
## Zendesk-tickets 对象
以下是 Zendesk-tickets 对象中所有字段的列表。
+ id
+ url
+ type
+ subject
+ raw\$1subject
+ 描述
+ 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 对象中的字段子集映射到 Customer Profiles 中的标准案例。下表列出了哪些字段可以从 Zendesk-tickets 对象映射到标准案例。
| Zendesk-tickets 源字段 | 标准案例目标字段 |
| --- | --- |
| requester\$1id | 属性。 ZendeskUserId |
| id | 属性。 ZendeskTicketId |
| subject | 标题 |
| 描述 | Summary |
| status | Status |
| requester\$1id | CreatedBy |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
来自 Zendesk 对象的 Zendesk-tickets 客户数据使用以下索引与 Amazon Connect 标准案例相关联。
| 标准索引名称 | Zendesk-tickets 源字段 |
| --- | --- |
| \$1zendeskUserId | requester\$1id |
| \$1zendeskTicketId | id |
例如，您可以在 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 中`ObjectFilter.KeyName`使用`_zendeskUserId`和`_zendeskTicketId`来查找标准案例。你可以使用和设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 来查找与特定配置文件关联的 Zendesk-Tickets 对象。`ProfileId` `ObjectTypeName` `Zendesk-tickets`
# 将 ServiceNow 对象映射到 Amazon Connect 客户档案中的标准案例
本主题列出了 ServiceNow 对象中的哪些字段映射到 Amazon Connect 客户资料中标准案例中的字段。
## 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
+ 描述
+ 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
+ 状态
+ 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 对象中的字段子集映射到 Customer Profiles 中的标准案例。
下表列出了哪些字段可以从 Servicenow-task 对象映射到标准案例。
| Servicenow-task 源字段 | 标准案例目标字段 |
| --- | --- |
| sys\$1id | 属性。 ServiceNowTaskId |
| opened\$1by.link | 属性。 ServiceNowSystemUserId |
| short\$1description | 标题 |
| 描述 | Summary |
| status | Status |
| sys\$1created\$1by | CreatedBy |
| sys\$1created\$1on | CreatedDate |
| sys\$1updated\$1on | UpdatedDate |
Servicenow 对象中的 Servicenow-task 客户数据使用下表中的索引与 Amazon Connect 标准案例相关联。
| 标准索引名称 | Servicenow-task 源字段 |
| --- | --- |
| \$1 serviceNowTask 身份证 | sys\$1id |
| \$1 serviceNowSystem 身份证 | open\$1by.link |
例如，您可以在 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 中`ObjectFilter.KeyName`使用`_serviceNowTaskId`和`_serviceNowSystemId`来查找标准案例。你可以使用和设置为的 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API 来查找与特定配置文件关联的 ServiceNow-Task 对象。`ProfileId` `ObjectTypeName` `Servicenow-task`
## Servicenow-incident 对象
以下是 Servicenow-incident 对象中所有字段的列表。
+ sys\$1id
+ business\$1stc
+ calendar\$1stc
+ caller\$1id.link
+ caller\$1id.value
+ category
+ caused\$1by
+ child\$1incidents
+ close\$1code
+ hold\$1reason
+ incident\$1state
+ notify
+ parent\$1incident
+ problem\$1id
+ reopened\$1by
+ reopened\$1time
+ reopen\$1count
+ resolved\$1at
+ resolved\$1by.link
+ resolved\$1by.value
+ rfc
+ severity
+ subcategory
## 将 Servicenow-incident 映射到标准案例
Servicenow-incident 对象中的字段子集映射到 Customer Profiles 中的标准案例。
下表列出了哪些字段可以从 Servicenow-incident 对象映射到标准案例。
| Servicenow-Incident 源字段 | 标准案例目标字段 |
| --- | --- |
| sys\$1id | 属性\$1 ServiceNowIncidentId |
| caller\$1id.link | 属性\$1 ServiceNowSystemUserId |
| incident\$1status | Status |
| caller\$1id.link | CreatedBy |
| resolved\$1at | ClosedDate |
| category | Reason |
Servicenow 对象中的 Servicenow-incident 客户数据使用下表中的索引与 Amazon Connect 标准案例相关联。
| 标准索引名称 | Servicenow 源字段 |
| --- | --- |
| \$1 serviceNowIncident 身份证 | sys\$1id |
| \$1 serviceNowSystem 身份证 | 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 来查找与特定配置文件关联的 ServiceNow-Incident 对象。`ProfileId` `ObjectTypeName` `Servicenow-incident`
# 标准航空偏好的对象类型映射
本节中的主题提供标准航空偏好定义。
**Topics**
+ [Customer Profiles 标准航空偏好对象字段](standard-air-preference-object-fields.md)
# Customer Profiles 标准航空偏好对象字段
下表列出了 Customer Profiles 标准航空偏好对象中的所有字段。
**航空偏好**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| PreferenceId | 字符串 | 标准航空偏好的唯一标识符 |
| Name | 字符串 | 偏好的名称 |
| CreatedDate | 字符串 | 偏好的创建日期 |
| CreatedBy | 字符串 | 创建者的标识符 |
| UpdatedDate | 字符串 | 上次更新日期 |
| UpdatedBy | 字符串 | 上次更新者的标识符 |
| StartDate | 字符串 | 偏好开始日期 |
| EndDate | 字符串 | 偏好结束日期 |
| Status | 字符串 | 偏好的当前状态 |
| ReferenceId | 字符串 | 所引用对象的 ID |
| ReferenceType | 字符串 | 所引用对象的类型 |
| TravelType | 字符串 | 旅行类型（例如直飞航班） |
| Transfer | 字符串 | 首选的转机类型 |
| ArrivalAirport | 字符串 | 首选到达机场 |
| ArrivalTerminal | 字符串 | 首选到达机场航站楼 |
| DepartureAirport | 字符串 | 首选出发机场 |
| DepartureTerminal | 字符串 | 首选出发机场航站楼 |
| HomeAirport | 字符串 | 家乡机场 |
| CheckInChannel | 字符串 | 值机模式 |
| CheckInChannelDevice | 字符串 | 用于值机的设备 |
| 语言 | 语言 | 有关首选通信语言的详情 |
| Seat | Seat | 座位选择详情 |
| Journey | Journey | 旅程偏好 |
| 可访问性 | 可访问性 | 有关无障碍请求的详情 |
| 保险 | 保险 | 有关保险的详情 |
| Interest | 兴趣 | 有关兴趣的详情 |
| Loyalty | 忠诚度 | 有关忠诚度的详情 |
| 餐厅 | 餐厅 | 餐厅偏好 |
| MediaEntertainment | MediaEntertainment | 媒体和娱乐偏好 |
| PaymentForm | PaymentForm | 付款方式偏好 |
| PetInfo | PetInfo | 宠物详情 |
| SpecialRequest | SpecialRequest | 特殊要求详情 |
| TicketDistribution | TicketDistribution | 门票分配偏好 |
| 市场营销 | 市场营销 | 市场营销偏好 |
| 医疗 | 医疗 | 医疗偏好 |
| Baggage | 行李 | 行李偏好 |
| ContactDetail | ContactDetail | 有关首选联系人的详情 |
| ContactDetailAddress | ContactDetailAddress | 联系地址详情 |
| ContactDetailCommunication | ContactDetailCommunication | 通信偏好 |
| 属性 | Map | 航空偏好的属性的键值对 |
标准航空偏好对象按下表中的键编制索引。
**标准索引字段**
| 标准索引名称 | 标准偏好记录字段 |
| --- | --- |
| \$1airPreferenceId | PreferenceId |
| \$1airReferenceId | ReferenceId |
例如，您可以在 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 中使用`_airPreferenceId`作为密钥名称来查找具有空中偏好且与搜索值 PreferenceId 匹配的配置文件。通过使用和`ObjectTypeName`设置为的 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)，您可以找到与特定配置文件关联的标准 AirPreferen `ProfileId` ce 对象。`_airPreference`
**ContactDetail 数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 类型 | 字符串 | 联系类型（例如个人、紧急情况） |
| PreferenceLevel | 字符串 | 此联系的优先级 |
| PhoneNumber | 字符串 | Phone number（电话号码） |
| 关系 | 字符串 | 与配置文件的关系 |
| EmailAddress | 字符串 | 电子邮件地址 |
| EmailLanguage | 字符串 | 联系详细信息电子邮件通信的首选语言 |
| PhoneLanguage | 字符串 | 联系详细信息电话通信的首选语言 |
**ContactDetailAddress 数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 类型 | 字符串 | 联系人的地址类型 |
| Address1 | 字符串 | 联系人地址的第一行。 |
| Address2 | 字符串 | 联系人地址的第二行。 |
| Address3 | 字符串 | 联系人地址的第三行。 |
| Address4 | 字符串 | 联系人地址的第四行。 |
| City | 字符串 | 联系人地址所在的城市。 |
| Country | 字符串 | 联系人地址所在的国家/地区。 |
| County | 字符串 | 联系人地址所在的县。 |
| PostalCode | 字符串 | 联系人地址的邮政编码。 |
| Province | 字符串 | 联系人地址所在的省。 |
| 州 | 字符串 | 联系人地址所在的州。 |
**ContactDetailCommunication 数据类型**
| 标准 airPreference 字段 | 数据类型 | 说明 |
| --- | --- | --- |
| 方法 | 字符串 | 通信方式（例如，短信、电子邮件） |
| PreferenceLevel | 字符串 | 对通信方法的偏好程度 |
**语言数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| PhoneLanguage | 字符串 | 电话交流的首选语言 |
| EmailLanguage | 字符串 | 电子邮件交流的首选语言 |
| InPersonLanguage | 字符串 | 面对面交流的首选语言 |
| PreferenceLevel | 字符串 | 语言偏好级别 |
**座位数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| PreferenceLevel | 字符串 | 座位偏好的优先级 |
| 方向 | 字符串 | 首选座位方向（例如，前、后） |
| 位置 | 字符串 | 首选座位位置（例如靠窗、过道） |
| 位置 | 字符串 | 座椅位置（例如，左、右） |
| 行 | 字符串 | 所需座位排 |
| ClassOfService | 字符串 | 旅行舱位等级（例如经济舱、商务舱） |
| NeighborFree | 字符串 | 优先选择没有邻居的座位 |
| Infant | 字符串 | 优先选择婴儿座位 |
| ExtraSeat | 字符串 | 优先选择额外座位 |
**旅程数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| MaxConnections | 字符串 | 支持的最大连接数 |
| PreferredAirline | 字符串 | 首选航空公司 |
| UpgradeAuction | 字符串 | 选择加入升级拍卖 |
| FlightTime | 字符串 | 首选飞行时间 |
| FlightMaxDuration | 字符串 | 首选最长旅行时长 |
**无障碍数据类型**
| 标准 airPreference 字段 | 数据类型 | 说明 |
| --- | --- | --- |
| Wheelchair | 字符串 | 轮椅无障碍信息 |
| 浴室 | 字符串 | 浴室无障碍信息 |
| Assistance | 字符串 | 帮助信息 |
| DisabilityType | 字符串 | 有关残疾的信息 |
| SupportAnimal | 字符串 | 支持动物信息 |
| ProximityToFacilities | 字符串 | 需要临近设施 |
**保险数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 名称 | 字符串 | 保险提供商或计划名称 |
| PreferenceLevel | 字符串 | 对保险的偏好程度 |
**兴趣数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 名称 | 字符串 | 特定的感兴趣领域 |
| PreferenceLevel | 字符串 | 兴趣的优先级 |
**忠诚度数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 名称 | 字符串 | 忠诚度计划的名称 |
| MembershipId | 字符串 | 忠诚度计划中的会员 ID |
| PreferenceLevel | 字符串 | 忠诚度计划偏好程度 |
**餐饮数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| MealType | 字符串 | 首选膳食类型 |
| FavoriteCuisine | 字符串 | 最喜欢的美食类型 |
| Beverage | 字符串 | 首选饮料 |
| DietaryRestriction | 字符串 | 饮食限制 |
| AllergyInfo | 字符串 | 有关过敏的详细信息 |
| PreferenceLevel | 字符串 | 餐饮偏好程度 |
**媒体和娱乐数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 名称 | 字符串 | 首选娱乐的名称 |
| PreferenceLevel | 字符串 | 媒体/娱乐的偏好程度 |
**PaymentForm 数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 名称 | 字符串 | 付款方式的名称 |
| Type | 字符串 | 付款类型（例如，信用卡， PayPal） |
| PreferenceLevel | 字符串 | 付款方式偏好程度 |
| UsageContext | 字符串 | 使用付款方式的地方 |
**PetInfo 数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 类型 | 字符串 | 宠物的类型 |
| PreferenceLevel | 字符串 | 有关宠物的偏好程度 |
**SpecialRequest 数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 类型 | 字符串 | 特殊要求的类型 |
| Name | 字符串 | 要求的名称或描述 |
| PreferenceLevel | 字符串 | 要求的优先级 |
**TicketDistribution 数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| PreferenceLevel | 字符串 | 门票分配的偏好程度 |
| 方法 | 字符串 | 门票交付方式（例如，电子邮件、实质门票） |
| TicketTime | 字符串 | 首选的送票时间 |
**营销数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| ChannelType | 字符串 | 营销渠道的类型（例如，短信、电子邮件） |
| OptIn | 字符串 | 营销的选择加入状态 |
| 频率 | 字符串 | 营销通信的频率 |
| StartDate | 字符串 | 营销开始日期偏好 |
| EndDate | 字符串 | 营销结束日期偏好 |
**医疗数据类型**
| 标准 airPreference 字段 | 数据类型 | 说明 |
| --- | --- | --- |
| Oxygen | 字符串 | （航空公司提供、乘客自备、医用制氧机等） |
| MedicalEquipment | 字符串 | 有关医疗设备（例如 CPAP 机、医用制氧机）的详细信息。 |
| Assistance | 字符串 | 指定旅行者在旅行期间是否需要一般性医疗援助（例如飞行中支持、药物帮助）。 |
| Stretcher | 字符串 | 旅客在飞行期间是否需要担架，通常用于医疗运输情形。 |
| WheelChair | 字符串 | 轮椅详情（防溢漏、湿牢房、无法移动、StairsAssistance RampNeeded、提供的航空公司等） |
**行李数据类型**
| 标准 airPreference 字段 | 数据类型 | 说明 |
| --- | --- | --- |
| Animal | 字符串 | 指明旅行者是否携带服务性动物或宠物旅行，并包括相关的规范或限制。（货舱、座舱） |
| BaggageType | 字符串 | 指定首选的行李处理类型（例如，仅限随身行李、托运行李、超大行李）。 |
| Assistance | 字符串 | 指明旅行者在携带或管理行李方面是否需要协助，例如机场搬运工服务或路边行李帮助。 |
| PreferenceLevel | 字符串 | 行李偏好程度字段 |
# 标准酒店偏好的对象类型映射
本节中的主题提供标准酒店偏好定义。
**Topics**
+ [Customer Profiles 标准酒店偏好对象字段](standard-hotel-preference-object-fields.md)
# Customer Profiles 标准酒店偏好对象字段
下表列出了 Customer Profiles 标准酒店偏好对象中的所有字段。
**酒店偏好**
| 标准 hotelPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| PreferenceId | 字符串 | 标准酒店偏好的唯一标识符 |
| Name | 字符串 | 偏好的名称 |
| CreatedDate | 字符串 | 偏好的创建日期 |
| CreatedBy | 字符串 | 创建者的标识符 |
| UpdatedDate | 字符串 | 上次更新日期 |
| UpdatedBy | 字符串 | 上次更新者的标识符 |
| StartDate | 字符串 | 偏好开始日期 |
| EndDate | 字符串 | 偏好结束日期 |
| Status | 字符串 | 偏好的当前状态 |
| 抽烟 | 字符串 | 抽烟偏好 |
| CleaningTime | 字符串 | 清理时间 |
| CheckInType | 字符串 | 办理入住手续的类型 |
| CheckOutType | 字符串 | 办理退房手续的类型 |
| ReferenceId | 字符串 | 所引用对象的 ID |
| ReferenceType | 字符串 | 所引用对象的类型 |
| 位置 | 位置 | 关于酒店房间位置的偏好 |
| Bedding | 床上用品 | 床上用品偏好 |
| Tour | 游览 | 游览偏好 |
| ContactDetail | ContactDetail | 有关首选联系人的详情 |
| ContactDetailAddress | ContactDetailAddress | 联系地址详情 |
| ContactDetailCommunication | ContactDetailCommunication | 通信偏好 |
| 语言 | 语言 | 语言偏好 |
| CarRental | CarRental | 汽车租赁偏好 |
| 可访问性 | 可访问性 | 无障碍偏好 |
| Interest | 兴趣 | 兴趣详情 |
| Loyalty | 忠诚度 | 忠诚度偏好 |
| 餐厅 | 餐厅 | 餐厅偏好 |
| MediaEntertainment | MediaEntertainment | 媒体和娱乐偏好 |
| PaymentForm | PaymentForm | 付款单偏好 |
| PetInfo | PetInfo | 宠物信息偏好 |
| SpecialRequest | SpecialRequest | 有关特殊要求的详情 |
| 市场营销 | 市场营销 | 市场营销偏好 |
| 医疗 | 医疗 | 医疗偏好 |
| Baggage | 行李 | 行李偏好 |
| 属性 | Map | 酒店偏好的属性的键值对 |
标准酒店偏好对象按下表中的键编制索引。
**标准索引字段**
| 标准索引名称 | 标准偏好记录字段 |
| --- | --- |
| \$1hotelPreferenceId | PreferenceId |
| \$1hotelReferenceId | ReferenceId |
例如，您可以在 [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) 中使用`_hotelPreferenceId`作为密钥名称来查找具有酒店偏好且与搜索值 PreferenceId 匹配的个人资料。通过使用和`ObjectTypeName`设置为的 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)，您可以找到与特定配置文件关联的标准 HotelPreferen `ProfileId` ce 对象。`_hotelPreference`
**ContactDetail 数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 类型 | 字符串 | 联系类型（例如个人、紧急情况） |
| PreferenceLevel | 字符串 | 此联系的优先级 |
| PhoneNumber | 字符串 | Phone number（电话号码） |
| 关系 | 字符串 | 与配置文件的关系 |
| EmailAddress | 字符串 | 电子邮件地址 |
| EmailLanguage | 字符串 | 联系详细信息电子邮件通信的首选语言 |
| PhoneLanguage | 字符串 | 联系详细信息电话通信的首选语言 |
**ContactDetailAddress 数据类型**
| 标准 airPreference 字段 | 数据类型 | 描述 |
| --- | --- | --- |
| 类型 | 字符串 | 联系人的地址类型 |
| Address1 | 字符串 | 联系人地址的第一行。 |
| Address2 | 字符串 | 联系人地址的第二行。 |
| Address3 | 字符串 | 联系人地址的第三行。 |
| Address4 | 字符串 | 联系人地址的第四行。 |
| City | 字符串 | 联系人地址所在的城市。 |
| Country | 字符串 | 联系人地址所在的国家/地区。 |
| County | 字符串 | 联系人地址所在的县。 |
| PostalCode | 字符串 | 联系人地址的邮政编码。 |
| Province | 字符串 | 联系人地址所在的省。 |
| 州 | 字符串 | 联系人地址所在的州。 |
**ContactDetailCommunication 数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| 方法 | 字符串 | 通信方法 |
| PreferenceLevel | 字符串 | 通信方法的偏好程度 |
| 频率 | 字符串 | 通信频率 |
**语言数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| PhoneLanguage | 字符串 | 首选电话语言 |
| EmailLanguage | 字符串 | 首选电子邮件语言 |
**CarRental 数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| Vendor | 字符串 | 首选租车供应商 |
| VehicleType | 字符串 | 首选车辆类型 |
| PreferenceLevel | 字符串 | 租车偏好程度 |
**位置数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| PreferredFloor | 字符串 | 对房间楼层的偏好 |
| ElevatorProximity | 字符串 | 靠近电梯的偏好 |
| QuietZone | 字符串 | 安静区偏好 |
| LobbyProximity | 字符串 | 靠近大厅偏好 |
| 视图 | 字符串 | 从房间里看到的理想视野 |
| RoomType | 字符串 | 首选房型 |
| PreferenceLevel | 字符串 | 对位置的偏好程度 |
**床上用品数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| BedType | 字符串 | 首选床型 |
| MattressType | 字符串 | 首选床垫类型 |
| PillowType | 字符串 | 首选枕头类型 |
| NumberOfPillows | 字符串 | 首选枕头数量 |
| BeddingMaterial | 字符串 | 床上用品的材质 |
| Allergy | 字符串 | 过敏相关的床上用品偏好 |
**游览数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| City | 字符串 | 首选游览城市 |
| Cultural | 字符串 | 文化之旅的兴趣 |
| Adventure | 字符串 | 探险之旅的兴趣 |
| Nightlife | 字符串 | 夜生活之旅的兴趣 |
| GuideLanguage | 字符串 | 首选的导游语言 |
| StartTime | 字符串 | 首选游览开始时间 |
| GroupSize | 字符串 | 首选的游览团体规模 |
| PreferenceLevel | 字符串 | 游览偏好的重要性 |
**无障碍数据类型**
| 标准 airPreference 字段 | 数据类型 | 说明 |
| --- | --- | --- |
| Wheelchair | 字符串 | 轮椅无障碍信息 |
| 浴室 | 字符串 | 浴室无障碍信息 |
| Assistance | 字符串 | 帮助信息 |
| DisabilityType | 字符串 | 有关残疾的信息 |
| SupportAnimal | 字符串 | 支持动物信息 |
| ProximityToFacilities | 字符串 | 需要临近设施 |
**兴趣数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| NameOfInterest | 字符串 | 兴趣的名称 |
| PreferenceLevel | 字符串 | 兴趣的偏好程度 |
**忠诚度数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| LoyaltyName | 字符串 | 忠诚度计划的名称 |
| MembershipId | 字符串 | 忠诚度会员 ID |
| PreferenceLevel | 字符串 | 忠诚度偏好程度 |
| PriorityServices | 字符串 | 优先服务偏好 |
**餐饮数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| MealType | 字符串 | 首选膳食类型 |
| FavoriteCuisine | 字符串 | 最喜欢的美食偏好 |
| Beverage | 字符串 | 饮料偏好 |
| DietaryRestriction | 字符串 | 饮食限制 |
| AllergyInfo | 字符串 | 过敏信息 |
| PreferenceLevel | 字符串 | 餐饮偏好程度 |
**MediaEntertainment 数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| 名称 | 字符串 | 首选媒体或娱乐的名称 |
| PreferenceLevel | 字符串 | 媒体或娱乐的偏好程度 |
**PaymentForm 数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| 名称 | 字符串 | 与付款方式关联的名称 |
| Type | 字符串 | 付款方式类型 |
| PreferenceLevel | 字符串 | 付款方式偏好程度 |
| UsageContext | 字符串 | 使用付款单的上下文 |
**PetInfo 数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| 类型 | 字符串 | 宠物的类型 |
| PreferenceLevel | 字符串 | 宠物的偏好程度 |
**特殊要求数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| 类型 | 字符串 | 特殊要求的类型 |
| Name | 字符串 | 特殊要求的名称 |
| PreferenceLevel | 字符串 | 要求的偏好程度 |
**营销数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| ChannelType | 字符串 | 营销渠道的类型（例如，短信、电子邮件） |
| OptIn | 字符串 | 营销的选择加入状态 |
| 频率 | 字符串 | 营销通信的频率 |
| StartDate | 字符串 | 营销开始日期偏好 |
| EndDate | 字符串 | 营销结束日期偏好 |
**医疗数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| Oxygen | 字符串 | 氧气供应偏好 |
| MedicalEquipment | 字符串 | 医疗设备详情 |
| Assistance | 字符串 | 所需医疗援助的类型 |
| Stretcher | 字符串 | 担架宾客要求 |
| WheelChair | 字符串 | 轮椅类型和所需的帮助 |
**行李数据类型**
| 标准 hotelPreference 字段 | Type | 说明 |
| --- | --- | --- |
| Bicycle | 字符串 | 自行车行李需求 |
| BaggageType | 字符串 | 行李详情（例如大件行李） |
| Courier | 字符串 | 快递相关行李偏好 |
| Fragile | 字符串 | 易碎物品偏好 |
| Preference Level | 字符串 | 行李偏好程度 |
# 标准机票预订的对象类型映射
本节中的主题提供标准机票预订定义。
**Topics**
+ [Customer Profiles 标准机票预订对象字段](standard-air-booking-object-fields.md)
# Customer Profiles 标准机票预订对象字段
下表列出了 Customer Profiles 标准机票预订对象中的所有字段。
**AirBooking**
| 标准 airBooking 字段 | Type | 说明 |
| --- | --- | --- |
| BookingId | 字符串 | 标准机票预订的唯一标识符 |
| ContextId | 字符串 | 用于跟踪预订来源的上下文特定的标识符 |
| PreferenceRef | 字符串 | 引用预订的偏好对象的标识符 |
| BookingName | 字符串 | 与预订关联的姓名 |
| PassengerIndex | 字符串 | 预订中乘客的索引 |
| TravellerId | 字符串 | 与预订相关的旅行者的唯一标识符 |
| GroupBooking | 字符串 | 指明预订是否为团体预订 |
| NumberOfPassengers | 字符串 | 预订的乘客总数 |
| NumberOfAdults | 字符串 | 预订的成人总数 |
| NumberOfChildren | 字符串 | 预订的儿童总数 |
| ProcessedDate | 字符串 | 处理预订的日期 |
| CreatedDate | 字符串 | 预订创建日期 |
| CreatedBy | 字符串 | 创建者的身份 |
| UpdatedDate | 字符串 | 上次更新日期 |
| UpdatedBy | 字符串 | 上次更新预订的人员的标识符 |
| Status | 字符串 | 当前预订状态 |
| PriorityStatus | 字符串 | 预订的优先级别 |
| ReservationStatus | 字符串 | 预订的预留状态 |
| MarketingCode | 字符串 | 表示营销来源或活动的代码 |
| MarketingName | 字符串 | 营销活动名称 |
| TravelAgent | 字符串 | 与预订关联的旅行社 |
| TravelAgency | 字符串 | 公司旅行社名称 |
| TravelCorpNumber | 字符串 | 公司客户编号 |
| Booker | 字符串 | 指明此人是否为进行预订的人 |
| AdditionalInformation | 字符串 | 其它自由格式信息 |
| 电子邮件 | 字符串 | 用于获取旅行日动态的联系人电子邮件 |
| PhoneNumber | 字符串 | 用于获取旅行日动态的联系人电话 |
| CancelledDate | 字符串 | 取消预订的日期（如适用） |
| Diplomat | 字符串 | 表示外交身份 |
| Child | 字符串 | 指明乘客是否为儿童 |
| 已禁用 | 字符串 | 表示残疾状况 |
| Oxygen | 字符串 | 表示需要氧气支持 |
| PetOnly | 字符串 | 预订仅适用于运送宠物 |
| CancellationCharge | 字符串 | 取消费用（如果适用）。0 表示不收费 |
| Refundable | 字符串 | 预订退款详情 |
| 清单 | 库存 | 预订的清单详情 |
| Loyalty | 忠诚度 | 预订的忠诚度详情 |
| 频道 | 频道 | 预订的渠道详情 |
| Payment | Payment | 预订的付款详情 |
| BillingAddress | 地址 | 预订的账单地址详情 |
| Price | 价格 | 预订的价格详情 |
| PaymentStatus | PaymentStatus | 预订的付款状态 |
| 属性 | Map | 自定义或扩展属性 |
**标准索引字段**
| 标准索引名称 | 标准偏好记录字段 |
| --- | --- |
| \$1airBookingId | BookingId |
| \$1airPreferenceRef | PreferenceRef |
**忠诚度数据类型**
| 标准 airBooking 字段 | Type | 说明 |
| --- | --- | --- |
| ProgramName | 字符串 | 忠诚度计划的名称 |
| MembershipId | 字符串 | 忠诚度计划会员号 |
| Tier | 字符串 | 忠诚度会员等级 |
**频道数据类型**
| 标准 airBooking 字段 | Type | 说明 |
| --- | --- | --- |
| CreationChannelId | 字符串 | 用于创建预订的渠道的 ID |
| LastUpdatedChannelId | 字符串 | 用于更新预订的渠道的 ID |
| 方法 | 字符串 | 通过渠道使用的方法（例如，网络、应用程序、电话） |
**付款数据类型**
| 标准 airBooking 字段 | Type | 说明 |
| --- | --- | --- |
| 类型 | 字符串 | 付款方式类型（例如卡、代金券） |
| CreditCardToken | 字符串 | 令牌化的卡，便于安全引用 |
| CreditCardType | 字符串 | 所使用的信用卡类型 |
| CreditCardExpiration | 字符串 | 卡的到期日期 |
| Cvv | 字符串 | CVV 号码 |
| NameOnCreditCard | 字符串 | 持卡人姓名 |
| RoutingNumber | 字符串 | 银行汇款路径号码（如果适用） |
| AccountNumber | 字符串 | 银行账号（如果适用） |
| VoucherId | 字符串 | 用于付款的代金券 |
| DiscountCode | 字符串 | 应用的促销折扣代码 |
| DiscountPercent | 字符串 | 应用于付款的折扣百分比 |
**账单地址数据类型**
| 标准 airPreference 字段 | 数据类型 | 说明 |
| --- | --- | --- |
| Address1 | 字符串 | 客户地址的第一行。 |
| Address2 | 字符串 | 客户地址的第二行。 |
| Address3 | 字符串 | 客户地址的第三行。 |
| Address4 | 字符串 | 客户地址的第四行。 |
| City | 字符串 | 客户地址所在的城市。 |
| Country | 字符串 | 客户地址所在的国家/地区。 |
| County | 字符串 | 客户地址所在的县。 |
| PostalCode | 字符串 | 客户地址的邮政编码。 |
| Province | 字符串 | 客户地址所在的省。 |
| 州 | 字符串 | 客户地址所在的州。 |
**价格数据类型**
| 标准 airBooking 字段 | Type | 说明 |
| --- | --- | --- |
| TotalPrice | 字符串 | 预订的总价格 |
| BasePrice | 字符串 | 预订的基本价格 |
| TravellerPrice | 字符串 | 每位旅客支付的价格 |
| DiscountAmount | 字符串 | 应用于基本票价的折扣 |
| 货币 | 字符串 | 付款使用的货币 |
**付款状态数据类型**
| 标准 airBooking 字段 | Type | 说明 |
| --- | --- | --- |
| PaidAt | 字符串 | 完成付款的时间戳 |
| AwaitingPayment | 字符串 | 表示付款处于待处理状态 |
| RequiredBy | 字符串 | 付款截止日期 |
**库存数据类型**
| 标准 airBooking 字段 | Type | 说明 |
| --- | --- | --- |
| Seats | 字符串 | 预订的座位总数 |
# 标准航段的对象类型映射
本节中的主题提供标准航段定义。
**Topics**
+ [Customer Profiles 标准航段对象字段](standard-air-segment-object-fields.md)
# Customer Profiles 标准航段对象字段
下表列出了 Customer Profiles 标准航段对象中的所有字段。
**航段**
| 标准 airSegment 字段 | Type | 说明 |
| --- | --- | --- |
| SegmentId | 字符串 | 标准航段的唯一标识符 |
| BookingRef | 字符串 | 预订引用标识符 |
| SegmentName | 字符串 | 航段的名称/描述 |
| PassengerIndex | 字符串 | 乘客的索引号 |
| SegmentIndex | 字符串 | 航段的索引号 |
| SeatSelection | 字符串 | 座位选择详情 |
| NumberOfPassengers | 字符串 | 乘客总数 |
| NumberOfLegs | 字符串 | 飞行航段数 |
| Tier | 字符串 | 乘客 tier/status 等级 |
| Origin | 字符串 | 出发机场代码 |
| OriginCountryCode | 字符串 | 出发国家/地区代码 |
| Dest | 字符串 | 目的地机场代码 |
| DestCountryCode | 字符串 | 目的地国家/地区代码 |
| ProcessedDate | 字符串 | 处理航段的日期 |
| CreatedDate | 字符串 | 创建记录的日期 |
| CreatedBy | 字符串 | 创建记录的用户 |
| UpdatedDate | 字符串 | 上次更新记录的日期 |
| UpdatedBy | 字符串 | 上次更新记录的用户 |
| Status | 字符串 | 航段的当前状态 |
| FlightNumber | 字符串 | 航班号 |
| Carrier | 字符串 | 承运公司代码 |
| CarrierType | 字符串 | 承运公司类型 |
| IsInternational | 字符串 | 指明航班是否为国际航班 |
| IsEticket | 字符串 | 指明是否为电子票 |
| IsArmed | 字符串 | 表示是否为携带武器的乘客 |
| LapInfant | 字符串 | 怀抱婴儿详情 |
| Pet | 字符串 | 表示是否携带宠物旅行 |
| PrisonerOrGuard | 字符串 | 表示囚犯或警卫身份 |
| Child | 字符串 | 指明乘客是否为儿童 |
| Married | 字符串 | 表示客户细分是否已婚 |
| CheckinEligible | 字符串 | 表示值机资格 |
| InEligibleReason | 字符串 | 不符合值机资格的原因 |
| UnEscortedMinor | 字符串 | 表示无人陪伴的未成年人身份 |
| PremiumAccess | 字符串 | 表示购买了高级权限 |
| MissingData | 字符串 | 表示缺失数据 |
| CurrentClassOfService | 字符串 | 当前服务等级 |
| BookedClassOfService | 字符串 | 最初预订的服务等级 |
| CodeShare | 字符串 | 表示代码共享航班 |
| ReverseCodeShare | 字符串 | 表示反向代码共享 |
| MarketCarrierCode | 字符串 | 营销承运公司代码 |
| OpCarrierCode | 字符串 | 承运公司代码 |
| InConnection | 字符串 | 入站连接详情 |
| OutConnection | 字符串 | 出站连接详情 |
| MilesToEarn | 字符串 | 要赚取的里程 |
| Duration | 字符串 | 飞行时长 |
| DurationTimeUnit | 字符串 | 持续时间的时间单位 |
| 距离 | 字符串 | 飞行距离 |
| DistanceUnit | 字符串 | 距离测量单位 |
| SellType | 字符串 | 指示这是否为强制出售 |
| GoShow | 字符串 | 表示这是否为走秀 |
| Incapacitated | 字符串 | 指明乘客是否丧失行为能力 |
| Upgraded | 字符串 | 指明航班是否已升级 |
| Downgraded | 字符串 | 指明航班是否已降级 |
| BaggageInsurance | 字符串 | 行李保险 |
| MaxAllowedBaggage | 字符串 | 支持的最大行李包数 |
| BaggageQuantity | 字符串 | 行李包数量 |
| BaggageFee | 字符串 | 行李总费用 |
| Arrival | 端口： | 航段的抵达详情 |
| Departure | 端口： | 航段的出发详情 |
| Seat | Seat | 座椅详情 |
| 优先级 | 优先级 | 优先级详情 |
| Doc | 文件 | 随附的旅行文件信息 |
| Baggage | 行李清单 | 行李详情 |
| Pets | 宠物清单 | 宠物详情 |
| OtherServices | OtherService 清单 | 其它服务详细信息 |
| 属性 | Map | 其它属性 |
**标准索引字段**
| 标准索引名称 | 标准偏好记录字段 |
| --- | --- |
| \$1airSegmentId | SegmentId |
| \$1airBookingRef | BookingRef |
**行李数据类型**
| 标准 airSegment 字段 | Type | 说明 |
| --- | --- | --- |
| Id | 字符串 | 行李标识符 |
| TagNumber | 字符串 | 行李标签号 |
| DepartureDate | 字符串 | 出发日期 |
| BaggageType | 字符串 | 行李类型 |
| 重量 | 字符串 | 行李的重量 |
| 长度 | 字符串 | 行李的长度 |
| 宽度 | 字符串 | 行李的宽度 |
| 高度 | 字符串 | 行李的高度 |
| PriorityBagDrop | 字符串 | 优先行李托运服务 |
| PriorityBagReturn | 字符串 | 优先行李退回服务 |
| HandsFreeBaggage | 字符串 | 免提行李服务 |
| 费用 | 字符串 | 行李费 |
| IsGateBag | 字符串 | 指示登机口托运行李 |
| IsHeavy | 字符串 | 指示超重行李 |
**座位数据类型**
| 标准 airSegment 字段 | Type | 说明 |
| --- | --- | --- |
| SeatNumber | 字符串 | 座位号 |
| SeatZone | 字符串 | 座位区域 |
| SeatType | 字符串 | 座位类型 |
| Price | 字符串 | 座位价格 |
| NeighborFree | 字符串 | 指示相邻座位是否空闲 |
| UpgradeAuction | 字符串 | 指示竞拍升级可用性 |
| 可用 | 字符串 | 指示座位可用性 |
| ExtraSeat | 字符串 | 指示额外座位 |
| AdditionalInformation | 字符串 | 额外座位信息 |
**机场数据类型**
| 标准 airSegment 字段 | Type | 说明 |
| --- | --- | --- |
| 位置 | 字符串 | 位置名称 |
| 代码 | 字符串 | 机场代码 |
| Terminal | 字符串 | 机场航站楼 |
| Country | 字符串 | 机场所在国家或地区 |
| 日期 | 字符串 | 日期 |
| 时间 | 字符串 | 时间 |
| EstimatedTime | 字符串 | 估计时间 |
| ScheduledTime | 字符串 | 计划时间 |
**优先级数据类型**
| 标准 airSegment 字段 | Type | 说明 |
| --- | --- | --- |
| TransactionId | 字符串 | 交易标识符 |
| PriorityServiceType | 字符串 | 优先服务的类型 |
| LoungeAccess | 字符串 | 指示贵宾室使用权 |
| Price | 字符串 | 优先服务价格 |
| AdditionalInformation | 字符串 | 额外优先级信息 |
**宠物数据类型**
| 标准 airSegment 字段 | Type | 说明 |
| --- | --- | --- |
| Species | 字符串 | 宠物种类 |
| Breed | 字符串 | 宠物品种 |
| 重量 | 字符串 | 宠物体重 |
| WeightUnit | 字符串 | 重量计量单位 |
| TransportType | 字符串 | 宠物运输的类型 |
**OtherService 数据类型**
| 标准 airSegment 字段 | Type | 说明 |
| --- | --- | --- |
| ServiceType | 字符串 | 服务类型 |
| 说明 | 字符串 | 服务描述 |
| Price | 字符串 | 服务价格 |
**证件数据类型**
| 标准 airSegment 字段 | Type | 说明 |
| --- | --- | --- |
| DocType | 字符串 | 证件类型 |
| DocTypeNeeded | 字符串 | 指示是否需要证件 |
| Nationality | 字符串 | 证件上的国籍 |
| DateOfBirth | 字符串 | 出生日期 |
| AppId | 字符串 | 应用程序标识符 |
| AgentId | 字符串 | 旅行社标识符 |
| VerifiedDateTime | 字符串 | 证件核查时间 |
# 标准酒店预订的对象类型映射
本节中的主题提供标准酒店预订定义。
**Topics**
+ [Customer Profiles 标准酒店预订对象字段](standard-hotel-reservation-object-fields.md)
# Customer Profiles 标准酒店预订对象字段
下表列出了 Customer Profiles 标准酒店预订对象中的所有字段。
**酒店预订**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| ReservationId | 字符串 | 标准酒店预订的唯一标识符 |
| ConfirmationNumber | 字符串 | 酒店或预订引擎提供的确认号码 |
| PreferenceRef | 字符串 | 引用预订的偏好对象的标识符 |
| Status | 字符串 | 预订的当前状态（例如，已确认、已取消） |
| TripType | 字符串 | 旅行的目的或性质（例如休闲、商务） |
| BrandCode | 字符串 | 表示酒店品牌的代码 |
| HotelCode | 字符串 | 标识特定酒店的代码 |
| PhoneNumber | 字符串 | 预订的联系人电话号码 |
| EmailAddress | 字符串 | 预订的联系人电子邮件地址 |
| GroupId | 字符串 | 将预订与团体预订关联的 ID |
| ContextId | 字符串 | 用于跟踪预订来源的上下文特定的标识符 |
| ProcessedDate | 字符串 | 处理预订的时间戳 |
| CreatedDate | 字符串 | 创建预订的时间戳 |
| CreatedBy | 字符串 | 创建预留 user/system 的标识符 |
| UpdatedDate | 字符串 | 上次更新预订的时间戳 |
| UpdatedBy | 字符串 | 更新预订 user/system 的标识符 |
| AgentId | 字符串 | 处理预订的座席的 ID |
| Reserver | 字符串 | 指示配置文件是否为预订人 |
| SameDayRate | 字符串 | 指示预订是否在同一天进行的 |
| Refundable | 字符串 | 指示预订是否可以退款 |
| CancellationCharge | 字符串 | 取消费用（如果适用）。0 表示不收费 |
| TransactionId | 字符串 | 交易的唯一标识符 |
| AmountPerNight | 字符串 | 每晚的房费金额 |
| AdditionalNote | 字符串 | 特别注意事项或说明 |
| NumberOfNights | 字符串 | 预订的晚数 |
| NumberOfGuests | 字符串 | 预订的宾客总数 |
| TotalAmountBeforeTax | 字符串 | 税前总成本 |
| TotalAmountAfterTax | 字符串 | 税后总成本 |
| Checkout | CheckOut | 退房详细信息 |
| Loyalty | 忠诚度 | 忠诚度详细信息 |
| 房间 | 房间 | 房间详细信息 |
| CheckIn | CheckIn | 入住详细信息 |
| Payment | Payment | 付款详细信息 |
| 货币 | 货币 | 货币详细信息 |
| 取消 | 取消 | 取消详细信息 |
| 频道 | 频道 | 渠道详细信息 |
| RatePlan | RatePlan | 费率计划详细信息 |
| 来宾 | 来宾 | 宾客详细信息 |
| Services | 服务清单 | 服务的清单 |
| 属性 | Map | 其它属性 |
**标准索引字段**
| 标准索引名称 | 标准偏好记录字段 |
| --- | --- |
| \$1hotelReservationId | ReservationId |
| \$1hotelPreferenceRef | preferenceRef |
**退房数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| Early | 字符串 | 已计划或要求提前退房 |
| Late | 字符串 | 已计划或要求延迟退房 |
| 自身 | 字符串 | 已计划或要求自助退房 |
| 日期 | 字符串 | 预订的退房日期 |
**忠诚度数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| ProgramName | 字符串 | 忠诚度计划的名称 |
| MembershipId | 字符串 | 忠诚度计划中的会员 ID |
| Tier | 字符串 | 忠诚度级别或等级 |
**房间数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| TypeCode | 字符串 | 房间类型/类别代码 |
| TypeName | 字符串 | 房间类型名称 |
| TypeDesc | 字符串 | 房间类型描述 |
| 数字 | 字符串 | 分配的房间号 |
| Capacity | 字符串 | 房间的最大容量 |
| AccessibilityType | 字符串 | 辅助功能 |
| SmokingAllowed | 字符串 | 指示房间内是否允许吸烟 |
**CheckIn 数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| 日期 | 字符串 | 预订的入住日期 |
| DigitalKey | 字符串 | 指示是否已发给数字房间钥匙 |
| Early | 字符串 | 指明是否要求提早入住 |
| Late | 字符串 | 指明是否要求延迟入住 |
| RoomKeys | 字符串 | 发给的房间钥匙数量 |
| UserSelectedRoom | 字符串 | 如果房客自己选择了房间，则为 True |
**付款数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| 类型 | 字符串 | 付款方式类型（例如信用卡、借记卡、代金券） |
| CreditCardToken | 字符串 | 令牌化的信用卡号 |
| CreditCardType | 字符串 | 信用卡类型（例如 Visa、Amex） |
| CreditCardExpiration | 字符串 | 信用卡到期日期 |
| Cvv | 字符串 | 信用卡验证值 |
| NameOnCreditCard | 字符串 | 信用卡上印刷的姓名 |
| RoutingNumber | 字符串 | 银行汇款路径号码 |
| AccountNumber | 字符串 | 银行账户 |
| VoucherId | 字符串 | 代金券标识符（如果使用） |
| DiscountCode | 字符串 | 已应用的折扣码 |
| DiscountPercent | 字符串 | 已应用的折扣百分比 |
**货币数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| 代码 | 字符串 | 货币的 ISO 代码（例如，USD） |
| Name | 字符串 | 货币的全名（例如，美元） |
| 符号 | 字符串 | 货币符号（例如 \$1） |
**取消数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| Reason | 字符串 | 取消原因 |
| Comment | 字符串 | 其它取消注释 |
**频道数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| CreationChannelId | 字符串 | 进行预订的渠道的 ID |
| LastUpdatedChannelId | 字符串 | 上次更新预订的渠道的 ID |
| 方法 | 字符串 | 用于预订的方法（例如，Web、移动应用程序） |
**RatePlan 数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| 代码 | 字符串 | 预订的费率计划的代码标识符 |
| Name | 字符串 | 预订的费率计划的名称 |
| 说明 | 字符串 | 费率计划的描述 |
**服务数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| ServiceType | 字符串 | 服务类型（例如，水疗、早餐） |
| 说明 | 字符串 | 服务的描述 |
| 成本 | 字符串 | 服务的成本 |
**宾客数据类型**
| 标准 hotelReservation 字段 | Type | 说明 |
| --- | --- | --- |
| Adults | 字符串 | 成人宾客人数 |
| Children | 字符串 | 儿童宾客人数 |
# 标准忠诚度的对象类型映射
本节中的主题提供标准忠诚度定义。
**Topics**
+ [Customer Profiles 标准忠诚度对象字段](standard-loyalty-object-fields.md)
# Customer Profiles 标准忠诚度对象字段
下表列出了 Customer Profiles 标准忠诚度对象中的所有字段。
**忠诚度**
| 标准忠诚度字段 | Type | 说明 |
| --- | --- | --- |
| LoyaltyId | 字符串 | 标准忠诚度的唯一标识符 |
| ProgramId | 字符串 | 忠诚度计划的标识符 |
| MembershipId | 字符串 | 计划中的备用标识符 |
| ProgramName | 字符串 | 忠诚度计划的名称 |
| Group | 字符串 | 忠诚度计划的组或类别 |
| 频道 | 字符串 | 用于访问忠诚度计划的渠道 |
| CreatedDate | 字符串 | 忠诚度账户的创建日期 |
| EnrollmentDate | 字符串 | 客户注册该计划的日期 |
| CreatedBy | 字符串 | 创建忠诚度账户的用户或系统 |
| UpdatedDate | 字符串 | 上次更新忠诚度账户的日期 |
| LastUpdatedBy | 字符串 | 上次更新忠诚度账户的用户或系统 |
| UpgradeDate | 字符串 | 上次升级等级的日期 |
| RenewalDate | 字符串 | 忠诚度会员续订日期 |
| AdditionalInformation | 字符串 | 任何其它信息 |
| EmailAddress | 字符串 | 客户的电子邮件地址 |
| EmailAddressVerified | 字符串 | 表示电子邮件是否已通过验证的标志 |
| PhoneNumber | 字符串 | 客户的电话号码 |
| PhoneNumberVerified | 字符串 | 表示电话号码是否已通过验证的标志 |
| Status | 字符串 | 忠诚度账户的当前状态 |
| Tier | 等级 | 等级详细信息 |
| Points | 积分 | 积分详细信息 |
| PointExpirations | PointExpiration 清单 | 积分到期详细信息 |
| Payment | Payment | 付款详细信息 |
| PaymentInformation | PaymentInformation | 付款信息详细信息 |
| BillingAddress | 忠诚度地址 | 地址详情 |
| 属性 | Map | 未以其它方式涵盖的其它属性 |
**标准索引字段**
| 标准索引名称 | 标准偏好记录字段 |
| --- | --- |
| \$1loyaltyId | LoyaltyId |
| \$1loyaltyMembershipId | membershipId |
**忠诚度地址数据类型**
| 标准 airPreference 字段 | 数据类型 | 说明 |
| --- | --- | --- |
| Address1 | 字符串 | 客户地址的第一行。 |
| Address2 | 字符串 | 客户地址的第二行。 |
| Address3 | 字符串 | 客户地址的第三行。 |
| Address4 | 字符串 | 客户地址的第四行。 |
| City | 字符串 | 客户居住的城市。 |
| Country | 字符串 | 客户居住的国家/地区。 |
| County | 字符串 | 客户居住的郡/县。 |
| PostalCode | 字符串 | 客户地址的邮政编码。 |
| Province | 字符串 | 客户居住的省份。 |
| State | 字符串 | 客户居住的州。 |
**等级数据类型**
| 标准忠诚度字段 | Type | 说明 |
| --- | --- | --- |
| CurrentTier | 字符串 | 客户当前的忠诚度等级 |
| NextTier | 字符串 | 客户的下一个可能的等级 |
| PointsToNextTier | 字符串 | 达到下一等级所需的积分 |
**积分数据类型**
| 标准忠诚度字段 | Type | 说明 |
| --- | --- | --- |
| Points.Unit | 字符串 | 积分的计量单位 |
| Points.Lifetime | 字符串 | 获得的终身积分总数 |
| Points.Balance | 字符串 | 当前积分余额 |
| Points.Redeemed | 字符串 | 兑换的积分总数 |
**PointExpiration 数据类型**
| 标准忠诚度字段 | Type | 说明 |
| --- | --- | --- |
| Points | 字符串 | 过期积分 |
| 日期 | 字符串 | 积分到期日期 |
**付款数据类型**
| 标准忠诚度字段 | Type | 说明 |
| --- | --- | --- |
| 类型 | 字符串 | 付款类型 |
| CreditCardToken | 字符串 | 令牌化信用卡引用 |
| CreditCardType | 字符串 | 信用卡类型（例如 Visa） |
| CreditCardExpiration | 字符串 | 信用卡到期日期 |
| Cvv | 字符串 | 信用卡验证值 |
| NameOnCreditCard | 字符串 | 卡片上的姓名 |
| RoutingNumber | 字符串 | 银行汇款路径号码 |
| AccountNumber | 字符串 | 银行账户 |
| VoucherId | 字符串 | 代金券标识符 |
**PaymentInformation 数据类型**
| 标准忠诚度字段 | Type | 说明 |
| --- | --- | --- |
| Schedule | 字符串 | 付款时间表 |
| LastPaymentDate | 字符串 | 上次付款日期 |
| NextPaymentDate | 字符串 | 下次付款日期 |
| NextBillAmount | 字符串 | 下一笔账单的金额 |
| CurrencyCode | 字符串 | 货币代码（例如 USD） |
| CurrencyName | 字符串 | 货币的全名 |
| CurrencySymbol | 字符串 | 货币符号（例如 \$1） |
# 标准忠诚度交易的对象类型映射
本节中的主题提供标准忠诚度交易定义。
**Topics**
+ [Customer Profiles 标准忠诚度交易对象字段](standard-loyalty-transaction-object-fields.md)
# Customer Profiles 标准忠诚度交易对象字段
下表列出了 Customer Profiles 标准忠诚度交易对象中的所有字段。
**忠诚度交易**
| 标准 loyaltyTransaction 字段 | Type | 说明 |
| --- | --- | --- |
| TransactionId | 字符串 | 标准忠诚度交易的唯一标识符。 |
| TransactionName | 字符串 | 交易的名称或标签。 |
| TransactionType | 字符串 | 交易类型（例如，赚取、兑换、调整）。 |
| ProgramRef | 字符串 | 对相关忠诚度计划的引用。 |
| MembershipRef | 字符串 | 对交易中使用的忠诚度会员资格的引用。 |
| PromotionRef | 字符串 | 对影响此交易的促销的引用。 |
| CreatedDate | 字符串 | 创建交易的日期。 |
| TransactionDate | 字符串 | 交易发生的日期。 |
| 行业 | 字符串 | 与交易相关的行业（例如航空业、酒店业）。 |
| 位置 | 字符串 | 交易发生的位置。 |
| CreatedBy | 字符串 | 交易创建者的标识符。 |
| UpdatedDate | 字符串 | 上次更新交易的日期。 |
| UpdatedBy | 字符串 | 上次更新交易的人的标识符。 |
| Status | 字符串 | 交易的当前状态。 |
| AccrualType | 字符串 | 应计方法（手动、自动等）。 |
| 类别 | 字符串 | 交易类别（例如航班、酒店住宿）。 |
| 频道 | 字符串 | 发起交易的渠道（例如，在线、店内）。 |
| ProductId | 字符串 | 与交易相关的产品或服务的标识符。 |
| 使用额 | 字符串 | 交易中花费或交易的金额。 |
| OriginValue | 字符串 | 任何转换或偏移之前的原始值。 |
| OriginValueCurrency | 字符串 | 原始交易价值的货币。 |
| OriginValueOffset | 字符串 | 调整促销、退款等的原始价值。 |
| PointsEarned | 字符串 | 从该交易中获得的总积分。 |
| PointOffset | 字符串 | 调整的积分（例如奖励、处罚）。 |
| QualifyingPointsEarned | 字符串 | 计入等级资格的积分。 |
| TierBefore | 字符串 | 交易前的客户等级。 |
| TierAfter | 字符串 | 交易后的客户等级。 |
| Brand | 字符串 | 与交易关联的品牌。 |
| 说明 | 字符串 | 交易的叙述性描述。 |
| AdditionalInformation | 字符串 | 与交易相关的自由格式的其它信息。 |
| PaymentMethod | 字符串 | 使用的付款方式（例如信用卡、代金券）。 |
| PointTransfer | PointTransfer | 积分转移详细信息 |
| 属性 | Map | 其它属性。 |
**标准索引字段**
| 标准索引名称 | 标准偏好记录字段 |
| --- | --- |
| \$1loyaltyTransactionId | TransactionId |
**PointTransfer 数据类型**
| 标准 loyaltyTransaction 字段 | Type | 说明 |
| --- | --- | --- |
| TransferId | 字符串 | 转移交易的标识符。 |
| SourceProgramId | 字符串 | 源忠诚度计划的 ID。 |
| DestinationProgrmId | 字符串 | 目标忠诚度计划的 ID。 |
| SourceMembershipId | 字符串 | 源计划中的会员 ID。 |
| DestinationMembershipId | 字符串 | 目标计划中的会员 ID。 |
| PointsTransferred | 字符串 | 从源计划中扣除的积分。 |
| PointsReceived | 字符串 | 记入目标计划的积分。 |
# 标准忠诚度促销的对象类型映射
本节中的主题提供标准忠诚度促销定义。
使用
**Topics**
+ [Customer Profiles 标准忠诚度促销对象字段](standard-loyalty-promotion-object-fields.md)
# Customer Profiles 标准忠诚度促销对象字段
下表列出了 Customer Profiles 标准忠诚度促销对象中的所有字段。
**忠诚度促销**
| 标准 loyaltyPromotion 字段 | Type | 说明 |
| --- | --- | --- |
| PromotionId | 字符串 | 标准忠诚度促销的唯一标识符。 |
| PromotionName | 字符串 | 促销的显示名称。 |
| PromotionType | 字符串 | 促销的类型或类别（例如奖励、等级提升、代金券）。 |
| ProgramType | 字符串 | 指示与促销相关的忠诚度计划的类型。 |
| ProgramRef | 字符串 | 相关忠诚度计划的引用 ID。 |
| PartnerId | 字符串 | 参与促销的合作伙伴组织的引用 ID。 |
| PartnerNumber | 字符串 | 与合作伙伴相关的标识符或编号。 |
| Tier | 字符串 | 促销针对或影响的等级。 |
| StartDate | 字符串 | 促销生效时间。 |
| EnrolledDate | 字符串 | 用户注册促销的日期。 |
| EndDate | 字符串 | 促销结束时间。 |
| 使用额 | 字符串 | 与促销关联的货币值或积分值。 |
| 周期 | 字符串 | 促销的时间段（例如，每周、每月、基于活动）。 |
| Status | 字符串 | 促销的当前状态（例如，活动、到期、已完成）。 |
| CreatedDate | 字符串 | 创建促销记录的日期。 |
| CreatedBy | 字符串 | 创建促销记录的用户或系统。 |
| UpdatedDate | 字符串 | 上次更新促销记录的日期。 |
| UpdatedBy | 字符串 | 上次更新促销的用户或系统。 |
| CampaignRef | 字符串 | 对此促销所属的更广泛活动的外部引用。 |
| AdditionalInformation | 字符串 | 有关促销的其它说明或营销文案。 |
| TriggerLimit | TriggerLimit | 触发限制详细信息 |
| 用法 | 用法 | 使用情况详细信息 |
| Rules | Rules | 促销规则详细信息 |
| Incentive | 激励 | 促销激励详细信息 |
| 属性 | Map | 其它元数据或计划特定的值。 |
**标准索引字段**
| 标准索引名称 | 标准偏好记录字段 |
| --- | --- |
| \$1loyaltyPromotionId | PromotionId |
**规则数据类型**
| 标准 loyaltyPromotion 字段 | Type | 说明 |
| --- | --- | --- |
| 名称 | 字符串 | 促销规则中的规则名称。 |
| 说明 | 字符串 | 促销规则中的规则描述。 |
**激励数据类型**
| 标准 loyaltyPromotion 字段 | Type | 说明 |
| --- | --- | --- |
| 类型 | 字符串 | 激励的类型（例如，bonusPoints、voucher、tierUpgrade）。 |
| 值 | 字符串 | 激励的价值，例如积分金额或代金券价值。 |
| 单位 | 字符串 | 激励值的单位（例如，积分、%、美元）。 |
**TriggerLimit 数据类型**
| 标准 loyaltyPromotion 字段 | Type | 说明 |
| --- | --- | --- |
| Times | 字符串 | 可以触发促销的次数。 |
| Interval | 字符串 | 触发限制的间隔。 |
**使用情况数据类型**
| 标准 loyaltyPromotion 字段 | Type | 说明 |
| --- | --- | --- |
| UsageProgressPercent | 字符串 | 促销使用情况的进度百分比。 |
| UsageCompleted | 字符串 | 完成的使用次数。 |
| UsageTarget | 字符串 | 目标使用次数。 |
# Web 分析对象的对象类型映射
**WebAnalytics 标准对象架构**
| 字段 | Type | 说明 |
| --- | --- | --- |
| 事件属性 |
| EventId | 字符串 | 网络分析事件的唯一标识符。 |
| EventType | 字符串 | 网络分析事件的类型，例如-页面查看、表单提交、按钮点击向上拉主线\$1u0000搜索栏互动、应用程序错误提示、购物车互动、购买、滚动等 |
| EventTimestamp | 数字 | 事件的纪元毫秒时间戳。 |
| EventDuration | 数字 | EventDuration 表示用户在特定互动中花费的时间，以秒为单位。常见用例包括：查看产品所花费的时间、特定页面上的浏览会话时长、在某项功能上花费的时间等。 |
| EventValue | 数字 | EventValue 是一个数字属性，用于表示交互事件的值或重要性。常见用例包括：交易事件的购买金额、产品评级的评分值、视频观看量的完成百分比等。 |
| 会话属性 |
| Session.ID | 字符串 | 会话的唯一标识符。 |
| 会话。 StartTimestamp | 数字 | Epoch 毫秒，表示会话的开始时间戳。 |
| 页面/屏幕属性 |
| 页面. 标题 | 字符串 | 移动应用程序的网 App/Screen 名标题。 |
| 页面. 位置 | 字符串 | 网页的网址。对于移动设备，它可能是深度链接或屏幕路由。 |
| Page.Referrer | 字符串 | 上一个屏幕/页面。 |
| 页面. 类别 | 字符串 | screen/page. Might be useful to group nested URLs/app地点的逻辑分组。 |
| HTML/DOM 元素 |
| Element.Id | 字符串 | HTML 元素标识 |
| 元素. 类型 | 字符串 | 元素类型-按钮、锚链接等 |
| 元素. 职业 | 字符串 | 元素的 CSS 样式类别 |
| 元素. 文本 | 字符串 | 元素文本（适用于按钮、输入字段、占位符等）。 |
| 元素。 AltText | 字符串 | AltText HTML 元素（通常用于图像）。 |
| 元素。来源 | 字符串 | 视频、图像等的来源 |
| 表单 |
| Form.ID | 字符串 | 输入表单的唯一标识符 |
| Form.Name | 字符串 | 表格名称 |
| 表单长度 | 字符串 | 表单中输入字段的数量。 |
| 表格。 ValidationErrors | 数字 | 表单中的验证错误数量。 |
| 表格。 FieldsCompleted | 数字 | 已完成的字段数。 |
| 表格。 FieldsRequired | 数字 | 必填字段数。 |
| Search |
| 搜索. 查询 | 字符串 | 输入中使用的查询字符串 |
| 搜索。 TotalMatchingResults | 数字 | 搜索结果总数。 |
| 搜索。 ResultsPerPage | 数字 | 每页显示的结果数。 |
| 搜索。 CurrentResultsPage | 数字 | 用户正在查看的当前结果页面。 |
| 搜索。 FilterExpression | 字符串 | 使用的任何其他过滤器表达式。 |
| 搜索。 SortCriteria | 字符串 | 对搜索结果进行排序的标准。例如-相关性、价格等 |
| 搜索。 SortOrder | 字符串 | 搜索结果的排序顺序-升序/降序。 |
| 物品/物品清单 |
| Item | Item | 活动中的重点商品，表示已添加到购物车的商品、已查看的商品等。 |
| ItemsList | 清单 - | 活动中商品的重点列表，表示已购买的商品、购物车中的商品、商品搜索结果等。 |
| 商品印象 |
| AdditionalItemImpressions | 清单
- | 其他商品展示次数列表 |
| 购物车 |
| Cart.Id | 字符串 | 购物车的唯一标识符。 |
| 购物车。 ItemsCount | 数字 | 购物车中的商品数量。 |
| 购物车。货币 | 字符串 | 购物车价值的货币。 |
| 购物车。Value | 数字 | 购物车中商品的货币价值。 |
| 订单信息 |
| OrderId | 字符串 | 订单的唯一标识符。我们只会在这里存储订单标识符，与订单相关的其他信息将存储在标准订单对象中。 |
| 设备 |
| DeviceId | 字符串 | 用户设备的唯一标识符。 |
| 滚动属性 |
| 滚动。 DepthPercentage | 字符串 | 垂直滚动深度百分比。这有助于了解用户在网页上滚动了多远。 |
| 滚动.positionX | 数字 | 水平滚动位置，以像素为单位向左移动。 |
| 滚动.positiony | 数字 | 从顶部开始垂直滚动位置（以像素为单位）。 |
| 错误 |
| 错误。描述 | 字符串 | 对错误的简短描述。 |
| 错误。类型 | 字符串 | 用户输入 Error/Server 错误。 |
| 用户 |
| 用户.ID | 字符串 | 用户的唯一标识符 |
| 用户。 AnonymousId | 字符串 | 匿名 UserId。这将是在用户未登录时分配给他们的 uniqueID。 |
| 用户。 IsReturning | 字符串 | 一个布尔值，表示用户是否正在重新访问。 |
| 用户。 IsLoggedIn | 字符串 | 一个布尔值，表示用户是否已登录。 |
| 活动位置 |
| Location.Country | 字符串 | 用户活动国家。 |
| 位置. 州 | 字符串 | 用户活动状态。 |
| 地点. 省 | 字符串 | 用户活动省份。 |
| 地点. 县 | 字符串 | 用户活动县。 |
| 位置。城市 | 字符串 | 用户活动城市。 |
| 位置. 纬度 | 字符串 | 用户活动位置坐标 |
| 位置. 经度 | 字符串 | 用户活动位置坐标 |
| 应用程序属性 |
| Application.Name | 字符串 | 应用程序的名称。 |
| Application.Version | 字符串 | 如果设备是移动设备，我们可以在此处捕获应用程序版本。用户也可以考虑将其用于群体 A/B 测试或实验属性。 |
| 应用程序. 环境 | 字符串 | 应用程序环境，比如-测试版、Gamma、Prod。 |
| 自定义属性 |
| 属性 | Map | 要添加到活动中的任何自定义属性或元数据。 |
**WebAnalytics 项目对象架构**
| 字段 | Type | 说明 |
| --- | --- | --- |
| Id | 字符串 | 商品的唯一标识符。 |
| 标题 | 字符串 | 物品的标题。 |
| 类别 | 字符串 | 商品的类别。 |
| 值 | 字符串 | 物品的货币价值。 |
| 货币 | 字符串 | 商品的货币。 |
| Quantity | 数字 | 商品的数量。 |
| ImpressionType | 字符串 | 标识事件展示类型的字符串。例如-精选、赞助、热门精选等 |
| ImpressionId | 字符串 | 用于唯一标识展示的字符串标识符。 |
**设备标准对象架构**
| 字段 | Type | 说明 |
| --- | --- | --- |
| DeviceId | 字符串 | 设备的唯一标识符。 |
| Type | 字符串 | 设备类型（例如台式机、移动设备） |
| 模型 | 字符串 | 设备型号，比如-Macbook Pro/Air、 IPhone 16 等 |
| Manufacturer | 字符串 | 设备的制造商。 |
| OperatingSystem | 字符串 | 表示 Windows、 MacOs、iOS、安卓。 |
| OperatingSystemVersion | 字符串 | 操作系统版本 |
| ScreenWidth | 数字 | 屏幕宽度 ViewPort |
| ScreenHeight | 数字 | 屏幕高度 ViewPort |
| 浏览器 | 字符串 | 用户正在与之交互的浏览器的名称。 |
| BrowserVersion | 字符串 | 浏览器的版本 |
| Locale | 字符串 | 设备或应用程序的区域设置。 |
| 属性 | Map | 设备的任何自定义属性。 |
# 商品目录的对象类型映射
| 字段 | Type | 说明 |
| --- | --- | --- |
| Id | 字符串 | 商品在目录中的唯一标识符。 |
| Name | 字符串 | 物品的名称 |
| 代码 | 字符串 | 目录项的代码 |
| Type | 字符串 | 目录项的类型 |
| 类别 | 字符串 | 目录中商品的类别 |
| 说明 | 字符串 | 物品描述 |
| AdditionalInformation | 字符串 | 与该商品相关的任何其他信息。 |
| ImageLink | 字符串 | 链接到物品的图片 |
| Link | 字符串 | 商品网址 |
| Price | 字符串 | 商品的价格 |
| CreatedAt | 长整型 | 为其创建物品的时代时间戳 |
| UpdatedAt | 长整型 | 更新物品的时代时间戳 |
| 属性 | Map | 其他物品属性 |
**注意**
您只能通过删除域对象类型 APIs。在先删除所有推荐人之后，您可以删除商品目录集成。这样可以防止出现数据依赖性问题。
**删除步骤：**
1. 删除您域名中的所有现有推荐者
2. 导航至商品目录集成。
3. 选择删除选项。
# 标准酒店住宿收入的对象类型映射
本节中的主题提供标准酒店住宿收入定义。
**Topics**
+ [Customer Profiles 标准酒店住宿收入对象字段](standard-hotel-stay-revenue-object-fields.md)
# Customer Profiles 标准酒店住宿收入对象字段
下表列出了 Customer Profiles 标准酒店住宿收入对象中的所有字段。
**酒店住宿收入**
| 标准 hotelStayRevenue 字段 | Type | 说明 |
| --- | --- | --- |
| StayRevenueId | 字符串 | 标准酒店住宿收入的唯一标识符。 |
| CurrencyCode | 字符串 | 货币的 ISO 代码（例如，USD） |
| CurrencyName | 字符串 | 货币的全名（例如，美元） |
| CurrencySymbol | 字符串 | 货币符号（例如 \$1） |
| ReservationId | 字符串 | 酒店住宿的唯一标识符 |
| GuestId | 字符串 | 宾客的唯一标识符 |
| LastUpdatedOn | 字符串 | 上次更新住宿记录的时间戳 |
| CreatedOn | 字符串 | 创建住宿记录时的时间戳 |
| LastUpdatedBy | 字符串 | 上次更新住宿记录的人的标识符 user/system |
| CreatedBy | 字符串 | 创建住宿记录 user/system 的人的标识符 |
| StartDate | 字符串 | 酒店住宿的开始日期 |
| HotelCode | 字符串 | 标识特定酒店的代码 |
| Type | 字符串 | 收入类型（例如房费、杂费、税款） |
| 说明 | 字符串 | 收入项的描述 |
| 使用额 | 字符串 | 收入项的金额 |
| ProcessedDate | 字符串 | 处理收入的日期 |
| Status | 字符串 | 收入项的状态 |
| 属性 | Map | 其它元数据或计划特定的值。 |
**标准索引字段**
| 标准索引名称 | 标准偏好记录字段 |
| --- | --- |
| \$1 hotelStayRevenue 身份证 | StayRevenueId |
# Customer Profiles 中对象类型的其他属性
属性类型定义了应使用哪个键来加密对象类型的任何数据。
有一个选项可以定义是否可以通过摄取此对象来创建新的资料。通常，当摄取的对象无法与现有资料匹配时，只要此选项为 true，就会创建新的资料。如果它不为 true，则会创建摄取的对象并将其写入域死信队列。
它还包含此对象类型的数据应在 Customer Profiles 中保留多长时间。
**注意**
单个对象的保留期是在摄取数据时设置的。更改特定对象类型的保留期仅适用于正在摄取的新数据。它不适用于已经摄取的现有数据。
**注意**
如果此对象与现有配置文件匹配，则它将不会覆盖通过 API 调用或座席工作区手动填充的字段，以防止自动摄取覆盖手动摄取。
例如，假设代理在座席工作区中手动创建了带有 FirstName “John” 的配置文件。将数据映射到标准配置文件 FirstName 字段的对象被收录。如果此对象与配置文件关联，则它不会覆盖 FirstName “John”。
# 推断的资料
当通过摄取没有字段的对象来创建资料时，此新资料的标准资料对象为空。此空标准资料对象是一个**推断的资料**。
在创建推断的资料时，将在资料对象的标准对象中填充以下两个字段（如果有）。
+ 如果在摄取的对象中定义了内容类型为 `EMAIL_ADDRESS` 的任何字段，则此值将填充到标准资料的 `EmailAddress` 字段中。
+ 如果在摄取的对象中有内容类型为 `PHONE_NUMBER` 的任何字段，则此值将填充到标准资料的 `PhoneNumber` 字段中。
即使这些字段未在字段定义中定义目标，这些字段的值也会填充到标准资料中。
要了解有关 Contact Records 模板类型的更多信息，以及如何调整域中使用的模板，请参阅 [联系人记录模板使用情况示例](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 管理控制台中更新 Contact Record 类型](#ctr-contact-record-template-usage-examples-console)
+ [自动将电子邮件联系人中的姓名添加到配置文件](#add-email-names-to-profile)
## 创建推断的配置文件和自动关联配置文件 (CTR-) NoInferred
**描述**
当使用点击率NoInferred 模板并发生联系事件（例如电话）时，将启动一个特定的流程来处理数据。最初，系统使用 `_ctrContactId` 键搜索与联络事件关联的现有资料。如果找到匹配的资料，则联络事件将自动与该资料关联。但是，如果使用 `_ctrContactId` 键未找到现有资料，则系统将继续使用名为 `_phone` 的备用键搜索资料。此键用于根据与联络事件关联的电话号码查找现有资料。找到匹配的资料时，则联络事件将自动与该资料关联。
如果 `_ctrContactId` 键和 `_phone` 键均未生成现有资料，则系统会创建新的推断资料。然后，该推断的资料将使用来自联络事件的元数据进行填充，从而确保相应信息被捕获并存储在系统中。
此过程可确保高效处理联络事件，促进与现有资料的自动关联，并在必要时允许创建推断的资料。通过利用这些机制，组织可以维护客户互动的全面记录，并在系统内有效地管理其联络事件数据。
建议使用点击率NoInferred 模板作为默认行为，因为它具有显著的优势，尤其是在减少重复配置文件方面
![\[联系人记录点击率NoInferred 模板图。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/ctr-contact-record-template-no-inferred.png)
## 仅限自动关联个人资料 (CTR-) AutoAssociateOnly
**描述**
点击率AutoAssociateOnly 模板的功能与点击率NoInferred模板类似，但有一个重要的区别：当找不到用于自动关联的现有配置文件时，它不会创建推断出的配置文件。
当联系人事件（例如电话）发生时，点击率AutoAssociateOnly 模板使用`_ctrContactId`密钥搜索匹配的现有个人资料。如果找到资料，则联络事件将自动与该资料关联。
但是，如果使用 `_ctrContactId` 键找不到现有资料，则模板将采用使用 `_phone` 键的辅助搜索机制。它会搜索与跟联络事件相同的电话号码关联的现有资料。如果找到匹配的资料，则联络事件将自动与该资料关联。
使用点击率AutoAssociateOnly 模板的目的是启用与现有配置文件的自动关联，同时严格控制个人资料的创建。与点击率模板不同，此NoInferred 模板可防止在找不到匹配项时创建推断出的配置文件。它可确保只能手动创建资料，从而为组织提供对资料管理更高级别的控制和准确性。
通过使用点击率AutoAssociateOnly 模板，组织可以利用自动关联，同时遵守有关个人资料创建的特定规则。这种方法可以简化联络事件处理和对资料生态系统的精确控制，从而确保准确的数据呈现并促进高效的客户管理。
![\[联系人记录点击率AutoAssociateOnly 模板图。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/ctr-contact-record-template-auto-associate.png)
## 仅创建推断的资料 (CTR)
**描述**
CTR 模板仅依靠 `_ctrContactId` 键来搜索现有资料，如果找到匹配项，它会自动将联络事件与相应资料相关联。但是，在找不到现有资料的情况下，模板会创建推断的资料并使用联络事件元数据对其进行填充。
尽管这种行为可确保即使不存在预先存在的资料也能捕获联络事件，但它可能会导致创建大量推断的资料。如此大量的推断资料可能会导致出现系统内存在重复资料的问题。
为了解决这个问题并推广更好的个人资料管理实践，我们强烈建议使用点击率NoInferred 模板作为默认选项。通过使用点击率NoInferred 模板，系统无需创建推断的配置文件，从而减少重复配置文件的出现。该模板可以更简化、更高效地处理联络事件，从而提高数据的完整性和准确性。
通过采用点击率NoInferred 模板作为默认选择，组织可以优化其个人资料管理流程，最大限度地减少数据重复，并确保更可靠地呈现客户互动。
![\[联系人记录 CTR 模板图。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/ctr-contact-record-template-inferred-only.png)
## 联系人记录模板使用情况示例
**Amazon Connect 管理员网站**
+ 在 Amazon Connect 管理网站中，创建新域名时，您可以选择所需的点击率行为。可以通过在**资料创建和自动关联**分区中提供的单选按钮选项来完成此操作。同样，在选择现有域时，单选按钮选项将反映先前与该域关联的行为。
+ 当编辑当前已启用的域时，域详细信息页面将在**资料创建和自动关联**分区显示当前应用的行为。通过选择本节标题中的**编辑**按钮，系统将您重定向到**编辑****资料创建和自动关联**页面。在这里，您可以根据自己的要求选择不同的行为。
+ 或者，如果您正在从**数据映射**页面查看 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 管理控制台中更新 Contact Record 类型
1. 在 Customer Profiles 控制台中，选择 **Customer Profiles 域**部分的**查看详细信息**。
![\[在 Customer Profiles 域部分选择查看详细信息\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-1.png)
1. 在**域名详细信息**页面的**配置文件创建和自动关联**部分选择**编辑**。
![\[在配置文件创建和自动关联部分中选择编辑。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-2.png)
1. 选择要应用于域的所需 Contact Record 行为，然后选择**保存**。
![\[选择要应用于域的所需 Contact Record 行为，然后选择保存。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-3.png)
## 自动将电子邮件联系人中的姓名添加到配置文件
您可以设置一个流来将电子邮件联系人中的姓名填充到客户的配置文件。使用配置为使用[更新配置文件](customer-profiles-block.md#customer-profiles-block-properties-update-profile)操作的[客户资料](customer-profiles-block.md)数据块。
# 将 Contact Record 与 Customer Profiles 中使用 \$1phone 密钥找到的一个配置文件相关联
您可以自动将联系人记录与使用 `_phone` 键找到的一个资料相关联
**示例**
在域中，以下资料由 `CreateProfile` API 创建：
```
{
"FirstName": "John",
"LastName": "Doe",
"PhoneNumber": "+11234567890"
}
```
当使用默认 CTR 模板接到来自 `PhoneNumber` \$111234567890 的呼叫时，除非座席已经将同一呼叫方的联系人记录手动关联到上述资料，否则联系人记录不会与上述资料自动关联。如果联系人记录未手动或自动关联，则 Customer Profiles 将使用联系人记录中的信息创建推断的资料。
要在没有人工代理干预的情况下自动将上述个人资料与联系人记录关联起来，你可以使用 CTR-NoInferred 模板。使用点击率NoInferred 模板接到来自 `PhoneNumber` \$111234567890 的电话时，联系人记录将使用配置文件密钥自动与上述个人资料关联。`_phone`
在两种情况下，Customer Profiles 将*无法*自动将联系人记录与资料关联：
+ 如果使用 `_phone` 资料键找到了多个资料，则 Customer Profiles 无法将联系人记录与唯一的资料相关联，请求将被拒绝。
+ 如果找不到 `_phone` 资料键的资料，则 Customer Profiles 将创建推断的资料。
要使用点击率NoInferred 模板替换默认的点击率模板，请在 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 中的生成式人工智能数据映射
Amazon Connect Customer Profiles 提供基于人工智能的生成式客户数据映射功能，可显著缩短创建统一档案所需的时间，使您能够帮助提供更加个性化的客户体验。
借助此功能，当联络中心管理员添加来自70多个可用的无代码数据连接器（例如Adobe Analytics、Salesforce或Amazon Simple Storage Service (S3)）中的任何一个的 Amazon Connect 客户数据时，客户档案将分析来自这些来源的数据，以自动确定如何组织不同来源中以不同格式存在的数据并将其组合成统一的配置文件。 Amazon Connect联络中心管理员可以查看并完成客户资料的设置，这样他们就可以为客服人员提供相关的客户信息，并对聊天机器人进行动态个性化设置 IVRs ，从而提高客户满意度和客服人员的工作效率。
生成式人工智能支持的客户数据映射在以下区域中可用：
+ 美国东部（弗吉尼亚州北部）
+ 美国西部（俄勒冈州）
+ 非洲（开普敦）
+ 亚太地区（新加坡）
+ 亚太地区（悉尼）
+ 亚太地区（东京）
+ 亚太地区 (首尔)
+ 加拿大（中部）
+ 欧洲地区（法兰克福）
+ 欧洲地区（伦敦）
## 设置生成式人工智能支持的数据映射
1. 打开 Amazon Connect 客户资料控制台。
1. 在**数据来源集成**选项卡上，选择**添加数据来源集成**。
1. 设置连接。从包含所有支持的可用连接器的下拉列表中选择数据来源。
![\[从包含所有支持的可用连接器的下拉列表中选择数据来源。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/genai-augmented-data-mapping-1.png)
1. 映射数据。选择自动生成数据映射的选项，或者选择已经存在的映射模板或从头开始创建一个映射模板。
![\[映射数据。选择自动生成数据映射的选项，或者选择已经存在的映射模板或从头开始创建一个映射模板。\]](http://docs.aws.amazon.com/zh_cn/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_cn/connect/latest/adminguide/images/genai-augmented-data-mapping-3.png)
## 工作原理
该系统分四个阶段运行。在第一阶段，Customer Profiles 会从您的数据来源获取源属性和数据样本（如果有），然后确定最适合目标的对象类型。对于 Amazon S3 数据来源，在选定的 Amazon S3 存储桶和前缀中找到的第一个 CSV 文件将用作数据示例。对于其他数据源，客户档案通过 AppFlow获取来源属性。在第二阶段，利用大型语言模型（LLM）进一步处理每个自定义属性并将其映射到标准的客户配置文件属性上。第三阶段再次使用 LLM 来选择可以用作键的合适属性，例如客户标识符。最后，在第四阶段，时间戳格式检测器会解析时间戳以保持记录正确的时间顺序。在合并预测结果后，系统能够在不到 20 秒的时间内生成多达 120 个属性的映射。
## 生成式人工智能支持的数据映射故障排除
以下各节显示了您可能会遇到的错误消息。它还提供了每个问题的原因和解决方案。
### 错误：无法将对象字符串解析为 JSON
请求中的对象字符串不是有效的 JSON。查看请求中的对象字符串并验证其是否为有效的 JSON。
### 错误：“对象”值不满足约束条件：成员的长度必须小于或等于 5
请求中的对象太多。一个请求中最多允许有五个对象。将对象的数量减少到五个或更少。
### 错误：突破了 120 个属性的限制
一个 JSON 对象中最多允许 120 个属性，包括嵌套的 JSON 属性。从 JSON 对象中移除一些不需要映射的属性。
![\[一个 JSON 对象中最多允许 120 个属性，包括嵌套的 JSON 属性。从 JSON 对象中移除一些不需要映射的属性。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/genai-augmented-data-mapping-breached-limit.png)
### 警告：我们找不到区分您的数据的**唯一键**。我们找不到用于识别您的配置文件的**配置文件键**。
模型无法从给定对象中找到有效的对象类型。根据建议更改输入或使用手动映射方法。
![\[模型无法从给定对象中找到有效的对象类型。根据建议更改输入或使用手动映射方法。\]](http://docs.aws.amazon.com/zh_cn/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_cn/connect/latest/adminguide/images/customer-profiles-data-limits-setup-1.png)
1. 将鼠标悬停在所需数据对象的限制上，然后选择编辑图标。
![\[将鼠标悬停在所需数据对象的限制上，然后选择编辑图标。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-data-limits-setup-2.png)
1. 输入限制，然后选择复选标记图标保存或更新限制。
![\[该图片显示正在输入新限制，并突出显示了用于保存或更新限制的复选标记图标。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-data-limits-setup-3.png)
## 如何清除 Customer Profiles 数据限制
1. 选择要清除限制的数据对象的单选按钮。然后，您将能够选择**清除限制**。
![\[突出显示数据限制页面上数据对象左侧的单选按钮。选择此处的单选按钮，就可以启用对象数据限制的清除按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-data-limits-clear-1.png)
1. 输入*确认*，清除所选数据对象的限制值。
![\[弹出一个框，要求您确认是否要清除数据对象的限制值。您可以输入小写字母“确认”，确认清除操作。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-data-limits-clear-2.png)
# 创建客户数据并将其摄取到 Customer Profile 中
您可以使用 Amazon S3 定义来自任何源的数据，无需自定义或预先构建的集成，即可无缝丰富客户资料。例如，假设您想向座席提供相关的购买历史信息。您可以将购买交易数据从内部应用程序导入到 S3 上的电子表格文件中，然后将其链接到客户资料。
要进行此设置，您需要定义一个[对象类型映射](customer-profiles-object-type-mapping.md)，用于描述自定义资料对象的外观。此映射定义如何使用数据中的字段来填充标准资料中的字段，或者如何能够使用它将数据分配给特定资料。
创建对象类型映射后，您可以使用 [PutProfileObject](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObject.html)API 将自定义配置文件数据从 CRM 上传到自定义配置文件对象。
**注意**
Customer Profiles 不支持从包含点表示法的 CSV 标题中摄取数据。
有关 Customer Profiles 访问 Amazon S3 存储桶中的数据以进行数据映射所需的 IAM 权限列表，请参阅 [Amazon Connect Customer Profiles 定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonconnectcustomerprofiles.html#amazonconnectcustomerprofiles-actions-as-permissions)中的表 `PutProfileObject`。
## 客户配置文件摄取
**摄取基于账户的配置文件**
1. 将数据文件上传到 S3。对账户配置文件中引用的配置文件和账户配置文件本身的摄取应分开进行。
1. 用于账户配置文件摄取的新文件应包含新的属性：配置文件类型以及电子邮件和电话的互动偏好。
1. 使用 AWS 管理控制台将文件从 S3 摄取到客户配置文件
**示例配置文件（在以下基于账户的配置文件中引用）CSV**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/customer-profiles-object-type-mappings.html)
**基于账户的配置文件 CSV 示例**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/customer-profiles-object-type-mappings.html)
**电子邮件互动偏好示例**：
```
[
{"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PersonalEmailAddress"},
{"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PersonalEmailAddress"}
]
```
**电话互动偏好示例**：
```
[
{"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PhoneNumber"},
{"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PhoneNumber"}
]
```
**注意**
对于 **ProfileType**`PROFILE`，您可以使用相同的方法获取和添加参与偏好。
1. 创建两个数据映射：一个用于子配置文件，一个用于基于账户的配置文件。
![\[创建两个数据来源集成，每个集成将基于所描述的关系创建一个映射。例如，账户/配置文件。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-1.png)
1. 接下来，映射客户配置文件属性。记下名为 `ProfileType` 的目标。
![\[接下来，映射客户配置文件属性。记下呼叫的目的地 ProfileType。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-2.png)
**摄取在基于账户的配置文件中引用的配置文件的对象类型映射示例**
```
{
"AllowProfileCreation": true,
"Description": "Standard Profile Object Type",
"Fields": {
"FirstName": {
"ContentType": "STRING",
"Source": "_source.FirstName",
"Target": "_profile.FirstName"
},
"LastName": {
"ContentType": "STRING",
"Source": "_source.LastName",
"Target": "_profile.LastName"
},
"PhoneNumber": {
"ContentType": "PHONE_NUMBER",
"Source": "_source.PhoneNumber",
"Target": "_profile.PhoneNumber"
},
"PersonalEmailAddress": {
"ContentType": "EMAIL_ADDRESS",
"Source": "_source.PersonalEmailAddress",
"Target": "_profile.PersonalEmailAddress"
},
"State": {
"ContentType": "STRING",
"Source": "_source.State",
"Target": "_profile.Address.State"
},
"CustomerId": {
"ContentType": "STRING",
"Source": "_source.CustomerId",
"Target": "_profile.Attributes.CustomerId"
},
"ProfileType": {
"ContentType": "STRING",
"Source": "_source.ProfileType",
"Target": "_profile.ProfileType"
}
},
"Keys": {
"CustomerId": [
{
"FieldNames": [
"CustomerId"
],
"StandardIdentifiers": [
"PROFILE",
"UNIQUE"
]
}
]
}
}
```
1. 重复该过程以摄取基于账户的配置文件。注意 EngagementPreferences。电子邮件和 EngagementPreference .Phone。
![\[重复该过程以摄取基于账户的配置文件。注意 EngagementPreferences。电子邮件和 EngagementPreference .Phone。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-3.png)
**用于摄取基于账户的配置文件的对象类型映射示例**
```
{
"AllowProfileCreation": true,
"Description": "Account-based profiles Object Type",
"Fields": {
"AccountNumber": {
"ContentType": "STRING",
"Source": "_source.AccountId",
"Target": "_profile.AccountNumber"
},
"PrimaryOwner": {
"ContentType": "STRING",
"Source": "_source.PrimaryOwner",
"Target": "_profile.Attributes.PrimaryOwner"
},
"SecondaryOwner": {
"ContentType": "STRING",
"Source": "_source.SecondaryOwner",
"Target": "_profile.Attributes.SecondaryOwner"
},
"ProfileType": {
"ContentType": "STRING",
"Source": "_source.ProfileType",
"Target": "_profile.ProfileType"
},
"EmailEngagementPreferences": {
"ContentType": "STRING",
"Source": "_source.EmailEngagementPreferences",
"Target": "_profile.EngagementPreferences.Email"
},
"PhoneEngagementPreferences": {
"ContentType": "STRING",
"Source": "_source.PhoneEngagementPreferences",
"Target": "_profile.EngagementPreferences.Phone"
}
},
"Keys": {
"Account": [
{
"FieldNames": [
"AccountNumber"
],
"StandardIdentifiers": [
"PROFILE",
"UNIQUE"
]
}
]
}
}
```
1. 创建两个数据来源集成，每个集成将基于所描述的关系创建一个映射。例如，账户/配置文件。
**注意**
只有在使用 Amazon Connect 客户档案控制台中的 [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html)API 或个人资料指标验证成功获取了基于账户的资料中引用的配置文件后，才应提取基于账户的个人资料。
自动生成映射不适用于摄取基于账户的配置文件及其子配置文件。
联系人首选项的电子邮件和电话列表可以具有 `KeyName` 和 `KeyValue` 或 `ProfileId` 以引用子配置文件。`KeyName` 应该是唯一的标识符。
更新子配置文件不会更新基于账户的配置文件中的互动偏好。更新必须通过摄取路径来进行。
# 创建 Kinesis 与 Amazon Connect Customer Profiles 的集成
以下步骤概述了将对象从 Amazon Kinesis 数据流流式传输到 Amazon Connect Customer Profiles 的过程。集成包含两个主要步骤：
1. 配置 EventBridge Pipe 以将数据从 Kinesis 数据流传输到总线。 EventBridge
1. 使用您创建的 Pipe 设置与您的 Kinesis 数据流的客户档案数据集成 EventBridge
## 第 1 步：将数据从 Kinesis 流式传输到 EventBridge
1. 打开 Amazon EventBridge 控制台，网址为 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)
1. 在导航窗格中，选择**事件总线**。
1. 选择 **Create event bus (创建事件总线)**。
1. 在**事件总线详细信息**部分中，提供描述性名称。例如 `kinesis-to-customer-profiles`。
1. 选择**创建**。
1. 转到 Kinesis 数据流详细信息页面。
1. 选择 “**EventBridge 管道**” 选项卡，然后选择 “**将 Kinesis 数据流连接到**管道”。
1. 为你的 EventBridge 管道创建一个名称。
1. 按照设置向导进行操作，直到进入**目标设置**页面。
1. 对于目标，选择在步骤 1 中创建的事件总线。例如 `kinesis-to-customer-profiles`。
1. 在**目标**部分之后，展开**目标输入转换器**手风琴式折叠组件。
1. 按如下方式设置目标输入转换器：
```
{
"data": <$.data>
}
```
1. 选择**创建管道**以完成设置。
此时，您已成功将 Kinesis 事件的路由配置为。 EventBridge接下来，我们将创建与 Customer Profiles 的集成。
## 第 2 步：将 EventBridge 数据提取到客户档案中
1. 在 Amazon Connect 控制台中转至 **Customer Profiles**。
1. 选择**数据来源集成**选项卡，并选择**添加数据来源集成**。
1. 从**数据来源**下拉列表中选择 **Kinesis**
1. 在**EventBridge 管道名称**下拉列表中，选择在步骤 1 中创建的管道，然后选择**下一**步。
1. 在**映射数据**页面上，选择相应的对象类型映射，然后选择**下一步**。
1. 在**查看和集成**页面上查看您的配置，然后选择**添加数据来源集成**以完成设置。
Kinesis 数据流现已与 Amazon Connect Customer Profiles 集成，您现在可以将事件从 Kinesis 发送到 Customer Profiles 了。
# 导出统一的客户配置文件数据
Amazon Connect 客户档案可将统一的客户档案实时数据导出到 Amazon Kinesis 数据流。您可以启用数据流式处理，并自动将新资料和现有资料更新的数据接收到 Amazon Kinesis Data Streams 中。
您可以使用 Amazon Connect 客户档案中的最新信息保留源系统数据 up-to-date，例如 CRMs 营销自动化工具。例如，当客户呼叫您的联系中心以更新其地址时，座席可以进行更改以添加新的客户地址，并将更新的资料信息实时发送到 Kinesis Data Streams。
要进行此设置，您需要在 Customer Profiles 控制台中启用**数据导出**。
## 启用实时导出
**为您的域启用数据流式处理**
1. 打开 Amazon Connect 客户资料控制台。
1. 选择**数据导出**选项卡，然后选择**启用数据流式处理**
![\[实时数据导出可启用 Kinesis 数据流。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-real-time-export-1.png)
1. 选择**启用数据流式处理**并从下拉菜单中选择现有的 Kinesis 数据流，或者选择**创建新的 Kinesis 数据流**以打开 Kinesis 控制台并创建流。有关更多信息，请参阅[创建和管理流](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html)。
![\[实时数据导出可启用 Kinesis 数据流。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-real-time-export-2.png)
1. 选择**启用数据流式处理**按钮以保存您的设置。
## 禁用实时导出
**为您的域禁用数据流式处理**
1. 打开 Amazon Connect 客户资料控制台。
1. 选择**数据导出**选项卡，然后选择**禁用数据流式处理**。
![\[实时数据导出可禁用 Kinesis 数据流。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/disable-real-time-export-1.png)
## 实时导出 Kinesis 有效负载
**JSON 格式的示例输出事件**
```
{
"SchemaVersion": 0,
"EventId": "eventId",
"EventTimestamp": "2020-01-01T00:00:00Z",
"EventType": "CREATED",
"DomainName": "domainName",
"ObjectTypeName": "objectTypeName",
"AssociatedProfileId": "associatedProfileId",
"ProfileObjectUniqueKey": "profileObjectUniqueKey",
"Object": {
"map": {
"k1": [
"a",
"b",
"c"
]
}
},
"IsMessageRealTime": true
}
```
**SchemaVersion**
架构的当前版本。
**EventId**
唯一的事件 ID。
**EventTimestamp**
使用 ISO8601 标准的事件时间戳。
**EventType**
导出的事件类型。
值：CREATED、UPDATED、HEALTH\$1CHECK
+ 已创建：导出事件是为了 CreateProfile。
+ 更新:导出事件是为了 UpdateProfile.
+ HEALTH\$1CHECK：导出 HealthCheck 活动旨在确保客户资料能够成功在 `putEvent` Kinesis Stream 中进行活动。
**DomainName**
事件所属的域。事件的 `/Domain`
**ObjectTypeName**
事件的对象类型
值：`_profile`、`_asset`、`_order`、`_case`。您也可以使用预定义的模板名称，例如`Salesforce-Account`或使用 [ PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API 创建的自定义对象名称。
**AssociatedProfileId**
与相应对象关联的标准资料的 ID。仅当对象类型不是 `_profile` 时，它才会出现
**ProfileObjectUniqueKey**
服务 ProfileObject 生成的唯一标识符。
类型：字符串
**Object**
标准资料或标准资料对象本身。
**IsMessageRealTime**
用于通知消息是实时消息还是已重启的标志。
**JSON 格式的示例有效负载**
```
{
"SchemaVersion": 0,
"EventId": "6049bf39-0000-0000-0000-b75656dd51a8",
"EventTimestamp": "2023-02-24T07:17:05.356Z",
"EventType": "UPDATED",
"DomainName": "SampleDomain",
"ObjectTypeName": "Salesforce-Account",
"AssociatedProfileId": "5ffcee99ab0000000000b3ae01225e40",
"ProfileObjectUniqueKey": "cNo77ZI0000000000pCPB7RQcqfeBaRfBwrzW2MMbws=",
"Object": {
"Id": "0012v00002kVKVuAAO",
"IsDeleted": false,
"Name": "Company A",
"Phone": "+12065551234",
"PhotoUrl": "/services/images/photo/0012v00002kVKVuAAO",
"OwnerId": "0052v00000fmQ7sAAE",
"CreatedDate": "2019-12-13T07:56:04.000+0000",
"CreatedById": "0052v00000fmQ7sAAE",
"LastModifiedDate": "2023-02-22T20:29:43.000+0000",
"LastModifiedById": "0052v00000fmQ7sAAE",
"SystemModstamp": "2023-02-22T20:29:43.000+0000",
"LastActivityDate": "2020-03-18",
"LastViewedDate": "2023-02-23T00:09:49.000+0000",
"LastReferencedDate": "2023-02-23T00:09:49.000+0000",
"CleanStatus": "Pending"
},
"IsMessageRealTime": true
}
```
# 解决将实时事件导出到 Kinesis 数据流的问题
首次将事件导出到 Kinesis 数据流时可能会出现延迟。这是因为为服务相关角色传播 IAM 权限需要很长时间。当发生实际问题时，流状态会进入错误状态。
![\[事件无法到达目标 Kinesis 数据流，进入错误状态。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/real-time-export-troubleshooting.png)
以下各节显示了您可能会遇到的错误消息。它还提供了每个问题的原因和解决方案。
## 错误：Kinesis 数据流未处于活动状态。请检查配置并稍后重新创建事件流
目标 Kinesis 数据流未处于 `ACTIVE` 状态。在创建或删除您的 Kinesis 数据流时，可能会发生这种情况。要解决此错误，请确保您的 Kinesis 数据流处于 ACTIVE 状态，然后重新启用数据流式处理设置。
## 错误：Kinesis 数据流不存在。请使用有效的 Kinesis 数据流目标重新创建事件流
目标 Kinesis 数据流将被删除。要解决此错误，请使用现有 Kinesis 数据流作为目标重新启用数据流式处理。
## 错误：Kinesis 数据流受限制。请考虑适当预置更高的 Kinesis 吞吐量
目标 Kinesis 数据流受限制（预置不足）。要解决此错误，请确保目标 Kinesis 数据流有足够的分片计数，然后重新启用数据流式处理。
## 错误：用于加密 Kinesis 数据流的 KMS 密钥受限制。请考虑适当增加 KMS 请求限额
由 Kinesis 数据流使用的 KMS 密钥受限制。要解决此错误，请重新启用数据流式处理。
## 错误：检查您的 Kinesis 数据流的 KMS 密钥配置
Customer Profiles 无法访问由 Kinesis 数据流使用的 KMS 密钥。当您的 KMS 密钥具有拒绝来自 Customer Profiles 服务相关角色的访问的密钥政策，或者密钥未处于“已启用”状态时，可能会发生这种情况。要解决此错误，请确保 KMS 密钥政策不会拒绝来自 Customer Profiles 服务相关角色的访问，并且密钥处于“已启用”状态。要解决此错误，请重新启用数据流式处理。
# 设置批量导出所有统一的客户配置文件数据
**注意**
要完成本主题中的步骤，您需要具备开发人员技能，并具备使用 AWS KMS Amazon S3 的经验。
当 Amazon Connect Customer Profiles 创建统一的客户配置文件时，它会通过合并来自第一方和第三方的数据，增强、完善和改进原始数据和信息，使其成为更准确的配置文件。Customer Profiles 还通过添加新数据来提高数据集的质量。您可以将改进后的数据集用于其他使用场景，例如制定更明智、更有针对性的营销、销售和客户服务策略。例如，您可能希望利用统一的客户配置文件来：
+ 审查您在整个域中拥有的客户数据。
+ 例如，对销售和营销报告执行内部分析。
+ 将数据导出到您自己的工具或第三方产品中，以个性化广告和目标客户。
要将统一客户配置文件数据用于其他使用场景，您可以将其批量导出到 Amazon S3。本主题将介绍如何操作。
**Topics**
+ [步骤 1：设置 KMS 密钥和 S3 存储桶](#enable-cpbulk-export)
+ [步骤 2：创建批量导出作业](#create-bulk-export-job)
+ [步骤 3：检查批量导出作业的状态](#check-status-bulk-cp-export)
+ [第 4 步：在 S3 中查看导出的数据](#view-bulk-cp-export)
+ [更新批量导出作业](#update-bulk-cp-export)
+ [删除或取消批量导出任务：不支持](#delete-bulk-cp-export)
## 步骤 1：设置 KMS 密钥和 S3 存储桶
要启用域的批量导出，您需要设置以下资源：
+ [具有特定资源策略的 KMS 密钥](#cp-kms)
+ [具有特定资源策略的目标 S3 存储桶](#cp-s3-bulk)。请勿在存储桶上配置[访问控制列表 (ACLs)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acls.html)。
接下来将解释这些步骤。
### 创建新的 KMS 密钥或重复使用现有的 KMS 密钥
要设置用于批量导出的 KMS 密钥，您必须创建或重复使用现有 KMS 密钥，该密钥与您计划配置为批量导出目标的 Amazon S3 存储桶位于同一 AWS 区域。您必须允许 Amazon Connect AppIntegrations 服务对密钥执行 KMS 操作。
将以下语句添加到**密钥政策**中。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Enable AppIntegrations access to KMS key",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:iam::111122223333:root"
],
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"kms:Encrypt*",
"kms:Describe*",
"kms:Decrypt*",
"kms:GenerateDataKey*"
],
"Resource": "*"
}
]
}
```
------
### 设置 S3 目标存储桶
您必须在与 KMS 密钥相同的 AWS 区域中配置新的或现有存储桶，并在 S3 存储桶上配置资源策略。
配置存储桶时，确保选择 **SSE-KMS 加密**，并使用与上一步骤相同的 KMS 密钥。此外，请勿在 S3 存储桶 ACLs 上启用。
以下是一个资源策略的示例。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Allow AppIntegrations to write data to destination bucket",
"Effect": "Allow",
"Principal": {
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"s3:GetObject",
"s3:ListBucket",
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": [
"arn:aws:s3:::{{amzn-s3-demo-bucket1}}",
"arn:aws:s3:::{{amzn-s3-demo-bucket2}}/*"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{AwsAccountId}}"
},
"ArnEquals": {
"aws:SourceArn": "arn:aws:*-*:{us-east-1}:{{AwsAccountId}}:data-integration/*"
}
}
}
]
}
```
------
## 步骤 2：创建批量导出作业
要创建批量导出任务，您需要调用以下 Amazon Connect AppIntegrations APIs：
1. [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)：此 API 创建了与数据源（例如，客户档案）的集成。
1. [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)：此 API 使用数据源将数据写入目标（例如 S3 存储桶）。
以下是有关如何调用它们的更多信息 APIs。
### 创建数据集成
数据集成代表您的数据的*数据来源*。您可以调用 [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API 或运行 [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI 命令来创建数据集成。您必须提供 Customer Profiles *对象类型*和 Customer Profiles *域*。
如果您要导出多个对象类型，则需要为每个类型创建一个单独的数据集成。例如，如果您要同时导出两个 `_profile` 对象和 `_asset` 对象，则需要创建两个单独的数据集成。
**注意**
导出时可能不包括在最近 30 分钟内摄取的任何数据。
以下代码示例显示了如何运行 [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI 命令。
```
aws appintegrations create-data-integration \
--region "us-west-2" \
--name "bulk-export-job-01" \
--description "Data integration for _profile objects" \
--kms-key "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012" \
--source-uri "AmazonConnect://AppIntegrations" \
--object-configuration '{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}'
```
以下代码示例显示了如何调用 [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API。
```
{
"Description": "Data integration for _profile objects",
"KmsKey": "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012",
"Name": "unique-data-integration-name-01",
"SourceURI": "AmazonConnect://AppIntegrations",
"ObjectConfiguration": {
"CustomerProfiles": {
"domainName": [
"my-domain-pdx"
],
"objectType": [
"_profile"
]
}
}
}
```
### 创建数据集成关联
数据集成关联表示您要导出数据的目的地，以及选择要导出的数据的时间范围。您可以调用 [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API 或运行 [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI 命令来创建数据集成。您可以使用 `StartTime` 和 `EndTime` 属性配置时间范围。此时间范围与 Customer Profiles 中对象的最后更新时间一致。
您指定的目标 S3 存储桶可以只是存储桶的名称，也可以包括您要导出数据的其他文件夹或 S3 前缀。
**注意**
有关**合并批量导出作业**的配额，请参阅 [Amazon Connect 客户档案服务配额](amazon-connect-service-limits.md#customer-profiles-quotas)。批量导出作业完成或失败后，不再计入合并配额。
以下代码示例显示了如何运行 [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI 命令。
```
aws appintegrations create-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--destination-uri "s3://amzn-s3-demo-bucket1" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
```
以下代码示例显示了如何调用 [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API。
```
{
"DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012",
"DestinationURI": "s3://amzn-s3-demo-bucket1",
"ExecutionConfiguration": {
"ExecutionMode": "ON_DEMAND",
"OnDemandConfiguration": {
"StartTime": "1713565000004",
"EndTime": "1713565000005"
}
}
}
```
## 步骤 3：检查批量导出作业的状态
要查看批量导出任务的状态，您可以调用 [ListDataIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_ListDataIntegrationAssociations.html)API 或运行 [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI 命令。
以下代码示例显示了如何运行 [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI 命令。
```
aws appintegrations list-data-integration-associations \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01"
```
## 第 4 步：在 S3 中查看导出的数据
当数据集成关联处于 `IN_PROGRESS` 状态时，您将开始看到数据被复制到您的 S3 存储桶。
导出的数据使用以下路径结构写入：
+ \$1BucketNameAndFolderName\$1
+ \$1AwsAccountId\$1
+ \$1DomainName\$1
+ \$1RequestTimestamp\$1
+ \$1lStartTime\$1-\$1EndTime\$1
+ \$1ObjectTypeName\$1
+
以下是一个路径示例：
`amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012`
## 更新批量导出作业
作业完成后，您可以使用不同的数据摄取开始时间和数据摄取结束时间更新数据集成关联。这样就创建了一个新的批量导出作业。如果您过去执行过批量导出，并且只想导出上次导出后更新的数据，则可能需要这样做。例如，如果您上一次批量导出作业是在三个月前，则可以将数据集成关联更新为 3 个月前到今天的时间范围。
您可以调用 [UpdateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_UpdateDataIntegrationAssociation.html)API 或运行 [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI 命令来更新导出作业。
以下代码示例显示了如何运行 [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI 命令。
```
aws appintegrations update-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--data-integration-association-identifier "arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
```
## 删除或取消批量导出任务：不支持
您无法删除或取消批量导出。导出作业完成后，将不再计入导出配额。
# 删除 Amazon Connect Customer Profiles 域
删除映射只会删除与该特定映射相关联的对象和数据。如果有多个对象与一个资料相关联，则删除特定的映射可能无法清除资料数据。如果要删除特定数据，则需要删除相应的映射，但是如果您的资料包含来自其他映射的数据，则这些资料可能仍将存在。这样可能会导致针对现有资料产生额外费用。为避免发生这种情况，您可以按照以下步骤使用 Amazon Connect 控制台删除您的 Customer Profiles 域。
1. 登录 Amazon Connect 控制台并从左侧导航窗格中选择 “客户档案”。选择您的 Customer Profiles 域，然后选择**查看详细信息**。
![\[Amazon Connect Customer Profiles 删除域页面，“查看详细信息”域按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/delete-customer-profiles-domain-step1.png)
1. 选择**删除域**。
![\[Amazon Connect Customer Profiles 删除域页面，“删除域”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/delete-customer-profiles-domain-step2.png)
1. 要删除您的域，请在框中输入*确认*，然后选择**删除域**。
![\[Amazon Connect Customer Profiles 删除域页面，手动输入确认后“删除域”确认按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/delete-customer-profiles-domain-step3.png)
# 在 Amazon Connect Customer Profiles 中设置计算的属性
*计算的属性*是使用公式从其它属性派生的值。您可以使用它们来识别用户的聚合行为。
您可以创建计算的属性来定义自己的业务逻辑，以便将客户配置文件数据转化为可操作的数据点。这使您能够个性化自动体验，例如交互式语音回复。
通过使用计算的属性，您可以识别有关客户过去行为的关键属性。例如：
+ 上次访问的网站或上次与之通话的座席
+ 行为模式，例如首选渠道和联络频率
+ 客户价值，如新客户和平均票务规模
您可以使用计算的属性 API，利用常见的聚合操作（例如平均值、计数、最小值、最大值以及总和）来创建新属性。
计算的属性会自动将原始数据实时转换为可操作的数据点和指标。联系中心管理员能够根据客户资料中可用的原始数据定义和配置计算。这些计算的属性使您可以更轻松地构建自动化体验，例如交互式语音响应 (IVR) 或聊天机器人。您可以构建个性化体验，帮助座席更快地了解客户背景。
有关可使用计算属 APIs 性的 AWS 区域列表，请参阅[按区域显示的 Customer Profiles 计算的属性 API 可用性](regions.md#customerprofiles_calculatedattributesregion)。
**Topics**
+ [计算的属性入门](customerprofiles-calculated-attributes-admin-website.md)
+ [已计算的属性 APIs](customerprofiles-calculated-attributes-apis.md)
+ [创建自定义计算的属性定义](customerprofiles-calculated-attributes-creating-definition.md)
+ [验证计算的属性值](customerprofiles-calculated-attributes-validating-values.md)
+ [默认计算的属性](customerprofiles-default-calculated-attributes.md)
+ [错误消息和解决方案](customerprofiles-calculated-attributes-troubleshooting.md)
# 开始使用 Amazon Connect 客户资料中的计算属性
使用计算的属性来定义自己的业务逻辑，以便将客户配置文件数据转化为可操作的数据点，从而实现交互式语音回复等自动化体验的个性化。
通过使用 Calculated Attributes，您可以识别有关客户过去行为、行为模式和客户价值的密钥属性。
本节的主题将向您介绍如何创建、查看、编辑和删除 Calculated Attributes。
**Topics**
+ [创建计算的属性](calculated-attributes-admin-website-create.md)
+ [设置事件筛选条件](calculated-attributes-admin-website-event-filters.md)
+ [查看计算的属性](calculated-attributes-admin-website-view.md)
+ [编辑计算的属性](calculated-attributes-admin-website-edit.md)
+ [删除计算的属性](calculated-attributes-admin-website-delete.md)
# 在 Amazon Connect 中创建计算的属性
1. 先决条件：确保您拥有必要的安全配置文件权限。有关更多信息，请参阅 [更新 Amazon Connect Customer Profiles 中计算的属性的权限](security-profile-customer-profile-calc-attribs.md)。
1. 在 Amazon Connect 管理网站中，导航到 “**客户资料**”、“**计算的属性”**，然后在 “**计算的属性**” 表格视图中选择 “创建**属性”**。
![\[座席工作区中的“客户配置文件”选项卡，“关联”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-create-1.png)
1. 要创建计算的属性，请指定描述性名称，添加描述（可选）以及有关属性的详细信息，并配置必填字段：
+ **计算：**定义属性的计算方式（average/count/sum/minimum/first occurrence/last occurrence/max出现次数）。
+ **属性：**您的客户配置文件数据中的一个数据点。
**注意**
如果要从标准对象类型 (`_asset`、、`_order`) 中选择一个属性`_case`，则这些属性必须位于 PascalCase。这意味着属性名称中每个单词的首字母都要大写，例如 `_case.CreatedBy` 或 `_order.TotalPrice`。
![\[座席工作区中的“客户配置文件”选项卡，“关联”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-create-2.png)
1. 此外，您可以通过选择*加号*图标来添加其他属性。您最多可以选择两个属性来进行计算，并通过运算符组合它们。指定*加号*或*减号*等运算符来组合属性值。
![\[座席工作区中的“客户配置文件”选项卡，“关联”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-create-3.png)
1. 选择计算后，您可以选择配置事件数量、时间段和源时间戳。默认情况下，计算的属性配置为使用无限制事件、无限制时间段和基于摄取日期的时间戳。
当在指定的时间段内至少有一个事件时，将返回输出。
+ **事件数量：**配置限制或使用无限制（默认）
+ **时间段：**设置特定的时间范围或使用无限制（默认）
+ **源时间戳：**在特定的时间戳字段或摄取日期（默认）之间进行选择
**注意**
虽然没有事件限制，但存在数据大小限制，即最旧的数据将被较新的数据所取代。源时间戳一经创建，便无法更改。
![\[座席工作区中的“客户配置文件”选项卡，“关联”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-create-4.png)
1. 或者，您可以定义标准，以便在计算中仅包括相关的事件。请参阅[设置事件筛选条件](calculated-attributes-admin-website-event-filters.md)了解更多信息。
1. 选择**创建**以创建计算的属性。
1. 在成功创建计算的属性后，表视图上将显示一个横幅，指示可在客户细分或流中使用计算的属性。还可以根据就绪情况查看计算的属性的状态。
![\[指示已创建了计算的属性的横幅。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-create-5.png)
# 设置事件筛选条件
事件筛选条件可让您筛选要在计算的属性中使用的配置文件对象。例如，事件筛选条件可以筛选客户的标准资产对象，这样计算中只包括**状态为已安装或已注册**的资产。
**注意**
创建计算的属性定义后，您无法编辑事件筛选条件。
当您创建计算的属性时，您可以创建一个或多个事件筛选条件。事件筛选条件包含以下组成部分：
![\[事件筛选条件组件。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-event-filters-1.png)
+ **筛选条件组**：应用于配置文件对象的一组筛选条件。您可以添加多个通过 OR 关系连接的筛选条件组。
+ **筛选条件**：通过指定属性、运算符和值，筛选计算的属性计算中包含的配置文件对象。您可以根据使用案例的需要添加任意数量的筛选条件。
+ **属性**：对象的要作为筛选依据的属性。您可以从存储在 Customer Profiles 域中的对象中选择属性，也可以使用在对象类型定义中定义的字段名称。有关对象类型映射的更多信息，请参阅 [Amazon Connect Customer Profiles 中的对象类型映射定义详细信息](object-type-mapping-definition-details.md)。
**注意**
在 Amazon Connect 管理网站中，属性下拉列表显示上次使用该属性保存或更新任何配置文件对象的时间戳。
如果同时存在配置文件对象的属性和同名的对象类型字段，则事件筛选条件会在其筛选中优先考虑对象类型字段名称。例如，如果配置文件对象具有名为**状态**的属性，并且还有一个名为**状态**的对象类型字段，则筛选条件将使用对象类型字段**状态**进行筛选。
+ **运算符**：运算符决定属性与您输入的值的关系。有关更多信息，请参阅[筛选条件运算符](#calculated-attributes-admin-website-event-filter-operators)。
+ **值**：用于筛选对象的值。您可以指定通过 OR 关系连接的多个值。例如，*资产的状态为已安装 OR 已注册*。请注意，值区分大小写。例如，*Asset's Status is Installed* 返回的结果与 *Asset's Status is installed* 返回的结果不同。要查看个人资料对象，请使用 Amazon Connect 客户档案 [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API。
您可以选择创建最多两个事件过滤器，并在它们之间创建关系 (AND/OR/EXCLUDE)。 有关关系的更多详细信息，请参阅[事件筛选条件之间的关系](#calculated-attributes-admin-website-relationship-between-event-filters)。
## 筛选条件运算符
运算符决定属性与您输入的值的关系。下表描述了可用的运算符。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/calculated-attributes-admin-website-event-filters.html)
**注意**
Amazon Connect 管理网站中的计算属性使用 UTC 时区，对于所有基于时间的过滤器，默认时间为 00:00:00 UTC。 您可以按日期进行筛选，但时间会记录为相同的值。如果您输入的日期为 2024-01-01，则控制台将时间传递为 2024-01-01T00:00:00Z。
**注意**
默认情况下，保存或更新配置文件对象时会评估事件筛选条件。例如，如果您筛选 `PurchaseDate` 在最后一周内的标准资产对象，则计算的相对时间为*自保存或更新资产对象时起的最后一周内*。这意味着筛选结果可能会有所不同，具体取决于保存或更新对象的时间。
## 事件筛选条件之间的关系
或者，您可以添加第二个事件筛选条件，并定义与第一个事件筛选条件的关系。在 Amazon Connect 管理员网站中创建计算的属性时，对于每个计算的属性，最多可以有两个事件筛选条件。如果将第二个事件筛选条件添加到计算的属性中，则可以选择以下两种方式之一来指定连接两个事件筛选条件的方式：
+ **AND 关系**：如果使用 AND 关系来连接两个事件筛选条件，则计算中将包括同时满足第一个和第二个事件筛选条件的对象。
+ **OR 关系**：如果使用 OR 关系来连接两个事件筛选条件，则计算中将包括满足第一个或第二个事件筛选条件的对象。
+ **EXCLUDE 关系**：如果使用 EXCLUDE 关系来连接两个事件筛选条件，则计算中将包括符合第一个事件筛选条件但不符合第二个事件筛选条件的对象。
## 后续步骤
+ [通过流编辑器在联络中心使用计算的属性](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-block.html#customer-profiles-block-properties-get-calculated-attributes)
+ [使用计算的属性定义客户细分](https://docs.aws.amazon.com/connect/latest/adminguide/segmentation-admin-website)
+ [在 Amazon Connect 中查看计算出的属性](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-view.html)
+ [在 Amazon Connect 中编辑计算属性](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-edit.html)
+ [删除 Amazon Connect 中的计算属性](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-delete.html)
# 在 Amazon Connect 中查看计算的属性
1. 登录 Amazon Connect 管理员网站 https://*instance name*.my.connect.aws/。使用管理员账户，或分配给安全配置文件且具有 **Customer Profiles - 计算的属性**权限的账户。
1. 在 Amazon Connect 的左侧导航窗格中，依次选择 **Customer Profiles**、**计算的属性**。
1. 在**计算的属性**页面上，从表的**名称**列中选择一个计算的属性。
下图显示了**名称**列中列出的计算的属性的示例。
![\[列出计算的属性的表。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-view-1.png)
1. 您现在可以查看所选属性的详细信息。下图显示了一个计算的属性的详细信息页面。
![\[计算的属性的详细信息视图。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-view-2.png)
# 在 Amazon Connect 中编辑计算的属性
1. 要编辑计算的属性，请在表格视图中选择一个属性，然后选择单选按钮，这将启用**编辑**按钮。选择**编辑**。
![\[编辑计算的属性\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-1.png)
1. 您可以编辑**描述**、**事件数量**和**时间段**。完成后，选择**保存**。
![\[编辑计算的属性。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-2.png)
# 在 Amazon Connect 中删除计算的属性
1. 要删除计算的属性，请选择表格中要删除的属性旁边的单选按钮。
1. 选择后，选择**删除**。
1. 在**删除属性**弹出窗口中，验证详细信息并输入*确认*以启用**删除**按钮。
![\[删除计算的属性。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/calculated-attributes-admin-website-delete-1.png)
1. 选择**删除**。
# Amazon Connect 客户档案计算出的属性 APIs
您可以使用以下 “客户档案” 计算属性 APIs
------
#### [ CreateCalculatedAttributeDefinition ]
**CreateCalculatedAttributeDefinition**
创建新的计算的属性。这需要域中现有的对象类型。您可以定义要从单个源对象中提取的属性和要整体应用于这些属性的数学运算，以及时间范围和对象计数。
创建后，摄取到 Customer Profiles 中的新对象数据将包含在计算的属性中，可以使用 `GetCalculatedAttributeForProfile` API 针对资料对其进行检索。要同时使用历史数据，请将 `UseHistoricalData` 指定为 true。API 回复中的 `Readiness` 和 `Status` 字段将提供有关在计算的属性中包含历史数据的状态的信息。
定义计算的属性后，该属性可用于域内的所有资料。每个计算属性只能引用其中一个 ObjectType 且最多两个字段 ObjectType。
**请求**
```
POST /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"Tags": {}
}
```
**响应**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**请求正文**
+ **CalculatedAttributeName**
计算的属性的唯一（每个域）名称。
+ 类型：字符串
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z0-9_-]+$`
+ 是否必需：是
+ **DisplayName**
计算的属性的显示名称。
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
+ 必需：否
+ **描述**
计算的属性的描述。
+ 类型：字符串
+ 长度限制：最小长度为 1。最大长度为 1000。
+ 必需：否
+ **UseHistoricalData**
计算中是否应包括在创建计算的属性之前摄取的历史数据。
+ 类型：布尔值
+ 必需：否
+ **AttributeDetails**
定义中使用的属性的详细信息以及不同属性之间涉及的数学运算。请参阅以下组件：
+ **Attributes**
在数学表达式中指定的属性项目列表。
+ **AttributeItem**
在数学表达式中指定的单个属性项目的详细信息。
+ Name
+ 资料对象类型中定义的属性的名称。
+ 类型：字符串
+ **Expression**
对属性列表中提供的属性项目执行的数学表达式。表达式中的每个元素都应遵循\$1 “\$1的结构ObjectTypeName。 AttributeName\$1\$1”。
+ 示例：`{ObjA.AttributeA} - {ObjA.AttributeB}`
+ 类型：字符串
+ 我们只支持以下数学运算：`+ - * /`
+ 一旦创建了计算的属性定义，就无法对表达式进行修改
+ **Conditions**
定义计算的属性聚合标准和阈值。
+ 类型：条件对象
+ Range
+ ObjectCount
+ Threshold
+ **Range**
数据包含在聚合中的相对时间段。
+ 类型：范围对象
+ Value：指定单位的时间长度。`ValueRange` 会覆盖 Value。
+ 类型：整数
+ 必需：否
+ ValueRange：一种结构，允许客户指定相对时间窗口，计算属性中包含该时间范围内的数据。使用正数表示终点在过去，使用负数表示它在未来。 ValueRange覆盖值。
+ 类型： ValueRange
+ 必需：否
+ 晚于
+ 包含对象时的开始时间。使用正数表示起点在过去，使用负数表示起点在将来。
+ 类型：整数
+ 是否必需：是
+ 早于
+ 包含对象时的结束时间。使用正数表示起点在过去，使用负数表示起点在将来。
+ 类型：整数
+ 是否必需：是
+ TimestampSource：一个表达式，用于指定 JSON 对象中应从中解析日期的字段。表达式应遵循\$1 “\$1的结构ObjectTypeName。 \$1\$1”。例如，如果您的对象类型为 MyType ，源 JSON 为`{"generatedAt": {"timestamp": "1737587945945"}}`，则 TimestampSource应为`"{MyType.generatedAt.timestamp}"`。
+ 长度约束：最小长度为 1。最大长度为 255。
+ 必需：否
+ TimestampFormat：指定您的 JSON 对象中时间戳字段的格式。此值应为 EPOCHMILLI（适用于具有 second/millisecond 等级精度的 Unix 纪元时间戳）或 ISO\$18601（遵循 ISO\$18601 格式，级别精度，可选偏移量为 Z 或者格式为 HH: MM 或 HHMM。）。 second/millisecond 例如，如果你的对象类型是， MyType而源 JSON 是`{"generatedAt": {"timestamp": "2001-07-04T12:08:56.235-0700"}},`，那么 TimestampFormat 应该是`"ISO_8601"`。
+ 单位：时间单位
+ 有效值：天
+ 是否必需：是
+ 是否必需：是
+ 初始范围：最长 366 天
+ **ObjectCount**
用于计算的属性的资料对象的数量。
+ 类型：数字
+ 范围：1 到 100
+ 必需：否
+ **Threshold**
生成 true/false 计算属性的比较逻辑。
+ 类型：阈值对象
+ Value
+ 阈值的值
+ 类型：字符串
+ 必需：否
+ Operator
+ 阈值的运算符
+ 类型：ENUM
+ 有效值：
+ GREATER\$1THAN
+ LESS\$1THAN
+ EQUAL\$1TO
+ NOT\$1EQUAL\$1TO
+ 必需：否
+ **Statistic**
要对计算的属性执行的聚合操作。
+ 类型：ENUM
+ 有效值：
+ FIRST\$1OCCURRENCE
+ LAST\$1OCCURRENCE
+ COUNT
+ SUM
+ MINIMUM
+ MAXIMUM
+ AVERAGE
+ MAX\$1OCCURRENCE
------
#### [ UpdateCalculatedAttributeDefinition ]
**UpdateCalculatedAttributeDefinition**
更新计算的属性定义。更新仅限于显示名称、描述、时间范围、对象计数和阈值。此 API 支持部分更新，因此只需要包含需要更新的参数。
**注意**
更新条件时：
增加计算的属性的日期范围不会触发包含大于当前日期范围的历史数据。
TimestampSource 并且在创建计算的属性定义后 TimestampFormat 无法更新。
**请求**
```
PUT /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
```
{
"DisplayName": "string",
"Description": "string",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
}
}
```
**响应**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**请求正文**
+ **DisplayName**
计算的属性的显示名称。
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
+ 必需：否
+ **描述**
计算的属性的描述。
+ 类型：字符串
+ 长度限制：最小长度为 1。最大长度为 1000。
+ 必需：否
+ **Conditions**
定义计算的属性聚合标准和阈值。
+ 类型：条件对象
+ Range
+ ObjectCount
+ Threshold
+ **Range**
数据包含在聚合中的相对时间段。
+ 类型：范围对象
+ 值：指定单位的时间长度
+ 类型：整数
+ 必需：否
+ ValueRange：一种结构，允许客户指定相对时间窗口，计算属性中包含该时间范围内的数据。使用正数表示终点在过去，使用负数表示它在未来。 ValueRange覆盖值。
+ 类型： ValueRange
+ 必需：否
+ 晚于
+ 包含对象时的开始时间。使用正数表示起点在过去，使用负数表示起点在将来。
+ 类型：整数
+ 是否必需：是
+ 早于
+ 包含对象时的结束时间。使用正数表示起点在过去，使用负数表示起点在将来。
+ 类型：整数
+ 是否必需：是
+ 单位：时间单位
+ 有效值：天
+ 是否必需：是
+ 是否必需：是
+ 初始范围：最长 366 天
+ **ObjectCount**
用于计算的属性的资料对象的数量。
+ 类型：数字
+ 范围：1 到 100
+ 必需：否
+ **Threshold**
生成 true/false 计算属性的比较逻辑。
+ 类型：阈值对象
+ Value
+ 阈值的值
+ 类型：字符串
+ 必需：否
+ Operator
+ 阈值的运算符
+ 类型：ENUM
+ 有效值：
+ GREATER\$1THAN
+ LESS\$1THAN
+ EQUAL\$1TO
+ NOT\$1EQUAL\$1TO
+ 必需：否
------
#### [ GetCalculatedAttributeDefinition ]
**GetCalculatedAttributeDefinition**
检索计算的属性定义。
**请求**
```
GET /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
**请求正文**
```
The request does not have a request body.
```
**响应**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Unit": "string",
"Value": number
"ValueRange"
{
"Start": number
"End": number
},
"TimestampFormat": "string",
"TimestampSource": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"UseHistoricalData" boolean,
"Status": "PREPARING" | "IN_PROGRESS" | "COMPLETED" | "FAILED",
"Readiness": {
"ProgressPercentage": number,
"Message": "string",
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**URI 请求参数**
+ **DomainName**
域的唯一名称。
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z0-9_-]+$`
+ 是否必需：是
+ **CalculatedAttributeName**
计算的属性的唯一（每个域）名称。
+ 类型：字符串
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z0-9_-]+$`
+ 是否必需：是
------
#### [ DeleteCalculatedAttributeDefinition ]
**DeleteCalculatedAttributeDefinition**
删除现有的计算的属性定义。请注意，可以删除默认计算的属性，但是一旦删除，您将无法撤消该操作，如果您想恢复该属性，则需要使用 `CreateCalculatedAttributeDefinition` API 自行重新创建该属性。
**请求**
```
DELETE /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
**请求正文**
```
The request does not have a request body.
```
**响应**
```
The response does not have a response body.
```
**URI 请求参数**
+ **DomainName**
域的唯一名称。
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z0-9_-]+$`
+ 是否必需：是
+ **CalculatedAttributeName**
计算的属性的唯一（每个域）名称。
+ 类型：字符串
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z0-9_-]+$`
+ 是否必需：是
------
#### [ ListCalculatedAttributeDefinitions ]
**ListCalculatedAttributeDefinitions**
检索域的所有计算的属性定义。
**请求**
```
GET /domains/DomainName/calculated-attributes?max-results=MaxResults&next-token=NextToken
```
**请求正文**
```
The request does not have a request body.
```
**响应**
```
{
"Items": [
{
"UseHistoricalData": boolean,
"ReadinessStatus": PREPARING | IN_PROGRESS | COMPLETED | FAILED,
"CalculatedAttributeName": "string",
"CreatedAt": number,
"Description": "string",
"DisplayName": "string",
"LastUpdatedAt": number,
"Tags": {
"string" : "string"
}
}
],
"NextToken": "string"
}
```
**URI 请求参数**
+ **DomainName**
域的唯一名称。
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z0-9_-]+$`
+ 是否必需：是
+ **MaxResults**
每页返回的对象的最大数量。
+ 有效范围：最小值为 1。最大值为 100
+ **NextToken**
上一次 ListCalculatedAttributeDefinition API 调用的分页令牌。
+ 长度限制：最小长度为 1。最大长度为 1024
------
#### [ GetCalculatedAttributeForProfile ]
**GetCalculatedAttributeForProfile**
启动计算并检索单个资料的单个计算的属性的结果。
**请求**
```
GET /domains/DomainName/profile/ProfileId/calculated-attributes/CalculatedAttributeName
```
**请求正文**
```
The request does not have a request body.
```
**响应**
```
{
"Name": "string",
"DisplayName": "string",
"Value": "string",
"IsDataPartial": "string",
"LastObjectTimestamp" : number
}
```
**URI 请求参数**
+ **DomainName**
域的唯一名称。
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z0-9_-]+$`
+ 是否必需：是
+ **CalculatedAttributeName**
计算的属性的唯一（每个域）名称。
+ 类型：字符串
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z0-9_-]+$`
+ 是否必需：是
------
#### [ ListCalculatedAttributesForProfile ]
**ListCalculatedAttributesForProfile**
启动计算并检索单个资料的所有计算的属性的结果。
**请求**
```
GET /domains/DomainName/profile/ProfileId/calculated-attributes?max-results=MaxResults&next-token=NextToken
```
**请求正文**
```
The request does not have a request body.
```
**响应**
```
{
"Items": [
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Value": "string",
"IsDataPartial" : "string",
"LastObjectTimestamp" : number
},
...
],
"NextToken": "string"
}
```
**URI 请求参数**
+ **DomainName**
域的唯一名称。
+ 长度限制：最小长度为 1。长度上限为 64。
+ 模式：`^[a-zA-Z0-9_-]+$`
+ 是否必需：是
+ **ProfileId**
+ 模式：`[a-f0-9]{32}`
+ 是否必需：是
+ **MaxResults**
每页返回的对象的最大数量。
+ 有效范围：最小值为 1。最大值为 100
+ **NextToken**
上一次 ListCalculatedAttributeDefinition API 调用的分页令牌。
+ 长度限制：最小长度为 1。最大长度为 1024
------
# 创建自定义 Amazon Connect Customer Profiles 计算的属性定义
使用客户配置文件 [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html)API，您可以根据自定义对象类型以编程方式创建自己的计算属性。
在本主题中，我们将演示如何使用自定义 JSON 文件创建计算的属性。
## 步骤 1：创建 JSON 文件
使用以下内容创建 JSON 文件：
```
{
"DomainName": "your-domain-name",
"CalculatedAttributeName": "your-calculated-attribute-name",
"UseHistoricalData": true,
"DisplayName": "your-display-name",
"Description": "your-description",
"AttributeDetails": {
"Attributes": [
{
"Name": "your-attribute-name"
}
],
"Expression": "{your-object-type.your-attribute-name}"
},
"Statistic": "your-statistic",
"Conditions": {
"Range": {
"ValueRange"
{
"Start": your-range-start
"End": your-range-end
},
"TimestampSource": "{your-object-type.your-timestamp-source}",
"Unit": "days"
},
"ObjectCount": your-object-count,
"Threshold": {
"Value": "your-threshold-value",
"Operator": "your-threshold-operator"
}
}
}
```
要使用您自己的值自定义 JSON，请遵循以下准则：
+ **Attributes**：其中应包含要用于计算的属性的对象类型的字段名称。支持此列表中引用的两个属性。
+ **Expression**：支持在不同属性之间执行的基本数学表达式。如果您只有一个属性，则此字段应为 `{ObjectTypeName.AttributeName}`，否则，如果您心中有一个数学表达式，则此字段应同时包含这两个属性。
+ **统计数据**：这是您调用其中一个实际执行聚合操作 APIs 的计算时执行的操作。大多数都是不言自明的，但我们为那些并非不言自明的添加了解释。
**支持的统计数据**
+ `FIRST_OCCURRENCE` 返回在最早摄取的对象的表达式中指定的属性。
+ `LAST_OCCURRENCE` 返回在最新摄取的对象的表达式中指定的属性。
+ `COUNT` 返回来自选定数据的计数。
+ `SUM` 返回来自选定数据的总和。
+ `MINIMUM` 返回来自选定数据的最小值。
+ `MAXIMUM` 返回来自选定数据的最大值。
+ `AVERAGE` 返回来自选定数据的平均值。
+ `MAX_OCCURRENCE` 返回表达式中指定的最常出现的值。
+ **射程**:
+ 单位：目前仅支持 DAYS 单位。
+ ValueRange：在 “开始” 或 “结束” 字段中 ValueRange指定正数以表示从多少天前开始，并指定负数表示从未来多少天开始。
+ TimestampSource：一个表达式，用于指定 JSON 对象中应从中解析日期的字段。表达式应遵循\$1 “\$1的结构ObjectTypeName。 \$1\$1”。例如；如果您的对象类型为 MyType ，源 JSON 为`{"generatedAt": {"timestamp": "1737587945945"}}`，则 TimestampSource应为`"{MyType.generatedAt.timestamp}"`。
+ **ObjectCount**：表示计算的属性计算应基于多少个对象。
+ **Threshold**：比如，如果您想知道它是否大于某个值，而不是确切计算的属性值，则可以使用阈值。
阈值可以是任何字符串，并且支持以下阈值运算符。
+ `GREATER_THAN`
+ `LESS_THAN`
+ `EQUAL_TO`
+ `NOT_EQUAL_TO`
+ UseHistoricalData：计算中是否应包括在创建计算属性之前提取的历史数据。
## 第 2 步：调用 CreateCalculatedAttributeDefinition API
使用您的值创建并自定义 JSON 文件后，调用 [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html)API，如以下示例所示：
```
aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name
```
还可使用以下端点：
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes
```
# 使用验证在 Amazon Connect 客户资料中计算出的属性值 APIs
有两个 APIs`ListCalculatedAttributesForProfile`、`GetCalculatedAttributeForProfile`和，属于配置文件级别。
+ **GetCalculatedAttributeForProfile**-检索单个配置文件的单个计算属性。
+ **ListCalculatedAttributesForProfile**-检索单个配置文件的计算属性列表
借助有效的资料 ID，您应该会看到计算的属性的值：
**响应示例**
```
{
"CalculatedAttributeName": "_average_hold_time",
"DisplayName": "Average hold time",
"IsDataPartial": "true",
"Value": "24144"
}
```
**IsDataPartial**-此标志表示尚未达到时间范围（30 天）或对象计数，因此计算出的属性仍在计算中。例如，如果您想要超过 30 天的平均值，则只有在 30 天之后，`IsDataPartial` 字段才会设置为 false。
## 检索计算的属性列表
**使用 AWS CLI**
```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --profile-id your-profile-id
```
**使用带有自定义 JSON 文件的 AWS CLI**
使用以下内容创建 JSON 文件：
```
{
"DomainName": "your-domain-name",
"ProfileId" "some-profile-id"
}
```
```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json
```
**端点：**
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/
```
## 检索单个计算的属性
**使用 C AWS LI**：
```
aws customer-profiles get-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --calculated-attribute-name your-calculated-attribute-name --profile-id your-profile-id
```
**使用带有自定义 JSON 文件的 AWS CLI**：
使用以下内容创建 JSON 文件：
```
{
"DomainName": "your-domain-name",
"CalculatedAttributeName": "your-calculated-attribute-name",
"ProfileId" "your-profile-id"
}
```
```
aws customer-profiles get-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json
```
**端点：**
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/your-calculated-attribute-name
```
# Amazon Connect Customer Profiles 中的默认计算的属性
## 默认 CTR 计算的属性
Amazon Connect 客户资料根据联系人记录提供信 out-of-the箱默认属性。这些属性如下：
**最频繁的渠道**
```
{
"CalculatedAttributeName": "_most_frequent_channel",
"DisplayName": "Most frequent channel",
"Description": "Returns customer's frequently used communication channel. Channels include voice, chat, task.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "channel"
}
],
"Expression": "{CTR.channel}"
},
"Tags": {
}
}
```
**最后一个渠道**
```
{
"CalculatedAttributeName": "_last_channel",
"DisplayName": "Last channel",
"Description": "Returns customer's last communication channel. Channels include voice, chat, task.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "channel"
}
],
"Expression": "{CTR.channel}"
},
"Tags": {
}
}
```
**最后一个座席标识符**
```
{
"CalculatedAttributeName": "_last_agent_id",
"DisplayName": "Last agent identifier",
"Description": "Returns identifier of the last agent customer connected with.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.id"
}
],
"Expression": "{CTR.agent.id}"
},
"Tags": {
}
}
```
**频繁来电者**
```
{
"CalculatedAttributeName": "_frequent_caller",
"DisplayName": "Frequent caller",
"Description": "Returns true or false based on the number of times a customer has called.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "COUNT",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null,
"Threshold": {
"Value": "5",
"Operator": "GREATER_THAN"
}
},
"AttributeDetails": {
"Attributes": [
{
"Name": "contactId"
}
],
"Expression": "{CTR.contactId}"
},
"Tags": {
}
}
```
**平均保持时间**
```
{
"CalculatedAttributeName": "_average_hold_time",
"DisplayName": "Average hold time",
"Description": "Returns customer's average hold time for voice calls.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "AVERAGE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.customerHoldDurationMillis"
},
{
"Name": "queue.durationMillis"
}
],
"Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}"
},
"Tags": {
}
}
```
**平均通话时长**
```
{
"CalculatedAttributeName": "_average_call_duration",
"DisplayName": "Average call duration",
"Description": "Returns customer's average call duration for voice calls.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "AVERAGE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "disconnectTimestamp"
},
{
"Name": "initiationTimestamp"
}
],
"Expression": "{CTR.disconnectTimestamp} - {CTR.initiationTimestamp}"
},
"Tags": {
}
}
```
**客户的最长保持时间**
```
{
"CalculatedAttributeName": "_maximum_hold_time",
"DisplayName": "Customer's maximum hold time",
"Description": "Returns customer's maximum hold time for voice calls in the past month.",
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.customerHoldDurationMillis"
},
{
"Name": "queue.durationMillis"
}
],
"Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}"
},
"Statistic": "MAXIMUM",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
## 默认配置文件计算的属性
Amazon Connect 客户配置文件根据配置文件提供 out-of-the框默认属性。这些属性如下：
**新客户**
```
{
"CalculatedAttributeName": "_new_customer",
"DisplayName": "New customer",
"Description": "Returns true or false for new customer profiles created.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "TIME_DIFFERENCE_FROM_NOW",
"Conditions": {
"ObjectCount": null,
"Threshold": {
"Value": "30",
"Operator": "LESS_THAN"
}
},
"AttributeDetails": {
"Attributes": [
{
"Name": "createdAt"
}
],
"Expression": "{_profile.createdAt}"
},
"Tags": {
}
}
```
## 默认资产计算的属性
Amazon Connect 客户资料提供基于资产的 out-of-the箱子默认属性。这些属性如下：
**资产数量**
```
{
"CalculatedAttributeName": "_assets_count",
"DisplayName": "Count of assets",
"Description": "Returns the count of assets for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetId"
}
],
"Expression": "{_asset.AssetId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**首次购买资产的日期**
```
{
"CalculatedAttributeName": "_asset_first_occurrence",
"DisplayName": "First asset purchased date",
"Description": "Returns purchase date of the customer's first asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "PurchaseDate"
}
],
"Expression": "{_asset.PurchaseDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**最后一次购买资产的日期**
```
{
"CalculatedAttributeName": "_asset_last_occurrence",
"DisplayName": "Last asset purchased date",
"Description": "Returns purchase date of the customer's last asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "PurchaseDate"
}
],
"Expression": "{_asset.PurchaseDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**总资产价格**
```
{
"CalculatedAttributeName": "_assets_price_sum",
"DisplayName": "Total asset price",
"Description": "Returns customer's total asset price.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Price"
}
],
"Expression": "{_asset.Price}"
},
"Statistic": "SUM",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**平均资产价格**
```
{
"CalculatedAttributeName": "_assets_price_average",
"DisplayName": "Average asset price",
"Description": "Returns customer's average asset price.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Price"
}
],
"Expression": "{_asset.Price}"
},
"Statistic": "AVERAGE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**第一个资产名称**
```
{
"CalculatedAttributeName": "_assets_name_first_occurrence",
"DisplayName": "First asset name",
"Description": "Returns name of the customer's first asset",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetName"
}
],
"Expression": "{_asset.AssetName}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**最后一个资产名称**
```
{
"CalculatedAttributeName": "_assets_name_last_occurrence",
"DisplayName": "Last asset name",
"Description": "Returns name of the customer's last asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetName"
}
],
"Expression": "{_asset.AssetName}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
## 默认案例计算的属性
Amazon Connect 客户资料根据案例提供 out-of-the箱子默认属性。这些属性如下：
**案例数**
```
{
"CalculatedAttributeName": "_cases_count",
"DisplayName": "Count of cases",
"Description": "Returns the count of customer's cases for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**第一个案例创建日期**
```
{
"CalculatedAttributeName": "_case_first_occurrence",
"DisplayName": "First case created date",
"Description": "Returns created date of the customer's first case.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_case.CreatedDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**最后一个案例创建日期**
```
{
"CalculatedAttributeName": "_case_last_occurrence",
"DisplayName": "Last case created date",
"Description": "Returns created date of the customer's last case.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_case.CreatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**未结案例数量**
```
{
"CalculatedAttributeName": "_cases_open_status_count",
"DisplayName": "Count of open cases",
"Description": "Returns the count of customer's open cases.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Status": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**已结案件数量**
```
{
"CalculatedAttributeName": "_cases_closed_status_count",
"DisplayName": "Count of closed cases",
"Description": "Returns the count of customer's closed cases.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Status": {
"DimensionType": "INCLUSIVE",
"Values": ["Closed"]
}
}
}
]
}
]
},
"Launched": false
}
```
## 默认通信记录计算的属性
Amazon Connect 客户资料根据通信记录提供信 out-of-the箱默认属性。这些属性如下：
**上次电子邮件打开日期**
```
{
"CalculatedAttributeName": "_campaign_email_last_open",
"DisplayName": "Last email open date",
"Description": "Returns the last email open date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.Open.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.Open.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Open.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**电子邮件打开次数**
```
{
"CalculatedAttributeName": "_campaign_email_open_count",
"DisplayName": "Email open count",
"Description": "Returns the number of times emails were opened by a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Open.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**电子邮件发送次数**
```
{
"CalculatedAttributeName": "_campaign_email_delivery_count",
"DisplayName": "Email delivery count",
"Description": "Returns the number of times emails were delivered to a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Delivery.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Delivery"]
}
}
}
]
}
]
},
"Launched": false
}
```
**发送的短信数量**
```
{
"CalculatedAttributeName": "_campaign_sms_delivery_count",
"DisplayName": "SMS delivered count",
"Description": "Returns the number of times SMS were delivered to a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_DELIVERED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_DELIVERED"]
}
}
}
]
}
]
},
"Launched": false
}
```
**上次短信屏蔽日期**
```
{
"CalculatedAttributeName": "_campaign_sms_last_stop",
"DisplayName": "Last SMS blocked date",
"Description": "Returns the last SMS blocked date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.TEXT_BLOCKED.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.TEXT_BLOCKED.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ANY",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_BLOCKED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_BLOCKED"]
}
}
}
]
}
]
},
"Launched": false
}
```
**上次短信运营商屏蔽日期**
```
{
"CalculatedAttributeName": "_campaign_sms_last_stop_carrier",
"DisplayName": "Last SMS carrier blocked date",
"Description": "Returns the last SMS carrier blocked date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.TEXT_CARRIER_BLOCKED.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.TEXT_CARRIER_BLOCKED.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ANY",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_CARRIER_BLOCKED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_CARRIER_BLOCKED"]
}
}
}
]
}
]
},
"Launched": false
}
```
## 默认订单计算的属性
Amazon Connect 客户资料根据订单提供 out-of-the箱子默认属性。这些属性如下：
**订单数量**
```
{
"CalculatedAttributeName": "_orders_count",
"DisplayName": "Count of orders",
"Description": "Returns the count of orders for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "OrderId"
}
],
"Expression": "{_order.OrderId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**第一个订单创建日期**
```
{
"CalculatedAttributeName": "_order_first_occurrence",
"DisplayName": "First order created date",
"Description": "Returns created date of the customer's first order.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_order.CreatedDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**最后一个订单创建日期**
```
{
"CalculatedAttributeName": "_order_last_occurrence",
"DisplayName": "Last order created date",
"Description": "Returns created date of the customer's last order.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_order.CreatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**所有订单的总价格**
```
{
"CalculatedAttributeName": "_orders_total_price_sum",
"DisplayName": "Total price of all orders",
"Description": "Returns sum of total price for all customer's orders.",
"Statistic": "SUM",
"AttributeDetails": {
"Attributes": [
{
"Name": "TotalPrice"
}
],
"Expression": "{_order.TotalPrice}"
},
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**订单总价的平均值**
```
{
"CalculatedAttributeName": "_orders_total_price_average",
"DisplayName": "Orders average of total price",
"Description": "Returns average of total price for all customer's orders.",
"AttributeDetails": {
"Attributes": [
{
"Name": "TotalPrice"
}
],
"Expression": "{_order.TotalPrice}"
},
"Statistic": "AVERAGE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
# Amazon Connect Customer Profiles 计算属性的错误消息和解决方案
下表显示了每个错误的计算的属性错误消息、原因和解决方案。
| 错误消息 | 原因 | 解决方案 |
| --- | --- | --- |
| 检索资料的计算的属性显示 null 值 | 这可能是因为计算的属性没有数据。创建计算的属性后，必须摄取新数据。 | 通过集成或和来摄取新数据或重新摄取旧数据。CreateProfile PutProfileObject APIs |
# 在 Amazon Connect Customer Profiles 中设置客户细分
*客户细分*是共享特定属性的一组客户配置文件。例如，客户细分可能包含居住在特定城市的所有客户，或所有经常来电且其平均支出超过 500 美元的客户。借助 Amazon Connect 出站式广告系列，您可以向客户细分发送广告系列。
客户细分是根据您定义的属性动态评估的，当属性的值发生变化时，客户细分可能会随着时间推移而发生变化。例如，如果您向 Customer Profiles 域添加新的配置文件，或者如果修改或删除现有配置文件，则该客户细分中的配置文件数量可能会增加或减少。有关创建客户细分的更多信息，请参阅[在 Amazon Connect 中构建客户细分](customer-segments-building-segments.md)。
作为在中建立区段的先决条件 Amazon Connect，您的管理员必须在 AWS 管理控制台中设置您的域并配置集成，以便将概况、订单、资产、 and/or 案例数据导入客户档案。有关更多信息，请参阅 [为您的 Amazon Connect 实例启用 Customer Profiles](enable-customer-profiles.md)。启用数据集成可支持继续根据进入域中的新数据生成动态客户细分
客户细分仅包含 Amazon Connect Customer Profiles 域中的客户配置文件。客户配置文件可以从 S3 或外部应用程序摄取，也可以通过座席应用程序、联系流或 API 创建。有关客户配置文件的更多信息，请参阅[Amazon Connect 中的客户资料是什么？](customer-profiles-what-data.md)。
**Topics**
+ [构建客户细分](customer-segments-building-segments.md)
+ [管理客户细分](customer-segments-managing-segments.md)
+ [从导入的文件创建客户细分](customer-segments-imported-files.md)
+ [将客户细分导出到 CSV 文件](customer-segments-exporting-segments.md)
+ [使用客户细分 AI 助手](customer-segments-ai-assistant.md)
+ [问题排查](customer-segments-troubleshooting.md)
# 在 Amazon Connect 中构建客户细分
**注意**
**由 SQL（测试版）支持的分段需要开启数据存储。请访问客户资料主页屏幕，并从顶部蓝色横幅中启用 “数据存储”**
**注意**
要在 Amazon Connect 管理网站中导航到分段生成器体验，您需要安全配置文件权限才能使用此功能。有关更多信息，请参阅 [分配安全配置文件权限以管理客户细分](security-profile-customer-profile-segmentation.md)。
在建立客户细分之前，我们建议您使用 Customer Profiles 域设置数据集成，以便在 Customer Profiles 域中填充配置文件。有关如何配置与 Customer Profiles 的数据集成的更多信息，请参阅[将外部应用程序与 Amazon Connect Customer Profiles 集成](integrate-external-apps-customer-profiles.md)。
客户细分可以包括您使用计算的属性捕获的事件。有关如何配置自定义计算的属性以及如何查看 Customer Profiles 提供的默认计算的属性的更多信息，请参阅[在 Amazon Connect Customer Profiles 中设置计算的属性](customerprofiles-calculated-attributes.md)。
Amazon Connect 提供了两种建立客户细分的方法：1/ 通过 Spark SQL 定义细分（测试版；需要启用数据存储）；2/ 通过受众群体和筛选条件定义细分（经典细分）。对于这两者，你可以通过生成式人工智能驱动的分段人工智能助手使用自然语言提示。如果您以其中一种方式定义区段，则会将该区段移动到另一种方式中，并且必须重新开始。
## 由 Spark SQL 提供支持的区段
由 Spark SQL 提供支持的区段使您能够使用完整的客户档案数据和扩展的功能来定义细分。您可以使用标准轮廓对象属性和自定义对象属性。您还可以使用基于 SQL 的功能，例如将标准对象和自定义对象连接在一起以使用来自不同对象的数据，使用百分位数等统计数据筛选区段，以及标准化日期字段以进行比较。
你可以先在区段助手 AI 中输入自然语言提示。区段 AI 助手将定义区段，包括将其转换为 Spark SQL。Segment Assistant AI 将提供定义区段所需的步骤，你可以验证它是否与你想要创建的区段相匹配。您还可以查看 SQL、自然语言的 SQL 步骤以及 AI 生成的 Spark SQL 摘要，以进一步帮助验证。如果要进行更改，可以更新自然语言提示或直接编辑 Spark SQL。
您还可以选择直接创建 Spark SQL 区段。
**与经典分段一样，由 Spark SQL 支持的区段可用于区段成员资格调用、流量区块和出站营销活动。**
**当您在客户事件发起的区段成员资格调用、流量区块或出站活动中使用 Spark SQL 区段时，它会使用上次导出的区段（区段快照）。用于成员资格的区段快照将在创建 1 年后过期。如果您收到 4XX 错误，请确保已导出分段（区段快照）。**
**由客户细分发起的出站营销活动不需要您导出该细分（区段快照）。**
### 步骤 1：构建新的客户细分
在 Segment AI 助手中，选择 “如何创建区段” 以获取有关创建有价值区段的更多指导，或选择 “我想生成区段” 以输入自然语言提示来创建区段。
或者，也可以使用 SQL 在查询编辑器中定义新的区段。
**注意-如果您想创建基于时区的出站广告系列，则必须确保时区属性是区段输出的一部分**
**注意-如果您想在出站广告系列中使用区段，则必须确保区段输出 IDs 中的配置文件是唯一的**
### 步骤 2：指定名称和描述
对于名称，为客户细分输入一个名称，以便之后易于识别。
**注意-** Amazon Connect 管理网站使用输入`DisplayName`的名称作为区段的名称，并根据该名称生成标识符。生成的标识符用作您使用客户资料访问区段`SegmentDefinitionName`时的标识符 APIs。
对于描述，可以选择输入客户细分的描述。
### 第 3 步：查看并验证区段
查看区段 AI 助手使用的数据以及 AI 模型生成区段所用的步骤。您还可以在查询编辑器中查看它为定义区段而创建的 SQL。如果它无法创建区段，请处理其提供的反馈以帮助其创建准确的区段。生成细分后，客户档案将自动为您创建细分预估值。
如果要进行编辑，可以在查询编辑器中单击 “新建对话” 或 create/edit SQL 来提供新的提示。
如果您没有使用区段 AI 助手，则可以通过单击查询编辑器下方的 “验证和估算查询” 按钮来验证查询并创建估算值。
**注意-与其他查询引擎类似，由 Spark SQL 支持的区段将花费一些时间，具体取决于您在区段中使用的配置文件数据量和所使用的 SQL（例如，跨对象的多个联接需要时间）。**
### 步骤 4：创建区段
建立区段并满意后，选择右上角的 “创建区段” 按钮。创建区段后，您可以选择操作-导出到.csv，在流程中使用区段，在出站广告系列中使用区段。
**注意-如果您在出站广告系列或流量区块中使用区段，它将根据上次创建区段的时间来检查区段成员资格。如果您需要在执行流程或广告活动时进行实时细分成员资格检查，请使用经典细分。**
## 使用受众群体和过滤器的经典细分
创建客户细分时，您可以选择起始受众，然后通过选择定义该客户细分的筛选条件来优化这类受众。例如，您可以创建一个受众组，然后选择一个筛选条件，来筛选居住在特定国家/地区且经常来电的所有客户。根据需要重新计算客户细分，例如在活动执行期间、联系流执行期间以及客户细分估算或导出期间。因此，每个客户细分的大小和成员会随着时间发生变化。
此外，您可以创建第二个受众组，然后在两个受众组之间创建关系（AND、OR 或 EXCLUDE），以进一步缩小范围、串联或将客户排除在第一个受众组之外。
![\[两个受众组。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-segments-building-segments-1.png)
## 受众组
当您创建客户细分时，会创建一个或多个受众组。一个受众组包含以下组成部分：
![\[显示受众组的组成部分的概念图。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-segments-audience-groups-1.png)
+ **起始受众**：定义初始用户组的客户细分。您最多可以指定 5 个起始受众，或者指定 Customer Profiles 域中的所有配置文件。
+ **筛选条件组**：应用于起始受众之上的受众信息类别。您可以添加多个由 OR 关系连接的筛选条件组。
+ **筛选条件**：筛选条件可减少属于客户细分的受众数量。您可以添加任意个筛选条件来定制符合需求的客户细分。
一个客户细分必须至少有一个受众群体，但您可以选择创建第二个受众群组，然后在两个受众群体之间创建关系 (AND/OR/EXCLUDE)。有关关系的更多详细信息，请参阅[步骤 5：添加第二个受众组（可选）](#step-5-add-the-second-audience-group-optional)。
## 创建客户细分
以下步骤介绍如何创建和配置客户细分：
+ 步骤 1：构建新的客户细分
+ 步骤 2：配置名称和描述
+ 步骤 3：选择要包含在受众组 1 中的起始受众
+ 步骤 4：选择和配置筛选条件组（可选）
+ 步骤 5：添加受众组 2（可选）
### 步骤 1：构建新的客户细分
1. 要创建客户细分，请确保已创建安全配置文件权限作为先决条件。有关更多信息，请参阅 [分配安全配置文件权限以管理客户细分](security-profile-customer-profile-segmentation.md)。此外，为了以最佳的方式可视化客户细分的成员资格，我们建议在创建客户细分之前进行数据摄取。要通过 S3 或外部应用程序摄取配置文件，请参阅[创建客户数据并将其摄取到 Customer Profile 中](customer-profiles-object-type-mappings.md)或[将外部应用程序与 Amazon Connect Customer Profiles 集成](integrate-external-apps-customer-profiles.md)。
1. 在“客户细分”表视图中选择**创建客户细分**。
![\[“创建客户细分”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-1-build-a-new-segment-1.png)
### 步骤 2：指定名称和描述
+ 对于**名称**，为客户细分输入一个名称，以便之后易于识别。
**注意**
Amazon Connect 管理网站使用输入的名称作为区段`DisplayName`的名称，并根据该名称生成标识符。生成的标识符用作您使用客户资料访问区段`SegmentDefinitionName`时的标识符 APIs。
+ 对于**描述**，可以选择输入客户细分的描述。
![\[“客户细分名称”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-2-configure-specify-name-and-description-1.png)
### 步骤 3：选择要包含在受众组 1 中的起始受众
首先，选择如何为客户细分组定义起始受众。
1. 在**受众组 1** 下，对于**起始受众**下拉列表，选择要包含在受众组中的一个或多个客户细分，或者选择**客户配置文件中的所有配置文件**。
**注意**
当您选择多个客户细分作为起始受众时，这些客户细分将通过 `OR` 关系进行连接。例如，如果您选择**高级会员客户**和**基本会员客户**细分作为起始受众，则其中任何一个客户细分中的所有配置文件都将被包括在内。
![\[“起始受众”下拉列表。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1.png)
1. 要使用创建细分 ProfileType，请先使用**客户资料中的所有账户**作为初始受众。这种方法可让您有效地筛选基于账户的配置文件。请务必注意，除非您另行指定，否则客户细分过程将自动导出 Customer Profiles 域中的所有配置文件。此默认行为可确保全面覆盖，但可以调整以满足特定的目标需求。
以下是有关如何创建客户细分定义（基于账户或标准配置文件）的示例：
**筛选所有基于账户的个人资料 (ProfileType=账户\$1个人资料)**
![\[筛选所有基于账户的个人资料（ProfileType=账户_个人资料）。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-5.png)
**注意**
要创建仅包含子配置文件的客户细分，请创建一个不包括基于账户的配置文件的新受众。例如，`ProfileType` 为 PROFILE 或其中 `ProfileType` 为空的配置文件。
![\[要创建仅包含子配置文件的客户细分，请创建一个不包括基于账户的配置文件的新受众。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-6.png)
**定位要通过 `Phone` 联系的账户的示例活动**
![\[定位要通过 Phone 联系的账户的示例活动\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-7.png)
在此示例中，活动以单个账户为目标，其通话顺序如下：
1. 第一次尝试联系 John（ID：2）
1. 如果 John 没有接听，则打电话给 Sally（ID：3）作为备用联系人
1. 选择起始受众后，**估算受众**部分将更新以显示符合条件的配置文件。编辑受众组后，您可以单击“估算受众”部分中的**刷新**按钮以重新获取估算值。
![\[“估算受众”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-2.png)
### 步骤 4：选择和应用受众筛选条件（可选）
在您选择了起始受众之后，您可以通过对属性应用条件逻辑来进一步细化受众。客户细分支持标准配置文件属性、自定义配置文件属性和计算的属性。
![\[受众筛选条件。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-1.png)
**选择和配置受众筛选条件**
1. 对于**属性**，您可以选择以下类型的属性
1. **计算的属性**：根据计算的属性之一筛选受众。
要了解有关默认计算的属性以及如何配置自定义计算的属性的信息，请参阅[在 Amazon Connect Customer Profiles 中设置计算的属性](customerprofiles-calculated-attributes.md)。
1. **标准属性**：根据标准配置文件属性之一筛选受众。
有关标准配置文件属性的列表，请参阅 [Amazon Connect Customer Profiles 中的标准配置文件定义](standard-profile-definition.md)。
1. **自定义属性**：根据自定义配置文件属性之一筛选受众。
**注意**
我们在域中存储多达 1000 个最新的配置文件属性。如果域包含大量属性，则最旧的属性可能不会显示在此列表中。
1. 选择**运算符**。运算符决定属性与您输入的值的关系。以下描述了可用的运算符。可用的运算符会根据所选属性的值类型而变化。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/customer-segments-building-segments.html)
**注意**
Amazon Connect 管理网站中的客户群使用 UTC 时区，所有基于时间的筛选条件均使用默认时间 00:00:00 UTC。 您可以按日期进行筛选，但时间会记录为相同的值。如果您输入的日期为 2024-01-01，则控制台将时间传递为 2024-01-01T00:00:00Z。
**注意**
为计算的属性指定筛选条件时，可以覆盖计算的属性定义的时间段。例如，筛选条件 `Frequent caller is true for the event time period of 60 days` 将覆盖*频繁来电者* [Amazon Connect Customer Profiles 中的默认计算的属性](customerprofiles-default-calculated-attributes.md)，以评估过去 60 天内的值，而不是[在计算的属性定义中配置的时间段](customerprofiles-calculated-attributes-apis.md)。这一覆盖特定于客户细分，而不会影响计算的属性定义本身。
![\[要评估的属性、运算符和值。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-2.png)
1. 指定值。您可以指定通过 `OR` 关系连接的多个值。例如，`Address.Country` 为 `USA` 或 `Mexico`。输入的值会根据在域中存储的客户配置文件，在下拉列表中显示字符串运算符的建议。
**注意**
值区分大小写。例如，*Address.Country 为 US* 返回的结果与 *Address.Country 为 us* 不同。
1. （可选）要将其它属性应用于此筛选条件组，请选择 **\$1 筛选条件**。要创建另一组筛选条件，请选择 **\$1 组**。
**注意**
当筛选条件组中有多个筛选条件时，筛选条件将通过 AND 关系进行连接。例如，一个筛选条件组包含 2 个筛选条件，“*Address.Country* 为 USA”和“*客户的平均保持时间*超过 10 秒”，而 *Address.Country* 为 USA **且***平均保持时间*超过 10 秒的配置文件将属于该客户细分。
当你的受众群组中有多个筛选群组时， Amazon Connect 管理网站中的客户细分会使用 OR 关系在筛选群组之间建立联系。
![\[两个受众筛选条件。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-3.png)
1. 完成设置受众组后，选择**创建客户细分**。
### 步骤 5：添加第二个受众组（可选）
（可选）添加第二个受众组并定义与受众组 1 的关系。当您使用Amazon Connect 管理员网站创建客户细分时，每个客户细分最多可以有两个受众组。如果您向客户细分中添加第二个受众组，则可以选择以下两种方式之一来指定两个受众组的连接方式：
+ **AND 关系**：如果您使用 AND 关系来连接两个受众，则客户细分将包含同时满足受众组 1 和受众组 2 的筛选条件的所有配置文件。
+ **OR 关系**：如果您使用 OR 关系来连接两个受众，则客户细分将包含符合受众组 1 或受众组 2 的筛选条件的所有配置文件。
+ **EXCLUDE 关系**：如果您使用 EXCLUDE 关系来连接两个受众，则客户细分将包含受众组 1 中的配置文件，但不包括受众组 2 中的配置文件。
**配置第二个受众组**
1. 配置受众组 1 后，选择 **AND**、**OR** 或 **EXCLUDE** 关系。
![\[AND、OR 或 EXCLUDE 选项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-1.png)
1. 选择受众组 2 中的起始受众。有关参考，请参阅[步骤 3：选择要包含在受众组 1 中的起始受众](#step-3-choose-the-starting-audiences-to-include-in-audience-group)。
1. （可选）选择要用来缩小客户细分的筛选条件。有关参考，请参阅[步骤 4：选择和应用受众筛选条件（可选）](#step-4-choose-and-apply-audience-filters-optional)。
1. 完成设置客户细分后，选择**创建客户细分**。客户细分已创建，您现在可以在出站活动或流中使用该客户细分。
![\[表明客户细分已成功创建的消息。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-2.png)
## 创建由 Spark SQL 提供支持的区段
由 Spark SQL 提供支持的区段使您能够使用完整的客户档案数据和扩展的功能来定义细分。您可以使用标准轮廓对象属性和自定义对象属性。您还可以使用基于 SQL 的功能，例如将标准对象和自定义对象连接在一起以使用来自不同对象的数据，使用百分位数等统计数据筛选区段，以及标准化日期字段以进行比较。
你可以先在区段助手 AI 中输入自然语言提示。区段 AI 助手将定义区段，包括将其转换为 Spark SQL。Segment Assistant AI 将提供定义区段所需的步骤，你可以验证它是否与你想要创建的区段相匹配。您还可以查看 SQL、自然语言的 SQL 步骤以及 AI 生成的 Spark SQL 摘要，以进一步帮助验证。如果要进行更改，可以更新自然语言提示或直接编辑 Spark SQL。
您还可以选择直接创建 Spark SQL 区段。
由 Spark SQL 提供支持的区段可用于区段成员资格调用、流量区块和出站营销活动。他们检查上次创建区段时的区段（区段快照）。如果您收到 4XX 错误，则必须执行区段快照。
**注意**
**SQL 分段在数据存储上运行，该数据存储最多可有 10 年的数据。经典细分使用最新数据（过去 3 年内更新的数据）**
### 步骤 1：构建新的客户细分
在 Segment AI 助手中，选择 “如何创建区段” 以获取有关创建有价值区段的更多指导，或选择 “我想生成区段” 以输入自然语言提示来创建区段。
或者，也可以使用 SQL 在查询编辑器中定义新的区段。
### 步骤 2：指定名称和描述
对于名称，为客户细分输入一个名称，以便之后易于识别。
**注意**
Amazon Connect 管理网站使用输入`DisplayName`的名称作为区段的名称，并根据该名称生成标识符。生成的标识符用作您使用客户资料访问区段`SegmentDefinitionName`时的标识符 APIs。
对于描述，可以选择输入客户细分的描述。
### 第 3 步：查看并验证区段
查看区段 AI 助手使用的数据以及 AI 模型生成区段所用的步骤。您还可以在查询编辑器中查看它为定义区段而创建的 SQL。如果它无法创建区段，请处理其提供的反馈以帮助其创建准确的区段。生成细分后，客户档案将自动为您创建细分预估值。
如果要进行编辑，可以在查询编辑器中单击 “新建对话” 或 create/edit SQL 来提供新的提示。
如果您没有使用区段 AI 助手，则可以通过单击查询编辑器下方的 “验证和估算查询” 按钮来验证查询并创建估算值。
**注意**
与其他查询引擎类似，由 Spark SQL 提供支持的分段将花费一些时间，具体取决于您在区段中使用的配置文件数据量和所使用的 SQL（例如，跨对象的多个联接通常需要更多时间）。
### 步骤 4：创建区段
建立区段并满意后，选择右上角的 “创建区段” 按钮。创建区段后，您可以选择操作-导出到.csv，在流程中使用区段，在出站广告系列中使用区段。
**注意**
如果您在出站广告系列或流量区块中使用区段，它将根据上次创建区段的时间来检查区段成员资格。如果您需要在执行流程或广告活动时进行实时细分成员资格检查，请使用经典细分。
# 在 Amazon Connect 中管理客户细分
您可以使用Amazon Connect 管理员控制台来为客户细分创建、查看、复制和执行其它管理任务。如果您要打开客户细分来查看其设置，也可以快速创建使用该客户细分的活动。有关创建客户细分的更多信息，请参阅《 Amazon Connect 开发人员指南》中的[在 Amazon Connect 中构建客户细分](customer-segments-building-segments.md)。
**管理客户细分**
1. 在**客户细分**页面上，导航到要管理的客户细分或选择一个操作。
![\[“客户细分”页面，客户细分列表。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-segments-managing-segments-1.png)
1. 在**操作**菜单上，提供了以下选项：
1. **查看详情**-选择此选项可显示有关客户细分的信息，包括创建该细分的日期和时间，以及该细分上次更新的日期和时间。 Amazon Connect 用户需要 **CustomerProfiles.Segments.View** 安全配置文件权限才能执行此操作。
1. **复制**：选择此选项可创建新的客户细分（即所选客户细分的副本）。然后，您可以修改新客户细分中的任何设置，而不会更改原始客户细分。 Amazon Connect 用户需要.S **CustomerProfilesegments.Create** 安全配置文件权限才能执行此操作。
1. **导出 CSV**：选择此选项可将客户细分导出到计算机上的文件中。有关更多信息，请参阅[在 Amazon Connect 中将客户细分导出到 CSV 文件](customer-segments-exporting-segments.md)。 Amazon Connect 用户需要. **CustomerProfilesSegments.Expor** t 安全配置文件权限才能执行此操作。
1. **删除**：选择此选项可永久删除客户细分。删除区段后，您将无法恢复该区段。 Amazon Connect 用户需要.S **CustomerProfilesegments.Delete** 安全配置文件权限才能执行此操作。
**重要**
如果您删除某个客户细分，使用该客户细分的所有活跃活动都将失败。同样，在该客户细分之上构建的任何客户细分都将停止工作。在删除客户细分之前，最好先确认是否有任何活跃的活动或其它客户细分在使用该客户细分。
# 在 Amazon Connect 中从导入的文件创建客户细分
**注意**
要访问 Amazon Connect 管理网站中的分段生成器体验，请确保配置了适当的安全配置文件权限。有关更多信息，请参阅 [分配安全配置文件权限以管理客户细分](security-profile-customer-profile-segmentation.md)。
客户细分导入使用包含配置文件数据的 CSV 文件来创建新的配置文件或更新现有配置文件，然后将这些配置文件分组为一个客户细分。CSV 文件的大小必须小于 1 GB，并包含映射到标准配置文件属性的有效标题。
以下步骤介绍创建和配置导入的客户细分：
1. [创建新的客户细分](#create-new-segment)
1. [上传 CSV 文件](#upload-csv-file)
1. [配置客户细分详细信息](#configure-segment-details)
1. [映射客户属性](#map-customer-attributes)
1. [设置配置文件到期](#set-profile-expiry)
1. [创建和监控客户细分导入](#create-monitor-segment-import)
## 创建新的客户细分
1. 要创建客户细分，请确保已创建安全配置文件权限作为先决条件。有关更多信息，请参阅 [分配安全配置文件权限以管理客户细分](security-profile-customer-profile-segmentation.md)。
1. 在 Amazon Connect 管理网站中，导航到**客户资料****客户细分**
1. 选择**创建客户细分**，然后从下拉列表中选择**来自文件上传**
## 上传 CSV 文件
通过以下任一方式选择 CSV 文件：
+ 选择**选择文件**，然后选择您的文件。
+ 将文件拖放到上传区域。
文件名必须为：
+ 采用 CSV 格式
+ 大小低于 1 GB
+ 包含标题
+ UTF-8 编码
## 配置客户细分详细信息
对于**名称**，为客户细分指定一个可识别的标识符。该字段为必填。
+ 仅使用字母（a-z，A-Z）、数字（0-9）、连字符（-）或下划线（\$1）
+ 以字母或数字开头（而不是下划线）
+ 最大长度为 255 个字符
**注意**
Amazon Connect 管理网站使用此名称作为区段名称并生成唯一标`SegmentDefinitionName`识符。`DisplayName`此标识符用于通过 Amazon Connect 客户档案访问该细分市场 APIs。
对于**描述**（可选），添加有关客户细分的详细信息：
+ 最大长度为 1000 个字符
## 映射客户属性
对象类型映射定义了 Customer Profiles 如何处理您的 CSV 数据。此映射：
+ 确定 CSV 数据如何填充标准配置文件对象。
+ 指定要为哪些字段编制索引以进行配置文件分配。
有关对象类型映射的更多信息，请参阅[创建客户数据并将其摄取到 Customer Profile 中](customer-profiles-object-type-mappings.md)。
选择以下选项之一以将 CSV 列映射到 Customer Profiles 属性：
### 选项 1：人工智能驱动的映射（推荐）
1. 选择**生成客户属性**，然后选择**下一步**。
1. 系统会分析 CSV 标题并建议与标准配置文件属性的相应映射。
1. 查看建议的映射。
1. 可选：自定义映射：
+ 修改标准配置文件属性映射。
+ 使用以下格式添加自定义属性：`Attributes.attribute-name`。
+ 更新唯一标识符。
### 选项 2：手动映射
1. 将每个 CSV 列标题映射到配置文件属性：
+ 使用标准配置文件属性。有关完整列表，请参阅[Amazon Connect Customer Profiles 中的标准配置文件定义](standard-profile-definition.md)。
+ 使用以下格式创建自定义属性：`Attributes.attribute-name`。
**注意**
最多可以映射到 25 个属性。
1. 选择一个已映射的属性作为客户标识符（唯一键）。
### 选择客户标识符
完成映射后，选择一个已映射的属性作为客户标识符。Amazon Connect Customer Profiles 使用此标识符来执行以下操作：
+ 创建新的配置文件或更新现有配置文件。
+ 将传入的数据与现有配置文件进行匹配。
**注意**
无论是使用人工智能驱动的映射还是手动映射，都可以在设置过程中随时修改属性映射。
## 设置配置文件到期
指定导入的配置文件何时到期：
1. 选择到期选项：
+ 默认：自导入之日起 14 天
+ 自定义：使用日期选择器选择日期
1. 对于自定义到期日期：
+ 最短：导入后 1 天
+ 最长：导入后 90 天
Customer Profiles 从客户细分和配置文件域中移除到期的配置文件。
**注意**
选择与数据留存要求相一致的有效期。在选择自定义日期之前，请考虑默认的 14 天期限是否满足您的业务需求。
## 创建和监控客户细分导入
**创建分段**
1. 审核 配置。
1. 选择**创建客户细分**。
1. 系统将：
+ 上传您的 CSV 文件。
+ 根据数据创建/更新配置文件。
+ 将配置文件组合为一个客户细分。
+ 使用通知横幅显示进度。
监控导入进度
+ 在客户细分详细信息页面上查看导入进度。
+ 通知横幅显示导入作业正在进行中。
+ 导入作业详细信息表显示：
+ 文件名
+ 导入作业创建日期
+ 导入作业完成日期
+ 处理的配置文件数
+ 成功导入的数量
+ 失败导入的数量
+ 您可以在导入过程中取消导入。
+ 当导入作业仍在进行时，可以在活动中使用客户细分。
**注意**
导入完成后，导入的客户细分可以像任何其它客户细分一样用于出站活动或导出。您可以从客户细分详细信息页面查看客户细分详细信息，包括导入状态和结果。
# 在 Amazon Connect 中将客户细分导出到 CSV 文件
在 Amazon Connect 管理网站的**客户细分**页面上，您可以将现有细分导出到计算机上的文件中。 完成后，客户档案会将与客户细分中的配置文件关联的所有配置文件属性导出到 CSV 文件中。
**导出客户细分**
1. 在“客户细分”页面上，在操作下拉列表中选择**导出 CSV**。
![\[“客户细分”页面，“导出 CSV”选项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-segments-exporting-segments-1.png)
或者，您可以导航到**查看详细信息**页面，然后依次选择**后续操作**、**下载**。
![\[客户细分的客户细分详细信息页面，“后续操作”选项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-segments-exporting-segments-2.png)
**注意**
Amazon Connect 管理网站支持导出包含多达 350,000 个个人资料的客户细分。如果您需要导出包含大量配置文件的客户细分，请使用 Customer Profiles API 中的 `CreateSegmentSnapshot` 操作。`CreateSegmentSnapshot` 操作支持将 ORC、JSONL 和 CSV 文件中的客户细分导出到 S3 存储桶。请注意，除了存储桶中导出的客户细分外，API 还会输出一个测试文件。
1. 导出作业开始后，将包含下载内容的窗口或选项卡保持打开状态，直到该过程完成。
![\[说明正在导出客户细分的消息。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-segments-exporting-segments-3.png)
1. 导出任务完成后， Amazon Connect 管理员网站会自动开始下载文件。
![\[说明已成功下载客户细分的消息。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-segments-exporting-segments-4.png)
导出的 CSV 文件包含在导出的配置文件间填充的所有[标准和客户配置文件属性](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html)。
# 在 Amazon Connect 中使用客户细分 AI 助手
Amazon Connect Customer Profiles 支持生成式人工智能驱动的客户细分，使非技术业务用户能够使用自然语言查询（[客户细分 AI 助手](#generating-a-segment-by-prompt)）构建受众，并根据客户数据中的趋势（[用于客户细分创建的灵感卡片](#inspiration-cards-for-segment-creation)）接收建议。这些功能利用 [Amazon Bedrock](https://aws.amazon.com/bedrock/) 中的高级人工智能算法，通过主动和个性化的外展服务来协助您提高客户满意度并增加收入。例如，您可以对上周频繁地联系客户支持并提供个性化服务优惠的客户创建客户细分。您还可以识别其总支出增加的客户，并提供个性化折扣，从而提高忠诚度并推动增长。
通过将生成式人工智能整合到客户细分工作流程中，可以增加以下优势：
+ **简化客户细分创建**：使用对话语言构建复杂的客户细分，使非技术用户能够访问该流程并提高效率。
+ **数据驱动的客户细分创建灵感**：根据客户数据中的趋势接收人工智能赋能的客户细分灵感。
+ **增强的个性化：**轻松识别和定位特定的客户组，以进行量身定制的通信和优惠。
以下各节介绍了每项功能、如何使用它们以及它们为协助您改善客户细分工作而提供的优势。
**注意**
要使用区段 AI 助手，用户需要获得区段创建 **CustomerProfiles.Segments.Create** 的权限。
虽然这些人工智能驱动的工具提供了宝贵的建议，但重要的是要审查和调整建议的客户细分，以确保它们与组织的特定业务目标保持一致并符合其数据使用策略。
## 客户细分创建的灵感卡片
灵感卡片是**客户细分**页面上由人工智能驱动的功能。它们可以简化并增强客户细分创建过程。下图显示了三张灵感卡片的示例。
![\[“客户细分”页面上的灵感卡片示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/inspiration-cards-for-segment-creation-1.png)
根据 Amazon Connect Customer Profiles 数据，这些卡片每次可生成多达三个类别的客户细分创意，以激发和简化客户细分创建过程。
**注意**
趋势数据基于默认计算的属性的事件摄取日期。
**主要特征**
+ **数据驱动的灵感**：每张灵感卡片都提供了针对特定客户数据和趋势量身定制的客户细分创意。
+ 灵感卡片可提供三个以业务为重点的主题的创意：
+ **促销**：通过特定的促销策略定位客户的创意。
+ **保留**：确定要实施客户保留工作的客户细分。
+ **支持**：重点突出可能需要特别关注以提供客户服务的客户组。
+ **基于洞察的建议**：利用历史趋势、数据见解和生成式人工智能来创建有意义的、切实可行的见解。
**如何使用灵感卡片**
1. 导航至**客户细分**页面。
1. 找到灵感卡片部分。它显示三个客户细分建议。
1. 查看每张卡片，以了解提议的客户细分及其潜在应用。
1. 找到要使用的卡片后，在该卡片上选择**开始使用**。
1. 选择**探索更多**以生成更多灵感卡片。它们可以根据 Amazon Connect Customer Profiles 数据提供全新的客户细分创意。
1. 选择**开始使用**后，系统会自动将您定向到**创建客户细分**页面。
1. 您选择的客户细分创意将填充到客户细分生成器中，供您查看和完善。
## 使用自然语言提示生成客户细分
客户细分 AI 助手提供了一种使用自然语言提示创建客户细分的指导方法，可简化创建复杂客户细分的过程，并支持您使用自然语言描述目标受众和获得结构化、切实可行的客户细分定义。
下图显示了一个客户细分 AI 助手提示的示例。
![\[客户细分 AI 助手提示的示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/generating-a-segment-by-prompt-1.png)
**要访问此功能：**
1. 导航至**客户细分**页面，然后选择**创建客户细分**。
1. 找到位于页面右侧的客户细分 AI 助手面板，如下图所示。
![\[页面右侧的“客户细分 AI 助手”面板的示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/generating-a-segment-by-prompt-2.png)
**使用客户细分 AI 助手**
1. 该助手通过一系列问题引导用户了解客户细分需求，与助手的所有交互路径都会生成提示。
1. 用户可以提供有关所需客户细分的文字描述。
1. 提示操作步骤提供了示例提示来作为撰写详细描述的参考。
1. 根据您的输入，Amazon Connect 生成结构化的客户细分定义。
1. 生成的客户细分定义将自动应用于客户细分生成器。
1. 您可以使用标准客户细分生成器工具进一步细化生成的客户细分。修改客户细分生成器上的筛选条件会覆盖先前生成的现有条件。
1. 在查看生成的客户细分并进行任何必要的调整后，您可以通过选择**创建客户细分**来最终完成该过程。此操作可保存您的客户细分并使其可用于您的活动中。
**最佳实践**
在使用客户细分 AI 助手时，请记住以下最佳实践：
+ 撰写具体的描述。当您使用现有属性的名称时，客户细分 AI 助手会生成更准确的条件。
+ 请确保您引用的所有属性均存在于您的域中。
+ 从简单的提示开始，然后尝试不同的提示。如果您在第一次尝试时没有收到想要的内容，请重新撰写您的提示。提交新提示将替换现有条件，或者选择**新对话**。
+ 在客户细分生成器上分配时间来进行客户细分优化和验证，以确保客户细分准确地反映您的实际数据值。
**注意**
客户细分 AI 助手旨在使用通用描述符和标准。描述客户细分时，请务必遵守数据保护法规和公司政策。确保提示和描述不包含任何敏感或个人信息。
## 提供有关所生成的客户细分的反馈
生成客户细分后，鼓励用户评估该功能的性能并提供反馈。这种反馈机制有助于改善客户细分生成流程，并确保其有效地满足业务需求。下图显示了反馈页面。
![\[您的反馈已记录的消息示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/providing-feedback-on-generated-segments-1.png)
反馈过程包括两个阶段：
1. **初步反应**：在警报部分的右下角，您会发现“赞成”和“反对”图标。点击其中任何一个图标，来表示您对生成的客户细分的总体满意度。
1. **其它反馈**：选择“赞成”和“反对”图标后，将向您显示提供更详细反馈的选项。这采用文本输入字段的形式，您可以在其中留下自由格式的评论。
我们鼓励您同时使用快速反应（赞成/反对）和文本输入来进行全面评估，在适用时提供具体的示例或使用案例，重点关注生成的客户细分如何与业务目标保持一致，并推荐旨在增强客户细分生成过程的改进措施或其它功能。
提出可增强客户细分生成过程的改进或其它功能。
通过积极参与反馈流程，用户可以为持续改进客户细分生成功能做出贡献，最终实现更有效的客户细分和有针对性的营销策略。
## 错误处理
使用客户细分 AI 助手生成客户细分时，您可能会偶尔遇到一条错误消息，指出：**We can't process your request right now.** 即使在为创建客户细分提供了有效的提示之后，仍可能出现此错误。
下图显示了此错误消息的示例。
![\[Amazon Connect 无法处理您的请求的错误消息示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-segments-ai-error-handling-1.png)
使用以下步骤有助于您了解和解决此错误。
**可能的原因：**
+ **高系统负载**：客户细分 AI 助手可能遇到高需求或同时处理多个请求。
+ **临时服务中断**：服务处理新的客户细分请求的能力可能会出现短暂中断。
+ **复杂的查询**：系统可能需要更多时间来处理特别复杂或资源密集型的客户细分查询。
**操作：**
+ **等待并重试**：错误消息会建议您等待几分钟后重试。这为系统留出时间来解决任何临时问题。
+ **手动创建客户细分**：如果您立即需要客户细分，则可以选择使用客户细分生成器手动创建客户细分
**如何重试：**
1. 请等待几分钟。
1. 选择聊天界面底部的**新对话**。
1. 开始新的对话并重新输入您的客户细分创建提示。
**最佳实践**
+ 如果多次尝试后，错误仍然存在，请考虑简化您的客户细分标准或将其分解为更小、更易于管理的请求。
+ 尽量避免快速、连续地发出重复的请求，因为这可能会导致系统过载。
+ 如果问题仍然存在，请联系客户支持来寻求更多帮助。
请记住，此错误通常是临时性的，按照提供的说明进行操作应该可以成功创建所需的客户细分。
## 已知限制条件
了解数据处理生命周期对于有效地使用客户细分 AI 助手至关重要。本节概述了业务用户在数据整合的不同阶段可以期待什么，以及它如何影响客户细分建议。
**数据处理和质量影响：**客户细分 AI 助手会经历两个主要演变阶段：初始数据摄取和后处理。在初始摄取期间，系统可能无法充分利用实际的属性值，更多地依赖于提示解释。例如，提示为 *VIP 客户*可能会建议使用 *VIP* 客户细分，而不是使用您数据中现有的*金卡*等级。完成处理后，系统会利用实际的属性值，从而更准确地创建客户细分，减少对提示解释的依赖，并提高整体客户细分质量。
**注意**
在依赖高级功能之前，请留出足够的时间来完成数据处理。定期更新客户配置文件数据。客户细分的准确性取决于 Amazon Connect Customer Profiles 中客户数据的完整性和时效性。系统会在其回复中标记任何缺失的属性。
**系统性能：**在高容量时期，预计客户细分生成可能会延迟。该系统针对典型的工作负载进行了优化，但是具有广泛客户细分需求的企业可能需要相应地调整其流程。
**属性可用性**：所生成的客户细分的质量取决于 Amazon Connect Customer Profiles 中提供的客户数据。客户档案数据越全面，系统在解释提示和定义相关细分时就越准确。 up-to-date如果有不存在的属性，我们将返回一条指明缺失属性的消息。
**提示复杂性**：对于非常复杂或细致入微的客户细分定义，自然语言处理可能存在局限性。客户应从相对简单的提示开始，并在获得该功能的体验后逐渐增加复杂性。
**细分优化**：尽管系统生成的客户细分是一个很好的起点，但客户可能仍需要审核和完善细节，以确保客户细分与其业务目标完美契合。客户细分界面支持在初始生成后进行完全自定义。
**性能和扩展**：在高并发度下，由于语言模型需要处理每个提示，因此客户细分生成过程可能会有一些延迟。该系统专为处理典型的客户细分工作负载而设计，但对客户细分要求极其高的客户可能需要相应地调整其工作流程
# 在 Amazon Connect 中对客户细分进行故障排除
## “客户细分”选项未出现在左侧导航面板中
如果 Amazon Connect 管理员网站左侧导航面板中不存在**客户细分**选项，请检查用户的安全配置文件是否具有 “**客户区段-查看”** 权限。 有关更多信息，请参阅[分配安全配置文件权限以管理客户细分](security-profile-customer-profile-segmentation.md)。更新权限后，刷新Amazon Connect 管理员网站页面以反映更改。
## “导出 CSV”按钮不可用，或者导出作业超时
Amazon Connect 管理员网站不支持导出包含超过 350,000 个配置文件的区段。或者，我们建议使用 `CreateSegmentSnapshot` API，通过命令行参考（CLI）或 SDK 将此类客户细分导出到 Amazon S3 存储桶。
## 错误：您达到了 60 个唯一属性的上限
当客户细分定义中的唯一属性数量超过配额时，就会发生此错误。以递归方式计算唯一属性的数量，包括起始受众。
**Solutions**
+ 通过移除客户细分定义中的受众筛选条件，或移除包含受众筛选条件的起始受众，来减少唯一属性的数量。
+ [申请增加服务配额](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)：客户细分中唯一属性的最大数量
有关默认服务配额的更多信息，请参阅 [Amazon Connect Customer Profiles 服务配额](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles)。
## 错误：您达到了 10 个具有唯一性的计算属性的上限
当客户细分定义中具有唯一性的计算属性数量超过配额时，就会发生此错误。以递归方式计算具有唯一性的计算属性的数量，包括起始受众。
**Solutions**
+ 通过移除客户细分定义中有关计算属性的受众筛选条件，或者移除包含有关计算属性的受众筛选条件的起始受众，来减少具有唯一性的计算属性的数量。
+ [申请增加服务配额](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)：客户细分中具有唯一性的计算属性的最大数量。
有关默认服务配额的更多信息，请参阅 [Amazon Connect Customer Profiles 服务配额](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles)。
## 错误：您达到了 5 个起始受众深度的上限
如果起始受众的深度超出配额，将发生此错误。深度是针对受众组中的所有初始受众以递归方式计算得出的。例如，如果您选择“符合条件的租车升级”客户细分作为起始受众，而“符合条件的租车升级”客户细分将另一个客户细分作为起始受众，则深度将为 2。
**解决方案**
+ 从包含深度嵌套的起始受众的受众组中移除一个或多个起始受众。
有关默认服务配额的更多信息，请参阅 [Amazon Connect Customer Profiles 服务配额](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles)。
# 在 Amazon Connect Customer Profiles 中设置配置文件浏览器
Amazon Connect 客户档案浏览器是一个动态的 all-in-one控制面板，可提供客户的 360 度全方位视图。它统一了分散的客户数据，支持组织自定义数据显示、跟踪互动并将客户信息转化为可行的洞察，从而提高业务价值和客户忠诚度。旅游业和酒店业等行业的组织可以使用配置文件浏览器，通过这个直观的界面更好地了解客户并与之互动。
+ 同时使用多个标识符（电子邮件、电话、预订引用等）**立即找到客户**，并提供实时搜索结果。
+ **自定义视图**以确定与特定业务需求相关性最高的信息的优先级，设计领域特定的布局以突出显示您定义的相关性最高的客户数据。
+ 通过交互式可视化和数据显示，**访问完整的客户情境**，包括人口统计数据、通信历史记录、行为互动和客户细分成员资格。
+ **利用人工智能驱动的见解**，获得重点突出关键模式的客户摘要以及个性化的行为推断。
![\[配置文件浏览器控制面板。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/customer-profiles-profile-explorer-1.png)
**Topics**
+ [启用配置文件浏览器](enabling-profile-explorer.md)
+ [开始使用](getting-started-profile-explorer.md)
+ [布局定义](layout-definition.md)
+ [将配置文件浏览器添加到座席工作区](add-profileexplorer-to-agentworkspace.md)
# 启用配置文件浏览器
以下步骤可让您为管理员和用户启用配置文件浏览器。此过程包括设置用于布局配置和查看访问权限的权限。
**Topics**
+ [支持管理员定义布局](#enable-administrators-define-layout)
+ [支持用户查看配置文件浏览器](#enable-users-view-profile-explorer)
+ [验证设置](#verify-setup)
## 支持管理员定义布局
管理员需要特定的权限，才能创建和编辑配置文件浏览器布局：
+ 在配置文件浏览器安全配置文件中分配以下权限：
+ **配置文件浏览器 - 编辑**：支持修改现有配置文件浏览器布局。
+ **配置文件浏览器 - 创建**：支持创建配置文件浏览器布局。
+ **配置文件浏览器 - 查看**：支持用于查看所配置的配置文件浏览器布局的访问权限。
![\[添加权限以支持用户创建、编辑和查看配置文件浏览器布局。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-administrators-define-layout-1.png)
## 支持用户查看配置文件浏览器
用户需要适当的权限，才能访问配置文件浏览器布局并与之交互：
+ 在配置文件浏览器安全配置文件中分配以下权限：
+ **配置文件浏览器 - 查看**：支持用于查看所配置的配置文件浏览器布局的访问权限。
![\[添加权限以支持用户查看配置文件浏览器布局。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-users-view-profile-explorer-1.png)
## 验证设置
要确认可以成功地启用配置文件浏览器：
以管理员身份登录，以验证您可以：
+ 访问配置文件浏览器页面。
+ 创建和修改配置文件浏览器布局。
以普通用户身份登录，以验证您可以：
+ 访问配置文件浏览器。
+ 查看配置文件浏览器布局。
+ 与已启用的功能进行交互。
# 开始使用 Amazon Connect Customer Profiles 配置文件浏览器
开始使用配置文件浏览器，并了解界面的基础知识。
**Topics**
+ [布局控件](layout-controls.md)
+ [编辑浏览器布局](editing-explorer-layout.md)
+ [保存浏览器布局](saving-explorer-layout.md)
# 布局控件
![\[添加权限以支持用户查看配置文件浏览器布局。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/layout-controls-1.png)
配置文件浏览器欢迎控制台。
1. 编辑选项卡
1. 添加小组件
1. 布局操作
## 编辑选项卡
使用选项卡控件将控制面板整理成逻辑部分：
+ **1a。添加选项卡**：创建新的选项卡以区分客户数据的不同方面
+ **1b。移除选项卡**：从布局中删除不必要的选项卡
+ **1c。重命名选项卡**：自定义选项卡名称以反映其内容
+ **1d. 重新排列选项卡**：拖放选项卡，以便按您的首选顺序排列它们
![\[“编辑选项卡”弹出窗口。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/layout-controls-2.png)
## 添加小组件
使用各种数据可视化小组件增强活动的选项卡：
### 可用小组件
+ 默认小组件
+ [生成式人工智能摘要](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)
只需选择您要使用的小组件，即可开始探索
## 布局操作
管理您的整体控制面板配置：
+ **保存布局**：保留您当前的控制面板配置
![\[保存布局弹出窗口。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/layout-controls-3.png)
**注意**
在保存之前，所有更改都处于草稿状态。
# 编辑浏览器布局
通过简单、直观的控件来管理小组件及其位置，自定义配置文件浏览器布局。
## 小组件控件
每个小组件在右上角都有一个三点菜单，提供两个主要选项：
+ **1A 编辑**：打开该特定小组件的配置面板
+ **1B 移除**：从布局中删除小组件
![\[编辑或移除浏览器布局的弹出窗口。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/widget-controls-1.png)
## 小组件自定义
+ **拖放**：将小组件重新定位到控制面板上的任何位置
+ **调整大小**：选择并拖动小组件边框以调整尺寸
+ **配置**：通过特定于每种小组件类型的编辑面板来访问详细的设置
![\[在浏览器布局中对小组件进行自定义和重新排序。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/widget-customization-1.png)
**注意**
每种小组件类型都有独特的配置选项。有关特定小组件设置的详细信息，请参阅小组件文档。
## 添加新的小组件
要向布局添加新的组件，请使用控制面板中的**添加小组件**按钮。
# 保存浏览器布局
如何保存和管理配置文件浏览器布局配置。
## 布局持久性
必须保存对配置文件浏览器布局所做的更改才能持久保留。离开页面或刷新浏览器时，未保存的更改将丢失。
## 默认布局
每个配置文件浏览器实现都包含一个默认布局。这用作组织的基本配置，可以根据需要进行修改。
## 保存更改
要保存布局更改：
1. 在“布局操作”菜单中选择**保存**。
1. 在保存对话框中确认您的更改。
1. 保存完成后，所有用户的布局将更新。
![\[将布局对话框保存在浏览器布局中。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/saving-changes-1.png)
**注意**
保存布局更改需要相应的权限。有关所需权限的信息，请参阅[启用配置文件浏览器](enabling-profile-explorer.md)。
# 布局定义
了解配置文件浏览器布局的结构和组件。
**Topics**
+ [工作原理](how-it-works.md)
+ [小组件](widgets.md)
# 工作原理
配置文件浏览器提供了各种用于显示客户信息的小组件，布局存储为 JSON 定义，表示控制面板的完整结构和配置。可视布局中的每个小组件和组件都对应于此定义中的一个特定 JSON 块。
## 核心组件
布局定义中的每个组件都由五个常见元素组成：
+ **Type**
+ 定义组件类别
+ 确定组件呈现的方式
+ 示例： BoardItem，表， KeyValuePair
+ **Id**
+ 每个组件的唯一标识符
+ 用于组件跟踪和更新
+ 在生成器中创建组件时自动生成
+ **道具**
+ 特定于组件的属性
+ 控制外观和行为
+ 包含配置设置
+ **子级**
+ 嵌套的组件或内容
+ 定义层次关系
+ 可以包含多个子组件
+ **DataSource**
+ 指定数据来源
+ 定义数据检索参数
+ 控制组件的数据绑定
## 示例布局组件定义
下面是一个控制面板表组件的 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": {}
}
]
}
```
## 动态数据配置
配置文件浏览器使用模板表达式在您的组件中动态访问和显示 Customer Profiles 数据。
### 单个值支持
对于诸如键值对和键指标之类的组件，您可以访问：
#### 标准配置文件信息
```
{{Customer.}}
```
示例用法：
+ `{{Customer.FirstName}}`
+ `{{Customer.LastName}}`
+ `{{Customer.PhoneNumber}}`
#### 计算的属性
```
{{Customer.CalculatedAttributes.}}
```
示例用法：
+ `{{Customer.CalculatedAttributes._cases_count}}`
+ `{{Customer.CalculatedAttributes._new_customer}}`
### 表数据支持语法
#### 计算的属性
```
{{Customer.CalculatedAttributes.DisplayName}}
```
```
{{Customer.CalculatedAttributes.CalculatedAttributeDefinitionName}}
```
#### Segments
```
{{Customer.CalculatedAttributes.DisplayName}}
```
```
{{Customer.CalculatedAttributes.SegmentDefinitionName}}
```
#### 配置文件对象
```
{{Customer.ObjectAttributes..}}
```
**示例用法：**
+ `{{Customer.ObjectAttributes.CTR.contactId}}`
+ `{{Customer.ObjectAttributes.Order.orderId}}`
### 实施示例
#### 单个值组件
```
{
"Type": "KeyValuePair",
"Props": {
"Items": [
{
"Label": {
"Content": {
"Type": "TextContent",
"Children": ["Customer Name"]
}
},
"Value": {
"Content": {
"Type": "TextContent",
"Children": ["{{Customer.FirstName}}"]
}
}
}
]
}
}
```
#### 表组件
```
{
"Type": "Table",
"Props": {
"ColumnDefinitions": [
{
"Cell": {
"Content": {
"Type": "TextContent",
"Children": ["{{Customer.ObjectAttributes.CTR.contactId}}"]
}
},
"Header": "Contact ID"
}
]
}
}
```
**注意**
请确保您引用的属性、对象和客户细分存在于客户 Customer Profiles 配置中，然后在布局中使用它们。
# 小组件
探索配置文件浏览器中提供的不同小组件类型。
## 概述
配置文件浏览器中的小组件是根据布局定义中的 JSON 组件构建的复合元素。虽然这些小组件代表复杂的 JSON 结构，但我们的用户界面生成器会自动处理技术构成，从而使控制面板管理变得简单易用。
**Topics**
+ [概述](#widgets-overview)
+ [可用小组件](#available-widgets)
+ [默认小组件](default-widgets.md)
+ [自定义小组件](custom-widgets.md)
## 可用小组件
+ 默认小组件
+ [生成式人工智能摘要](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)
# 默认小组件
配置文件浏览器附带一系列预配置的小组件，旨在无缝处理 Customer Profiles 数据。这些默认小组件只需最少的设置即可立即提供值，使您只需单击几下即可构建复杂的控制面板。
![\[在浏览器布局中添加默认小组件。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/default-widgets-1.png)
## Ready-to-use 小部件
+ [生成式人工智能摘要](#generative-ai-summary)
+ [客户信息](#customer-information)
+ [计算的属性](#calculated-attribute)
+ [联系人](#contacts)
+ [案例](#cases-cp)
+ [订单](#orders-cp)
+ [资产](#assets-cp)
**注意**
尽管这些小组件是预配置的，但您仍然可以对其进行自定义，以更好地满足您的特定需求。它们是便于入门的起点。
## 生成式人工智能摘要
配置文件浏览器提供默认的由人工智能提供支持的客户见解，这些见解可以生成简洁的摘要（重点关注关键行为模式），根据互动历史记录提供个性化的客户见解，并从客户 360 度数据中获得切实可行的建议。人工智能生成的摘要通过识别跨多个客户接触点的模式、提供特定于每个客户的个性化行为见解，并支持改善客户体验和提高忠诚度，从而有助于组织做出数据驱动的决策。
![\[生成式人工智能摘要小组件。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/generative-ai-summary-1.png)
## 客户信息
“客户信息”小组件使用键值对组件为标准客户配置文件数据提供清晰、井井有条的视图。此默认小组件以易于扫描的格式自动显示重要的客户信息。
### 概述
此小组件利用键值对组件在结构化的布局中显示客户属性。
+ 名
+ 姓
+ 电子邮件地址
+ 电话号码
+ 地址
+ 账号
+ 个人资料 ID
### 数据
该小组件自动连接到 Customer Profiles 域，并从标准配置文件属性中提取信息。基本功能无需额外配置。
**注意**：尽管此小组件预配置了标准配置文件属性，但您可以根据自己的特定需求，自定义要显示标准配置文件中的哪些属性。
#### 了解详情
+ [标准配置文件定义](standard-profile-definition.md)
+ 键值对
## 计算的属性
通过“计算的属性”小组件，您可以利用客户配置文件的计算的属性中的数据来显示关键指标组件。
### 概述
通过“计算的属性”小组件，您可以利用客户配置文件的计算的属性中的数据来显示关键指标组件。
### 组件功能
+ 将计算指标显示为单值指标
### 使用案例示例可能为
+ 已交付的活动
+ 未结的案例
+ 平均通话时间
+ 渠道首选项
### 配置
只需选择计算的属性并选择首选的显示格式即可
**注意**
必须先在 Customer Profiles 域中配置计算的属性，然后才能在此小组件中使用这些属性。
**了解详情**
+ 关键指标
+ [设置计算的属性](customerprofiles-calculated-attributes-admin-website.md)
## 联系人
“联系”小组件使用表 JSON 组件构建，以井井有条的表格式显示 Customer Profiles 联系对象数据。此小组件自动连接到 Customer Profiles CTR 数据，同时显示关键的联系信息和互动历史记录。
### 功能
+ 查看所有客户联系活动
+ 对联系记录进行排序和筛选
+ 自定义显示的联系字段
+ 访问详细的联系信息
有关 Customer Profiles CTR 对象的更多信息，请参阅 [Amazon Connect Customer Profiles 中的联系人记录模板](ctr-contact-record-template.md)
## 案例
“案例”小组件使用表 JSON 组件构建，以井井有条的表格式显示 Customer Profiles 案例对象数据。此小组件自动连接到 Customer Profiles 案例数据，同时显示支持互动和案例管理详细信息。
### 功能
+ 查看所有客户案例
+ 对案例记录进行排序和筛选
+ 自定义显示的案例字段
+ 访问详细的案例信息
有关 Customer Profiles 案例对象的更多信息，请参阅 [Customer Profiles 中标准案例的对象类型映射](object-type-mapping-standard-case.md)。
## 订单
“订单”小组件使用表 JSON 组件构建，以井井有条的表格式显示 Customer Profiles 订单对象数据。此小组件自动连接到 Customer Profiles 订单数据，同时显示购买历史记录和交易详情。
### 功能
+ 查看所有客户订单事件
+ 对订单记录进行排序和筛选
+ 自定义显示的订单字段
+ 访问详细的订单信息
有关 Customer Profiles 订单对象的更多信息，请参阅 [为 Amazon Connect Customer Profiles 中标准订单的对象类型映射](object-type-mapping-standard-order.md)
## 资产
“资产”小组件使用表 JSON 组件构建，以井井有条的表格式显示 Customer Profiles 资产对象数据。此小组件自动连接到 Customer Profiles 资产数据，同时显示客户拥有的产品和服务。
### 功能
+ 查看所有客户资产记录
+ 对资产数据进行排序和筛选
+ 自定义显示的资产字段
+ 访问详细的资产信息
有关 Customer Profiles 资产对象的更多信息，请参阅 [Customer Profiles 中标准资产的对象类型映射](object-type-mapping-standard-asset.md)
# 自定义小组件
从头开始创建量身定制的控制面板组件，以满足您的特定业务需求。自定义小组件可让您在没有任何预定义数据的情况下构建独特的可视化效果。
![\[在配置文件浏览器布局中添加客户小组件。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/custom-widgets-1.png)
## 可用的自定义组件
+ [表](#table-widget)
+ [键值对](#key-value-pair)
+ [关键指标](#key-metric)
+ [圆环图](#donut-chart)
## 构建自定义小组件
**可以为每个自定义小组件配置：**
+ 自定义数据来源
+ 自定义显示
+ 自定义字段
+ 自定义项目互动
## 表
自定义表组件提供灵活的配置选项，用于以表格式显示数据，并具有用于互动和整理的高级功能。
### 功能
1. **列配置**
+ 定义自定义列标题
+ 为每列指定数据
+ 设置数据格式化选项
+ 定义列位置
1. **过滤**
+ 快速筛选表中的项目
1. **链接**
+ 连接资源链接
+ 无缝导航至：
+ Segments
+ 计算的属性
+ 在新选项卡中打开
+ **外部 URL 链接**
+ 将行项目值转换为 URLs 可以选择的值
+ 在新选项卡中打开
+ 根据行数据动态生成链接
+ 抽屉式视图链接
+ 在侧边抽屉中打开详细信息
+ 无需离开页面即可查看完整的记录详情
1. 数据整理
+ 分组
+ 按特定字段名称对行进行分组
+ 持久性组设置
+ 排序
+ 按任意列字段排序
+ 升序整理
+ 持久性排序设置
**图 1**
![\[自定义表小组件编辑示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/table-features-1.png)
**图 2**
![\[另一个自定义表小组件编辑示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/table-features-2.png)
### 示例配置
```
{
"Type": "Table",
"Props": {
"ColumnDefinitions": [
{
"Header": "Table column header"
"Cell": {
"Content": {
"Props": {
"Variant": "Link",
"LinkOptions": {
"LinkType": "Drawer"
}
},
"Type": "TextContent",
"Children": ["string"]
}
},
}
]
}
}
```
## 键值对
利用“键值对”组件，您能够以灵活、易于阅读的格式创建相关数据点的有条理显示。
### 概述
通过定义自定义键值关系来创建动态数据显示。此组件对于显示属性对特别有用，例如：
+ 客户详细信息
+ 账户信息
### 功能
1. **交互式链接选项**
+ 连接资源链接
+ 直接链接到相关资源
+ 无缝导航至：
+ 计算的属性
+ Segments
+ 在新选项卡中打开
+ 外部 URL 链接
+ 将项目值转换为您可以选择 URLs 的值
+ 在新选项卡中打开
+ 抽屉式视图链接
+ 在侧边抽屉中打开详细信息
+ 无需离开页面即可查看完整详情
1. 列配置
+ 定义 1-4 列键值对
1. 按逻辑分组整理配对
**图 1**
![\[自定义键值对小组件编辑示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/key-value-pair-features-1.png)
**图 2**
![\[另一个自定义键值对小组件编辑示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/key-value-pair-features-2.png)
### 示例配置
```
{
"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]"]
}
}
}
]
}
}
```
**注意**
此组件目前在用户界面生成器中不支持 `ProfileObjects`。
## 关键指标
关键指标组件使您能够以易于理解的格式突出显示关键业务指标和重要统计数据。 KPIs
### 概述
创建高可见度指标显示，以突出显示重要的数据点、趋势或状态指标。此组件非常适合展示：
+ 性能指标
+ 关键测量值
+ 状态摘要
+ 趋势指标
### 功能
1. **大的显示文字**
1. **指标格式**
1. **交互式链接选项**
+ 连接资源链接
+ 直接链接到相关资源
+ 无缝导航至：
+ 计算的属性
+ Segments
+ 在新选项卡中打开
+ 外部 URL 链接
+ 将项目值转换为您可以选择 URLs 的值
+ 在新选项卡中打开
+ 抽屉式视图链接
+ 在侧边抽屉中打开详细信息
+ 无需离开页面即可查看完整详情
1. **整理指标布局**
**图 1**
![\[自定义关键指标小组件编辑示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/key-metric-features-1.png)
**图 2**
![\[另一个自定义关键指标小组件编辑示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/key-metric-features-2.png)
### 示例配置
```
{
"Type": "KeyMetrics",
"Props": {
"MetricDefinitions": [
{
"MetricLabel": "Total Revenue",
"MetricValue": {
"Content": {
"Type": "TextContent",
"Props": {
"Format": "USD",
"FontSize": "large",
"FontWeight": "bold"
},
"Children": ["[string]"]
}
},
"Columns": 1
}
]
}
}
```
**注意**
此组件目前在用户界面生成器中不支持 `ProfileObjects`。
## 圆环图
圆环图组件通过圆形的圆环图实现了情绪评分的可视化。
### 概述
通过定义自定义评分标准来创建动态情绪可视化效果。此组件特别适用于显示：
+ 成功指标
+ 成就率
+ 风险评测
+ 性能指标
### 功能
1. 情绪分析选项
+ 正面情绪
+ 从零开始
+ 根据标准跟踪成就：
+ 自定义点值
+ 颜色编码的客户细分
+ 灰色表示未满足的条件
+ 显示成功率百分比
+ 负面情绪
+ 从最大值开始
+ 跟踪扣除额：
+ 颜色编码的客户细分
+ 积分扣除系统
+ 绿色表示剩余价值
+ 显示最终分数
1. 计算的属性值
1. 运算符选项
+ 等于
+ 不等于
+ 大于
+ 小于
1. 值条件
1. 每个条件分配的积分
**图 1：正面情绪示例**
![\[正面情绪小组件编辑示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/donut-chart-features-1.png)
**图 2：负面情绪示例**
![\[负面情绪小组件编辑示例。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/donut-chart-features-2.png)
### 示例配置
```
{
"Type": "DonutChart",
"Props": {
"Variant": "PositiveSentiment",
"ConditionDefinitions": [
{
"Title": "Customer Satisfaction",
"Color": "#4CAF50",
"CalculatedAttribute": "satisfaction_score",
"Operator": "GREATER_THAN",
"ValueCondition": 8,
"Points": 10
}
]
}
}
```
**注意**
**圆环图目前仅支持将计算的属性作为数据来源。**
**所有条件定义都必须包括标题、颜色、计算的属性、运算符、值条件和积分值。**
# 将配置文件浏览器添加到座席工作区
默认情况下，拥有相应[安全配置文件权限](enabling-profile-explorer.md)的用户可以在 Amazon Connect 管理员网站上查看配置文件浏览器。您可能还希望您的座席能够在其座席工作区中访问配置文件浏览器。本主题将介绍如何操作。
下图显示座席工作区中的配置文件浏览器示例。
![\[座席工作区，“配置文件浏览器”选项卡。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/profile-explorer-agent-workspace.png)
## 创建要与座席共享的配置文件浏览器布局
以下是高级概述：
1. 确保您拥有创建配置文件浏览器布局的[安全配置文件权限](enabling-profile-explorer.md)。
1. 按照[开始使用 Amazon Connect Customer Profiles 配置文件浏览器](getting-started-profile-explorer.md)中的说明创建并保存要与座席共享的布局。
## 将个人资料浏览器作为集成添加到 Amazon Connect
1. 在 Amazon Connect 控制台的左侧导航栏中，选择**集成**，如下图所示。
![\[Amazon Connect 控制台，“集成” 菜单项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/integrations.png)
1. 在**集成**页面上，选择**添加集成**。
1. 在**添加集成**页面上，填写**基本信息**部分的以下字段：
1. **显示名称**：应用程序的友好名称。**此名称将在座席工作区的选项卡上向座席显示**。它还显示在安全配置文件上。您可以回来更改此名称。
1. **集成标识符**：您的集成唯一的官方名称。如果每个访问网址只有一个集成，我们建议您使用访问网址的来源。您无法更改此名称。
1. **描述（可选）**：您可以选择为此应用程序提供任何描述。此描述不会向座席显示。
1. **集成类型**：选择**标准应用程序**。
1. **联系人范围**：选择**每个联系人**。这是来电支持的必需设置。
1. **初始化超时**：可以与工作区建立连接的最长时间（以毫秒为单位）。
下图显示了这些字段的配置。初始化超时设置为 5 秒。
![\[“基本信息”部分，为座席工作区上的配置文件浏览器所配置。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/add-integration.png)
1. 在**访问**部分，填写以下字段：
1. **访问 URL**：这是托管应用程序的 URL。除非是本地主机，否则 URL 必须是安全的，以 https 开头。
**重要**
URL 必须包含 `?_appLayoutMode=embedded`。例如：
`https://{CONNECT_INSTANCE}/customer-profiles/profile-explorer?_appLayoutMode=embedded`
如果不包括`?_appLayoutMode=embedded`，则 Amazon Connect 管理员网站的左侧导航栏将显示在代理工作区中。
有关此字段支持的内容的更多详细信息，请参阅[集成](3p-apps.md#onboard-3p-apps-how-to-integrate)。
1. **已批准的来源-可选**：如果与访问网址不同，则应允许的允许名单 URLs。除非是本地主机，否则 URL 必须是安全的，以 https 开头。
1. 填写接下来的两个部分（**权限**和 **Iframe 配置**）是可选的，将配置文件浏览器添加到座席工作区不要求填写这两个部分。有关这些部分的信息，请参阅[集成](3p-apps.md#onboard-3p-apps-how-to-integrate)。
1. **实例关联**：选择您的座席正在使用的实例。
您可以授予该账户区域内的任何实例访问此集成的权限。
1. 选择**添加集成**。
## 向座席分配对新的安全配置文件的权限
在此步骤中，您需要为代理分配访问新集成的权限，并向配置文件资源管理器分配查看权限。
1. 在 Amazon Connect 管理网站中，导航到**代理**安全配置文件。
1. 在**编辑安全配置文件**页面上，分配以下权限：
+ **Customer Profiles** - **配置文件浏览器** - **查看**
+ **代理应用程序**-**您的集成名称**-**访问权限**
下图显示了为名为 P **rofile Explorer** 的新集成添加权限的示例。
![\[新集成的安全配置文件权限。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/profile-explorer-securityperms.png)
## 告诉座席固定新的应用程序
使用正常的通信方法，告诉座席将新的应用程序固定到其座席工作区。这可让座席跨工作区实例访问配置文件浏览器。
+ 在座席工作区中，选择“更多”图标，然后选择**固定选项卡**，如下图所示。
![\[座席工作区，“固定选项卡”选项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/pin-tab.png)
## 支持的功能
完成上述步骤后，配置文件浏览器支持查找传入的联系人。支持以下：
+ 电话和聊天：完全支持
+ 自定义联系人属性：完全支持配置文件浏览器读取的用户定义属性。您可以在流中设置用户定义的属性以支持任何客户使用案例。例如：
```
{
"profileSearchKey": "_phone",
"profileSearchValue": "" }
```
有关更多信息，请参阅 [自动填充 Customer Profiles](auto-pop-customer-profile.md)。
# 预测性见解（预览版）
*预测见解*（预览）是 Amazon Connect 客户档案的一项功能，它使用人工智能为您的客户生成个性化的产品和内容推荐。通过分析客户互动数据，Predictive Insights 可帮助您在所有客户接触点上提供更相关的体验。
## 预测见解的工作原理
预测见解（预览版）使用 AI 模型来分析客户行为模式并生成实时建议。该服务会处理您的客户互动数据，例如购买历史记录和浏览活动，以识别模式和偏好。
+ **第 1 步：**使用现有数据连接器向配置文件添加交互数据，使用客户互动数据训练 AI 模型
+ **第 2 步：**向 S3 添加商品目录以允许客户档案通过访问您的商品数据 AWS 管理控制台
+ **第 3 步：**通过定义推荐类型（相似项目、经常配对的项目、热门项目）来创建推荐
+ **第 4 步：**在整个 Amazon Connect 生态系统中应用建议，包括代理工作区、Flows 和 Connect 人工智能代理
## 先决条件
+ **在客户资料中启用数据存储**
要使用客户档案训练 AI 模型，您需要启用数据存储。要了解更多信息，请参阅 “客户资料数据存储” 下的详细信息。
+ **KMS**
您已将客户资料配置为在 a 下对您的数据进行加密 AWS KMS key。
+ **安全配置文件**
您已将安全配置文件配置为支持查看（列出和查看预测性见解）、创建（创建推荐）、删除（删除推荐）和编辑（更新推荐）权限，并启用预测见解。
## 使用预测性见解的好处
使用预测见解可以带来以下几个主要好处：
+ 通过个性化推荐改善客户体验
+ 通过相关的产品建议增加销售机会
+ 通过自动显示相关建议来节省代理时间
+ 在所有客户接触点提供一致的建议
+ 随着客户行为的变化，实时更新建议
# 开始使用预测性见解
要开始使用预测见解，请按照以下步骤操作：
**Topics**
+ [步骤 1：将互动数据添加到客户资料中](#add-interaction-data)
+ [步骤 2：添加商品目录数据](#add-item-catalog-data)
+ [第 3 步：创建预测性见解](#create-predictive-insights)
+ [第 4 步：在客户互动渠道中使用预测性见解](#use-across-customer-engagement-channels)
## 步骤 1：将互动数据添加到客户资料中
您可以利用客户档案中的现有数据连接器将交互数据映射到标准的 Web Analytics 对象中。
有关更多信息，请参阅 [Web 分析对象的对象类型映射](standard-loyalty-promotion-object-mapping-web-analytics.md)。
## 步骤 2：添加商品目录数据
您可以使用标准目录数据来表示域内目录中的单个商品。此目录数据存在于域级别，与任何特定的客户档案无关。它可以结构化地呈现您的产品，可用于个性化功能。您可以使用数据连接器将产品或商品信息作为域对象导入到客户档案中，这些数据连接器为提取和维护目录信息提供了灵活的选项，从而确保您的产品数据保持最新且可在系统中访问。
有关更多信息，请参阅 [商品目录的对象类型映射](standard-loyalty-promotion-object-mapping-item-catalog.md)。
## 第 3 步：创建预测性见解
Amazon Connect 使您能够构建和部署根据您的特定产品推荐需求量身定制的专用 AI 模型。这些模型可以通过 Connect Web UI 进行配置，也可以通过编程方式进行配置 APIs ，以匹配您的独特业务场景。预测见解提供了几种类型的建议：
1. **为您推荐**-提供针对特定用户的个性化推荐。推荐基于用户过去的行为，例如点击流事件、购买事件、消费内容等。
1. **相似物品** ——使用生成式 AI 来查找主题上与目录中现有物品相似的物品。它非常适合客户希望向其用户提供替代商品推荐的追加销售或替代用例。
1. **经常配对的商品**-推荐经常与目录中现有商品交互的商品。它非常适合交叉销售或补充商品推荐用例。
1. **热门商品**-旨在推荐用户最常与之互动的物品。
1. **现在趋势**-推荐最近一段时间内参与速度增幅最大的商品。它旨在显示在用户互动中正在经历病毒式传播的项目。
**注意**
使用预测见解启用 AI 模型已在预览版中提供。将来可能会收取额外定价。
**按推荐类型划分的项目限制**
下表说明了生成建议时考虑的最大项目数，具体取决于所使用的建议类型。
| **推荐类型** | **描述** | **限制** |
| --- | --- | --- |
| 为您推荐 | 预测性见解所考虑的最大项目数 | 四千万 |
| 类似的物品 | 预测性见解所考虑的最大项目数 | 一千万 |
| 所有其他业务场景 | 预测性见解所考虑的最大项目数 | 750,000 |
## 第 4 步：在客户互动渠道中使用预测性见解
### 在 Connect 流程中使用客户资料推荐
本节介绍如何使用 “客户档案获取个人资料推荐” 流程区块通过实时为个人资料生成人工智能驱动的推荐，从而丰富联系期间的用户体验。
**流块属性**
“**获取配置文件推荐**” 流程块具有以下属性可供配置：
1. **个人资料 ID（必填）：**
此区块需要配置文件 ID 才能正常运行。“**获取个人资料推荐**” 流程区块会针对此处提供的个人资料 ID 生成推荐。您可以选择手动输入配置文件 ID 或使用存储在属性中的预定义值。如果使用预定义的值，请确保使用前面的 “**获取配置文件” 区块来提供配置文件** ID。使用 “**获取配置文件**” 块可以精确定位特定的配置文件，然后再继续在后续区块中生成推荐。
1. **推荐人姓名（必填）：**
要使此区块发挥作用，必须提供推荐人名称。这是您要用来为给定个人资料 ID 生成推荐的推荐人的姓名。您只能使用活跃的推荐人来生成推荐。
1. **最大结果（必填）：**
为给定的个人资料 ID 生成的最大推荐数量。这可以介于 1 到 3 个建议之间。
1. **推荐属性（必填）：**
定义推荐回复的哪些属性将保留在联系人属性中。
1. **商品编号：**
这是作为附加上下文提供的商品 ID，用于为给定个人资料 ID 生成推荐。仅当使用 “*相似商品” 或 “*经常配对的商品”** 推荐类型时，才需要商品编号。您可以选择手动输入配置文件 ID 或使用存储在属性中的预定义值。如果使用预定义值，请确保使用前面的 “**获取计算属性”** 区块提供商品 ID。使用 “**获取计算的属性”** 块可以精确定位特定的项目 ID，然后再向前移动，以便在后续区块中生成推荐。
**流块分支**
“**获取个人资料推荐**” 流程块可以将联系人路由到以下分支：
1. **成功：**
已成功为提供的个人资料 ID 生成推荐。选定的推荐属性保留在联系人属性 \$1.Customer.Recomporations 中。
1. **错误**：
尝试生成推荐时遇到错误。这可能是由于系统错误或 “**获取配置文件推荐**” 区块的配置方式所致。
1. **未找到：**
无法生成任何建议。
**使用区块中的推荐**
推荐回复 JSONPath 作为推荐对象的 JSON 列表保留在 \$1.Customer.Recompordations 联系人属性中。每个推荐对象都将包含选定的**推荐属性**。
以下来自 Lambda 函数的 Python 示例代码片段展示了如何使用它来转换来自**获取个人资料**推荐区块的推荐并将其保留为其他联系人属性，以便在后续区块中使用这些推荐。
```
import boto3
import json
# Handle lambda request
def lambda_handler(event, context):
print("Contact flow data: ", event)
# Transform recommendations
recommendations = event['Details']['Parameters']['Recommendations']
contact_attributes = {}
for i, rec in enumerate(recommendations):
contact_attributes.update(flatten(rec, i))
# Set contact attributes using each recommendation attribute value
print("Setting contact attributes: ", contact_attributes)
try:
client = boto3.client('connect', region_name="us-west-2")
client.update_contact_attributes(
InstanceId=event['Details']['ContactData']['InstanceARN'].rsplit('/', 1)[1],
InitialContactId=event['Details']['ContactData']['InitialContactId'],
Attributes=contact_attributes
)
print("Contact attributes set successfully.")
except Exception as e:
print("Error setting contact attributes: ", e)
# Success response
return {
'statusCode': 200,
'body': json.dumps('Success')
}
# Flatten a nested object into a simple string:string object
def flatten(recommendation, index):
flat = {}
for key, value in recommendation.items():
if isinstance(value, dict):
flat.update(flatten(value, index))
else:
flat[f"Rec{index}_{key}"] = str(value)
return flat
```
使用 “**获取个人资料推荐**” 区块设置流程后，您就可以开始使用它在客户联系期间为他们生成推荐。
### 在出站促销活动中使用客户资料建议
您可以将 Predictive Insights 与 Amazon Connect 出站活动集成，通过电子邮件和短信渠道提供个性化推荐。创建事件触发的活动时，您可以将 “推荐” 部分配置为针对与该活动关联的客户资料自动生成基于人工智能的推荐。
此集成使用 Web Analytics 对象映射作为事件类别来捕获客户互动数据，从而使推荐引擎能够根据客户行为提供相关且有针对性的建议。
有关在事件触发的活动中配置推荐的 step-by-step说明，请参阅。[使用事件触发器创建出站活动](how-to-create-campaigns-using-event-triggers.md)
### 为销售推荐设置 Connect 人工智能代理
Amazon Q in Connect 通过其新的 “编排” 代理类型增强了代理功能。此功能对于创建可以提供商品推荐的 Sales AI 代理特别有用，在追加销售和交叉销售场景中尤其有用。
**开始使用**
要开始实施，请访问 AWS 管理控制台 并导航至 Amazon Connect。通过访问网址登录您的 Connect 实例后，从左侧菜单中找到 Amazon Q，然后选择 AI 代理。在 QiC 页面的 AI Agent 下，你可以找到一个处于草稿状态的 Orchestration (SalesAgent) 类型的预先配置的 AI 代理。此模板包含了 1P 工具的所有必要配置和推荐示例提示。
**创建您的自定义代理**
要创建自定义销售代理，请先创建一个编排类型的新 AI 代理，然后从现有 SalesAgent 模板中复制。此过程将所有工具和配置从模板传输到您的新代理。
**自定义代理**
在更新代理的提示时，管理员有两个主要选择。他们可以将现有的代理提示附加到销售代理提示并添加追加销售标识说明，也可以通过删除 SalesAgent 提示并根据当前发布的代理创建新的 Orchestration 提示并在其中添加销售代理提示来重新开始。这种灵活性允许根据特定的业务需求和领域要求提供量身定制的解决方案。
**流程配置和集成**
完成代理配置并发布后，下一步是在 Flows 下创建 Amazon Lex 机器人。需要更新入站流以包含已创建的 Lex bot 的 GetCustomerInput 区块，并且 SalesAgent 应在其他选项中选择新的方块。您需要添加用于检索配置文件 ID 的客户资料流程块和设置联系人属性流程块，将配置文件 ID 和值设置 CustomerId 为 \$1Customer 的密钥。 ProfileId。
该实现支持聊天联系人和语音通话，客户输入的内容可以无缝传递给 Lex 机器人上的 QIC 代理。这种全面的设置可在您的 Amazon Connect 环境中提供人工智能驱动的销售建议和追加销售机会。该系统的灵活性允许根据特定的行业需求进行定制，同时保持智能销售辅助的核心功能。该解决方案提供了一个框架，用于通过人工智能驱动的推荐来增强客户互动，最终支持更有效的销售和客户服务运营。管理员可以通过添加特定领域的说明和自定义建议类型来进一步完善实施，以满足其业务需求。
### 配置 SalesAgent 为用于代理协助
您可以将配置 SalesAgent 为在座席工作区的 Q in connect 聊天控件中使用。要做到这一点，你需要修改两个主要内容。
1. 使用访问联系人记录的说明更新 AIAgent 提示。
1. 在 Prompt 编辑器 SalesAgent 中打开与提示相关的提示并更新提示以添加访问联系人笔录的说明 ` {{$.transcript}} `
1. 以下是可以附加到提示符的示例 SalesAgent提示。
```
**IMPORTANT**
**Guide on how to process requests and information:**
- The messages section contains YOUR conversation with the customer service agent
- Respond to the agent's questions/requests in the messages section
- The transcript below is background information about the agent's conversation with their customer
- Do not respond directly to the customer - you are helping the AGENT
Background context from agent-customer conversation.
The following transcript is for your information ONLY. Do not directly respond to messages in this conversation, but instead look at the messages section for what the agent requests you to do.
IF YOU REFERENCE ANY INFORMATION FROM THIS SECTION: You should indicate so by saying "According to your conversation with the customer ..."
{{$.transcript}}
```
1. AIAgent 使用新的提示版本更新，并使用此代理更新 “默认配置” → “代理协助” 用例。
**注意**
建议使用两种不同的自助服务销售 AIAGent 和代理协助用例，因为两者都需要对提示进行细微的修改。这可以通过克隆代理来完成，只需更改提示版本并更新默认配置以指向相应用例的正确的 AI Agent
1. 更新联系人入站流程。
1. 移除方 GetCustomerInput 块然后改为添加 Connect 助手流程块
1. 在流程块配置中填写 AIAssistant ARN，然后选择相应的。 AIAGent
现在，您可以将此流程用作常规入站流程，而 Q in connect 聊天小部件应该能够提供建议来帮助处理用户的请求。
## 数据注意事项
以下各节提供了有关如何匹配用例和评估预测见解的数据准备情况的指导。
### 您是否将自己的用例与预测见解进行了匹配？
预测见解个性化类型可以解决以下用例：
+ 为用户生成个性化建议
+ 推荐类似或相关物品
+ 推荐趋势或热门物品
+ 按相关性对项目重新排序
### 您是否有足够的物品交互数据？
对于所有用例和个性化类型，您必须与 25 位独立用户进行至少 1,000 次项目互动，每位用户至少有两次互动。为获得高质量的建议，我们建议您至少有 1000 名用户的最少 5 万次物品交互，每位用户有两次或更多次物品交互。
### 您是否有实时事件流式传输架构？
如果您能够将实时事件流式传输到 Connect 客户档案，则可以利用实时个性化功能。通过某些个性化类型，Predictive Insights 可以从用户的最新活动中学习，并在他们使用您的应用程序时更新推荐。
### 您的数据是否针对预测性见解进行了优化？
我们建议您在数据中检查以下内容：
+ 检查是否缺失值。我们建议至少 70% 的记录包含每个属性的数据。我们建议允许空值的列的填写率至少为 70%。
+ 修复数据中的任何不准确或问题，例如命名惯例不一致、项目类别重复、数据集 IDs 间不匹配或重复 IDs。这些问题可能会对建议产生负面影响或导致意外行为。例如，你可能同时有 “N/A” and “Not Applicable” in your data, but filter out recommendations based on only “N/A”。标记为“不适用”的物品不会被筛选器删除。
+ 如果一个物品、用户或操作可以有多个类别（例如一部电影有多种类型），请将分类值合并到一个属性中，并使用 \$1 运算符分隔每个值。例如，电影的 GENRES 数据可能是动作 \$1 冒险 \$1 惊悚片。
+ 避免为一列设置超过 1000 个可能的类别（除非该列包含仅用于筛选目的的数据）。
# 使用 Amazon Connect Customer Profiles API
有关如何以编程方式管理域和资料的信息，请参阅 [Amazon Connect Customer Profiles API 参考](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html)。
## ListObjectTypeAttributeValues API
ListObjectTypeAttributeValues API 提供对任何指定属性的最新不同值的访问权限，因此对于对象类型内的实时数据验证和一致性检查非常有用。此 API 跨域运行，支持自定义和标准对象类型。API 接受对象类型名称、属性名称和域名作为输入参数，并返回的值不超过大约 350KB 的存储限制。
**注意：**
+ 我们每个字段最多可存储 350KB 的属性值，优先考虑最新的值。达到此限制后，将自动删除较旧的值，以便为新条目腾出空间。
## GetObjectTypeAttributeValues API
该 GetObjectTypeAttributeValues API 提供有关特定对象类型内属性的统计见解，但仅适用于启用了数据存储的域。此 API 执行每日计算，以提供有关您的属性值的统计信息，从而帮助您了解数据的模式和趋势。统计计算每天执行一次，从而提供属性数据特征的一致快照。
**注意：**
+ 在两种情况下，您会收到空值：
+ 在启用 Data Vault 后的第一个时段（除非出现计算周期，即每天发生一次）。
+ 适用于不包含数值的属性。
我们建议在将客户档案集成到您自己的代理应用程序中时使用 CustomerProfile JS 开源库。有关更多信息，请参阅 [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles) 上 CustomerProfiles的 JS 存储库。
有关如何将现有应用程序与 Amazon Connect 集成的更多信息，请使用 [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams)。您可以将联系人控制面板 (CCP) 组件嵌入到应用中。
# 在 Amazon Connect 客户档案中了解 IPv6 支持
## 公有连接
所有 Amazon Connect 客户档案都 APIs 完全支持 IPv4 和 IPv6 致电。
```
profile.Region.api.aws
```
**例如**：
```
profile.us-east-1.api.aws
```
对于 AWS CLI，您需要显式使用这些端点：
```
aws customer-profiles list-domains \
--endpoint https://profile.us-east-1.api.aws \
--region us-east-1
```
旧版本 APIs 仍可作为向后兼容性使用。他们只支持 IPv4 通话。
```
profile.Region.amazonaws.com
```
**例如**：
```
profile.us-east-1.amazonaws.com
```
## 私有连接
您可以使用 Amazon VPC 控制台或 AWS 命令行界面（AWS CLI）为 Amazon Connect Customer Profiles 服务创建 VPC 端点。有关更多信息，请参阅 AWS PrivateLink 指南中的[创建接口终端节点](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html)。
使用以下服务名称为 Amazon Connect Customer Profiles 创建 VPC 端点：
```
com.amazonaws.Region.profile
```
**例如**：
```
com.amazonaws.us-east-1.profile
```
如果您为终端节点启用私有 DNS，则可以使用该终端节点 IPv4 和该地区 IPv6 支持的 DNS 名称（例如 profile.us-east-1.api.aws）向 Amazon Connect 客户档案发出 API 请求。
或者，也 IPv4仅支持该地区的旧 DNS 名称。
**例如**：
```
profile.us-east-1.amazonaws.com
```
# 示例：以编程方式将 S3 与 Amazon Connect Customer Profiles 集成
使用客户档案 [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API，您可以通过编程方式为 S3、Salesforce、Marketo 等创建集成。
在本主题中，我们将介绍如何创建同步间隔为 15 分钟（当前支持的最小值）的 S3 集成。
## 步骤 1：创建 JSON 文件
使用以下内容创建 JSON 文件：
```
{
"DomainName": "your-domain",
"ObjectTypeName": "your-object-name",
"FlowDefinition": {
"FlowName": "your-flow-name",
"KmsArn": "the key ARN is the same as your domain's key",
"Description": "Created by Customer Profiles",
"TriggerConfig": {
"TriggerType": "Scheduled",
"TriggerProperties": {
"Scheduled": {
"ScheduleExpression": "rate(15minutes)",
"DataPullMode": "Incremental",
"ScheduleStartTime": 1634244800.435,
"FirstExecutionFrom": 1594166400
}
}
},
"SourceFlowConfig": {
"ConnectorType":"S3",
"SourceConnectorProperties": {
"S3": {
"BucketName": "your-bucket",
"BucketPrefix": "your-prefix"
}
}
},
"Tasks": [
{"TaskType":"Filter","SourceFields":["colA","colB"],"ConnectorOperator":{"S3":"PROJECTION"}},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colA","TaskProperties":{},"SourceFields":["colA"],"TaskType":"Map"},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colB","TaskProperties":{},"SourceFields":["colB"],"TaskType":"Map"}
]
}
}
```
要使用您自己的值自定义 JSON，请遵循以下准则：
+ `FlowName`：可以是 STRING [a-zA-Z0-9][\$1w\$1@\$1.-]\$1
+ `ScheduleStartTime`：设置为当前的 `DateTime` \$1 5 分钟（采用纪元时间）。
+ `FirstExecutionFrom`：转到 S3，查看文件日期，然后使用最早日期之前的日期。
+ `Tasks`：定义 `TaskType`。在 `Sourcefields` 字段中，您必须提供该数组中 CSV 中的所有列。然后，对于该数组中的每个项目，您需要指定 `ConnectorOperator`。此示例适用于包含两个列的 CSV 文档：`colA` 和 `colB`。
## 第 2 步：调用 PutIntegration API
使用您的值创建并自定义 JSON 文件后，调用 [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API，如以下示例所示：
```
aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2
```
来自 `PutIntegration` 的响应返回一个流 URI。例如：
```
{
"DomainName": "testDomain",
"Uri": "arn:aws:appflow:us-west-2:9999999999999:flow/Customer_Profiles_testDomain_S3_Salesforce-Account_1634244122247",
"ObjectTypeName": "your objec type",
"CreatedAt": "2021-10-14T13:51:57.748000-07:00",
"LastUpdatedAt": "2021-10-14T13:51:57.748000-07:00",
"Tags": {}
}
```
## 第 3 步：调用亚马逊 AppFlow StartFlow API
使用流程 URI 调用亚马逊 AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html)API。例如：
```
aws appflow start-flow —flow-name uri --region us-west-2
```