This bundle provides comprehensive user tracking with Google Analytics for any Symfony2 project.
Inside this bundle, only the new "Universal Analytics API" (i.e. "analytics.js") is used for pageview- and event tracking [1]. For the server-to-server (non-JavaScript) features - especially in the context of ecommerce tracking - the bundles relies on the "Measurement Protocol API" [2].
[1] https://developers.google.com/analytics/devguides/collection/analyticsjs/
[2] https://developers.google.com/analytics/devguides/collection/protocol/v1/
Besides the widely known pageview tracking, this bundle also provides an easy way for pushing custom events to Google via the lightweight JavaScript tracking code.
Event pushing for exceptions and other basic events, like logins and some user actions provided by the FOSUserBundle (registration, resetting, ...) is already included in the bundle. Please be aware that the number of events that can be sent is limited by Google.
See https://developers.google.com/analytics/devguides/collection/analyticsjs/events
The code snippet for the enhanced link attribution (ga('require', 'linkid', 'linkid.js');)
is included in the JavaScript tag. Please make sure, every link and every button
has a unique id, since this is required for Google to track the links properly.
See https://support.google.com/analytics/answer/2558867
Coming soon.
See https://developers.google.com/analytics/devguides/collection/analyticsjs/custom-dims-mets
Coming soon.
See https://developers.google.com/analytics/devguides/collection/analyticsjs/user-id
Coming soon.
See https://developers.google.com/analytics/solutions/experiments-server-side
I didn't decide on a license yet, but I'll do eventually.
-
Include this bundle as a dependency in your
composer.json:{ ..., "require": { ..., "swis/google-analytics-bundle": "dev-master@dev", ... }, ... }
-
Enable the bundle in your
app/AppKernel.php:class AppKernel extends Kernel { public function registerBundles() { $bundles = array( /* ... */ new Swis\Bundle\GoogleAnalyticsBundle\SwisGoogleAnalyticsBundle(), /* ... */ ); /* ... */ } /* ... */ }
-
Provide your Google Analytics Tracking ID somewhere in your
app/config/config.yml:swis_google_analytics: tracking_id: UA-xxxxxxxx-x # Get this value from your Google Analytics account.
-
Include the JavaScript code snippet in your template before the closing
</head>tag:<html> <head> <!-- ... //--> {{ swis_google_analytics() }} </head> <!-- ... //--> </html>
-
If you want to use the Measurement Protocol features, then you need the clientId from the Google Analytics tracking cookie. To internally track this clientId, just include the routes from this bundle and everything else is done automatically when you then set a userId. You can change the prefix to whatever you want.
swis_google_analytics: resource: "@SwisGoogleAnalyticsBundle/Resources/config/routing.yml" prefix: /tracking
-
That's it!
swis_google_analytics:
tracking_id: ~ # The Google Analytics tracking ID (e.g. UA-xxxxxxxx-x). Required.
domain: ~ # If set, the configured host name is sent to Google instead of the really one retrieved from the called URL.
provide_opt_out: false # If set, a javascript function for opting out the Google tracking is provided. The function's name then is googleOptOut().
site_speed_sample_rate: 100 # Defines the site speed sample rate. See https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#siteSpeedSampleRate for details.
anonymize_ip: true # Triggers the IP anonymization for privacy reasons. Required in some countries to be true.
enable_displayfeatures: true # Enables the Google Analytics display features. See https://developers.google.com/analytics/devguides/collection/analyticsjs/display-features for details.
enable_exceptions: true # If set, exceptions are tracked via the JavaScript API. Please make sure, that you include the twig tag into your exception template to have the event connected to the right URL within GA.
enable_default_events: true # If set, default events are tracked via the JavaScript API, see the [DefaultEventsListener](https://github.com/swis/GoogleAnalyticsBundle/blob/master/Listener/DefaultEventsListener.php)
tests: # This section is optional and only if you want to make use of the server-side test features.
testID1: # This name of the following array should be the ID of the test as given by the Google Analytics web site, e.g. Sbz39RY3R5SwOKwKV10OxA.
distribution: [x, y] # The distribution across the original and the variants, e.g. [.8, .15, .05] means that we have the original and 2 variants and the 1st variant should be applied to 15% of the visitors and the 2nd variant to 5%.
testID2: # ...
distribution: [x, y]
...