README

GoogleTagManagerBundle提供了一种简单易用的方法，将Google Tag Manager集成到您的Symfony 2应用程序中。

注意：此Bundle仍在开发中。欢迎报告遇到的问题！

要求

2.x

PHP 5.3及以上
Symfony 2.8及以上

3.x

PHP 5.6及以上
Symfony 2.8及以上

安装

步骤 1：下载Bundle

打开命令行，进入您的项目目录，并执行以下命令以下载此Bundle的最新稳定版本

2.x

$ composer require xynnn/google-tag-manager-bundle "~2.0"

3.x

$ composer require xynnn/google-tag-manager-bundle "~3.0"

此命令需要您已全局安装Composer，请参阅Composer文档的安装章节。

步骤 2：启用Bundle

然后，通过在您的项目的app/AppKernel.php文件中添加以下行来启用此Bundle

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...

            new Xynnn\GoogleTagManagerBundle\GoogleTagManagerBundle(),
        );

        // ...
    }

    // ...
}

步骤 3：启用Google Tag Manager

将配置添加到您的yaml文件中。请记住调整您的Google Tag Manager Id。

步骤 4：插入ViewHelper

将ViewHelper插入到您的布局文件中，以启用Google Tag Manager。请注意，请在HTML body标签之后插入它！

<body>
{{ google_tag_manager_body() }}
...
</body>

并且在HTML head标签之后

<head>
{{ google_tag_manager_head() }}
...
</head>

并且在关闭BODY标签之前

{{ google_tag_manager_body_end() }}
</body>

或者使用autoAppend设置，让内核响应监听器自动将它们添加到布局中。

其他说明：https://developers.google.com/tag-manager/quickstart

步骤 5：从Google Tag Manager填写DataLayer（可选）

如果您想向Google Tag Manager发送一些信息，可以使用dataLayer。

/** @var GoogleTagManagerInterface $manager */
$manager = $this->get('google_tag_manager');
$manager->setData('example', 'value');

如果您想在body的末尾添加推送（不在初始dataLayer中）

/** @var GoogleTagManagerInterface $manager */
$manager = $this->get('google_tag_manager');
$manager->addPush(['test' => 123);

配置

google_tag_manager:
    enabled: true
    id: "GTM-XXXXXX"
    autoAppend: true|false

一个名为additionalParameters的可选参数允许指定要添加到标签管理器URL的URL参数。这可以用于支持标签管理器中的自定义环境。

google_tag_manager:
    additionalParameters: gtm_auth=XXXXXXXXXXXXX&gtm_preview=env-30&gtm_cookies_win=x

作者

Philipp Bräutigam

...以及贡献者！

许可

版权（c）2017 Philipp Bräutigam 此存储库在GNU LGPL v3.0许可下发布。

xyNNN / google-tag-manager-bundle

维护者

详细信息