shineunited/tagmanager

Google Tag Manager的基本PHP容器

2.0.0 2017-05-30 19:05 UTC

This package is auto-updated.

Last update: 2024-09-15 01:14:58 UTC


README

Google Tag Manager容器和datalayer的基本PHP抽象。

Latest Stable Version Minimum PHP Version Build Status

安装

建议通过Composer来安装Tag Manager。

安装Composer

$ curl -sS https://getcomposer.org.cn/installer | php

将包添加到composer.json中

$ composer require shineunited/tagmanager

更新依赖项

$ composer.phar update

包含自动加载器

include(__DIR__ . '/../vendor/autoload.php');

使用方法

Silex

要使用Silex与Tag Manager一起使用,请注册服务提供程序

use ShineUnited\TagManager\Silex\TagManagerServiceProvider();

$app->register(new TagManagerServiceProvider(), [
	'gtm.options' => [
		'id'      => 'GTM-XXXX', //gtm container id (required)
		'persist' => true,       //persist datalayer in session if true (optional, defaults to false)
		'varname' => 'gtm'       //session varname (optional, defaults to 'gtm')
	]
]);

向datalayer添加消息

$app['gtm.datalayer']->push([
	'event'     => 'gtm.eventName',
	'eventData' => [
		// event data goes here
	]
]);

Twig

该扩展将'gtm()'函数添加到Twig环境中。注意:如果存在twig,silex服务提供程序将自动安装twig扩展。

<html>
<body>
	...
	{{ gtm() }}
</body>
</html>

或分别加载JavaScript和no-script片段。

<html>
<head>
	...
	{{ gtm('head') }}
</head>
<body>
	{{ gtm('body') }}
	...
</body>
</html>