water.ga

Class GoogleAnalyticsRequest<T>

java.lang.Object

water.ga.GoogleAnalyticsRequest<T>

Direct Known Subclasses:

AppViewHit, DefaultRequest, EventHit, ExceptionHit, ItemHit, PageViewHit, SocialHit, TimingHit, TransactionHit

public class GoogleAnalyticsRequest<T>
extends java.lang.Object

Base GA Tracking Request containing the standard and custom parameter values.

It also provides type safe getter/setters for all parameters that are applicable for all hit types. Hit specific setters/getters are available in corresponding Hit specific request objects (like EventHit or PageViewHit etc)

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<java.lang.String,java.lang.String>	customDimentions
protected java.util.Map<java.lang.String,java.lang.String>	customMetrics
protected java.util.Map<GoogleAnalyticsParameter,java.lang.String>	parms

Constructor Summary

Constructors

Constructor and Description
GoogleAnalyticsRequest()
GoogleAnalyticsRequest(java.lang.String hitType)
GoogleAnalyticsRequest(java.lang.String hitType, java.lang.String trackingId, java.lang.String appName, java.lang.String appVersion)

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	adwordsId()
T	adwordsId(java.lang.String value)
java.lang.Boolean	anonymizeIp()
T	anonymizeIp(java.lang.Boolean value)
java.lang.String	applicationID()
T	applicationID(java.lang.String value)
java.lang.String	applicationInstallerID()
T	applicationInstallerID(java.lang.String value)
java.lang.String	applicationName()
T	applicationName(java.lang.String value)
java.lang.String	applicationVersion()
T	applicationVersion(java.lang.String value)
java.lang.String	cacheBuster()
T	cacheBuster(java.lang.String value)
java.lang.String	campaignContent()
T	campaignContent(java.lang.String value)
java.lang.String	campaignId()
T	campaignId(java.lang.String value)
java.lang.String	campaignKeyword()
T	campaignKeyword(java.lang.String value)
java.lang.String	campaignMedium()
T	campaignMedium(java.lang.String value)
java.lang.String	campaignName()
T	campaignName(java.lang.String value)
java.lang.String	campaignSource()
T	campaignSource(java.lang.String value)
java.lang.String	clientId()
T	clientId(java.lang.String value)
java.lang.String	contentDescription()
T	contentDescription(java.lang.String value)
java.lang.String	customDimension(int index)
T	customDimension(int index, java.lang.String value)
java.util.Map<java.lang.String,java.lang.String>	customDimentions()
java.lang.String	customMetric(int index)
T	customMetric(int index, java.lang.String value)
java.util.Map<java.lang.String,java.lang.String>	custommMetrics()
java.lang.String	displayadId()
T	displayadId(java.lang.String value)
java.lang.String	documentEncoding()
T	documentEncoding(java.lang.String value)
java.lang.String	documentHostName()
T	documentHostName(java.lang.String value)
java.lang.String	documentPath()
T	documentPath(java.lang.String value)
java.lang.String	documentReferrer()
T	documentReferrer(java.lang.String value)
java.lang.String	documentTitle()
T	documentTitle(java.lang.String value)
java.lang.String	documentUrl()
T	documentUrl(java.lang.String value)
java.lang.String	expirementId()
T	expirementId(java.lang.String value)
java.lang.String	expirementVariant()
T	expirementVariant(java.lang.String value)
java.lang.String	flashVersion()
T	flashVersion(java.lang.String value)
protected java.lang.String	fromBoolean(java.lang.Boolean booleanString)
protected java.lang.String	fromDouble(java.lang.Double doubleValue)
protected java.lang.String	fromInteger(java.lang.Integer intValue)
protected java.lang.Boolean	getBoolean(GoogleAnalyticsParameter parameter)
protected java.lang.Double	getDouble(GoogleAnalyticsParameter parameter)
protected java.lang.Integer	getInteger(GoogleAnalyticsParameter parameter)
java.util.Map<GoogleAnalyticsParameter,java.lang.String>	getParameters()
protected java.lang.String	getString(GoogleAnalyticsParameter parameter)
java.lang.String	hitType()
T	hitType(java.lang.String value)
protected boolean	isEmpty(java.lang.String string)
java.lang.Boolean	javaEnabled()
T	javaEnabled(java.lang.Boolean value)
java.lang.String	nonInteractionHit()
T	nonInteractionHit(java.lang.String value)
protected java.lang.String	parameter(GoogleAnalyticsParameter parameter)
protected T	parameter(GoogleAnalyticsParameter parameter, java.lang.String value)
java.lang.String	protocolVersion()
T	protocolVersion(java.lang.String value)
java.lang.Integer	queueTime()
T	queueTime(java.lang.Integer value)
java.lang.String	screenColors()
T	screenColors(java.lang.String value)
java.lang.String	screenResolution()
T	screenResolution(java.lang.String value)
java.lang.String	sessionControl()
T	sessionControl(java.lang.String value)
protected T	setBoolean(GoogleAnalyticsParameter parameter, java.lang.Boolean value)
protected T	setDouble(GoogleAnalyticsParameter parameter, java.lang.Double value)
protected T	setInteger(GoogleAnalyticsParameter parameter, java.lang.Integer value)
protected T	setString(GoogleAnalyticsParameter parameter, java.lang.String value) Sets the String value for specified parameter.
protected java.lang.Boolean	toBoolean(java.lang.String booleanString)
protected java.lang.Double	toDouble(java.lang.String doubleString)
protected java.lang.Integer	toInteger(java.lang.String intString)
java.lang.String	toString()
java.lang.String	trackingId()
T	trackingId(java.lang.String value)
java.lang.String	userAgent()
T	userAgent(java.lang.String value) User Agent Override parameter: &ua Should be a User Agent reported by the browser.
java.lang.String	userId()
T	userId(java.lang.String value) Optional.
java.lang.String	userIp()
T	userIp(java.lang.String value) IP Override parameter: uip Should be a valid IP address.
java.lang.String	userLanguage()
T	userLanguage(java.lang.String value)
java.lang.String	viewportSize()
T	viewportSize(java.lang.String value)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

