README

Google Tag Manager 集成。

需求

在继续之前，请确保所有依赖项都已安装

PHP >= 7.1
Composer

安装

通过 Composer 安装

$ composer require helick/gtm

通过声明以下内容更新您的应用程序配置

Config::define('GTM_CONTAINER_ID', env('GTM_CONTAINER_ID'));

通过声明以下内容更新您的环境变量

GTM_CONTAINER_ID=GTM-XXXX

使用方法

为了支持没有 JavaScript 的设备的回退 iframe，请在您的主题中在 <body> 标签之后添加以下代码

<?php wp_body_open(); ?>

数据层

Google Tag Manager 提供了一个数据层，它允许您传递任意数据，这些数据可以用来修改添加到您网站上的标签。

此插件添加了一些默认信息，例如帖子、标签和分类，并提供了一个简单的过滤器，以添加您自己的自定义数据。

add_filter('helick_gtm_data_layer', function (array $dataLayer) {
    $dataLayer['foo'] = 'bar';

    return $dataLayer;
});

事件跟踪

要禁用事件跟踪，您可以声明以下内容

add_filter('helick_gtm_enable_event_tracking', '__return_false');

默认情况下，事件监听器脚本将在您的标记中查找具有特殊数据属性的页面元素，并监听指定的事件以推送到数据层。

数据属性如下

data-gtm-variable 字符串 可选：覆盖此事件的默认数据层变量名称。
data-gtm-on 枚举 [click|submit|keyup|focus|blur] 要监听的 JS 事件，默认为 'click'。
data-gtm-event 字符串 事件名称。
data-gtm-category 字符串 可选：将事件分组。
data-gtm-label 字符串 可选：事件的易读标签。
data-gtm-value 数字可选：与事件关联的数字值。
data-gtm-fields 字符串 可选：作为编码 JSON 提供的额外数据。

示例

<button
    data-gtm-on="click"
    data-gtm-event="play"
    data-gtm-category="videos"
    data-gtm-label="Featured Promotional Video"
>
  Play video
</button>

贡献

请参阅CONTRIBUTING 和 CODE_OF_CONDUCT 了解详细信息。

安全性

如果您发现任何与安全相关的问题，请通过电子邮件evgenii@helick.io 而不是使用问题跟踪器。

鸣谢

许可

MIT 许可证 (MIT)。请参阅许可文件了解更多信息。

helick / gtm

维护者

详细信息

README

需求

安装

使用方法

数据层

事件跟踪

贡献

安全性

鸣谢

许可