2017 © Pedro Peláez
 

library laravel-analytics

Analytics tracking for laravel 4.x

image

arcticfalcon/laravel-analytics

Analytics tracking for laravel 4.x

  • Thursday, February 12, 2015
  • by arcticfalcon
  • Repository
  • 1 Watchers
  • 0 Stars
  • 59,199 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 41 Forks
  • 0 Open issues
  • 13 Versions
  • 3 % Grown

The README.md

Analytics tracking package for Laravel 4.x

Latest Stable Version Latest Unstable Version License Total Downloads, (*1)

Installation

Add to your composer.json following lines, (*2)

"require": {
    "arcticfalcon/laravel-analytics": "~1.0"
}

Run php artisan config:publish arcticfalcon/laravel-analytics, (*3)

Then edit analytics.php in app/config/packages/arcticfalcon/laravel-analytics to your needs., (*4)

Add 'ArcticFalcon\LaravelAnalytics\AnalyticsServiceProvider', to providers in app/config/app.php., (*5)

Add 'Analytics' => 'ArcticFalcon\LaravelAnalytics\AnalyticsFacade', to aliases in app/config/app.php., (*6)

Configuration

provider    - Provider to use, possible Providers are: GoogleAnalytics, NoAnalytics

Google Analytics

tracking_id - Tracking ID

tracking_domain - Tracking domain, unset or set to "auto" for automatic fallback

anonymize_ip - (true|false) anonymize users ip

auto_track - (true|false) auto tracking current pageview

Usage

In controller action (or anywhere else) use following statement to track an event or page view:, (*7)

//  tracking the current page view
Analytics::trackPage(); // only necessary if `auto_track` is false or Analytics::disableAutoTracking() was called before

//  tracking an event
Analytics::trackEvent('category', 'action');

//  tracking a custom line
Analytics::trackCustom("ga('send', ......"); // this line will be added within the tracking script

In your view or layout template (e.g. a blade template) use the following statement:, (*8)

{{ Analytics::render() }}

For Google Analytics you should place the statement right behind the body tag, (*9)

<body>{{ Analytics::render() }}

How to use

The GoogleAnalytics Provider automatically controls the local environment behaviour for testing purposes. See https://developers.google.com/analytics/devguides/collection/analyticsjs/advanced#localhost for details., (*10)

There is a builtin provider called NoAnalytics. This is for testing environments and tracks nothing. So you do not have to rewrite your code, simple select this provider in analytics configuration for your special environment configurations., (*11)

Track a measurement without having javascript

  1. Log in to Google Analytics and create custom definition. There you create a custom metrics. For example: Email opens, Integer type, min: 0 and max: 1 This will be available as metric1., (*12)

  2. Within your mail template (or page template) you have to create a tracking image, (*13)

    <img src="{{ Analytics::trackMeasurementUrl('metric1', '1', new Event, new Campaign, md5($user)) }}" width="1" height="1" style="background-color: transparent; border: 0 none;" />, (*14)

  3. That's it, (*15)

API Documentation

For the correct usage methods look at the ArcticFalcon\LaravelAnalytics\Contracts\AnalyticsProviderInterface.php, (*16)

Analytics::render()

For rendering the correct javascript code., (*17)

/**
 * returns the javascript code for embedding the analytics stuff
 *
 * @return string
 */
public function render();

Analytics::trackPage()

For tracking a page view., (*18)

/**
 * track an page view
 *
 * @param null|string $page
 * @param null|string $title
 * @param null|string $hittype
 * @return void
 */
public function trackPage($page, $title, $hittype);

Analytics::trackEvent()

For tracking an event, (*19)

/**
 * track an event
 *
 * @param string $category
 * @param string $action
 * @param null|string $label
 * @param null|int $value
 * @return void
 */
public function trackEvent($category, $action, $label, $value);

Analytics::trackCustom()

For tracking a custom script line within the embedded analytics code., (*20)

/**
 * track any custom code
 *
 * @param string $customCode
 * @return void
 */
public function trackCustom($customCode);

Analytics::enableAutoTracking()

Enabling the auto tracking, overriding the configuration setting auto_track., (*21)

/**
 * enable auto tracking
 *
 * @return void
 */
public function enableAutoTracking();

Analytics::disableAutoTracking()

Disabling the auto tracking, overriding the configuration setting auto_track., (*22)

/**
 * disable auto tracking
 *
 * @return void
 */
public function disableAutoTracking();

Analytics::trackMeasurementUrl()

Sometimes you have to track measurements, e.g. opening an email newsletter. There you have no javascript at all., (*23)

/**
 * assembles an url for tracking measurement without javascript
 *
 * e.g. for tracking email open events within a newsletter
 *
 * @param string $metricName
 * @param mixed $metricValue
 * @param \ArcticFalcon\LaravelAnalytics\Data\Event $event
 * @param \ArcticFalcon\LaravelAnalytics\Data\Campaign $campaign
 * @param string|null $clientId
 * @param array $params
 * @return string
 */
public function trackMeasurementUrl($metricName, $metricValue, Event $event, Campaign $campaign, $clientId = null, array $params = array());

The Versions

12/02 2015

dev-master

9999999-dev

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robert Kummer
by Juan Falcón

laravel statistics analytics php javascript google analytics

12/02 2015

1.6

1.6.0.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robert Kummer
by Juan Falcón

laravel statistics analytics php javascript google analytics

04/11 2014

1.5

1.5.0.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robert Kummer
by Juan Falcón

laravel statistics analytics php javascript google analytics

28/10 2014

1.4.1

1.4.1.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robert Kummer
by Juan Falcón

laravel statistics analytics php javascript google analytics

28/10 2014

1.4

1.4.0.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robert Kummer
by Juan Falcón

laravel statistics analytics php javascript google analytics

27/10 2014

1.3

1.3.0.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robert Kummer
by Juan Falcón

laravel statistics analytics php javascript google analytics

27/10 2014

1.2

1.2.0.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robert Kummer
by Juan Falcón

laravel statistics analytics php javascript google analytics

27/10 2014

1.1.0

1.1.0.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

The Development Requires

by Robert Kummer
by Juan Falcón

laravel statistics analytics php javascript google analytics

15/09 2014

1.0.7

1.0.7.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

by Robert Kummer

laravel statistics analytics php javascript google analytics

15/08 2014

1.0.6

1.0.6.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

by Robert Kummer

laravel statistics analytics php javascript google analytics

09/05 2014

1.0.4

1.0.4.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

by Robert Kummer

laravel statistics analytics php javascript google analytics

27/03 2014

1.0.3

1.0.3.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

by Robert Kummer

laravel statistics analytics php javascript google analytics

07/03 2014

1.0.0

1.0.0.0

Analytics tracking for laravel 4.x

  Sources   Download

MIT

The Requires

 

by Robert Kummer

laravel statistics analytics php javascript google analytics