README

将 Google Analytics 和 Ads 转化跟踪添加到您的网站。使用 syntro/silverstripe-klaro 进行同意管理。

安装

要安装此模块，请运行以下命令

composer require syntro/silverstripe-google-suite

使用方法

此模块的使用方法非常简单。一旦启用某个产品，依赖项就会注入到每个页面。同意管理由 klaro! 负责，它只在用户接受后才会加载跟踪脚本。

有两个配置来处理注入相应的依赖项

• Syntro\SilverstripeGoogleSuite\AnalyticsConfig
• Syntro\SilverstripeGoogleSuite\AdsConfig

提到的每个配置都可以通过添加注册 Ads 或 Analytics 时获得的令牌来启用。您可以添加多个令牌以向多个账户发送事件。还可以指定 gtag('cofig', ...) 标签的附加选项

Syntro\SilverstripeGoogleSuite\AnalyticsConfig:
  google_tokens:
    - X-XXXXXXXXX
    - token: X-XXXXXXXXX
      title: Some Ads Account # set a title for backend use
      option: value

添加至少一个标记后，相应的产品将变为活动状态。

Google Analytics

此模块旨在与新属性一起使用。配置令牌后，所有内容都应自动工作。

Google Ads 转化跟踪

为了跟踪页面上的转化，您必须在 Ads 账户中配置这些转化。转化有一个标签分配给它，您需要将其发送到正确的容器。

要在页面上注入自动化转化，您必须在配置中定义它们

Syntro\SilverstripeGoogleSuite\AdsConfig:
  google_tokens:
    - token: XX-XXXXXXXXXXXX
  onclick_conversion:
    - selector: "a[href*=tel]"
      conversion_label: XxXXxxXXXXxx
    - selector: a[href^="mailto:info@domain.com"]
      conversion_label: XxXXxxXXXXxx
    - selector: a[href*="shop.domain.com"]
      conversion_label: XxXXxxXXXXxx
  onsubmit_conversion:
    - selector: "form[id*=SomeForm]"
      conversion_label: XxXXxxXXXXxx
      conversion_id: XX-XXXXXXXXXXXX

目前有两种自动化转化类型

• onclick_conversion：这些在用户点击元素时触发。
• onsubmit_conversion：这些在用户提交表单时触发。

每个自动化转化都可以有以下键

• selector：一个 CSS 选择器，用于识别您想要跟踪的 DOM 节点
• conversion_label：转化的标签
• conversion_id：（可选）当发出事件时要使用的转化 ID。默认情况下，使用第一个配置的令牌，但在需要添加多个令牌的边缘情况下，请使用此选项来定义目标。
• conversion_url：（可选）不应使用。这会覆盖正常行为，强制用户访问此 URL。

klaro! 样式

此模块使用 syntro/silverstripe-klaro 模块通过同意管理进行 klaro!。我们建议查看该模块以获取有关如何样式化同意窗口的信息。