Pass as: protocolVersion
or v
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.
Pass as: trackingId
or webPropertyId
or tid
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.
Pass as: anonymizeIp
or aip
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
Pass as: dataSource
or ds
Optional. Indicates the data source of the hit. Hits sent from analytics.js will have data source set to 'web'; hits sent from one of the mobile SDKs will have data source set to 'app'.
Pass as: queueTime
or qt
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.
Pass as: cacheBuster
or z
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.
Pass as: clientId
or cid
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
Pass as: userId
or uid
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.
Pass as: sessionControl
or sc
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.
Pass as: ipOverride
or uip
Optional. The IP address of the user. This should be a valid IP address. It will always be anonymized just as though &aip (anonymize IP) had been used.
Pass as: userAgentOverride
or ua
Optional. The User Agent of the browser. Note that Google has libraries to identify real user agents. Hand crafting your own agent could break at any time.
Pass as: geoid
Optional. The geographical location of the user. The geographical ID should be a two letter country code or a criteria ID representing a city or region (see http://developers.google.com/analytics/devguides/collection/protocol/v1/geoid). This parameter takes precedent over any location derived from IP address, including the IP Override parameter. An invalid code will result in geographical dimensions to be set to '(not set)'.
Pass as: documentReferrer
or dr
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.
Pass as: campaignName
or cn
Optional. Specifies the campaign name.
Pass as: campaignSource
or cs
Optional. Specifies the campaign source.
Pass as: campaignMedium
or cm
Optional. Specifies the campaign medium.
Pass as: campaignKeyword
or ck
Optional. Specifies the campaign keyword.
Pass as: campaignContent
or cc
Optional. Specifies the campaign content.
Pass as: campaignId
or ci
Optional. Specifies the campaign ID.
Pass as: googleAdwordsId
or gclid
Optional. Specifies the Google AdWords Id.
Pass as: googleDisplayAdsId
or dclid
Optional. Specifies the Google Display Ads Id.
Pass as: screenResolution
or sr
Optional. Specifies the screen resolution.
Pass as: viewportSize
or vp
Optional. Specifies the viewable area of the browser / device.
Pass as: documentEncoding
or de
Optional. Specifies the character set used to encode the page / document.
Pass as: screenColors
or sd
Optional. Specifies the screen color depth.
Pass as: userLanguage
or ul
Optional. Specifies the language.
Pass as: javaEnabled
or je
Optional. Specifies whether Java was enabled.
##Flash Version
Pass as: flashVersion
or fl
Optional. Specifies the flash version.
Pass as: hitType
or t
Required for all hit types.The type of hit. Must be one of 'pageview', 'screenview', 'event', 'transaction', 'item', 'social', 'exception', 'timing'.
Pass as: non-interactionHit
or ni
Optional. Specifies that a hit be considered non-interactive.
Pass as: documentLocationUrl
or dl
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.
Pass as: documentHostName
or dh
Optional. Specifies the hostname from which content was hosted.
Pass as: documentPath
or dp
Optional. The path portion of the page URL. Should begin with '/'.
Pass as: documentTitle
or dt
Optional. The title of the page / document.
Pass as: screenName
or cd
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 screenview hit.
Pass as: linkId
or linkid
Optional. The ID of a clicked DOM element, used to disambiguate multiple links to the same URL in In-Page Analytics reports when Enhanced Link Attribution is enabled for the property.
Pass as: applicationName
or an
Optional. Specifies the application name.
Pass as: applicationId
or aid
Optional. Application identifier.
Pass as: applicationVersion
or av
Optional. Specifies the application version.
Pass as: applicationInstallerId
or aiid
Optional. Application installer identifier.
Pass as: eventCategory
or ec
Optional. Specifies the event category. Must not be empty.
##E vent Action
Pass as: eventAction
or ea
Optional.Specifies the event action. Must not be empty.
Pass as: eventLabel
or el
Optional. Specifies the event label.
Pass as: eventValue
or ev
Optional. Specifies the event value. Values must be non-negative.
Pass as: transactionId
or ti
Required for transaction hit type.Required for item hit type.A unique identifier for the transaction. This value should be the same for both the Transaction hit and Items hits associated to the particular transaction.
Pass as: transactionAffiliation
or ta
Optional. Specifies the affiliation or store name.
##Transaction Revenue
Pass as: transactionRevenue
or tr
Optional. Specifies the total revenue associated with the transaction. This value should include any shipping or tax costs.
Pass as: transactionShipping
or ts
Optional. Specifies the total shipping cost of the transaction.
Pass as: transactionTax
or tt
Optional. Specifies the total tax of the transaction.
Pass as: itemName
or in
Required for item hit type.Specifies the item name.
Pass as: itemPrice
or ip
Optional. Specifies the price for a single item / unit.
Pass as: itemQuantity
or iq
Optional. Specifies the number of items purchased.
Pass as: itemCode
or ic
Optional. Specifies the SKU or item code.
Pass as: itemCategory
or iv
Optional. Specifies the category that the item belongs to.
Pass as: currencyCode
or cu
Optional. When present indicates the local currency for all transaction currency values. Value should be a valid ISO 4217 currency code.
Pass as: socialNetwork
or sn
Required for social hit type.Specifies the social network, for example Facebook or Google Plus.
Pass as: socialAction
or sa
Required for social hit type.Specifies the social interaction action. For example on Google Plus when a user clicks the +1 button, the social action is 'plus'.
Pass as: socialActionTarget
or st
Required for social hit type.Specifies the target of a social interaction. This value is typically a URL but can be any text.
Pass as: userTimingCategory
or utc
Optional. Specifies the user timing category.
Pass as: userTimingVariableName
or utv
Optional. Specifies the user timing variable.
Pass as: userTimingTime
or utt
Optional. Specifies the user timing value. The value is in milliseconds.
Pass as: userTimingLabel
or utl
Optional. Specifies the user timing label.
Pass as: pageLoadTime
or plt
Optional. Specifies the time it took for a page to load. The value is in milliseconds.
Pass as: dnsTime
or dns
Optional. Specifies the time it took to do a DNS lookup. The value is in milliseconds.
Pass as: pageDownloadTime
or pdt
Optional. Specifies the time it took for the page to be downloaded. The value is in milliseconds.
Pass as: redirectResponseTime
or rrt
Optional. Specifies the time it took for any redirects to happen. The value is in milliseconds.
Pass as: tcpConnectTime
or tcp
Optional. Specifies the time it took for a TCP connection to be made. The value is in milliseconds.
Pass as: serverResponseTime
or srt
Optional. Specifies the time it took for the server to respond after the connect time. The value is in milliseconds.
Pass as: domInteractiveTime
or dit
Optional. Specifies the time it took for Document.readyState to be 'interactive'. The value is in milliseconds.
Pass as: contentLoadTime
or clt
Optional. Specifies the time it took for the DOMContentLoaded Event to fire. The value is in milliseconds.
Pass as: exceptionDescription
or exd
Optional. Specifies the description of an exception.
Pass as: isExceptionFatal
or exf
Optional. Specifies whether the exception was fatal.
Pass as: cd[1-9][0-9]*
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.
Pass as: cm[1-9][0-9]*
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.
Pass as: cg(10|[0-9])
Optional. Up to 10 content groups are possible.
Pass as: experimentId
or xid
Optional. This parameter specifies that this user has been exposed to an experiment with the given ID. It should be sent in conjunction with the Experiment Variant parameter.
Pass as: experimentVariant
or xvar
Optional. This parameter specifies that this user has been exposed to a particular variation of an experiment. It should be sent in conjunction with the Experiment ID parameter.
To use enhanced e-commerce you must explicitly enable it in Google Analytics admin. Some parameters overlap with regular e-commerce tracking (ti
, ta
, tr
, tt
, ts
),
however item tracking is different.
You may generate enhanced e-commerce using the gampee
module.
Pass as: pr[0-9]{1,3}id
Optional. The SKU of the product. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pr[0-9]{1,3}nm
Optional. The name of the product. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pr[0-9]{1,3}br
Optional. The brand associated with the product. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pr[0-9]{1,3}ca
Optional. The category to which the product belongs. Product index must be a positive integer between 1 and 200, inclusive. The product category parameter can be hierarchical. Use / as a delimiter to specify up to 5-levels of hierarchy. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pr[0-9]{1,3}va
Optional. The variant of the product. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pr[0-9]{1,3}pr
Optional. The price of a product. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pr[0-9]{1,3}qt
Optional. The quantity of a product. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pr[0-9]{1,3}cc
Optional. The coupon code associated with a product. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pr[0-9]{1,3}ps
Optional. The product's position in a list or collection. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pr[0-9]{1,3}cd[0-9]{1,3}
Optional. A product-level custom dimension where dimension index is a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pr[0-9]{1,3}cm[0-9]{1,3}
Optional. A product-level custom metric where metric index is a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pa
Optional. The role of the products included in a hit. If a product action is not specified, all product definitions included with the hit will be ignored. Must be one of: detail, click, add, remove, checkout, checkout_option, purchase, refund. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: ti
Optional. The transaction ID. This is an additional parameter that can be sent when Product Action is set to 'purchase' or 'refund'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: ta
Optional. The store or affiliation from which this transaction occurred. This is an additional parameter that can be sent when Product Action is set to 'purchase' or 'refund'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: tr
Optional. The total value of the transaction, including tax and shipping. If not sent, this value will be automatically calculated using the product quantity and price fields of all products in the same hit. This is an additional parameter that can be sent when Product Action is set to 'purchase' or 'refund'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: tt
Optional. The total tax associated with the transaction. This is an additional parameter that can be sent when Product Action is set to 'purchase' or 'refund'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: ts
Optional. The shipping cost associated with the transaction. This is an additional parameter that can be sent when Product Action is set to 'purchase' or 'refund'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: tcc
Optional. The transaction coupon redeemed with the transaction. This is an additional parameter that can be sent when Product Action is set to 'purchase' or 'refund'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: pal
Optional. The list or collection from which a product action occurred. This is an additional parameter that can be sent when Product Action is set to 'detail' or 'click'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: cos
Optional. The step number in a checkout funnel. This is an additional parameter that can be sent when Product Action is set to 'checkout'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: col
Optional. Additional information about a checkout step. This is an additional parameter that can be sent when Product Action is set to 'checkout'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: il[0-9]{1,3}nm
Optional. The list or collection to which a product belongs. Impression List index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: il[0-9]{1,3}pi[0-9]{1,3}id
Optional. The product ID or SKU. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: il[0-9]{1,3}pi[0-9]{1,3}nm
Optional. The name of the product. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: il[0-9]{1,3}pi[0-9]{1,3}br
Optional. The brand associated with the product. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: il[0-9]{1,3}pi[0-9]{1,3}ca
Optional. The category to which the product belongs. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: il[0-9]{1,3}pi[0-9]{1,3}va
Optional. The variant of the product. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: il[0-9]{1,3}pi[0-9]{1,3}ps
Optional. The product's position in a list or collection. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: il[0-9]{1,3}pi[0-9]{1,3}pr
Optional. The price of a product. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: il[0-9]{1,3}pi[0-9]{1,3}cd[0-9]{1,3}
Optional. A product-level custom dimension where dimension index is a positive integer between 1 and 200, inclusive. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: il[0-9]{1,3}pi[0-9]{1,3}cm[0-9]{1,3}
Optional. A product-level custom metric where metric index is a positive integer between 1 and 200, inclusive. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: promo[0-9]{1,3}id
Optional. The promotion ID. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: promo[0-9]{1,3}nm
Optional. The name of the promotion. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: promo[0-9]{1,3}cr
Optional. The creative associated with the promotion. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: promo[0-9]{1,3}ps
Optional. The position of the creative. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.
Pass as: promoa
Optional. Specifies the role of the promotions included in a hit. If a promotion action is not specified, the default promotion action, 'view', is assumed. To measure a user click on a promotion set this to 'promo_click'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.