包简介

Google Tag Manager integration for Laravel 4

README 文档

README

THIS PACKAGE HAS BEEN ABANDONED

Google Tag Manager integration for Laravel

An easy Google Tag Manager implementation for your Laravel 4 application.

Laravel 5 version: spatie/laravel-googletagmanager

Spatie is a webdesign agency in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.

Google Tag Manager

Google Tag Manager allows you manage tracking and marketing optimization with AdWords, Google Analytics, et al. without editing your site code. One way of using Google Tag Manager is by sending data through a dataLayer variable in javascript after the page load and on custom events. This package makes managing the data layer easy.

For concrete examples of what you want to send throught the data layer, check out Google Tag Manager's Developer Guide.

You'll also need a Google Tag Manager ID, which you can retrieve by signing up and creating an account for your website.

Postcardware

You're free to use this package (it's MIT-licensed), but if it makes it to your production environment you are required to send us a postcard from your hometown, mentioning which of our package(s) you are using.

Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.

The best postcards will get published on the open source page on our website.

Install

You can install the package via Composer:

$ composer require spatie/laravel4-googletagmanager

Start by registering the package's the service provider and facade:

// app/config/app.php (L4)

'providers' => [
  ...
  'Spatie\GoogleTagManager\GoogleTagManagerServiceProvider',
],

'aliases' => [
  ...
  'GoogleTagManager' => 'Spatie\GoogleTagManager\GoogleTagManagerFacade',
],

The facade is optional, but the rest of this guide assumes you're using the facade.

Next, publish the config files:

// L4
$ php artisan config:publish spatie/googletagmanager --path="vendor/spatie/laravel4-googletagmanager/resources/config"

Optionally publish the view files. It's not recommended to do this unless necessary so your views stay up-to-date in future package releases.

// L4
$ php artisan views:publish spatie/googletagmanager --path="vendor/spatie/laravel4-googletagmanager/resources/views"

Configuration

The configuration file is fairly simple.

return [
    'id' => '',
    'enabled' => true,
];

During development, you don't want to be sending data to your production's tag manager account, which is where enabled comes in.

Example setup:

return [
    'id' => 'GTM-XXXXXX',
    'enabled' => app()->environment() === 'production',
];

Usage

Basic Example

First you'll need to include Google Tag Manager's script. Google's docs recommend doing this right after the body tag.

{{-- layout.blade.php --}}
<html>
  {{-- ... --}}
  <body>
    @include('googletagmanager::script')
    {{-- ... --}}
  </body>
</html>

Your base dataLayer will also be rendered here. To add data, use the set() function.

// HomeController.php

public function index()
{
    GoogleTagManager::set('pageType', 'productDetail');

    return view('home');
}

This renders:

<html>
  <!-- ... -->
  <body>
    <script>dataLayer = [{"pageType":"productDetail"}];</script>
    <script>/* Google Tag Manager's script */</script>
    <!-- ... -->
  </body>
</html>

Other Simple Methods

// Retrieve your Google Tag Manager id
$id = GoogleTagManager::id(); // GTM-XXXXXX

// Check whether script rendering is enabled
$enabled = GoogleTagManager::isEnabled(); // true|false

// Enable and disable script rendering
GoogleTagManager::enable();
GoogleTagManager::disable();

// Add data to the data layer (automatically renders right before the tag manager script). Setting new values merges them with the previous ones. Set als supports dot notation.
GoogleTagManager::set(['foo' => 'bar']);
GoogleTagManager::set('baz', ['ho' => 'dor']);
GoogleTagManager::set('baz.ho', 'doorrrrr');

// [
//   'foo' => 'bar',
//   'baz' => ['ho' => 'doorrrrr']
// ]

Dump

GoogleTagManager also has a dump() function to convert arrays to json objects on the fly. This is useful for sending data to the view that you want to use at a later time.

<a data-gtm-product='{!! GoogleTagManager::dump($article->toArray()) !!}' data-gtm-click>Product</a>

$('[data-gtm-click]').on('click', function() {
    dataLayer.push({
        'event': 'productClick',
        'ecommerce': {
            'click': {
                'products': $(this).data('gtm-product')
            }
        }
        'eventCallback': function() {
            document.location = $(this).attr('href');
        }
    });
});

DataLayer

Internally GoogleTagManager uses the DataLayer class to hold and render data. This class is perfectly usable without the rest of the package for some custom implementations. DataLayer is a glorified array that has dot notation support and easily renders to json.

$dataLayer = new Spatie\GoogleTagManager\DataLayer();
$dataLayer->set('ecommerce.click.products', $products->toJson());
echo $dataLayer->toJson(); // {"ecommerce":{"click":{"products":"..."}}}

If you want full access to the GoogleTagManager instances' data layer, call the getDataLayer() function.

$dataLayer = GoogleTagManager::getDataLayer();

Macroable

Adding tags to pages can become a repetitive process. Since this package isn't supposed to be opinionated on what your tags should look like, the GoogleTagManager is macroable.

GoogleTagManager::macro('impression', function ($product) {
    GoogleTagManager::set('ecommerce', [
        'currencyCode' => 'EUR',
        'detail' => [
            'products' => [ $product->getGoogleTagManagerData() ]
        ]
    ]);
});

GoogleTagManager::impression($product);

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email freek@spatie.be instead of using the issue tracker.

Credits

About Spatie

Spatie is a webdesign agency in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.

License

The MIT License (MIT). Please see License File for more information.

spatie/laravel4-googletagmanager 适用场景与选型建议

spatie/laravel4-googletagmanager 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 781 次下载、GitHub Stars 达 14，最近一次更新时间为 2015 年 06 月 11 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「laravel」「spatie」「Google Tag Manager」「laravel-googletagmanager」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 spatie/laravel4-googletagmanager 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 spatie/laravel4-googletagmanager 我们能提供哪些服务？

定制开发 / 二次开发

基于 spatie/laravel4-googletagmanager 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 spatie/laravel4-googletagmanager 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

kbv-vcos/laravel-webhook-client 0

Receive webhooks in Laravel apps

juzaweb/image-optimizer 0

Easily optimize images using PHP

e-conomix/mageplaza-magento-2-social-login 0

Magento 2 Social Login extension is designed for quick login to your Magento 2 store without procesing complex register steps

jimchen/laravel-settings 1

Store your application settings

metasyntactical/google-directions-client 2

Client for Google Directions API to add interpolated points to a route consisting of given coordinates.

foxtes/alfabank-rest 1

Alfabank REST API integration

spatie/laravel4-googletagmanager

包简介

关键字：