创建或更新客户

该类接口提供创建DM Hub客户的能力，共有三个接口：

• 创建客户

  最基本的客户创建接口，提供根据单个身份来创建或更新客户的能力。不支持多客户身份，不支持客户合并能力。

• 批量创建客户

  提供根据单个身份批量创建客户的能力。不支持多身份、不支持客户合并。

• 多身份创建客户

  支持根据多个身份创建客户，支持按身份优先级和唯一性处理客户身份，支持根据身份来合并客户。

三个接口的比较：

关于省市区字段，系统会做校验并规范化：

• 建议省份不要带"省"字，城市不要带"市"字，系统会规范化统一去掉"省"，"市"
• 如果只填写城市，则自动补全省份
• 直辖市：填写省份，则城市、省份字段都取省份；区县填写到城市，规范化至区县，未填写省份，补全省份和城市

关于手机号格式的说明

手机号码格式：

国内手机号：+86/0086/86/+(86)或无任何前缀的11位手机号码，例如1590000****。

国际/港澳台手机号：第一位为+，第二位为不为0的数字，最大15位数字, 例如+852000012****。

创建或更新客户

批量创建或更新客户

多身份创建或更新客户

使用API创建客户时可以附带多个客户身份信息，根据策略的不同，DM Hub会进行客户创建、更新或合并。具体步骤如下：

根据提供的客户数据和客户身份数据，DM Hub首先使用“目标客户策略”寻找或创建目标客户； 如果身份不冲突，DM Hub将未关联客户的身份关联到目标客户； 找到目标客户后，DM Hub会根据“客户合并策略”决定是否对多个客户进行合并； DM Hub将API提供的客户字段更新到目标客户。

客户创建中的策略表:

• 身份唯一性策略
  • 系统身份唯一性策略：在DM Hub设置中心进行设置
• 身份优先级策略(identityPriorityStrategy)
  • 系统身份优先级 (system)：使用系统配置的身份优先级
  • 自定义身份优先级 (custom)：以API提供的身份的顺序为优先级
• 目标客户策略(targetCustomerStrategy)
  • 高优先级身份优先(identityFirst)：按优先级顺序查找到的第一个与优先级较高的身份没有身份冲突的客户为目标客户，否则新建一个客户作为目标客户
  • 最先找到的客户优先(customerFirst)：按优先级顺序查找到的第一个客户为目标客户，否则新建一个客户作为目标客户
• 客户合并策略(autoMerge)
  • 不合并客户(false)：如果根据提供的多个客户身份找到多个客户，不对客户进行合并。
  • 合并客户(true)：如果根据提供的多个客户身份找到多个客户，先将其他与目标客户的身份没有唯一性冲突的客户合并到目标客户，再对目标客户进行字段更新。

乐观锁处理：

• 遇到乐观锁的异常请进行重试
• 详情请看：锁异常的处理

开启加密功能对参数和响应的影响

• 倘若用户在2.8版本之前开启过任意属性加密（包含：客户属性，客户身份属性，会员属性，客户事件属性，自定义对象属性），现在客户属性加密仍是开启状态，那么创建或更新客户返回的客户对象里被加密字段内容将是密文。
• 倘若用户在2.8版本之前没开启过任意属性加密（包含：客户属性，客户身份属性，会员属性，客户事件属性，自定义对象属性），现在客户属性加密是开启状态，那么创建或更新客户返回的客户对象里被加密字段内容将是明文。
• 不管现在客户属性加密是否开启，创建或更新客户请求参数的客户属性一直都是明文。