README

此插件使您能够将营销自动化工具 Mautic 与 Neos CMS 一起使用。其关键功能包括

两步轻松添加 Mautic 跟踪
通过 Neos 表单和 Neos FormBuilder 表单收集数据
SEO 优化的动态内容

安装

composer require punktde/mautic

配置

配置 Mautic

访问您的 Mautic 安装，并为 API 创建用户。
启用 API 和 HTTP 基本认证。可选：请确保您的 Mautic 安装正在 HTTPS 上运行以提高安全性。
如果您的网站和 Mautic 在同一服务器上运行，请跳过此步骤
- 启用 CORS，将您的网站添加到 有效域名。

配置插件

将以下配置添加到您的网站 Settings.yaml

PunktDe:
  Mautic:
    mauticServer:
      url: https://mymautic.com
    mauticUser:
      username: mautic-api
      password:

启用跟踪

请确保您已在配置中输入了正确的 Mautic URL。
将 Mautic 跟踪模板放置在 <body> 的底部
```
mautic = PunktDe.Mautic:MauticTracking
```

将此代码添加到您希望跟踪的每个页面的融合文件中。如果您想跟踪所有页面，请将此部分添加到您的页面 Root.fusion 或 AbstractPage.fusion。

从表单传递信息到 Mautic

yaml 格式的表单

要从 yaml 表单传递信息到 Mautic，您需要定义哪些表单元素应被考虑。将以下属性添加到这些字段

mauticIdentifier: 'firstname'

由于 Mautic API 中的一个错误，mauticIdentifier 必须是小写。

您还需要添加以下完成器

identifier: 'PunktDe.Mautic:UpdateUser'

一个示例表单看起来像这样

type: 'Neos.Form:Form'
identifier: 'form-identifier'
label: 'Blog comment'
renderingOptions:
  submitButtonLabel: 'Send'
renderables:
  -
    type: 'Neos.Form:Page'
    identifier: 'blog-comment'
    renderables:
      -
        type: 'Neos.Form:SingleLineText'
        identifier: 'name'
        label: 'Name'
        properties:
          mauticIdentifier: 'firstname'
        defaultValue: ''
finishers:
  -
    identifier: 'PunktDe.Mautic:UpdateUser'

mauticIdentifier 的值必须是 Mautic 中定义的用户字段（即自定义字段）。您可以根据需要搜索、编辑或创建新的自定义字段。

FormBuilder 格式的表单

由 FormBuilder 创建的表单需要在 Neos 后端中输入 Mautic 标识符。这可以通过选择表单元素并在您 UI 的右侧设置栏中设置值来实现。

由于 Mautic API 中的一个错误，mauticIdentifier 必须是小写。

您还必须为此表单注册 Mautic 完成器。

动态内容

您可以为属于不同 Mautic 段的用户显示不同的内容维度。

在 Mautic 中创建一个新的段.
在您的 settings.yaml 中定义段。请使用与您的 Neos 维度相同的名称以及您的 mautic 段。

Neos: ContentRepository: contentDimensions: mautic: label: 'Mautic Segment' icon: 'icon-globe' default: defaultUser defaultPreset: defaultUser presets: all: null defaultUser: label: 'Default User' values: - defaultUser uriSegment: '' twitter: label: twitter values: - twitter uriSegment: twitter
您可以无问题地组合多个维度（例如语言）。
访问后端，更改维度并编辑内容。发布它。

社交媒体跟踪

可以使用 UTM 标签跟踪来自不同来源的用户。只需在发布到社交媒体之前将任何 UTM 标签添加到链接中即可

https://punkt.de/blog/post?utm-source=AnySourceName

当用户有 UTM 标签并提交表单时，此信息也将保存在 Mautic 中。

punktde / mautic

维护者

详细信息