# 发送设置

# 域名

发信域名是邮件发送时候的“身份证”，每个账户必须要有一个发信域名。在 SMTP 会话过程中, 即是 mail from 的后缀

mail from: test@liubida.cn
250 sender test@liubida.cn OK

如上所示, liubida.cn 就是这封邮件的发信域名.

成功注册 SendCloud 的账户后，系统会自动分配一个测试发信域名。正式使用前，请务必创建真实业务使用的域名，不要使用系统提供的测试域名进行真实业务的发送

# 发信域名配置

发信域名的配置包括SPF、DKIM、MX、DMARC。其中，SPF、DKIM 和 MX 为必配项，DMARC 为选配项。

SPF wiki 解释 (opens new window)

SPF 是为了防范垃圾邮件而提出来的一种 DNS 记录类型, 用于登记某个域名拥有的外发邮件的所有 IP 地址 MX

MX 是邮件交换记录, 它指向一个邮件服务器, 用于电子邮件系统发邮件时根据收信人的地址后缀来定位邮件服务器

DKIM wiki 解释 (opens new window)

DKIM 是防止欺诈邮件的一个重要技术手段, 通常发送方会在电子邮件的标头插入 DKIM-Signature 及电子签名资讯, 而接收方则透过 DNS 查询得到公钥后进行验证. 建议配置, 特别是国外域比较多的用户.

DMARC

"DMARC"协议的主要目的是用于识别并拦截欺诈邮件。配置通过后，平台将使用当前域名作为 from 的域名后缀投递邮件。从而减少邮箱服务商拦截、提升邮件的可信度、提高进箱率.

选择【发送设置】- 【域名】，进入发信域名配置界面。如果没有正式发信域名，可以新增发信域名.

点击需要配置的域名，进入配置界面。按照系统给出的数据，到您的域名管理系统中做相关配置

域名配置后有三种状态：

未验证：必配项（SPF，DKIM 和 MX）中任一项未通过（此时域名不能绑定 API_USER）
可使用：必配的三项全部验证通过，选配项未验证通过
已验证：配置项全部验证通过

完成所有记录配置后，域名管理系统上生效可能需要 10-30 分钟

你需要给触发邮件和批量邮件设置不同的域名（拥有不同主域的域名），以避免共享一个发信域名导致两类邮件同时被限制，触发邮件无法及时送达

# 如何在DNS解析平台配置域名

下面为大家介绍一下 DNSPOD 服务商如何操作域名配置。

首先，您请确认，您已经在SendCloud后台创建了自己的发信域名。

以下示例，以xxx.com为例进行讲解。

DNSPOD

登陆DNSPOD平台，进入xxx.com的域名记录管理页面。
点击【添加记录】按钮，出现如下图一条新的记录框。
参照SendCloud的xxx.com的域名配置信息，填写对应的“主机记录”、“记录类型”和“记录值”并保存。
您需要填写3条TXT记录，1条MX记录，请确保和SendCloud提供信息完全一致。

# API_USER

API_USER 是调用接口发信时的帐号

创建 API_USER 时, 你需要指定其「类型」(触发/批量), 「发信域名」, 「追踪选项」
类型: 「触发类型」的 API_USER 只能发送触发邮件, 「批量类型」的 API_USER 只能发送批量邮件
发信域名: 创建 API_USER 时需要选择绑定一个发信域名, 用以确定此 API_USER 发信时的域名
追踪选项: 选择之后, 使用此 API_USER 发信, SendCloud 可以帮助用户收集接收者相应的追踪信息

API_KEY 是调用接口发信时的密码

注册成功后,您需要登录账户手动生成一个 API_KEY
同一 API_KEY 在界面中显示一次后无法再次显示
每个 API_USER 都有对应的 API_KEY，可以相同也可以不同
可单独或者批量重置，批量重置的 API_USER 共享同一个 API_KEY
API_KEY 重置之后立即生效，15 分钟以内新旧 API_KEY 均可使用

API_USER 和 API_KEY 是在通过 API 或者 SMTP 发信时，进行身份验证时的重要信息，需妥善保管

# 标签

标签能够帮助用户对邮件进行分类, 适用于 A/B 测试等场景。

标签创建成功后系统会自动分配一个标签 ID，在邮件发送时，就可以带上标签 ID 参数对邮件打上标签。

同时，可以在系统中通过标签维度来查询对应内容的发送情况。

# 追踪选项

邮件追踪能够帮助用户收集已发出邮件的「打开数据」,「点击数据」,「退订数据」, 以此来评估邮件发送的效果. 你可以通过追踪选项来配置某个「API_USER」的「打开追踪」,「点击追踪」,「订阅追踪」.

追踪实现的原理

