Mautic 配置设置

正确的配置对于品牌形象、性能以及团队成员的工作体验至关重要。大多数设置完成初始配置后无需更改。

系统设置

常规设置

• 站点 URL - 这是 Mautic 实际安装的位置。在此处设置该站点的 URL。Cron 任务需要此设置来正确确定生成电子邮件等链接时的绝对 URL。它也被称为 Mautic 的“基础 URL”。

• Mautic 的根 URL - 当用户登录其 Mautic 实例时，他们会访问 mautic.example.com。然而，该着陆页也对公众开放。如果联系人访问该地址，他们会看到该实例的 Mautic 登录页面。

  要为该着陆页打上品牌烙印，请创建一个您希望用来欢迎任何访问您根 URL 的联系人的 Mautic 着陆页。完成后，用户可以通过访问 mautic.example.com/s/login 登录 Mautic。

• 404 页面 - 选择您要用作 404 着陆页的着陆页。如果您不想使用 Mautic 默认的 404 错误页面，请创建一个自定义着陆页并在此处选择该着陆页。如果您不选择任何页面，Mautic 将使用默认的错误页面。

• 缓存、日志和图片目录路径 - 这是文件系统路径，Mautic 将在其中保存缓存、日志和图片。

系统默认值

• 每页默认项目限制 - 当您进入某个项目部分时，每页显示的联系人、营销活动、电子邮件等项目数量。默认值为 10。

• 默认时区 - 用户的默认时区，通常设置为公司总部所在的时区。Mautic 允许用户通过其个人资料设置自己的时区。默认值为 UTC。

  例如：总部在波士顿，Mautic 的时区是 America/New York。一位在旧金山（太平洋时间）的用户可以设置 America/Los Angeles，以便在用户界面中使用太平洋时间。

• 默认语言 - 分配给用户的初始语言。个人用户可以选择他们自己的设置。Mautic 默认使用 English - United States。

• 缓存数据超时（分钟） - Mautic 会缓存数据以加快页面加载速度。更新此设置以更改 Mautic 缓存数据的时间。Mautic 默认使用 10 分钟。

• 日期范围筛选默认值 - 设置 Mautic 在报告中查找数据的默认回溯时间，包括项目页面上的营销活动和电子邮件快照图表。此设置允许您控制 Mautic 查找数据的默认回溯时间。如果您已更改某个报告中的设置，Mautic 将使用您输入的值。Mautic 的默认值为 1 个月。

• 完整日期、仅日期、短日期和仅时间的默认格式 - 默认设置使用标准的美国时间格式。框中的字母是 PHP 代码。请参阅 PHP manual for date functions。

CORS 设置

跨源资源共享 (CORS) 允许数据在您的网站和 Mautic 之间传递。

• 限制域名 - 设置为“否”时，任何网站都可以向 Mautic 传递信息。**强烈建议**选择“是”，以限制仅允许“有效域名”中列出的网站与您的 Mautic 实例通信。

• 有效域名 - 允许与您的 Mautic 实例通信的域名列表。在文本框中，每行列出一个您想要允许的确切顶级域名 URL。例如：http://www.example.com 会跟踪非安全 example.com 页面上的任何活动，但 https://www.example.com 不会，因为这仅在安全的 https:// 网站上跟踪。

• 可信任主机 - 明确允许可以向 Mautic 发送请求的主机。输入您安装 Mautic 的域名，例如 mautic.example.com。多个主机用逗号分隔。您也可以使用正则表达式进行高级匹配，Mautic 会使用 / 定界符将其括起来。例如，.*\.?example.com$ 变为 /.*\.?example.com$/。如果留空，Mautic 会响应所有主机。

  在保存过程中，Mautic 会验证您的输入。无效的域名或正则表达式模式会触发错误消息。

  [!CAUTION] 错误的设置可能会阻止访问您的 Mautic 实例。如果被锁定，则需要手动编辑数据库或配置文件来修复设置。

• 可信任代理 - 配置 Mautic 应信任为代理的 IP 地址。当 Mautic 位于 SSL 终端代理后面时，此设置是强制性的。多个 IP 地址用逗号分隔。例如 127.0.0.1, 10.0.0.0/8, fc00::/7

[!NOTE] 在“有效域名”字段中，末尾不要包含斜杠。例如，使用 https://www.example.com 而不是 https://www.example.com/。

杂项设置

