自定义对象

1.概述

在使用DM Hub的时候，企业往往是以客户为管理对象，围绕客户开展各种各样的业务场景，比如筛选符合一定条件的客户、给客户打标签、记录客户订单。基于这些场景，系统提前预设了很多数据对象，比如：客户、事件、订单、身份等等，但是企业实际的业务场景所包含的对象不止这些，比如B2B企业的场景可能涉及：合同、销售、公司、工单等对象的管理，零售快消行业可能会涉及：商品、优惠券、门店等对象的管理。单纯的管理客户并不能满足以上这些业务场景的需求。有了自定义对象，就可以支持新增对象，添加对象属性，建立对象之间的关联关系，实现除客户以外，对其他对象的管理。

2.应用场景

自定义对象可应用的对象较为广泛，那么用自定义对象具体可以实现哪些场景呢？和客户一样，自定义对象可以被筛选分析、消息触达和参与自动流程的搭建，比如：

筛选领取过XXX优惠券几次的客户（自定义对象为优惠券）

针对华东地区的公司的客户发送消息通知（自定义对象为公司）

一个客户可能拥有多辆车，对即将需要保养的那部分车的车主发消息提醒他们去保养，消息里插入车信息变量——您的XXX车需要保养（自定义对象为车）

购买过指定的某几种品类，支持限定客户订单的关联商品的属性（自定义对象为商品）

3.自定义对象配置

如需使用自定义对象，则首先需配置一个对象。并且，和客户一样，自定义对象可以新建事件、关联订单、给对象打标签等。

3.1新建自定义对象

点击【设置-系统设置-自定义对象】，或在左侧菜单导航中点击【自定义对象】，进入自定义对象配置界面。
自定义对象配置中心可查看自定义对象列表，可根据对象名称或ID进行搜索。

点击右上方【新建】按钮，可创建新的自定义对象。我们一共提供 20 个自定义对象的创建额度，其中通用档案至多能创建 5 个，通用档案超过 5 个后将不能再创建通用档案；超过 20 个自定义对象后则任何类型档案都无法创建。

自定义对象目前提供两种类型：

1）通用档案

通常情况下，标准档案相对于客户主档案较为独立，业务能力接近于客户主档案。你可以对标准档案打标签，圈群或触达。标准档案的事件会记录在标准档案上。当然你可以创建关联关系到客户主档案上或其他档案，互为信息的补充。例如，客户购买的车（一辆具体的车是一个实体）比较适合使用标准档案类型

2）其他/纬度类型档案

通常情况下，是对客户主档案维度信息的补充，或者是一类临时需要记录的数据。维度本身不能触达，但可作为客户主档案圈群，打标签的额外筛选信息，有助于更精准的触达

创建时，需要填入一些设置项。

对象类型：对象类型在创建后不可修改

对象名称：为此对象进行命名

对象ID：为对象设置一个唯一ID，仅支持英文字母、数字和下划线。创建后不可修改

描述：可简要说明此对象的业务意义

图标：为对象设置专属图标，在菜单或系统内可显示

菜单入口：可选择除设置中心外的对象列表入口

设置完成后，点击【确定】即创建对象成功。

3.2自定义对象删除

在自定义对象列表中，可删除一个自定义对象，删除自定义对象不仅是删除此条自定义对象的设置，也会将所有的具体对象及其数据全部删除，需谨慎操作。

3.3自定义对象的设置

创建了自定义对象后，可设置自定义对象的属性。

在自定义对象列表中点击编辑按钮，可查看到该对象的基本信息与属性。 在基础信息tab下可以对自定义对象创建时的基础信息进行编辑

3.3.1属性设置

一个新的对象默认有以下这些属性：

ID:一个具体对象的主键，具有唯一性，用于标识该具体对象，该属性名称、ID不可修改。例如，微信openID就是一个
Name:一个具体对象的名字，该属性可修改名称
创建者：一个具体对象的创建者
创建时间：一个具体对象的创建时间
最后更新时间：一个具体对象的最后更新时间

点击【创建】可为自定义对象创建新的自定义属性。

