邮件自定义
运行机制
登录管理器产品提供一组发送给用户的标准邮件模板:
- 注册确认
- 欢迎
- 验证(包含链接和验证码)
- 密码更改
- 邮箱地址更改
- 多因素认证(MFA)代码
- MFA设置更改
- 新闻订阅
模板使用HTML和CSS代码编写。
您可以:
- 对标准模板进行更改以自定义邮件的外观和内容;
- 设置用自己的邮件服务从艾克索拉发送邮件或使用SendGrid应用程序发送邮件。
适用对象
集成了登录管理器并使用艾克索拉数据库或自定义存储的合作伙伴。
邮件开发建议
并没有适用于所有邮件应用程序的统一邮件开发标准,因为每个应用程序显示邮件的方式都不一样。您的邮件设计应尽量简单、简洁,以确保在不同邮件应用程序和设备上的显示趋于一致。
一般结构
JavaScript和CSS
不能通过JavaScript在邮件中添加多媒体内容。如要在邮件中添加动画,请使用GIF图片。如要在邮件中添加视频,请使用图片作为链接将用户定向到视频内容的URL。
部分邮件应用程序仅支持有限的CSS3功能。创建邮件模板时应注意这一点。
请只使用内联样式。大部分邮件应用程序会排除写在style
标记中的样式。
- html
<div style="text-align: center;"></div>
使用独立区块
建议使用最有效的邮件开发方法,即采用独立区块的形式。该方法有以下优点:- 在设备上显示不正确的区块不会影响其他区块的显示。
- 可在现有邮件中调整区块并快速测试效果。
- 可创建一套区块然后按照不同邮件的目的快速组合使用。
使用表格
邮件应用程序无法正确处理区块元素和position: absolute
属性。要创建包含区块的邮件,请使用表格布局,并指定表格单元格的align
和valign
属性。使用表格能更好地适应不同的屏幕。
请避免通过colspan
和rowspan
属性合并单元格,应使用插入表格。
大小和单位
要让内容在大小屏幕上都能正确显示且没有滚动条,请为所有包含内容的容器指定以下设置:
- 始终指定
width: 100%
属性。 - 最大屏幕的宽度限制。建议宽度不要超过
800px
,因为该值是最适合阅读的宽度。
请不要以%
或em
为单位来指定line-height
属性。应只使用像素为单位,以便邮件在所有邮件应用程序和不同屏幕上看起来一样。
使用字体
请使用标准字体。大多数邮件应用程序不支持外部字体。
标准字体:
- 衬线体:Courier、Courier New、Georgia、Times、Times New Roman
- 无衬线体:Arial、Black、Tahoma、Verdana、Trebuchet MS
摘要
大部分邮件应用程序会显示一行摘要作为邮件预览。应始终添加摘要,因为它会鼓励用户打开收到的邮件。有些邮件应用程序可能会因为邮件主题太长而截断显示,添加摘要可帮助用户了解邮件的内容。代码长度
请减少代码长度以便邮件正确显示。例如,Gmail和Yahoo在显示超过100 KB的邮件时会出现问题。使用图片
开发包含图片的邮件时,请考虑以下事项:
- 用户可能在邮件应用程序设置中禁用了显示图片。
- 图片可能需要很长时间加载。
- 图片质量可能在不同屏幕上有所区别。
请使用PNG或JPEG图片格式,不要用SVG格式,因为大部分邮件应用程序不支持该格式。
对于4K分辨率的显示器,请使用建议大小两倍的图片。例如,对于原本400px
的图片,请使用它800px
宽度的版本并添加至邮件:
- html
<img src="https://site.com/images/123.png" width="400" height="auto" style="width: 400px; height: auto" />
使用链接
所有链接均应包含协议和主机名部分,例如https://site.ru/path
。请勿使用相对链接(/path
)和没有协议部分的链接(://site.ru/path
)。此类链接将自动获取file
协议,浏览器将尝试进行下载而非打开链接。
要确保邮件不被归入垃圾邮件,请为所有链接指定title
属性。该属性可帮助依赖额外软件访问网页内容的残障人士。
应始终指定链接的字体颜色。如未指定,邮件应用程序将使用自己的颜色。
请将邮件地址和电话号码添加为链接。应用程序的样式可能影响电话号码的正确显示。
要在新选项卡或新窗口中打开邮件中的链接,请指定target="_blank"
属性。
其他建议
自适应邮件开发的其他建议。如何获取
发送给用户的邮件应包含解释性文字以及一个确认用户操作的链接。对于邮件上的每个元素,您可以:
- 使用自己的文本,显示语言与文本语言一致;
- 使用本地化为20种语言的艾克索拉标准文本。
艾克索拉的文本在游戏模板中以变量(占位符)形式插入,例如:
{{subject}}
– 邮件标题文本。{{text}}
– 邮件正文文本。{{action_link}}
– 链接文本。链接地址由艾克索拉生成。{{button}}
– 按钮文本。
生成邮件时,占位符会替换为相应语言的文本。
邮件语言的选择基于用户的区域位置。以下方法可用于决定用户的区域位置:
- 通过登录管理器小组件集成时,可将应用程序界面中的用户区域位置在打开小组件时传入小组件。随后小组件将该区域位置传入Login API方法。
- 通过Login API集成时,可将应用程序界面中的用户区域位置在调用Login API方法时传入该方法。
- 如果未传入用户的区域位置,则语言根据IP地址或浏览器语言决定。
要自定义邮件模板:
- 前往您的发布商帐户,然后打开您的项目 > 登录管理器。
- 在登录管理器项目面板中单击配置。
- 前往自定义区块,然后选择邮件自定义部分。
- 从下拉列表中选择邮件模板。
- 如果模板以预览模式打开,请单击开关按钮(右上)切换为HTML模式。
- 添加或修改邮件的HTML布局,考虑采纳建议的事项。
- 要检查邮件的显示效果,请切换为预览模式。
- 检查邮件代码的有效性。
- 如需要,编辑发件人字段:指定发送人的名称(该信息会在邮件标题中显示)和邮箱地址。默认发送人名称为您登录管理器项目的名称,默认邮箱地址是noreply@login.xsolla.com。填写该字段时,可使用
application.name
形式的常用变量,例如{{application.name}} <>
。
- html
<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>{{subject}}</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
</head>
<body style="background-color:#0a1e37;">
<table align="center" border="0" cellpadding="0" cellspacing="0" class="" style="width:400px;" width="400">
<tr>
<td style="line-height:0px;font-size:0px;mso-line-height-rule:exactly;">
<table align="center" border="0" cellpadding="0" cellspacing="0" role="presentation" style="width:100%;">
<tbody>
<tr>
<td style="direction:ltr;font-size:0px;padding:60px 0 0;text-align:center;vertical-align:top;">
<table align="center"
background="https://cdn.xsolla.net/xsolla-login-widget/images/mail/hero_background.jpg"
border="0" cellpadding="0" cellspacing="0" role="presentation"
style="background:url(https://cdn.xsolla.net/xsolla-login-widget/images/mail/hero_background.jpg) top center / auto repeat;width:100%;">
<tbody>
<tr>
<td style="direction:ltr;font-size:0px;padding:0;text-align:center;vertical-align:top;">
<table border="0" cellpadding="0" cellspacing="0" role="presentation" width="100%">
<tr>
<td align="center" style="font-size:0px;padding:10px 25px;word-break:break-word;">
<div style="font-family:Helvetica Neue, Helvetica, Arial, sans-serif;font-size:36px;line-height:42px;text-align:center;color:#fff;">
{{subject}}
</div>
</td>
</tr>
</table>
</td>
</tr>
</tbody>
</table>
<table align="center"
background="rgba(44,72,98,0.7)"
border="0" cellpadding="0" cellspacing="0" role="presentation"
style="background: rgba(44,72,98,0.7); width:100%;">
<!-- Block with the email text -->
</table>
</td>
</tr>
</tbody>
</table>
</td>
</tr>
</table>
</body>
</html>
继续阅读
在常见问答中寻找答案
我可以使用自己的SendGrid应用程序来发送邮件吗?发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。