stelianandrei/laravel-server-side-ga

A simple Laravel package that allows the sending of Google Analytics events from the server side

Laravel Server Side Google Analytics

This is a simple package that allows you to track Google Analytics page views and events from your Laravel application., _(*1)

It was created because I needed a simple way to track these when certain actions occured server-side or when specific actions were triggered from the frontend and I din't want to mingle the JavaScript logic with the tracking part., _(*2)

Installation

First thing you need to do is require the package using composer., _(*3)

composer require stelianandrei/laravel-server-side-ga

Then you need to add the service provider to your config/app.php file under the Package Service Providers section:, _(*4)

  StelianAndrei\LaravelServerSideGA\AnalyticsServiceProvider::class,

Also add the Analytics facade to the aliases array in the same file:, _(*5)

  'Analytics' => StelianAndrei\LaravelServerSideGA\AnalyticsFacade::class,

Last thing you need to do is publish the configuration for this package. In order to do that all you need to do it run the following command:, _(*6)

php artisan vendor:publish --provider="StelianAndrei\LaravelServerSideGA\AnalyticsServiceProvider"

That will create a configuation file for this package at config/analytics.php where you need to enter the property code you are using for tracking events and page views. You can either keep it here or define the ANALYTICS_TRACKING_ID property in your .env file., _(*7)

Tracking page views

To track page views, use it as follows:, _(*8)

Analytics::trackPage($page, $title, $hitType)

Where:, _(*9)

• $page - (optional) the url of the page you are tracking (eg: /about)
• $title - (optional) the title of the page you are tracking (eg: About us)
• $hitType - (optional) the type of hit you are sending (defaults to pageview)

Tracking events

To track an event, use it as follows:, _(*10)

Analytics::trackEvent($category, $action, $label = null, $value = null)

Where:, _(*11)

• $category - the category of the event (eg: Account creation)
• $action - the action you're tracking (eg: Click button)
• $label - (optional) the label for the event (eg: Recover password)
• $value - (optional) an optional value for the event