AdWords
Last updated
Last updated
Name
Type
Dimension
DefaultMetric
DefaultDimension
Description
Date
Date
True
The date of the session formatted as YYYYMMDD.
Year
Integer
True
The year of the session. A four-digit year from 2005 to the current year.
Month
Integer
True
The month of the session. An integer from 01 to 12.
Week
Integer
True
The week of the session. A number from 01 to 53. Each week starts on Sunday.
Day
Integer
True
The day of the month. A number from 01 to 31.
Hour
Integer
True
An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time.
Language
String
True
The language provided by the HTTP Request for the browser. Values are given as an ISO-639 code.
Country
String
True
The country of users, derived from IP addresses.
City
String
True
The cities of property users, derived from IP addresses.
Browser
String
True
The names of browsers used by users to your website. For example, Internet Explorer or Firefox.
OperatingSystem
String
True
The operating system used by your users. For example, Windows, Linux , Macintosh, iPhone, iPod.
DeviceCategory
String
True
The type of device: desktop, tablet, or mobile.
Campaign
String
True
True
When using manual campaign tracking, this value is the value of the utm_campaign campaign tracking parameter. When using AdWords autotagging, this value is the name(s) of the online ad campaign that you use for your property. Otherwise, this value is: not set.
AdGroup
String
True
The name of your AdWords ad group.
Keyword
String
True
When using manual campaign tracking, this value is the value of the utm_term campaign tracking parameter; i.e., the keywords used by users to reach your property when using AdWords autotagging or if a user used organic search to reach your property. Otherwise this value is: not set.
Sessions
Integer
False
True
Counts the total number of sessions.
Impressions
Integer
False
True
Total number of campaign impressions.
AdClicks
Integer
False
True
The total number of times users have clicked on an ad to reach your property.
AdCost
Decimal
False
True
Derived cost for the advertising campaign. The currency for this value is based on the currency that you set in your AdWords account.
CTR
Double
False
True
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).
CPC
Decimal
False
True
Cost to advertiser per click.
RPC
Decimal
False
True
RPC, or revenue-per-click, is the average revenue from e-commerce sales and/or goal value you received for each click on one of your search ads.
ROI
Decimal
False
True
Returns on Investment is overall transaction profit divided by derived advertising cost.
Margin
Decimal
False
True
The overall transaction profit margin.
PercentNewSessions
Double
False
The percentage of sessions by people who had never visited your property before.
NewUsers
Integer
False
The number of users whose visit to your property was marked as a first-time session.
BounceRate
Double
False
The percentage of single-page session.
PageviewsPerSession
Double
False
The average number of pages viewed during a session on your property.
AvgSessionDuration
Double
False
The average duration of user sessions represented in total seconds.
GoalConversionRateAll
Double
False
The percentage of sessions that resulted in a conversion to at least one of your goals.
Transactions
Integer
False
The total number of transactions.
RevenuePerTransaction
Decimal
False
The average revenue for an e-commerce transaction.
TransactionRevenue
Decimal
False
The total sale revenue provided in the transaction, excluding shipping and tax.
TransactionRevenuePerSession
Decimal
False
Average transaction revenue for a session on your property.
StartDate
String
Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).
EndDate
String
End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).
Dimensions
String
A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions.
Metrics
String
A comma-separated list of metrics to retrieve in addition to the columns defined in the schema.
CohortTypes
String
Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE
CohortStartDates
Date
Available only when using the V4 API. A comma-separated list of cohort start dates.
CohortEndDates
Date
Available only when using the V4 API. A comma-separated list of cohort end dates.
SamplesReadCounts
String
Comma separated list of samples read counts when the response data is sampled.
SamplingSpaceSizes
String
Comma separated list of samples space sizes counts when the response data is sampled.
Name
Type
Description
Segments
String
Segments the data returned for your request. Either a SegmentId or a custom segment.
Profile
String
The Profile ID or website URL to retrieve data from.