快速入门:使用社交电商搭建电商网站

更新时间:
复制 MD 格式

登录平台后请按下图顺序先完成 CDN,SMS 的配置以及渠道店铺的接入。

image.png

注册激活 Salesforce Social Commerce 账号

每一个 Salesforce Social Commerce 账号以邮箱作为唯一标识。账号分为超级管理员和员工两种类型。

超级管理员是在 Salesforce Internal Console 创建组织时使用的邮箱,是组织下的首位用户,具备所有权限。

员工是在 Salesforce Social Commerce 的组织-员工模块下创建的其他用户。

本文介绍如何注册 Salesforce Social Commerce 账号。

超级管理员注册

前提条件

阿里云工作人员在 Salesforce Internal Console 创建组织时会使用一个邮箱作为超级管理员账户,并发送了一封激活邮件。

操作步骤

  1. 超级管理员打开邮箱,点击邮件中的激活按钮。

  2. 设置登录密码和手机号,向手机发送验证码,收到验证码后填入。点击确认。

  3. 账号注册成功,自动跳转登录页。

员工注册

前提条件

由超级管理员或者其他组织员工在 Salesforce Social Commerce 的组织-员工模块,创建新员工,并向员工邮箱发送了一封激活邮件。

操作步骤

  1. 员工打开邮箱,点击邮件中的激活按钮。

  2. 设置登录密码和手机号,向手机发送验证码,收到验证码后填入。点击确认。

  3. 账号注册成功,自动跳转登录页。

  4. 如果员工已存在于其他组织,且已激活,您创建员工时将发送邀请加入组织邮件,员工点击邮件中的加入组织按钮即可,不需要重新设置密码和绑定手机号。

通过 MFA 登录 Salesforce Social Commerce

为了您的账号安全,Salesforce Social Commerce 为您开启了多因子身份验证(MFA),每次登录时,输入账号密码后,您还需要使用绑定的 Authenticator APP 输入您的安全代码,以确保登录者是你本人。本文介绍如何通过 MFA 登录 Salesforce Social Commerce。

注意:为了保障您的信息安全,登录 Social Commerce 后 1 小时无操作将会自动登出。

前提条件

  • 成功注册 Salesforce Social Commerce 账号。

  • 您需要使用移动设备,前往安卓或 IOS 的应用商店下载 Authenticator APP,我们推荐您使用 Salesforce Authenticator,同时我们也支持 Google Authenticator, Microsoft Authenticator 等其他厂商的 Authenticator 应用。

操作步骤

首次登录流程:

  1. 打开 Salesforce Social Commerce 登录页,点击登录。

  2. 进入 IDaaS 登录页,输入邮箱和密码,点击登录。

  3. 系统检测到您未绑定过 Authenticator,将进入 Authenticator 绑定页,点击获取验证码,将发送验证码到账号绑定的手机号,收到验证码并填入,点击确认。

  4. 通过验证后,将进入 Authenticator 安全代码页,使用预先下载好的 Authenticator APP 内的二维码扫描器,扫描页面上的二维码。扫码完成后,APP 内会接入 Salesforce Social Commerce 的账户。image

  5. 请完成首次验证,将 Authenticator APP 的安全代码填入页面中的安全代码输入框。点击确认。image

  6. 验证通过,自动登录 Salesforce Social Commerce。

普通登录流程:

  1. 打开 Salesforce Social Commerce 登录页,点击登录。

  2. 进入 IDaaS 登录页,输入邮箱和密码,点击登录。

  3. 进入 Authenticator 安全代码页,打开 Authenticator APP,查看 Salesforce Social Commerce 账户下的安全代码,并将其填入页面中的安全代码输入框,点击确认。

  4. 验证成功,自动登录 Salesforce Social Commerce。

