Lors de l’utilisation de l’API de Google Analytics, vous allez régulièrement avoir besoin de la liste des Dimensions & Metrics.
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 usewww.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 viagooglestore.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:isMobile | Indicates mobile visitors. The possible values are Yes or No where the first letter must be capitalized. | |
ga:javaEnabled | Indicates Java support for visitors’ browsers. The possible values are Yes or No where the first letter must be capitalized. | |
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 orPPC 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: 1024×738. | |
ga:subContinent | The sub-continent of website visitors, derived from IP addresses. For example, Polynesiaor 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:nextPagePath | A page on your website that was visited after another page on your website. | |
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:previousPagePath | A page on your website that was visited before another page on your website. | |
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. 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. | |
| 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. AdWords | Note: Each ID corresponds to the following AdWords API class member. | |
ga:adwordsAdGroupId | A string. Corresponds to AdWords API AdGroup.id. | |
ga:adwordsCampaignId | A string. Corresponds to AdWords API Campaign.id. | |
ga:adwordsCreativeId | A string. Corresponds to AdWords API Ad.id. | |
ga:adwordsCriteriaId | A string. Corresponds to AdWords API Criterion.id. | |
ga:adwordsCustomerId | A string. Corresponds to AdWords API AccountInfo.customerId. |
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. |