自定义属性有多种类型，不同的类型可存储不同的数据，作用也不同
文本：存储文本类型的值，一般是对象的固定信息，比如“所在城市”
数值：存储数值类型的值，一般是对象的数字类型的信息，比如“公司人数”
日期：存储日期类型的值，一般是对象的某些重要日期，比如“注册日期”
查找关系：用于建立当前对象和其他对象的关联关系
主从关系：将当前对象作为从对象关联至某个主对象，删除主对象时将相应地删除关联的从对象
手机号码：存储对象的手机号码信息，可用于对具体对象发送短信
邮箱：存储对象的邮箱信息，可用于对具体对象发送邮件

3.3.2事件设置

系统预设有事件，比如发送短信、发送邮件、购买商品和服务等，另外还可以创建自定义对象事件。自定义对象事件暂不支持打分、推进阶段、加内容标签等。需要选择事件属于哪个对象。 切换tab至事件，可查看到自定义对象事件的列表。
点击右上方【新建】可新建一个对象的自定义事件。可设置事件名称、事件id、事件属性等。
注意：通用档案支持创建事件，其他/纬度类型档案不支持创建事件。
事件属性里支持创建查找关联字段，至多10个。选择了关联对象后，在高级筛选或分析中心里可以通过限制事件关联的对象的属性来进行筛选。

3.3.3自定义对象属性加密设置

自定义对象属性加密设置与客户对象属性加密一致，选择类型为文本类型的字段进行加密。设置完成后，数据将以加密的形式存入数据库，在没有做任何脱敏设置的情况下，数据在DM Hub前端界面以明文的形式展示，对于一些敏感数据，不希望明文展示的，需要同时对属性进行脱敏设置。

3.3.4自定义对象属性脱敏设置

在使用系统的自定义对象的功能时，有时基于业务的需要，会对部分的属性字段进行脱敏显示，即显示自定义属性字段值时，需要对全部或部分内容的显示使用“***”替代。
DMHub系统支持对自定义对象的一部分字段进行脱敏设置，例如：手机号，邮箱等

3.3.4.1设置脱敏字段

创建脱敏字段
自定义对象详情页面点击”数据脱敏“Tab，数据脱敏Tab下分为两个部分：”部分角色查看时显示明文“和”对象属性“。

在“部分角色查看时显示明文”中，可选择系统中国已经创建好的角色，当拥有此角色的用户访问页面时，无视数据脱敏的限制，全部明文显示。
在“对象属性”中，可点击”添加属性“，会弹出弹窗，在弹窗中设定UDO的属性加密。
在弹窗中完成设置后点击确认，页面显示”字段名“和”脱敏规则“、”打码位置“、”打码长度“等信息。
选择对象属性–可选择不包括日期类型的其他类型的字段；脱敏规则支持部分打码和全部打码，默认选择部分打码；打码位置支持前面、中间、后面，默认选择前面；打码长度可输入数字，输入数字后下方文本会基于输入的数值掩码显示示例。

编辑&删除脱敏字段设置 完成创建后可点击编辑对已经创建的脱敏规则进行调整，或点击删除按钮去除已经创建的脱敏规则。

3.3.4.2完成脱敏设置的自定义对象显示效果

自定义对象列表的脱敏样式如下：

自定义对象详情的脱敏样式如下：

3.3.5自定义对象详情页显示设置

系统中可创建多个不同的自定义对象，但是不同的自定义对象承载的业务也不同；
因此，在使用自定义对象功能进行业务管理时，可按照业务的要求设置自定义对象详情页面显示的内容，让自定义对象的显示更加符合业务要求。
详情页设置：
点击自定义对象设置页面中的“详情页设置”的tab，在此tab下可对在线索详情页中显示哪些tab进行设置。
选择需要添加的tab选项，完成添加后可在详情页中进行显示，可选项为：时间轴、关联对象、标签、消费订单、退货订单。

4.对象数据的增查改删

自定义对象数据支持API导入或文件导入。
API导入请参考 pathname:///../api-docs/v2/restapi/saveOrUpdate-udo-data
文件导入有两个入口。
1）在自定义对象里面点击【导入】
上传文件