换绑 Authenticator 流程:

  1. 打开 Salesforce Social Commerce 登录页,点击登录。

  2. 进入 IDaaS 登录页,输入邮箱和密码,点击登录。

  3. 如需换绑您的 Authenticator,请点击重绑 Authenticator,进入 Authenticator 重绑,点击获取验证码,将发送验证码到账号绑定的手机号,收到验证码并填入,点击确认。

  4. 通过验证后,将进入 Authenticator 安全代码页,使用预先下载好的新 Authenticator APP 内的二维码扫描器,扫描页面上的二维码。扫码完成后,APP 内会接入 Salesforce Social Commerce 的账户。

  5. 请完成首次验证,将新 Authenticator APP 的安全代码填入页面中的安全代码输入框。点击确认。

  6. 验证通过,自动登录 Salesforce Social Commerce。

配置 CDN 域名和证书

Salesforce Social Commerce 提供了两种图片存储方式:

  1. 直接存储域名在白名单下的 URL 作为图片链接。

  2. 上传图片的实体文件,存储在 Salesforce Social 的 OSS 中。

如果您选择第一种方式,您可以不配置 CDN 直接创建商品,如果您想使用第 2 种图片存储方式,我们为您的图片等静态资源提供中国地区的 CDN(Content Delivery Network 内容分发网络)加速服务。您需要先完成 CDN 相关配置,才能使用对象存储服务上传您的商品图片等素材。未配置 CDN 或 CDN 配置失效,都将导致所有系统图片无法访问和打开。本文介绍如何配置 CDN。

前提条件

  • 提供一个属于您组织的单域名,单域名要求三级或三级以上(比如 commerce.salesforce-china.com),不支持泛域名。并且该域名要求是全新未被使用过的,即未配置过 CNAME 或未指向过任何 CDN。

  • 向任一服务商为此单域名购买 SSL 证书,开通 HTTPS(超文本传输安全协议)服务。

如何购买 SSL 证书和开通 HTTPS 服务? 以阿里云为例,详情可参考使用正式证书为Web站点开启HTTPS访问

  1. 购买一个 SSL 实例。

  2. 购买后提交 SSL 证书申请。提交时注意使用即将服务于 Social Commerce CDN 功能的单域名。

  3. 登录 SSL 证书控制台将已签发的证书下载到本地,建议下载 Nginx 类型的 SSL 证书,获取.key(私钥)和.pem(公钥)格式的两个文件。image

操作步骤

整个域名配置流程,需要完成三个步骤:CNAME 配置,HTTPS 证书配置,CDN 配置校验。

第一步:CNAME 配置

  1. 点击系统右上角设置 icon-Social Commerce 配置-CDN 服务模块,点击配置域名。

  2. 输入任意一个属于您组织的单域名,注意,每个域名只能绑定一个组织,点击下一步image

  3. 将系统生成的 TXT 值复制粘贴到对应的 DNS 域名解析服务商的相应位置中,然后回到 Salesforce Social Commerce 中点击验证配置验证上一步填入的域名归属权。请参考阿里云文档配置CNAME,以同样的方法配置 TXT 记录到 DNS 中。image

  4. 验证通过后,点击下一步。

  5. 验证归属权成功后,CDN 会为您分配一个 CNAME 域名。复制 CNAME,到 DNS 域名解析服务商中添加 CNAME 记录。然后点击验证配置验证是否成功添加。请参考阿里云文档配置CNAMEimage

  6. 验证通过后,点击完成。

第二步:HTTPS  配置

  1. 继续点击配置证书。

  2. 将预先准备好的 SSL 证书公钥和私钥复制粘贴到 Salesforce Social Commerce 中。image

  3. 点击确认,完成 HTTPS 配置。

第三步:CDN 配置校验

当以上两步完成后,平台会对 CDN 配置是否最终完成进行最后一次校验,确保以上两步都配置了且状态正常。最后一次校验因为对需要对客户所有的静态资源作异步处理,会花费比较长时间,客户可以离开当前页面进行其他操作,之后回来检查状态。

根据 CNAME 和 HTTPS 配置状态的不同,CDN 配置校验提示包含三种状态:

  1. CNAME 和 HTTPS 证书未配置或者状态异常提示:CDN 未完成配置,您的静态资源无法被客户访问。image

  2. CNAME 和 HTTPS 证书刚完成配置时提示:CDN 配置完成,正在处理您的静态资源,请稍等。image

  3. CNAME 和 HTTPS 证书都配置了且状态正常:CDN 配置完成,您的静态资源已开启加速服务。image