• IP 查找服务 - 默认情况下，Mautic 使用 MaxMind's 的数据库，根据其 IP 地址的互联网服务提供商 (ISP) 位置来识别网站访问者的城市。
• IP 查找服务认证 - 要使用任何需要认证的 IP 查找服务，请输入您的凭证。
• 不跟踪联系人 IP 列表 - 要关闭对特定 IP 地址的跟踪，每行输入一个地址。Mautic 建议不要添加您的办公 IP 地址。如果您列出了内部 IP 地址，Mautic 将不会跟踪来自该 IP 的点击、页面访问等，**包括您在测试时**，这可能会导致困难。
• 已知机器人列表 - Mautic 具有识别和关闭对几个已知机器人跟踪的功能。要跟踪这些机器人的活动，请将它们从此列表中移除。要关闭对其他机器人的跟踪，请在此处添加它们 - 每行一个。
• URL 缩短器 - 如果您在短信链接中使用像 bit.ly 这样的 URL 缩短服务，请在此处输入您的访问令牌。

[!NOTE] 对于 bit.ly，请使用以下 URL 结构：https://api-ssl.bitly.com/v3/shorten?access_token=[ACCESS_TOKEN]&format=txt&longUrl

• 项目最大锁定时间 - 当用户编辑营销活动、电子邮件、着陆页等时，Mautic 会锁定该项目以防止其他用户同时编辑。当初始用户保存并关闭或取消时，项目可能在此时间段内保持锁定。默认值为 0 秒。
• 翻译页面标题 - 将联系人活动历史中的页面标题从非拉丁字符翻译为拉丁（英文）字符。

更新设置

• 设置更新所需的最低稳定性级别 - 这允许您接收早期访问版本的更新通知。在更新到早期访问版本之前，请务必阅读发行说明。设置更新所需的最低稳定性级别。
• 通过 Composer 更新 Mautic [beta] - 如果您通过 Composer 更新 Mautic，请设置为“是”。如果您想通过市场安装和更新插件，这是一个先决条件。这将成为 Mautic 5 中的默认安装和更新方法。

主题设置

• 默认主题 - 将某个主题应用于尚未应用主题的任何表单。如果您没有为偏好中心创建着陆页，但在电子邮件设置中打开了偏好设置，Mautic 将使用此处所选主题的表单样式创建默认的偏好中心页面。

API 设置

完整的 API 文档可在开发者文档的 Mautic REST API 部分找到。

• 启用 API - 选择“是”以允许通过 API 向 Mautic 传入和传出数据。

• 启用 HTTP 基本认证？ - 为 Mautic 的 API 启用基本认证。建议仅对安全站点 (https) 使用此功能。

• 访问令牌有效期 - 在授权新的应用程序或集成时，此设置限制访问令牌的有效时间（以分钟为单位）。默认值为 60 分钟。

  例如 - 您向 SaaS 平台添加了一个新的集成。在此处输入 30，将访问令牌的有效期限制为 30 分钟。如果您在此期间未完成认证，则必须重新验证。

• 刷新令牌有效期 - 使用 OAuth 2.0 时，用于在访问令牌过期后请求新访问令牌的刷新令牌的有效期。一旦刷新令牌过期，您必须重新授权。默认值为 14 天。

资源设置

• 资源目录路径 - 设置资源上传文件夹的绝对路径。为了防止公众访问资源，请使用公共 Web 根目录之外的目录。
• 最大大小（兆字节） - 设置上传资源的最大大小（以兆字节为单位）。
• 允许的文件扩展名 - 文件扩展名，用逗号分隔。您只能上传具有指定文件扩展名的文件。

营销活动设置

• 重试失败操作前的等待时间 - 如果营销活动操作因某种原因未执行，这是 Mautic 在重试之前等待的时间长度。

• 对所有视图使用日期范围 - 查看营销活动时，在选项卡中显示的操作、条件、决策和联系人的日期范围，Mautic 默认使用此日期范围。

• 使用汇总统计 - 查看每天有数千个事件的营销活动时，使用汇总数据来提高性能。首次启用此设置时，您需要运行一个 Cron 任务<营销活动 Cron 任务> 来汇总现有数据。

