有赞
DM Hub支持对接有赞商城，将有赞店铺的订单数据接入DM Hub。将有赞订单接入DM Hub可与系统中的客户数据匹配，打通用户画像、互动数据与订单数据。
在DM Hub分析中心的订单分析、RFM分析等分析组件中，可对客户的消费行为进行分析，更好地了解客户的消费习惯和品类偏好等。
1. 接入指南
在DM Hub【营销应用-应用市场】页面找到有赞点击【安装】；安装后即可在DM Hub【营销应用-已安装列表】页面查看有赞应用，点击【打开】进入有赞插件。
DM Hub提供三方服务方式和自研应用对接两种接入方式对接有赞店铺，以满足不同企业客户的对接需求。首次安装打开有赞应用后系统弹窗请求选择对接方式，选择对接方式后不再支持切换。
如果尚未明确采用哪种对接方式可点击关闭弹窗，在授权店铺列表为空的状态下仍可点击页面右上方【设置对接方式】打开该窗口。
1.1 三方服务方式
三方服务方式即使用Convertlab作为服务商在有赞应用中心发布的应用“DM Hub订单平台”，快速对接同步有赞店铺信息及订单至DM Hub。此方式需支付2000元/年应用服务费（费用实际上将作为技术服务费由有赞方收取，Convertlab在对接过程中不收取额外费用）。
1.1.1 购买DM Hub订单平台应用
前往有赞应用市场搜索应用：“DM Hub订单平台”。有赞店铺管理员可点击【购买应用】并选择要授权的店铺（购买一次该应用仅可授权一个店铺），支付应用服务费2000元，应用有效期1年。
在有赞应用市场账号【我的订单】下可查看购买应用的订单编号。
1.1.2 授权店铺
在DM Hub【营销应用-有赞】设置对接方式窗口选择“购买三方服务方式”，点击【开始对接】。
填写在有赞应用市场购买“DM Hub订单平台”的订单编号，设置导入数据起始时间，点击【确认授权】。
授权成功后即可在【店铺信息】列表看到已授权的店铺信息。如需授权更多店铺，可点击页面右上方的【授权店铺】。
点击设置【授权到期提醒】，可最多填写3个手机号，授权到期前3天上午10点，将短信通知到填写的手机号码。
1.2 自研应用对接
自研应用对接方式面向自有开发团队的企业商家，支持有赞商家在有赞云开通自用型无容器应用，将自研应用授权的店铺对接至DM Hub。
在DM Hub【营销应用-有赞】设置对接方式窗口选择“自研应用对接方式”，点击【开始对接】。
输入自研应用的Client ID和Client Secret，点击【确认绑定】。每个自研应用只能绑定在一个DM Hub租户下。
绑定成功后需将DM Hub【营销应用-有赞】首页提示的回调地址配置到有赞云后台应用信息回调地址处。
点击DM Hub有赞应用店铺列表页面右上方【导入已授权店铺】，输入自研应用授权范围内的店铺ID、店铺名称、店铺授权到期时间以及导入订单数据起始时间。
点击【确认导入】，即可在店铺信息列表看到已导入授权的店铺信息。如需导入更多店铺，可点击页面右上方的【导入已授权店铺】继续导入。
2. 有赞订单同步
三方服务方式或自研应用对接并设置好店铺授权后即可同步有赞订单数据至DM Hub.
只有状态为待发货，等待买家确认，订单完成，订单关闭的订单会同步到DM Hub中。
2.1 订单同步字段匹配
有赞订单接入到DM Hub的订单数据及字段匹配如下：
订单头字段
| DM Hub字段名称 | DM Hub字段ID | 对应有赞字段ID |
|---|---|---|
| 订单号 | orderNo | orderInfo.tid |
| 订单总额 | amountTotal | payInfo.total_fee |
| 实际支付金额 | amountPaid | payInfo.payment |
| 销售渠道 | salesChannel | 无，有赞插件导入订单默认销售渠道为有赞 |
| 收货人姓名 | contactName | address.receiver_name |
| 收货人电话 | contactTel | address.receiver_tel |
| 收货人省份 | shippingProvince | address.delivery_province |
| 收货人城市 | shippingCity | address.delivery_city |
| 收货人区县 | shippingCounty | address.delivery_district |
| 收货人街道 | shippingAddress | address.delivery_address |
| 下单时间 | dateOrder | transformTime(orderInfo.created) |
| 支付流水号 | paymentNo | payInfo.transaction |
| 支付方式 | paymentTerm | orderInfo.pay_type_str |
| 店铺名称 | store | shopName |
订单行字段
| DM Hub字段名称 | DM Hub字段ID | 对应有赞字段ID |
|---|---|---|
| 订单行id | lineId | it.oid |
| 商品名称 | productName | it.title |
| 商品ID | productId | it.item_id |
| SKU ID | skuId | it.sku_id |
| 数量 | qty | it.num |
| 单价 | priceUnit | it.price |
| 商品总额 | priceSubTotal | it.total_fee |
| 商品实际支付金额 | priceSubPaid | it.payment |
2.2 订单同步时间
在授权店铺时设置了初始导入订单数据起始终时间，系统将同步从该时间点到当下的店铺订单数据。
在【店铺信息】列表页面，点击【重新导入】可重新设置导入数据起始时间，系统将导入从起始时间到当下的所有订单数据，若修改的导入起始时间早于初次导入起始时间，新导入订单将覆盖已导入历史订单；若晚于初次导入起始时间，两段起始时间内的已导入历史订单数据均保留。
历史订单同步完成后，新增订单将实时同步到DM Hub中。
自研应用对接请确认已经将DM Hub的回调地址配置在有赞云控制台，并开启了消息服务订阅开关，以便有赞店铺订单可以实时同步。3. 有赞订单相关的客户数据及客户事件
同步有赞订单后，DM Hub会通过身份匹配系统中已有的客户并将订单信息记录到匹配到的客户身上，
有赞订单匹配DM Hub客户的身份优先级顺序为：yz_openid > openid > unionid。
如果通过身份没有匹配到对应的客户，系统会自动创建一个有赞身份的新客户并记录订单数据。
创建客户的属性姓名、手机号、国家、省份、城市、区县、家庭地址信息来自有赞订单中收货人相关的信息。
订单数据关联到客户后，在客户详情页的【时间轴】【订单】下可查看客户订单相关的事件和订单详情数据。
在【客户-高级筛选】和【分析中心】中可以查询有订单相关事件的客户、分析客户订单相关的事件行为等。
3.1 有赞订单关联的客户事件
DM Hub系统中有三个和订单相关的系统事件，通过DM Hub有赞应用同步的订单同样会记录相应的客户事件。
- 购买商品和服务事件。
- 商品退货事件。
- 取消订单事件。
在【设置中心-基础数据-事件】中可查看以上事件的ID和事件属性。
DM Hub仅同步等待卖家发货、等待买家确认收货 、订单成功、交易关闭四种状态的订单。相应客户事件记录规则如下：
获取到订单且状态为订单成功，订单数据同步到DM Hub订单表；相应客户会被记录购买商品和服务事件；
获取到的订单的状态为订单成功且查询到有退款数据，相应客户会被记录商品退货事件，实际支付金额会扣减退款金额；
获取到的订单且状态为待发货或等待买家确认，订单数据同步到DM Hub订单表；相应客户会被记录购买商品和服务事件；
首次获取到的订单且状态为订单关闭，订单数据不同步到DM Hub订单表单；不记录事件；
获取到的订单的状态为订单关闭，且之前已同步过订单数据到DM Hub订单表，相应客户会被记录一个取消订单事件，实际支付金额会扣减订单的相应金额。
3.2 有赞未付款订单提醒事件
未付款的有赞订单不会同步至DM Hub中，但可以在DM Hub中设置未支付订单催单提醒。
通过三方服务方式或自研应用对接均可在DM Hub有赞应用店铺信息列表设置【未支付订单催单提醒时段】。 自研应用对接请确保已经将DM Hub的回调地址配置在有赞云控制台，并开启了消息服务订阅开关。
设置后，客户在有赞发生待付款状态订单达到设置的时间段，DM Hub会记录一个未付款提醒客户事件。
在DM Hub自动流程中可以使用该事件作为触发条件，设置发送短信、订阅消息等方式提醒客户付款。
3.3 有赞订单相关的客户阶段推进和活跃度评分
订单相关事件如果设置了客户阶段推进和活跃度评分，则客户被记录事件时相应的会推进或不推进客户阶段，增加或扣减客户活跃度分值。
在【设置中心-基础数据-事件】中可查看并修改与订单相关的系统预设事件的客户阶段推进和活跃度评分设置。
3.4 有赞订单相关的分析组件
DM Hub分析中心中的行为分析、漏斗分析、路径分析等包含行为事件的分析组件，支持分析与订单关联的三个事件：购买商品和服务事件；商品退货事件；取消订单事件。
DM Hub分析中心的订单分析、退单分析、复购分析、商品组合分析、RFM分析组件，支持基于导入DM Hub系统的订单数据对客户的购买行为和习惯等进行多维度的分析。