CDN 配置成功后,用户就可以在 Salesforce Social Commerce 上传图片了。需要注意:由于 Social Commerce 的 OSS 为公共读,上传的图片全网可见。

配置 SMS 账号

在电商场景中,通常需要在客户触发某个行为后向他们发送消息通知。比如注册登录验证码,客户下单支付成功通知,订单超时取消提醒,客户订单已发货通知等等。本文介绍如何向客户发送 SMS 消息通知。

前提条件

  1. 开通阿里云 SMS 短信服务。相关操作,请参考阿里云短信服务

  2. 强烈建议提供专门服务于 Social Commerce SMS 功能的子用户 AccessKey。

操作步骤

  1. 打开设置-SMS 配置模块,点击 SMS 账号,输入从阿里云短信服务平台中获取的 AccessKey ID 和 AccessKey Secret。

  2. 前往设置-SMS 配置-签名管理,点击创建,输入已经在阿里云短信服务中通过审核的签名,提交校验。(提示:请在阿里云申请短信签名时选择通用模板,防止用户收不到非验证码类型的短信通知)image

  3. 校验成功,签名将被添加到 Salesforce Social Commerce。

  4. 前往设置-SMS 配置-模板管理,点击创建,根据提示选择或者输入模板类型,事件类型,模板名称,模板内容,申请说明。

    重要提醒:模板内容支持添加变量。根据选择事件类型的不同,变量会有所不同,并且不同的事件支持发送的短信类型也不同。image

  5. 提交审核,模板推送到阿里云短信服务平台进行审核,审核通过后您便可以使用这个短信模板。审核失败可以修改后再提交审核。

  6. 前往社交电商通知-店铺通知配置,右上角选择对应需要发送通知的店铺。image

  7. 在事件列表内点击添加通知,选择签名和模板,预览短信内容。image

  8. 提交成功后,每当对应事件触发,Salesforce Social Commerce 将调用阿里云短信服务 API 将短信发送给客户。

信息说明

名称

描述

签名

根据用户属性创建符合自身属性的签名,一般建议设置为账号主体所在机构的全称或简称。当发送短信时,短信平台会将已审核通过的个性化短信签名添加到短信内容中,再发送给短信接收方。

模板

短信模板,即具体发送的短信内容,短信模板需要审核通过后才可以使用。模板类型包括国内短信和国际/港澳台短信两大类,其中国内短信包括验证码、短信通知、推广短信。详细定义请参见短信模板简介

事件

客户触发这些事件时,将推送 SMS 消息。事件由 Salesforce Social Commerce 定义,暂时不支持自定义事件类型。事件包括客户下单支付成功、订单超时取消、客户订单已发货、注册、验证码登录、忘记密码。

变量

短信模板可以包含变量,变量表示实际发送短信时,用户希望自定义变化的内容。变量属性的规范请参见公共内容规范国际/港澳台短信模板规范

如果您想更多了解阿里云短信服务这一产品,请参考短信服务快速入门

接入微信小程序店铺或者接入网站

接入微信小程序店铺

接入店铺是使用 Salesforce Social Commerce 的基础。

前提条件

  • 如果您没有微信小程序,需要先前往微信公众平台注册微信小程序。相关操作,请参考小程序注册流程

  • 如果您已有微信小程序,需要检查是否已经为小程序开通微信支付。相关操作,请参考小程序接入支付

信息说明

  • 渠道:店铺所依附的应用类型,目前主要有微信小程序和网站两种类型的渠道。

  • 店铺:店铺是商户经营的前端站点,是建立在渠道基础上的。一个渠道可能拥有多家店铺。比如在微信小程序渠道,商户添加并启用了 5 个小程序号,意味着在微信小程序渠道下商户拥有 5 家店铺。

  • Customer List: 客户表的概念是店铺的客户数据的最高级定义,通过 Customer List,你可以使多个店铺共用一个用户体系,意味着在任一店铺中注册的用户,使用相同的账号密码,可以登录到共用用户体系的其他店铺中,并共享用户行为记录和订单记录。当然,您可以在创建店铺时选择创建新的 Customer List, 不与现有店铺共用客户账号,但是请注意,该店铺配置确认并生成店铺后,无法更改,请慎重确认该信息。