parms

protected java.util.Map<GoogleAnalyticsParameter,java.lang.String> parms

customDimentions

protected java.util.Map<java.lang.String,java.lang.String> customDimentions

customMetrics

protected java.util.Map<java.lang.String,java.lang.String> customMetrics

Constructor Detail

GoogleAnalyticsRequest

public GoogleAnalyticsRequest()

GoogleAnalyticsRequest

public GoogleAnalyticsRequest(java.lang.String hitType)

GoogleAnalyticsRequest

public GoogleAnalyticsRequest(java.lang.String hitType,
                      java.lang.String trackingId,
                      java.lang.String appName,
                      java.lang.String appVersion)

Method Detail

setString

protected T setString(GoogleAnalyticsParameter parameter,
          java.lang.String value)

Sets the String value for specified parameter. If value is null, the parameter is removed from the parameters list.

Parameters:

parameter -

value -

Returns:

getString

protected java.lang.String getString(GoogleAnalyticsParameter parameter)

setInteger

protected T setInteger(GoogleAnalyticsParameter parameter,
           java.lang.Integer value)

getDouble

protected java.lang.Double getDouble(GoogleAnalyticsParameter parameter)

setDouble

protected T setDouble(GoogleAnalyticsParameter parameter,
          java.lang.Double value)

getBoolean

protected java.lang.Boolean getBoolean(GoogleAnalyticsParameter parameter)

setBoolean

protected T setBoolean(GoogleAnalyticsParameter parameter,
           java.lang.Boolean value)

getInteger

protected java.lang.Integer getInteger(GoogleAnalyticsParameter parameter)

fromBoolean

protected java.lang.String fromBoolean(java.lang.Boolean booleanString)

toBoolean

protected java.lang.Boolean toBoolean(java.lang.String booleanString)

fromInteger

protected java.lang.String fromInteger(java.lang.Integer intValue)

toInteger

protected java.lang.Integer toInteger(java.lang.String intString)

fromDouble

protected java.lang.String fromDouble(java.lang.Double doubleValue)

toDouble

protected java.lang.Double toDouble(java.lang.String doubleString)

parameter

protected T parameter(GoogleAnalyticsParameter parameter,
          java.lang.String value)

parameter

protected java.lang.String parameter(GoogleAnalyticsParameter parameter)

getParameters

public java.util.Map<GoogleAnalyticsParameter,java.lang.String> getParameters()

customDimension

public java.lang.String customDimension(int index)

customDimension

public T customDimension(int index,
                java.lang.String value)

Optional.

Each custom dimension has an associated index. There is a maximum of 20 custom dimensions (200 for Premium accounts). The name suffix must be a positive integer between 1 and 200, inclusive.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
cd[1-9][0-9]*	text	None	150 Bytes	all