点击：系统会将邮件原始链接替换为追踪域名带参的链接。当用户点击邮件中的链接，因为追踪域名配置的 CNAME 是 track.sendcloud.org ，SendCloud服务器会收到请求对点击进行统计，再跳转到原始链接。
打开：系统会在邮件内插入1张1像素的透明图片。当邮件打开时，一般情况 MP 的客户端、网页端会自动下载邮件中的图片，SendCloud服务器会收到请求对打开进行统计。
退订：系统会在邮件底部插入一段含有退订链接的html代码，或将%%user_defined_unsubscribe_link%%变量替换为退订链接。当退订链接被点击后，会展示对应退订页面，用户在退订页面选择退订原因，提交表单后，SendCloud收集到消息进行处理。

追踪域名

SendCloud 提供默认追踪域名，但默认追踪域名是共享的，会受其他用户影响，建议配置自定义追踪域名。

因Chrome等浏览器升级，未来将禁止加载HTTP资源，这将导致拦截、追踪数据不准等情况，建议上传SSL证书，开启HTTPS追踪。

追踪开关

可根据情况进行开关、设置调整。建议保持订阅追踪的开启，以便用户能在不想继续接收邮件时操作取消订阅而不是向MP举报。

若您使用的追踪域名的DNS配置未保持CNAME配置，开启点击追踪服务后，邮件中的链接或将无法点击跳转。

# 退订设置

要在追踪选项中开启订阅追踪服务后，退订设置才会生效。

退订维度

SendCloud 提供三个方式的退订维度设置

当一个API_USER被退订时，仅退订该API_USER。系统默认此选项。
当一个API_USER被退订时，退订所有API_USER。
当一个API_USER被退订时，退订自定义内的API_USER。

当你选择3时，每一个API_USER都可以单独设定其退订规则。您可以根据对API_USER业务分配情况，进行退订的处理。

退订链接

系统默认插入到邮件中的退订按钮会根据退订页面的语言进行变化，若您对此按钮样式不满意，可以自行编写html代码，链接使用%%user_defined_unsubscribe_link%%变量即可，在发送时SendCloud会对 %%user_defined_unsubscribe_link%% 进行替换。

退订页面

您可以根据需要，设置个性化的退订页面，我们支持设置语言、页面配色、logo图片、退订定向跳转，对于非中文翻译您觉得不满意也可以在编辑时自行修改。

您可以在【追踪设置】中为API_USER指定退订页面，也可以在API调用时指定退订页面。API指定退订页面优先级高于API_USER绑定的退订页面。详见page_id

# Webhook

WebHook是客户接收其发送情况的渠道。用户将邮件请求发送给 SendCloud 之后, SendCloud 会把「请求结果」同步返回给用户, 而邮件的「发送结果」和「其他事件结果」是通过 WebHook 异步返回给用户的。

当某事件发生, 就会触发 SendCloud 向客户设置的 URL 发送数据 ( POST )客户收到数据, 解析出事件和数据, 做后续的处理。

目前我们支持的事件包括:请求、发送、打开、点击、取消订阅、举报、无效邮件、软退信、转信。具体每个事件的消息格式，请参考此处

# 设置选项

# 固定from后缀和固定mail from

什么是from？ from是信件内容里的发件人，格式为 email 格式。在 SendCloud 你可以在API或SMTP发送时，自定义from为任何格式合法的email地址。

什么是mail from？ mail from 是信封上的发件人，也可以称作sender，格式为email格式。 mail from 相当于是 from 的秘书，替from传达消息。在 SendCloud 平台 mail from 后缀由系统控制，和当前所用发信域名统一；前缀可在页面单独设定，未设定情况下系统默认生成随机串。

为什么 SendCloud 默认生成的 mail from 前缀会是随机串？ 部分邮箱会根据 mail from 来控制收件的数量。为了避免因mail from 为同一值而限制，所以mail from前缀默认采用了随机串。

from 与 mail from 不一致会怎么样？

from 和 mail from 后缀不一致，邮件内会出现代发的情况。部分邮箱要求完全一致才不会出现代发。
严苛的邮箱对于from 和 mail from 不一致的情况，会出现进入垃圾箱或拒信现象

固定 from 后缀 当你需要 from 的后缀和 mail from 后缀一致时，你可以在API或SMTP发送时自行控制，也可以在 SendCloud 【固定from后缀】中可根据邮箱域名作为接收域，设置 from 后缀是否固定和 mail from 后缀保持一致。一般情况下，设置后将不会出现代发。

固定 mail from 当你遇到一些邮箱因为mail from的前缀是随机串影响发送的，可设置固定 mail from,在【固定mail_from】中添加记录以该邮箱域名作为接收域即可。