2）设置中心-数据导入

选择要导入的数据的对象

上传文件

在自定义对象的高级筛选里面可以根据自定义对象相关的数据进行自定义对象的筛选

筛选出符合条件的对象后可批量对其进行修改

也可删除部分对象

筛选出目标对象然后选择导出的自定义对象的属性数据

5.自定义对象群组和标签

5.1群组

自定义对象也可以建立群组，但是自定义对象的群组和客户的群组是完全分开的，在客户的群组里面只能看到客户群组，在自定义对象里面只能看到自定义对象群组。

5.2标签

自定义标签支持创建静态值标签和导入外部值标签，类型包括：文本，数值，时间和查找关系

查找关系：给客户或者自定义对象打标签的时候，支持根据用户设置的标签id来打标签

自动流程中，自定义对象的属性判断支持值标签的判断

自动流程中，自定义对象的【修改标签】里支持值标签的修改

值标签可以进行高级筛选（包括：静态值标签和外部值标签）

6.自定义对象触达

自定义对象支持圈选对象群组，也可以通过筛选器进行对象圈选，然后保存到群组，支持静态群组和智能群组。
圈选完成后即可对该群组的对象进行各种触达，如短信、邮件、APP Push，且支持在各种类型的触达消息中插入自定义对象的属性、上下文事件属性、值标签作为变量信息，下面一一介绍各类消息关于自定义对象的发送处理。

6.1短信

首先在编辑短信内容时，支持插入自定义对象的属性、上下文事件属性、值标签作为内容变量。

注意：一旦插入某个自定义对象的变量，便不再允许插入其他对象的变量。

内容编辑完成后，进行群发时可选择对应的自定义对象群组及关联对象的手机号进行发送。

发送完成后会在关联对象的时间轴记录发送行为。

6.2邮件

邮件有HTML和模板编辑两种模式，两种模式都支持插入自定义对象的属性、上下文事件属性、值标签作为变量信息。

HTML模式：

模板模式：

内容编辑完成后，同样在群发的时候同样可以选择具体群发的对象组。

6.3APP Push

APP Push的消息中支持插入自定义对象的属性、上下文事件属性、值标签信息，发送的时候自动取对应的变量信息进行显示。

6.4Webhook

新建Webhook消息时可直接在消息体中插入自定义对象的属性、上下文事件属性、值标签信息。

6.5视频短信

如果需要给UDO发送视频短信，请确保已经启用新渠道框架。在创建视频短信模板时可直接在消息体中插入自定义对象的属性、上下文事件属性、值标签信息。

注意：一旦插入某个自定义对象的变量，便不再允许插入其他对象的变量。

内容编辑完成后，进行群发时可选择对应的自定义对象群组及关联对象的手机号进行发送。

发送完成后会在关联对象的时间轴记录发送行为。

6.6彩信

如果需要给UDO发送彩信，请确保已经启用新渠道框架。在创建彩信模板时可直接在消息体中插入自定义对象的属性、上下文事件属性、值标签信息。

注意：一旦插入某个自定义对象的变量，便不再允许插入其他对象的变量。

内容编辑完成后，进行群发时可选择对应的自定义对象群组及关联对象的手机号进行发送。

发送完成后会在关联对象的时间轴记录发送行为。

6.7微信公众号

如果需要给UDO发送微信公众号的模板消息和订阅通知，请确保已经启用新渠道框架。在创建微信公众号的模板消息的模板和订阅通知的模板时可直接在消息体中插入自定义对象的属性、上下文事件属性、值标签信息。

注意：一旦插入某个自定义对象的变量，便不再允许插入其他对象的变量。

在发送前，请为需要触达的UDO创建对应的UDO属性（文本类型），用于存储微信公众号的Openid，并线下将Openid导入此对象属性。

无论是群发或自动流发送，选择UDO后，选择之前创建的UDO对象属性，并完成其他发送配置的输入

6.8微信小程序