Example value: Sports
Example usage: cd[1-9][0-9]*=Sports

customMetric

public T customMetric(int index,
             java.lang.String value)

Optional.

Each custom metric has an associated index. There is a maximum of 20 custom metrics (200 for Premium accounts). The name suffix must be a positive integer between 1 and 200, inclusive.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
cm[1-9][0-9]*	integer	None	None	all

Example value: 47
Example usage: cm[1-9][0-9]*=47

customMetric

public java.lang.String customMetric(int index)

customDimentions

public java.util.Map<java.lang.String,java.lang.String> customDimentions()

custommMetrics

public java.util.Map<java.lang.String,java.lang.String> custommMetrics()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

protocolVersion

public T protocolVersion(java.lang.String value)

Required for all hit types.

The Protocol version. The current value is '1'. This will only change when there are changes made that are not backwards compatible.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
v	text	None	None	all

Example value: 1
Example usage: v=1

protocolVersion

public java.lang.String protocolVersion()

trackingId

public T trackingId(java.lang.String value)

Required for all hit types.

The tracking ID / web property ID. The format is UA-XXXX-Y. All collected data is associated by this ID.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
tid	text	None	None	all

Example value: UA-XXXX-Y
Example usage: tid=UA-XXXX-Y

trackingId

public java.lang.String trackingId()

anonymizeIp

public T anonymizeIp(java.lang.Boolean value)

Optional.

When present, the IP address of the sender will be anonymized. For example, the IP will be anonymized if any of the following parameters are present in the payload: &aip=, &aip=0, or &aip=1

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
aip	boolean	None	None	all

Example value: 1
Example usage: aip=1

anonymizeIp

public java.lang.Boolean anonymizeIp()

queueTime

public T queueTime(java.lang.Integer value)

Optional.

Used to collect offline / latent hits. The value represents the time delta (in milliseconds) between when the hit being reported occurred and the time the hit was sent. The value must be greater than or equal to 0. Values greater than four hours may lead to hits not being processed.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
qt	integer	None	None	all

Example value: 560
Example usage: qt=560

queueTime

public java.lang.Integer queueTime()

cacheBuster

public T cacheBuster(java.lang.String value)

Optional.

Used to send a random number in GET requests to ensure browsers and proxies don't cache hits. It should be sent as the final parameter of the request since we've seen some 3rd party internet filtering software add additional parameters to HTTP requests incorrectly. This value is not used in reporting.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
z	text	None	None	all

Example value: 289372387623
Example usage: z=289372387623

cacheBuster

public java.lang.String cacheBuster()

clientId

public T clientId(java.lang.String value)

Required for all hit types.

This anonymously identifies a particular user, device, or browser instance. For the web, this is generally stored as a first-party cookie with a two-year expiration. For mobile apps, this is randomly generated for each particular instance of an application install. The value of this field should be a random UUID (version 4) as described in http://www.ietf.org/rfc/rfc4122.txt

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
cid	text	None	None	all

Example value: 35009a79-1a05-49d7-b876-2b884d0f825b
Example usage: cid=35009a79-1a05-49d7-b876-2b884d0f825b

clientId

public java.lang.String clientId()

userId

public T userId(java.lang.String value)

Optional.

This is intended to be a known identifier for a user provided by the site owner/tracking library user. It may not itself be PII. The value should never be persisted in GA cookies or other Analytics provided storage.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
uid	text	None	None	all

Example value: as8eknlll
Example usage: uid=as8eknlll

Parameters:

value -

Returns:

userId

public java.lang.String userId()

sessionControl

public T sessionControl(java.lang.String value)

Optional.

Used to control the session duration. A value of 'start' forces a new session to start with this hit and 'end' forces the current session to end with this hit. All other values are ignored.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
sc	text	None	None	all

Example value: start
Example usage: sc=start

Example value: end
Example usage: sc=end

sessionControl

public java.lang.String sessionControl()

documentReferrer

public T documentReferrer(java.lang.String value)

Optional.

Specifies which referral source brought traffic to a website. This value is also used to compute the traffic source. The format of this value is a URL.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
dr	text	None	2048 Bytes	all

Example value: http://example.com
Example usage: dr=http%3A%2F%2Fexample.com

documentReferrer

public java.lang.String documentReferrer()

campaignName

public T campaignName(java.lang.String value)

Optional.

