My favorites ▼ | English ▼ | Sign in

Google Analytics (Labs)

Dimensions & Metrics Reference

Contents

This document lists and describes all the metrics and dimensions that available to the Data Export API. To learn more about which combinations of requests are valid, see Valid Combinations.

In addition, calculated metrics are not available in the Data Export API, so you can refer to Common Calculations for details on how to define calculated metrics such as bounce rate.

  1. Dimensions
    1. D1. Visitor
      1. ga:browser
      2. ga:browserVersion
      3. ga:city
      4. ga:connectionSpeed
      5. ga:continent
      6. ga:countOfVisits (deprecated)
      7. ga:country
      8. ga:date
      9. ga:day
      10. ga:daysSinceLastVisit
      11. ga:flashVersion
      12. ga:hostname
      13. ga:hour
      14. ga:javaEnabled
      15. ga:language
      16. ga:latitude
      17. ga:longitude
      18. ga:month
      19. ga:networkDomain
      20. ga:networkLocation
      21. ga:operatingSystem
      22. ga:operatingSystemVersion
      23. ga:pageDepth
      24. ga:region
      25. ga:screenColors
      26. ga:screenResolution
      27. ga:subContinent
      28. ga:userDefinedValue
      29. ga:visitCount
      30. ga:visitLength
      31. ga:visitorType
      32. ga:week
      33. ga:year
    2. D2. Campaign
      1. ga:adContent
      2. ga:adGroup
      3. ga:adSlot
      4. ga:adSlotPosition
      5. ga:campaign
      6. ga:keyword
      7. ga:medium
      8. ga:referralPath
      9. ga:source
    3. D3. Content
      1. ga:exitPagePath
      2. ga:landingPagePath
      3. ga:pagePath
      4. ga:pageTitle
      5. ga:secondPagePath
    4. D4. Ecommerce
      1. ga:affiliation
      2. ga:daysToTransaction
      3. ga:productCategory
      4. ga:productName
      5. ga:productSku
      6. ga:transactionId
      7. ga:visitsToTransaction
    5. D5. Internal Search
      1. ga:searchCategory
      2. ga:searchDestinationPage
      3. ga:searchKeyword
      4. ga:searchKeywordRefinement
      5. ga:searchStartPage
      6. ga:searchUsed
    6. D6. Navigation
      1. ga:nextPagePath
      2. ga:previousPagePath
    7. D7. Events
      1. ga:eventCategory
      2. ga:eventAction
      3. ga:eventLabel
    8. D8. Custom Variables
      1. ga:customVarName(n)
      2. ga:customVarValue(n)
  1. Metrics
    1. M1. Visitor
      1. ga:bounces
      2. ga:entrances
      3. ga:exits
      4. ga:newVisits
      5. ga:pageviews
      6. ga:timeOnPage
      7. ga:timeOnSite
      8. ga:visitors
      9. ga:visits
    2. M2. Campaign
      1. ga:adCost
      2. ga:adClicks
      3. ga:CPC
      4. ga:CPM
      5. ga:CTR
      6. ga:impressions
    3. M3. Content
      1. ga:uniquePageviews
    4. M4. Ecommerce
      1. ga:itemQuantity
      2. ga:itemRevenue
      3. ga:transactions
      4. ga:transactionRevenue
      5. ga:transactionShipping
      6. ga:transactionTax
      7. ga:uniquePurchases
    5. M5. Internal Search
      1. ga:searchDepth
      2. ga:searchDuration
      3. ga:searchExits
      4. ga:searchRefinements
      5. ga:searchUniques
      6. ga:searchVisits
    6. M6. Goals
      1. ga:goal(n)Completions
      2. ga:goalCompletionsAll
      3. ga:goal(n)Starts
      4. ga:goalStartsAll
      5. ga:goal(n)Value
      6. ga:goalValueAll
    7. M7. Events
      1. ga:totalEvents
      2. ga:uniqueEvents
      3. ga:eventValue

Dimensions

The following table lists the available dimension fields.