操作步骤

  1. 登录 Salesforce Social Commerce,进入渠道-微信小程序模块。点击接入微信小程序

  2. 选择现有的 Customer List 还是创建新的 Customer List。

  3. 前往设置-社交账号完成小程序授权,在微信公众平台授权二维码页,使用小程序管理员手机微信扫描二维码,选择您要授权的小程序账号进行授权,完成授权后回到接入小程序店铺页面直接选择对应的小程序完成店铺创建。注意,每个小程序只能开通一个店铺。

  4. 授权成功,店铺创建,绑定微信支付。输入从微信商户号后台获取的 MerchantID 和 SecretKey,提交校验。如果此时您还没有开通微信支付,可以跳过这一步进入下一步-接入 API。image

    注意:

    1. SecretKey 和 MerchantID 必须匹配且应为 V2 版本,长度为 32 位。

    2. 小程序 appid 和商户需要进行关联 (可在微信小程序管理后台 - 功能 - 微信支付 - 商户号管理 - 已关联商户号中检查)。

    3. 如上述注意事项均已核验后仍无法成功绑定微信支付,可能是由于长期没有使用微信支付的收款功能,账号被暂时冻结(可在微信支付管理后台 - 消息中心 - 消息通知中查看是否有[业务异常]信息)。此时需联系微信支付客服处理。

  5. 在接入 API 页,您可以点击查阅 OpenAPI 文档,为已开发的小程序前端代码切换 Salesforce Social Commerce 的 API。如果没有已开发的小程序,可以点击下载我们给您提供的样本小程序源代码包,该样本小程序已接入大部分 OpenAPI。您也可以在此基础上继续开发改造成为符合您需要的小程序。image

说明:首次接入时没有输入微信支付参数的,可以在渠道-微信小程序模块的店铺卡片中,点击绑定,在弹窗中完成支付能力绑定。

接入网站

接入店铺是使用 Salesforce Social Commerce 的基础,本文介绍如何接入网站店铺。

前提条件

信息说明

  • 渠道:店铺所依附的应用类型,目前主要指微信小程序和网站两种类型的渠道。

  • 店铺:店铺是商户经营的前端站点,是建立在渠道基础上的。一个渠道可能拥有多家店铺。比如在网站渠道,商户拥有 5 个不同网址的站点,意味着在网站渠道下商户拥有 5 家店铺。

操作步骤

  1. 登录 Salesforce Social Commerce,进入渠道-网站模块。点击接入网站

  2. 输入店铺名称和网址。提交校验。image

  3. 选择现有的 Customer List 还是创建新的 Customer List。

  4. 校验成功,店铺创建,绑定网站支付能力。

a. 如果是绑定微信网站支付,输入从微信商户号后台获取的 AppID, MerchantID 和 SecretKey,提交校验。

b. 如果是支付宝网站支付,使用支付宝客户端管理员账号扫描二维码,选择要授权的网页进行授权。

c. 如果是银联支付,根据系统需要,提供商户号,关联证书等信息进行银联账户绑定,提交校验。

d. 如果此时还没有开通支付,可以跳过这一步进入下一步-接入 API。

  1. 在接入 API 页,您可以点击查阅 OpenAPI 文档,为已开发的网站前端代码切换 Salesforce Social Commerce 的 API。如果没有已开发的网站,可以点击下载我们给您提供的样本网站源代码包,该样本网站已接入大部分 OpenAPI。您也可以在此基础上继续开发改造成为符合您需要的网站。image

说明:首次接入时没有绑定支付能力的,可以在渠道-网站模块的店铺卡片中,点击绑定,在弹窗中完成支付能力绑定。

我们还为您提供了二项集成工具,用于实现消息发送,数据同步,数据分析等多种功能,在开始使用它们之前您也需要进行相应的配置:

  • 配置 Webhook 来实现主动向外部系统推送数据或者指令。

