Amazon Connect Customer Profiles 中的对象类型映射定义详细信息
对象类型映射定义具有两个部分:字段定义和键定义。
提示
要了解如何创建对象类型映射器,请参阅此博客文章:使用预先构建的 Amazon S3 连接器,通过 Amazon Connect Customer Profiles 统一和整理客户信息
字段定义详细信息
字段定义用于定义字段的源、目标和类型。例如:
"Fields": { "{fieldName}": { "Source": "{source}", "Target": "{target}", "ContentType": "{contentType}" }, ... }, ...
-
Source
:这可以是字段的 JSON 访问器,也可以是用于生成字段值的 Handlebar 宏。正在解析的源对象被命名为
_source
,因此源字段中的所有字段都需要以此字符串为前缀。仅支持_source
对象。使用 Handlebar 宏解决方案生成常量并将多个源对象字段组合成一个字段。这对于编制索引很有用。
-
Target
:指定在标准对象类型中,该字段的数据应映射到何处。通过填充标准资料,您可以将从任何数据源摄取的数据与基于 Customer Profiles 构建的应用程序结合使用,而无需具体了解所摄取数据的格式。
该字段是可选的。您可能想定义字段,仅仅是为了将其包含在键中。
此字段的格式始终为 JSON 访问器。唯一支持的目标对象是
_profile
。 -
ContentType
:支持以下值:STRING、NUMBER、PHONE_NUMBER、EMAIL_ADDRESS、NAME。如果未指定ContentType
,则会采用 STRING。ContentType
用于确定如何为该值编制索引,以便座席可以对其进行搜索。例如,如果ContentType
设置为 PHONE_NUMBER,则会处理电话号码,以便座席可以采用任何格式搜索该号码:字符串“+15551234567”与“(555)-123-4567”匹配。
键定义详细信息
键包含一个或多个字段,这些字段共同定义了一个键,该键可用于使用 SearchProfiles API 搜索对象(或它们所属的资料)。也可以将键定义为唯一标识资料或唯一标识对象本身。
"Keys": { "{keyName}": [{ "StandardIdentifiers": [...], "FieldNames": [ "{fieldname}", ...] }], ... }, ...
键名称是域的全局名称。如果您有两个键,并且在两个不同的对象类型映射中具有相同的名称:
-
这些密钥应该占用相同的命名空间
-
它们可以用于潜在地将不同对象之间的资料链接在一起。如果它们在不同对象之间匹配,则 Customer Profiles 会将这两个对象放在同一个资料中。
换句话说:当且仅当相同的值意味着键相关时,键在域中应该具有相同的键名称。例如,在一种类型的对象中指定的电话号码将与在另一种类型的对象中指定的相同电话号码相关。为从 Salesforce 导入的对象指定的内部标识符可能与从 Marketo 导入的另一个对象无关(即使它们的值完全相同)。
密钥定义的使用方式有两种:
-
在摄取期间,在 Customer Profiles 中,它们用于确定应将对象分配给哪个资料。
-
它们允许您使用 SearchProfiles API 来搜索键值并查找相应资料。
默认搜索密钥
默认搜索密钥(例如 _phone
和 _email
)由标准配置文件、标准资产、标准订单和标准案例对象模板预定义。您可以使用默认搜索密钥作为 SearchProfiles API 的密钥名称来查找配置文件。