V1 Readme

Java API for Google Analytics Measurement Protocol

Java API for Google Analytics Measurement Protocol (part of Universal Analytics). This library is released under liberal Apache Open source License 2.0

Google Analytics Measurement Protocol is new tracking protocol, which will replace the legacy Tracking protocol. This protocol is documented at https://developers.google.com/analytics/devguides/collection/protocol/v1/

The library is available in Maven Central. Add the following dependency and you are good to go.

<dependency>
    <groupId>com.brsanthu</groupId>
    <artifactId>google-analytics-java</artifactId>
    <version>1.1.2</version>
</dependency>

To get a local build, do

git clone https://github.com/brsanthu/google-analytics-java.git
mvn install

View Javadocs here http://brsanthu.github.io/google-analytics-java/javadocs/

Features

This library implements the measurement protocol with following features.

Supports all parameters and hit types.
Able to configure default parameters, which would be used for each request.
Type safe data types as appropriate (String, Integer, Double and Boolean)
Convenient hit specific request types for easy construction.
Synchronous or Asynchronous Event Processing.
Support for delayed request construction.
Asynchronous processing uses Java Concurrent Executor Service.
Uses the latest Apache Http Client (4.3) for high performing event posting.
Event posting can be enabled/disabled at run time at configuration level.
Supports connections via Proxy
Gathers some basic information from the underlying Jvm (File Encoding, User Language, Screen Size, Color Depth etc)
Validates the request and can throw exception or log warning if validation fails (still wip)
Logging uses SLF4J api
Gathers basic stats (number of events posted for each hit type) if requested in the configuration.
Implementation is Thread Safe
Jar files are OSGi ready, so could be used with Eclipse
Build against Java 1.6
Complete Measurement Protocol parameter information is made available as Javadocs

Version History

Version 1.1.2 - Apr 29 2015

Version 1.1.1 - May 21 2014

Fixed the issue #14. Https Collection url has been updated to latest one.
Fixed the issue #15. Added new parameter User Id (uid). As part of this, another change was made to move initializing the default ClientId parameter from GoogleAnalyticsRequest to DefaultRequest. This way, whatever the default clientid you use, will be used for all requests. Previously, default client id wasn't referred.

Version 1.1.0 - Apr 22 2014

Fixed the issue #5. Fix changes some of the existing behavior. If you are using discover system parameters, then by default Screen Colors and Screen Resolution will not be populated. If you would like, you need to set AwtRequestParameterDiscoverer in the GoogleAnalyticsConfig before initializing the GoogleAnalytics. This change is to ensure that it can be used in a environment where JVM has no access to java.awt.* classes.

Version 1.0.5 - Apr 09 2014

Fixed the issue #12

Version 1.0.4 - Mar 3 2014

Fixed the issue #8

Version 1.0.3 - Jan 20 2014

Fixed the issue #6

Examples

GoogleAnalytics ga = new GoogleAnalytics("UA-12345678-1");
ga.post(new PageViewHit("https://www.google.com", "Google Search"));

Or

GoogleAnalytics ga = new GoogleAnalytics("UA-12345678-1");
ga.postAsync(new PageViewHit("https://www.google.com", "Google Search"));

Or

GoogleAnalytics ga = new GoogleAnalytics("UA-12345678-1");
ga.postAsync(new RequestProvider() {
    public GoogleAnalyticsRequest getRequest() {
        return new PageViewHit("https://www.google.com", "Google Search");
    }
});

Other Implementations

There are few Java implementation of Google Analytics api, but found some issues (or protocol mismatch) with each of them.

https://github.com/nhnopensource/universal-analytics-java

Doesn't implement all parameters of Measurement Protocol.
Cannot specify default parameters
Only one unit test case and coverage is very minimal
Uses Legacy Apache Http Client (3.x)

https://code.google.com/p/jgoogleanalyticstracker/

Implements Legacy Google Analytics protocol

https://github.com/siddii/jgoogleanalytics

Implements Legacy Google Analytics protocol

Provide feedback

Saved searches