Specifies the campaign name.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
cn	text	None	100 Bytes	all

Example value: (direct)
Example usage: cn=%28direct%29

campaignName

public java.lang.String campaignName()

campaignSource

public T campaignSource(java.lang.String value)

Optional.

Specifies the campaign source.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
cs	text	None	100 Bytes	all

Example value: (direct)
Example usage: cs=%28direct%29

campaignSource

public java.lang.String campaignSource()

campaignMedium

public T campaignMedium(java.lang.String value)

Optional.

Specifies the campaign medium.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
cm	text	None	50 Bytes	all

Example value: organic
Example usage: cm=organic

campaignMedium

public java.lang.String campaignMedium()

campaignKeyword

public T campaignKeyword(java.lang.String value)

Optional.

Specifies the campaign keyword.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
ck	text	None	500 Bytes	all

Example value: Blue Shoes
Example usage: ck=Blue%20Shoes

campaignKeyword

public java.lang.String campaignKeyword()

campaignContent

public T campaignContent(java.lang.String value)

Optional.

Specifies the campaign content.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
cc	text	None	500 Bytes	all

Example value: content
Example usage: cc=content

campaignContent

public java.lang.String campaignContent()

campaignId

public T campaignId(java.lang.String value)

Optional.

Specifies the campaign ID.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
ci	text	None	100 Bytes	all

Example value: ID
Example usage: ci=ID

campaignId

public java.lang.String campaignId()

adwordsId

public T adwordsId(java.lang.String value)

Optional.

Specifies the Google AdWords Id.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
gclid	text	None	None	all

Example value: CL6Q-OXyqKUCFcgK2goddQuoHg
Example usage: gclid=CL6Q-OXyqKUCFcgK2goddQuoHg

adwordsId

public java.lang.String adwordsId()

displayadId

public T displayadId(java.lang.String value)

Optional.

Specifies the Google Display Ads Id.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
dclid	text	None	None	all

Example value: d_click_id
Example usage: dclid=d_click_id

displayadId

public java.lang.String displayadId()

screenResolution

public T screenResolution(java.lang.String value)

Optional.

Specifies the screen resolution.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
sr	text	None	20 Bytes	all

Example value: 800x600
Example usage: sr=800x600

screenResolution

public java.lang.String screenResolution()

viewportSize

public T viewportSize(java.lang.String value)

Optional.

Specifies the viewable area of the browser / device.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
vp	text	None	20 Bytes	all

Example value: 123x456
Example usage: vp=123x456

viewportSize

public java.lang.String viewportSize()

documentEncoding

public T documentEncoding(java.lang.String value)

Optional.

Specifies the character set used to encode the page / document.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
de	text	UTF-8	20 Bytes	all

Example value: UTF-8
Example usage: de=UTF-8

documentEncoding

public java.lang.String documentEncoding()

screenColors

public T screenColors(java.lang.String value)

Optional.

Specifies the screen color depth.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
sd	text	None	20 Bytes	all

Example value: 24-bits
Example usage: sd=24-bits

screenColors

public java.lang.String screenColors()

userLanguage

public T userLanguage(java.lang.String value)

Optional.

Specifies the language.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
ul	text	None	20 Bytes	all

Example value: en-us
Example usage: ul=en-us

userLanguage

public java.lang.String userLanguage()

javaEnabled

public T javaEnabled(java.lang.Boolean value)

Optional.

Specifies whether Java was enabled.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
je	boolean	None	None	all

Example value: 1
Example usage: je=1

javaEnabled

public java.lang.Boolean javaEnabled()

flashVersion

public T flashVersion(java.lang.String value)

Optional.

Specifies the flash version.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
fl	text	None	20 Bytes	all

Example value: 10 1 r103
Example usage: fl=10%201%20r103

flashVersion

public java.lang.String flashVersion()

hitType

public T hitType(java.lang.String value)

Required for all hit types.

The type of hit. Must be one of 'pageview', 'appview', 'event', 'transaction', 'item', 'social', 'exception', 'timing'.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
t	text	None	None	all

Example value: pageview
Example usage: t=pageview

hitType

public java.lang.String hitType()

nonInteractionHit

public T nonInteractionHit(java.lang.String value)

Optional.

Specifies that a hit be considered non-interactive.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
ni	boolean	None	None	all

Example value: 1
Example usage: ni=1

nonInteractionHit

public java.lang.String nonInteractionHit()

documentUrl

public T documentUrl(java.lang.String value)