Dimension Category Dimension Name Description
D1. Visitor
ga:browser The names of browsers used by visitors to your website. For example, "Internet Explorer" or "Firefox."
ga:browserVersion The browser versions used by visitors to your website. For example, 2.0.0.14
ga:city The cities of website visitors, derived from IP addresses. The city field falls in a hierarchy of geographical groupings used in Analytics, which proceeds in the following order: continent, sub-continent, country, region, sub-region, and city.
ga:connectionSpeed The qualitative network connection speeds of website visitors. For example, T1, DSL, Cable, Dialup.
ga:continent The continents of website visitors, derived from IP addresses.
ga:countOfVisits (deprecated) See ga:visitCount. Number of visits to your website. This is calculated by determining the number of visitor sessions.
ga:country The countries of website visitors, derived from IP addresses.
ga:date The date of the visit. An integer in the form YYYYMMDD.
ga:day The day of the month from 01 to 31.
ga:daysSinceLastVisit The number of days elapsed since visitors last visited your website. Used to calculate visitor loyalty.
ga:flashVersion The versions of Flash supported by visitors' browsers, including minor versions.
ga:hostname The hostnames visitors used to reach your website. In other words, if some visitors use www.googlestore.com to reach your website, this string appears as one of the hostnames used to reach your website. However, if other visitors also come to your website via googlestore.com or via an IP redirect from a search engine result (66.102.9.104), those values will also be present in this field.
ga:hour A two-digit hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time, adhering to all local rules for daylight savings time. If your timezone follows daylight savings time, there will be an apparent bump in the number of visits during the change-over hour (e.g. between 1:00 and 2:00) for the day per year when that hour repeats. A corresponding hour with zero visits will occur at the opposite changeover. (Google Analytics does not track visitor time more precisely than hours.)
ga:javaEnabled Indicates Java support for visitors' browsers. The possible values are Yes or No.
ga:language The language provided by the HTTP Request for the browser. Values are given as an ISO-639 code (e.g. en-gb for British English).
ga:latitude The approximate latitude of the visitor's city. Locations north of the equator are represented by positive values and locations south of the equator by negative values.
ga:longitude The approximate longitude of the visitor's city. Locations east of the meridian are represented by positive values and locations west of the meridian by negative values.
ga:month The month of the visit. A two digit integer from 01 to 12.
ga:networkDomain The domain name of the ISPs used by visitors to your website.
ga:networkLocation The name of service providers used to reach your website. For example, if most visitors to your website come via the major service providers for cable internet, you will see the names of those cable service providers in this element.
ga:operatingSystem The operating system used by your visitors. For example, Windows, Linux, Macintosh, iPhone, iPod.
ga:operatingSystemVersion The version of the operating system used by your visitors, such as XP for Windows or PPC for Macintosh.
ga:pageDepth The number of pages visited by visitors during a session (visit). The value is a histogram that counts pageviews across a range of possible values. In this calculation, all visits will have at least one pageview, and some percentage of visits will have more.
ga:region The region of website visitors, derived from IP addresses. In the U.S., a region is a state, such as New York.
ga:screenColors The color depth of visitors' monitors, as retrieved from the DOM of the visitor's browser. For example 4-bit, 8-bit, 24-bit, or undefined-bit.
ga:screenResolution The screen resolution of visitors' monitors, as retrieved from the DOM of the visitor's browser. For example: 1024x738.
ga:subContinent The sub-continent of website visitors, derived from IP addresses. For example, Polynesia or Northern Europe.
ga:userDefinedValue The value provided when you define custom visitor segments for your website. For more information, see Creating Custom Visitor Segments.
ga:visitCount Number of visits to your website. This is calculated by determining the number of visitor sessions.
ga:visitLength The length of a visit to your website measured in seconds and reported in second increments. The value returned is a String. To replicate the length of visit report in the user interface, after requesting the data, you can convert the string value to a number and sum up the visits for a group of visit durations.
ga:visitorType A boolean indicating if visitors are new or returning. Possible values: New Visitor, Returning Visitor.
ga:week The week of the visit. A two-digit number from 01 to 52.
ga:year The year of the visit. A four-digit year from 2005 to the current year.
 D2. Campaign