• 营销活动重新激活行为 - 配置在停用一段时间后重新激活营销活动时，Mautic 如何处理工作流中间具有相对延迟的预定事件。此设置提供了一个全局默认值，您可以针对单个营销活动覆盖它。此设置会影响 营销活动 Cron 任务<营销活动 Cron 任务> 安排事件的方式。有关更多信息，请参阅 营销活动重新激活行为 部分。

  可用选项：

  • 无论激活状态如何都计算延迟 - Mautic 使用原始触发日期。事件根据原始计划中的日历日执行，无论营销活动在这些天内是处于活动还是非活动状态。这是默认行为。
  • 在重新激活时重新开始 - 当您重新激活营销活动时，延迟计数器会重置。Mautic 会重新安排事件，从上次激活日期开始执行整个延迟周期。
  • 仅在活动时计算延迟 - 事件仅在营销活动保持活动状态时计算天数。如果您停用营销活动，这些天不计入延迟。当您重新激活营销活动时，Mautic 会相应地重新安排事件。

联系人事件调度器优化

联系人事件调度器优化设置允许您配置用于营销活动优化事件调度器的默认计时和缓存选项。

• 默认优化开始时间 - 当特定联系人数据不可用时，设置优化交互窗口的默认开始时间。
• 默认优化结束时间 - 当特定联系人数据不可用时，设置优化交互窗口的默认结束时间。
• 默认优化天数 - 当特定联系人数据不可用时，选择被认为最适合交互的默认工作日。
• 交互数据缓存超时 - 选择缓存交互数据的时间。
• 获取交互数据的时间范围 - 选择获取交互数据的时间范围。这决定了查找交互的回溯时间。
• 交互获取限制 - 设置每种类型（例如：页面点击、邮件阅读、表单提交）要获取用于计时优化的最大交互数量。

电子邮件设置

邮件传输设置

由于 Mautic 从 v5 开始使用 Symfony Mailer 库，它开箱即用支持所有 Symfony Mailer 核心插件。

SMTP 传输

SMTP 传输是用于通过 Mautic 发送电子邮件的默认传输方式。它是在 Mautic 配置的“电子邮件设置”选项卡下配置的。其配置与 Symfony Mailer 文档中的配置相同。

Mautic 现在使用一种特定的方式来提供邮件传输解释的连接详细信息，称为数据源名称 (DSN)。这是 Symfony Mailer 文档中为 SMTP 提到的 DSN 配置示例：

smtp://user:pass@smtp.example.com:port

Mautic 会根据在电子邮件配置中输入的值自动创建此 DSN：

示例 DSN smtp://user:pass@smtp.example.com:port/path?option1=value1&option2=value2 说明

[!NOTE] 使用 Mautic 的全局配置来粘贴 DSN 信息，特别是 API 密钥和密码。这些值必须进行 URL 编码，而配置表单会为您处理这一点。如果您直接将 DSN 设置粘贴到 config/local.php 文件中，则必须自己对这些值进行 URL 编码。

示例 API 传输安装

[!WARNING] 只有当您 通过 Composer 安装了 Mautic </getting_started/how_to_install_mautic> 时，才能安装 Symfony 传输插件。

例如，如果您想使用 SendGrid API 而不是 SMTP 来发送电子邮件，您可以通过运行以下命令（在 Symfony Mailer 文档中与其他命令一起提及）来安装官方的 Symfony SendGrid 传输插件。

composer require symfony/sendgrid-mailer

之后，您可以在 Mautic 配置中配置传输方式。示例 DSN 同样在 Symfony Mailer 文档中与其他传输方式一起提及。在使用 SendGrid API 的示例中，DSN 看起来像这样：

sendgrid+api://KEY@default

这就是您配置 Mautic 电子邮件配置的方式：

要替换 SendGrid API 密钥，请将其添加到电子邮件配置中的相关字段并保存。现在，Mautic 将使用 SendGrid API 发送电子邮件。

[!WARNING] Mautic 可以使用 Symfony Mailer 提供的任何传输方式，这是一个不错的功能。但是，请注意，来自 Symfony 的此类传输方式**不支持批量发送，即使是 API 也不支持**。它们每个请求只发送一封电子邮件，而某些 Mautic 传输方式每个请求可以发送一千封电子邮件，这可能会使其在规模较大时速度变慢。它们**也不支持用于退回邮件管理的传输回调处理**。如果您计划发送大量电子邮件或需要使用需要回调处理的功能，请考虑使用专门为此类用途构建的电子邮件传输方式。这些插件可在 Mautic 市场 </marketplace/marketplace> 中找到。

下表列出了为 Mautic 创建的可用传输插件，这些插件包含对批量发送和回调处理的支持。