如果需要给UDO发送微信小程序订阅消息，请确保已经启用新渠道框架。在创建微信小程序订阅消息模板时可直接在消息体中插入自定义对象的属性、上下文事件属性、值标签信息。

注意：一旦插入某个自定义对象的变量，便不再允许插入其他对象的变量。

在发送前，请为需要触达的UDO创建对应的UDO属性（文本类型），用于存储微信小程序的Openid，并线下将Openid导入此对象属性。

无论是群发或自动流发送，选择UDO后，选择之前创建的UDO对象属性，并完成其他发送配置的输入

7.自动流

UDO在自动流中的操作和客户的自动流中的操作类似，区别在于UDO自动流可以针对自定义对象和自定义对象的关联对象进行营销。

7.1 新建自定义对象

首先需要在自定义对象功能中新建一个自定义对象，然后才能在自动流这边选择到自定义对象相关自动流。

UDO自动流程支持仅对UDO进行营销和对UDO和UDO关联的客户进行营销。

7.2在自动流中，UDO自定义对象自动流同样支持实时营销、单次营销、周期性营销、纪念日营销、外部信号触发五大类营销场景。

下面以实时营销为例介绍UDO在自动流中的使用。

7.2.1 营销触达

我们首先选择一个UDO自动流，以“车车”这个自动流为例，在营销触达中选择【微信回复】，自动流发布后，进入流程的属性关联对象“客户”将会收到微信回复的“啊哦”。同理，公众号模版消息、订阅通知也是一样。在短信、邮件、webhook中，可以选择操作对象为自定义对象本身和关联对象，原因是此时不需要微信身份即可发送消息。

7.2.2数据操作

推进阶段

可以设置在满足条件时，修改自定义对象关联对象的推进阶段。

修改属性

支持修改自定义对象及其关联对象的属性

任务（请注意：该功能非系统默认功能，如需使用可联系客户经理开通。）

当客户留资或进入到重要阶段时，可能会需要客户负责人的介入，联系客户推进销售或对客户进行特定操作，进行从营销到销售的连接。DM Hub支持以手工或自动的方式为用户创建任务，并可以关联具体客户，实现及时跟进线索的目的。

自动流中，可以分配任务的执行者及时跟进客户。

7.2.3条件判断

可以针对自定义对象做属性判断、属性多分支、事件判断、事件多分支等操作。

属性判断

当自定义对象或其关联对象满足属性条件判断时，走是分支，反之走否分支。

属性多分支

属性多分支遵循从上至下的判断，从上至下进行判断，满足分支1的条件则走分支1，否则继续匹配分支2的条件，如果条件都不满足，则走其他分支。

如上图所示，自定义对象名称等于111时，走分支1，如果不等于111，会先判断是否等于222，如果还不满足这个条件，继续判断是否等于333，如果上面的条件都不满足，则走其他分支。

同理可得事件判断和事件多分支。

上下文事件多分支

可以根据上下文事件节点来定义自定义对象需要走哪个分支。

7.2.4执行控制

执行控制组件的操作和客户自动流的类似，可以参考客户自动流进行操作。

8.自定义对象在客户高级筛选中的查找

客户和自定义对象有可能是多对一或一对多对关系，自定义对象有查找关联字段，选择该字段时，可以继续限定关联对象的属性

客户和对象的关联关系有三种：

• 客户（N）：自定义对象A（1）：客户有个查找关联字段，关联自定义对象 A。选择客户该字段，可以继续限定关联对象的属性

• 客户（1）：自定义对象 A（N）：自定义对象 A有个查找关联字段，关联客户。支持限定是通过哪个字段建立的关联；支持限定关联数量、对象属性、统计指标

• 客户（1）：事件/订单（N，1）：自定义对象 A（1）：客户事件上有一个查找关联字段，关联某个自定义对象 A。选择事件/订单的该字段，可以继续限定关联对象的属性

9、自定义对象分析

自定义对象支持行为分析、属性分析、漏斗分析、标签分析、订单分析。比如可以统计客户所属公司、公司下单情况等。分析前需要先选择分析的对象。

选择好自定义对象后，分析的其他功能可参考客户的分析