ga:adContent The first line of the text for your online Ad campaign. If you are using mad libs for your AdWords content, this field displays the keywords you provided for the mad libs keyword match.
ga:adGroup The ad groups that you have identified for your campaign keywords.
ga:adSlot The position of the advertisement as it appears on the host page. For example, the online advertising position might be side or top.
ga:adSlotPosition The order of the online advertisement as it appears along with other ads in the position on the page. For example, the ad might appear on the right side of the page and be the 3rd ad from the top.
ga:campaign The name(s) of the online ad campaign that you use for your website.
ga:keyword The keywords used by visitors to reach your website, via both paid ads and through search engine results.
ga:medium The type of referral to your website. For example, when referring sources to your website are search engines, there are a number of possible mediums that can be used from a search engine referral: from a search result (organic) and from an online ad on the search results page (CPC, ppc, cpa, CPM, cpv, cpp).
ga:referralPath The path of the referring URL. If someone places a link to your website on their website, this element contains the path of the page that contains the referring link.
ga:source The domain (e.g. google.com) of the source referring the visitor to your website. The value for this dimension sometimes contains a port address as well.
D3. Content
ga:exitPagePath The last page of the session (or "exit" page) for your visitors.
ga:landingPagePath The path component of the first page in a user's session, or "landing" page.
ga:pagePath A page on your website specified by path and/or query parameters.
ga:pageTitle The title for a page, as specified in the <title></title> element of the HTML document.
ga:secondPagePath The path component of the second page in a user's session.
D4. Ecommerce
ga:affiliation Typically used to designate a supplying company or brick and mortar location; product affiliation.
ga:daysToTransaction The number of days between users' purchases and the related campaigns that lead to the purchases.
ga:productCategory Any product variations (size, color) for purchased items as supplied by your ecommerce application.
ga:productName The product name for purchased items as supplied by your ecommerce tracking method.
ga:productSku The product codes for purchased items as you have defined them in your ecommerce tracking application.
ga:transactionId The transaction ID for the shopping cart purchase as supplied by your ecommerce tracking method.
ga:visitsToTransaction The number of visits between users' purchases and the related campaigns that lead to the purchases.
D5. Internal Search
ga:searchCategory The categories used for the internal search if you have this enabled for your profile. For example, you might have product categories such as electronics, furniture, or clothing.
ga:searchDestinationPage A page that the user visited after performing an internal website search.
ga:searchKeyword Search terms used by website visitors on your internal site search.
ga:searchKeywordRefinement Subsequent keyword search terms or strings entered by users after a given initial string search.
ga:searchStartPage A page where the user initiated an internal site search.
ga:searchUsed A boolean that separates visitor activity depending upon whether internal search activity occured or did not occur. Values are Visits With Site Search and Visits Without Site Search.
D6. Navigation
ga:nextPagePath A page on your website that was visited after another page on your website.
ga:previousPagePath A page on your website that was visited before another page on your website.
D7. Events
ga:eventCategory A string. The category of the event.
ga:eventAction A string. The action of the event.
ga:eventLabel A string. The label of the event.
D8. Custom Variables Note: There are 5 custom variables available in the API. You can request a custom variable value by using its corresponding number (from 1- 5). For example, to get the value for the custom variable set to 2, use ga:customVarValue2. To view the scope for a custom variable, see the Account Feed Response information.
ga:customVarName(n) A string. The name for the requested custom variable.
ga:customVarValue(n) A string. The value for the requested custom variable number.
Back to Top

Metrics