比如您想要将店铺的订单数据推送给下游订单管理系统(OMS)进行管理,可以通过 Webhook 实现。详情请参考使用 Webhook功能指南-通知

使用 Webhook

Webhook 是一种 web 回调或者 http 的 push API,是向 APP 或者其他应用提供实时信息的一种方式。Webhook 在数据或者事件产生时立即发送数据。比如当触发“订单付款状态变更“这一事件时,发送数据到外部的订单管理系统或物流系统。本文介绍如何创建和使用 Webhook。

Webhook 工作机制

一般来说,当 Webhook 事件被成功创建的前提下,事件被触发(如订单支付成功),系统将自动把订单支付成功的通知信息,即将事件/数据发布(POST 请求)下达到下游客户系统,下游系统成功接收后将把 HttpStatusCode 200 状态返回给平台,若没有接收到该状态,系统首先进入自动重试的流程中,若所有自动重试作业失败,您可以参考帮助中心的 Webhook 最佳实践中提供的方案进行解决。

自动重试机制:

  • SSC 会在两种情况下自动触发重试,5 秒内没有收到响应或者 HttpStatusCode 的响应状态若非下方状态则为不正常: Response Status Code: 200; Response Body: success

  • 响应状态不正常时,需要立即重试 7 次(重试时间间隔为:0 秒,15 秒,30 秒,1 分钟,1.5 分钟,2 分钟,和 3 分钟),如果我们仍然没有得到客户的成功响应(通常表示客户的系统或网络通信存在问题),我们将把请求数据放入重试队列。

  • 重试作业-在前 7 次失败后,我们会再重试 8 次,但为了分流,我们有一个重试作业机制(自动重试时间间隔为 30 秒分钟、1 分钟、3 分钟、7 分钟、15 分钟、25 分钟,35 分钟;这些重试是通过消息传递队列调度消息机制实现的),总共会重试 14 次。

  • 重试失败后的通知:若所有重试作业都失败(14 次重试作业失败),我们会把这些事件放入“DLQ”(Dead Letter Queue)中,并通过邮件通知系统管理员。

在此自动重试机制下,可以大大提高 Webhook 的推送信息的成功率,但即便如此,因为上下游网络或者服务不稳定等因素,仍旧可能导致 Webhook 信息推送失败,针对这种情况,您可以参考帮助中心的 Webhook 最佳实践中提供的方案进行解决,以保证 Webhook 事件能成功下推到下游系统。

关于 Webhook 的更多信息,请参考功能指南-通知

前提条件

要使用 Webhook,需要向 Salesforce Social Commerce 提供通过公网可以访问的 URL。该 URL 是应用程序中的一个位置,它将接受数据并对其进行处理。每当有新数据出现时,Webhook 都会将其发送到您的 URL。

操作步骤

  1. 打开通知-Webhook模块,点击创建 Webhook

  2. 在创建 Webhook 页,输入 Webhook 名称。可以根据事件类型和推送渠道进行命名,提高可读性。image

  3. 选择事件类型。是指触发通知的事件种类。每一种事件类型会推送指定的参数到目标 URL。

  4. 输入 URL。是指 Webhook 被触发后,发送 HTTPS 通知的目标地址。

  5. 填写密钥信息。 Webhook 密码/密钥,用于 Webhook 鉴权的方式,可通过 Webhook 密码/密钥生成请求签名进行鉴权,防止 URL 被恶意请求,因此当我们给下游发送请求时,需要用该密钥信息生成 header 签名,您用创建 Webhook 的密钥在下游根据我们的签名生成规则生成与系统匹配的 header 签名,通过比对,确认该请求为 SSC 推送过来的信息。

    签名生成规则为:signature = HMAC-SHA-256(RequestBodyString, X-Salesforce-Transaction-ID + CustomizeSecret + X-Salesforce-Push-At)。

  6. 选择对应事件后,系统将根据该事件含有的信息,自动计算出关联表的自定义字段选项,您可以选择部分自定义字段随 webhook 事件触发的其他数据一起发送到指定地址。如希望在此处可以勾选对应的自定义字段,请先在【设置-自定义字段】管理模块“启用”该字段的“通过 Webhook 发送”

  7. 完成信息填写后,对需要推送的 URL 进行健康检查,将数据以 JSON 格式发布到指定 URL 中,当返回结果为以下结果时代表连接状态正常,否则连接失败。

    Response Status Code: 200 ;Response Body: success

    下游系统需要将 Response Status Code 配置为 200,将 Response Body 配置为 Success。

  8. 创建完成。

