Download the PHP package spatie/laravel-googletagmanager without Composer
On this page you can find all versions of the php package spatie/laravel-googletagmanager. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download spatie/laravel-googletagmanager
More information about spatie/laravel-googletagmanager
Files in spatie/laravel-googletagmanager
Package laravel-googletagmanager
Short Description Google Tag Manager integration for Laravel
License MIT
Homepage https://github.com/spatie/laravel-googletagmanager
Informations about the package laravel-googletagmanager
Google Tag Manager integration for Laravel
An easy Google Tag Manager implementation for your Laravel 5 application.
Laravel 4 version: spatie/laravel4-googletagmanager
Spatie is a webdesign agency in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
Support us
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
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 through 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.
Install
You can install the package via Composer:
In Laravel 5.5 and up, the package will automatically register the service provider and facade
In L5.4 or below start by registering the package's the service provider and facade:
The facade is optional, but the rest of this guide assumes you're using the facade.
Next, publish the config files:
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.
If you plan on using the flash-functionality you must install the GoogleTagManagerMiddleware, after the StartSession middleware:
Configuration
The configuration file is fairly simple.
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:
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.
Your base dataLayer will also be rendered here. To add data, use the set()
function.
This renders:
Flashing data for the next request
The package can also set data to render on the next request. This is useful for setting data after an internal redirect.
After a form submit, the following dataLayer will be parsed on the contact page:
Other Simple Methods
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.
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.
If you want full access to the GoogleTagManager instances' data layer, call the getDataLayer()
function.
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.
In the configuration you can optionally set the path to the file that contains your macros.
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you've found a bug regarding security please mail [email protected] instead of using the issue tracker.
Postcardware
You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Kruikstraat 22, 2018 Antwerp, Belgium.
We publish all received postcards on our company website.
Credits
- Sebastian De Deyne
- All Contributors
License
The MIT License (MIT). Please see License File for more information.