Metric Category Metric Name Description
M1. Visitor
ga:bounces The total number of single-page visits to your website.
ga:entrances The number of entrances to your website. The value will always be equal to the number of visits when aggregated over your entire website. Thus, this metric is most useful when combined with dimensions such as ga:landingPagePath, at which point entrances as a metric indicates the number of times a particular page served as an entrance to your website.
ga:exits The number of exits from your website. As with entrances, it will always be equal to the number of visits when aggregated over your entire website.
ga:newVisits The number of visitors whose visit to your website was marked as a first-time visit.
ga:pageviews The total number of pageviews for your website when aggregated over the selected dimension. For example, if you select this metric together with ga:pagePath, it returns the number of page views for each page.
ga:timeOnPage How long a visitor spent on a particular page or set of pages. Calculated by subtracting the initial view time for a particular page from the initial view time for a subsequent page. Thus, this metric does not apply to exit pages for your website. The value from this metric is returned in the XML as a string, with the value represented in total seconds. Different client libraries have various ways of representing this value, such as a double, float, long, or string.
ga:timeOnSite The total duration of visitor sessions over the selected dimension. For example, suppose you combine this field with a particular ad campaign. In this case, the metric will display the total duration of all visitor sessions for those visitors who came to your website via a particular ad campaign. The value from this metric is returned in the XML as a string, with the value represented in total seconds. Different client libraries have various ways of representing this value, such as a double, float, long, or string.
ga:visitors Total number of visitors to your website for the requested time period.
ga:visits The total number of visits over the selected dimension. A visit consists of a single-user session.
M2. Campaign
ga:adClicks The total number of times users have clicked on an ad to reach your website.
ga:adCost Derived cost for the advertising campaign. The currency for this value is based on the currency that you set in your AdWords account.
ga:CPC Cost to advertiser per click.
ga:CPM Cost per thousand impressions.
ga:CTR Click-through-rate for your ad. This is equal to the number of clicks divided by the number of impressions for your ad (e.g. how many times users clicked on one of your ads where that ad appeared).
ga:impressions Total number of campaign impressions.
M3. Content
ga:uniquePageviews The number of different (unique) pages within a visit, summed up across all visits
M4. Ecommerce Note: The currency value for all revenue-based metrics adhere to the guidelines described in the Ecommerce Guidelines for the ga.js API.
ga:itemRevenue Total revenue from purchased product items on your website. See the tracking API reference for _addItem() for additional information.
ga:itemQuantity The total number of items purchased. For example, if users purchase 2 frisbees and 5 tennis balls, 7 items have been purchased.
ga:transactions The total number of transactions.
ga:transactionRevenue The total sale revenue, including shipping and tax, if provided in the transation. See the documentation for _addTrans() in the tracking API reference for additional information.
ga:transactionShipping The total cost of shipping.
ga:transactionTax The total amount of tax.
ga:uniquePurchases The number of product sets purchased. For example, if users purchase 2 frisbees and 5 tennis balls from your site, 2 product sets have been purchased.
M5. Internal Search
ga:searchDepth The average number of subsequent page views made on your site after a use of your internal search feature.
ga:searchDuration The visit duration to your site where a use of your internal search feature occurred.
ga:searchExits The number of exits on your site that occurred following a search result from your internal search feature.
ga:searchRefinements The number of refinements made on an internal search.
ga:searchUniques The number of visits to your site who used your internal search feature.
ga:searchVisits The total number of visits to your site where a use of your internal search feature occurred.
M6. Goals Note: There are 20 goals available in the API. You can request a goal value by using its corresponding number (from 1-20). For example, if you want the number of goal starts for goal 13, you would use ga:goal13Starts.
ga:goal(n)Completions The total number of completions for the requested goal number.
ga:goalCompletionsAll The total number of completions for all goals defined for your profile.
ga:goal(n)Starts The total number of starts for the requested goal number.
ga:goalStartsAll The total number of starts for all goals defined for your profile.
ga:goal(n)Value The total numeric value for the requested goal number.
ga:goalValueAll The total numeric value for all goals defined for your profile.
M7. Events
ga:totalEvents The total number of events for the profile, across all categories.
ga:uniqueEvents The total number of unique events for the profile, across all categories.
ga:eventValue The total value of events for the profile.
Back to Top