Optional.

Use this parameter to send the full URL (document location) of the page on which content resides. You can use the &dh and &dp parameters to override the hostname and path + query portions of the document location, accordingly. The JavaScript clients determine this parameter using the concatenation of the document.location.origin + document.location.pathname + document.location.search browser parameters. Be sure to remove any user authentication or other private information from the URL if present.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
dl	text	None	2048 Bytes	all

Example value: http://foo.com/home?a=b
Example usage: dl=http%3A%2F%2Ffoo.com%2Fhome%3Fa%3Db

documentUrl

public java.lang.String documentUrl()

documentHostName

public T documentHostName(java.lang.String value)

Optional.

Specifies the hostname from which content was hosted.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
dh	text	None	100 Bytes	all

Example value: foo.com
Example usage: dh=foo.com

documentHostName

public java.lang.String documentHostName()

documentPath

public T documentPath(java.lang.String value)

Optional.

The path portion of the page URL. Should begin with '/'.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
dp	text	None	2048 Bytes	all

Example value: /foo
Example usage: dp=%2Ffoo

documentPath

public java.lang.String documentPath()

documentTitle

public T documentTitle(java.lang.String value)

Optional.

The title of the page / document.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
dt	text	None	1500 Bytes	all

Example value: Settings
Example usage: dt=Settings

documentTitle

public java.lang.String documentTitle()

contentDescription

public T contentDescription(java.lang.String value)

Optional.

If not specified, this will default to the unique URL of the page by either using the &dl parameter as-is or assembling it from &dh and &dp. App tracking makes use of this for the 'Screen Name' of the appview hit.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
cd	text	None	2048 Bytes	all

Example value: High Scores
Example usage: cd=High%20Scores

contentDescription

public java.lang.String contentDescription()

applicationName

public T applicationName(java.lang.String value)

Optional.

Specifies the application name. Only visible in app views (profiles).

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
an	text	None	100 Bytes	all

Example value: My App
Example usage: an=My%20App

applicationName

public java.lang.String applicationName()

applicationVersion

public T applicationVersion(java.lang.String value)

Optional.

Specifies the application version. Only visible in app views (profiles).

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
av	text	None	100 Bytes	all

Example value: 1.2
Example usage: av=1.2

applicationVersion

public java.lang.String applicationVersion()

applicationID

public T applicationID(java.lang.String value)

Optional.

Specifies the application ID. Only visible in app views (profiles).

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
aid	text	None	150 Bytes	all

Example value: 1.2
Example usage: aid=1.2

applicationID

public java.lang.String applicationID()

applicationInstallerID

public T applicationInstallerID(java.lang.String value)

Optional.

Specifies the application installer ID. Only visible in app views (profiles).

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
aiid	text	None	150 Bytes	all

Example value: 1.2
Example usage: aiid=1.2

applicationInstallerID

public java.lang.String applicationInstallerID()

expirementId

public T expirementId(java.lang.String value)

Optional.

This parameter specifies that this visitor has been exposed to an experiment with the given ID. It should be sent in conjunction with the Experiment Variant parameter.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
xid	text	None	40 Bytes	all

Example value: Qp0gahJ3RAO3DJ18b0XoUQ
Example usage: xid=Qp0gahJ3RAO3DJ18b0XoUQ

expirementId

public java.lang.String expirementId()

expirementVariant

public T expirementVariant(java.lang.String value)

Optional.

This parameter specifies that this visitor has been exposed to a particular variation of an experiment. It should be sent in conjunction with the Experiment ID parameter.

Parameter	Value Type	Default Value	Max Length	Supported Hit Types
xvar	text	None	None	all

Example value: 1
Example usage: xvar=1

expirementVariant

public java.lang.String expirementVariant()

userIp

public T userIp(java.lang.String value)

IP Override parameter: uip Should be a valid IP address. This will always be anonymized just as though &aip (anonymize IP) had been used. example: &uip=1.2.3.4

userIp

public java.lang.String userIp()

userAgent

public T userAgent(java.lang.String value)

User Agent Override parameter: &ua Should be a User Agent reported by the browser. Note: We have libraries to identify real user agents. Hand crafting your own agent could break at any time. example: &ua=Opera%2F9.80%20(Windows%20NT%206.0)%20Presto%2F2.12.388%20Version%2F12.14

userAgent

public java.lang.String userAgent()

isEmpty

protected boolean isEmpty(java.lang.String string)