注意:数据如果不符合 Json 格式,Webhook 会推送失败。因此换行符被转译为符合 Json 格式的//n 或//r 下推,外部系统接收并展示数据时可能存在"/"的冗余。

编辑 Webhook

操作步骤:

  1. 在编辑前需要先禁用 Webhook 才能进行对应的编辑操作,且当编辑页面打开时,密钥的数据将被隐藏,编辑后的数据也同样需要经过健康检查才能成功保存。

  2. 除了 Webhook 的事件类型不支持编辑,其余操作跟创建 Webhook 操作一致。

启用/禁用 Webhook

支持启用/禁用 Webhook(根据列表中 Webhook 的“状态”显示启用/停用按钮)

  • 进行启用 Webhook 操作时,后端可以自动做一次 Check,如果 Check 不成功则返回启用失败的状态提示!列表的状态仍旧保留初始状态。

删除 Webhook

点击删除按钮,弹出提示:确定删除该 Webhook?删除后事件将无法找回,原有事件将无法推送至三方!

  • 成功删除后原有的事件将处于停用状态。

  • 成功删除后,该数据将从列表中去除。

此外,您可以自由选择是否使用 Tableau 来处理您的数据,你可以配置 Tableau 来实现海量数据分析。

使用 Tableau Server

Tableau Server 是一个高度可扩展的企业级业务分析平台,同时也作为一款灵活强大的数据分析工具,能为客户提供数据可视化的能力,客户可通过直观的数据分析图表进行精细化运营,及时地调整商业战略和计划。本文介绍如何从 Salesforce Social Commerce 接入 Tableau Server。

前提条件

前往Tableau 官网开通 Creator 账号,并获取有效的证书。

操作步骤

  1. 下载 Tableau Desktop,根据提示完成 Tableau Server 部署,更新版本号到最新。

  2. 成功登录 Tableau,创建站点。

  3. 打开 Tableau 的设置模块,复制站点 ID 和 URL。然后打开设置-Tableau Server 集成配置模块,粘贴在站点 ID 和 URL 栏。image

  4. 打开 Tableau 的我的账号设置-设置模块,点击创建新令牌,将弹出提示“已成功个人访问令牌”。复制弹窗中的令牌和令牌密码,然后打开 Salesforce Social Commerce 的设置-Tableau Server 集成配置模块,粘贴在个人访问令牌和令牌密码栏。

  5. 配置完成。为校验是否成功接入 Tableau Server 网站,可在第二天尝试登录 Tableau Server, 看是否在 Tableau 中查找到从 Salesforce Social Commerce 推送过来的数据源。

数据源

数据源是推送到 Tableau Server 的数据,目前 Salesforce Social Commerce 将为客户提供接入 Tableau Server 的数据源主要包含:“订单”和“客户”相关的数据包。

  • 我们会将平台的部分数据定时推送到我们创建的数仓内,目前的更新频率为每天更新一次,具体更新时间:每天晚上 00:00:00 更新。

  • 每次更新数据时,以整个数据包推送的方式进行增量推送。

  • 系统需要存储上一次成功推送的时间,若累积几次推送失败,需要显示推送失败原因,在下一次更新时需要推送从上一次成功推送时间到现在的数据到 Tableau Server 中(如 3 月 10 日和 11 日的数据推送都失败,上一次成功推送的时间为 3 月 9 日,则需要把 3 月 10 日和 11 日的数据分别推送到 Tableau 上)。

  • 支持开启/关闭”是否开启数据推送“按钮,当开启时,数据将按照推送规则进行正常推送工作,点击关闭时,弹出提示:是否确认关闭推送数据到 Tableau Server?关闭则系统不会定时推送数据!点击确认则开关变成关闭状态,且后台停止定时推送数据操作。