Google Analytics API
InfoCaptor uses Google Analytics API and here is the direct reference to the documentation
Dimension and Metrics
Dimension and Metrics go together and there is a list of valid combination that Google provides so be careful when specifying the dimensions or metrics
What is a dimension?
Dimensions are things like browser and country, browser versions, landing and exit pages, the URL of a page, and the source website a visitor has come from.
Google Analytics uses the following 5 main marketing dimensions for analysis:
What is a metric?
Metrics are the quantitative measure of a dimension for specific data types, such as totals of new visitors, page views, unique page views etc.
NOTE: For the php api, you don't need to prefix the dimension or metric with "ga:". All of the below example shows the names without the "ga:"
Some of the combinations from the above API document is reproduced here. Notice how the dimension in the original API documentation has a prefix of "ga:" whereas when you want to use them in InfoCaptor you don't need the prefix. Everything else remains the same (including the case the of dimension and metric name)
Visitor - Dimensions & Metrics Reference
A boolean indicating if a visitor is new or returning. Possible values: New Visitor, Returning Visitor.
The visit index for a visitor to your website. Each visit from a unique visitor will get its own incremental index starting from 1 for the first visit. Subsequent visits do not change previous visit indicies. For example, if a certain visitor has 4 visits to your website, visitCount for that visitor will have 4 distinct values of '1' through '4'.
The number of days elapsed since visitors last visited your website. Used to calculate visitor loyalty.
The value provided when you define custom visitor segments for your website.
Total number of visitors to your website for the requested time period.
The number of visitors whose visit to your website was marked as a first-time visit.
The percentage of visits by people who had never visited your site before.
(ga:newVisits / ga:visits) * 100
AdWords - Dimensions & Metrics Reference
The name of your AdWords ad group.
The location of the advertisement on the hosting page (Top, RHS, or not set).
The ad slot positions in which your AdWords ads appeared (1-8).
The networks used to deliver your ads (Content, Search, Search partners, etc.).
The match types applied to your keywords (Phrase, Exact, Broad, etc.). Ads on the content network are identified as "Content network".
The search queries that triggered impressions of your AdWords ads.
The domains where your ads on the content network were placed.
The URLs where your ads on the content network were placed.
Your AdWords ad formats (Text, Image, Flash, Video, etc.).
How your AdWords ads were targeted (keyword, placement, and vertical targeting, etc.).
How you manage your ads on the content network. Values are Automatic placements or Managed placements.
The URLs your AdWords ads displayed.
The URLs to which your AdWords ads referred traffic.
A string. Corresponds to AdWords API AccountInfo.customerId.
A string. Corresponds to AdWords API Campaign.id.
A string. Corresponds to AdWords API AdGroup.id.
A string. Corresponds to AdWords API Ad.id.
A string. Corresponds to AdWords API Criterion.id.
Total number of campaign impressions.
The total number of times users have clicked on an ad to reach your website.
Derived cost for the advertising campaign. The currency for this value is based on the currency that you set in your AdWords account.
Cost per thousand impressions.
Cost to advertiser per click.
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).
The cost per transaction for your site.
adCost / transactions
The cost per goal conversion for your site.
adCost / goalCompletionsAll
The cost per conversion (including ecommerce and goal conversions) for your site.
adCost / (transactions + goalCompletionsAll)
RPC or revenue-per-click is the average revenue (from ecommerce sales and/or goal value) you received for each click on one of your search ads.
(transactionRevenue + goalValueAll) / adClicks
Returns on Investment is overall transaction profit divided by derived advertising cost.
(transactionRevenue + goalValueAll - adCost) / adCost
The overall transaction profit margin.
(transactionRevenue + goalValueAll - adCost) / (transactionRevenue + goalValueAll)
Event Tracking - Dimensions & Metrics Reference
The category of the event.
The action of the event.
The label of the event.
The total number of events for the profile, across all categories.
The total number of unique events for the profile, across all categories.
The total value of events for the profile.
The total number of visits with events.
The average value of an event.
eventValue / totalEvents
The average number of events per visit with event.
totalEvents / visitsWithEvent