AccountCurrencyCode
|
The currency of the Customer account.
Type | String |
Display Name | Currency |
XML Attribute | currency |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
AccountDescriptiveName
|
The descriptive name of the Customer account.
Type | String |
Display Name | Account |
XML Attribute | account |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
AccountTimeZone
|
Name of the timezone selected for the Customer account. For example: "(GMT-05:00) Eastern Time". This field does not reflect the current state of daylight saving time for the timezone.
Type | String |
Display Name | Time zone |
XML Attribute | timeZone |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
AdGroupId
|
The ID of the AdGroup.
Type | Long |
Display Name | Ad group ID |
XML Attribute | adGroupID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
AdGroupName
|
The name of the AdGroup.
Type | String |
Display Name | Ad group |
XML Attribute | adGroup |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
AdGroupStatus
|
Status of the ad group.
Type | AdGroupStatus |
Display Name | Ad group state |
XML Attribute | adGroupState |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
UNKNOWN | unknown |
ENABLED | enabled |
PAUSED | paused |
REMOVED | removed |
|
AverageCpc
|
The total cost of all clicks divided by the total number of clicks received.
Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.
Type | Money |
Display Name | Ad Avg. CPC |
XML Attribute | adAvgCPC |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
AveragePosition
|
Your ad's position relative to those of other advertisers.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Ad Avg. position |
XML Attribute | adAvgPosition |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
CampaignId
|
The ID of the Campaign.
Type | Long |
Display Name | Campaign ID |
XML Attribute | campaignID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
CampaignName
|
The name of the Campaign.
Type | String |
Display Name | Campaign |
XML Attribute | campaign |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
CampaignStatus
|
The status of the Campaign.
Type | CampaignStatus |
Display Name | Campaign state |
XML Attribute | campaignState |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
UNKNOWN | unknown |
ENABLED | enabled |
PAUSED | paused |
REMOVED | removed |
|
Clicks
|
The number of clicks.
Type | Long |
Display Name | Ad Clicks |
XML Attribute | adClicks |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
CombinedAdsOrganicClicks
|
Clicks from ads or organic search results.
Type | Long |
Display Name | Combined Clicks |
XML Attribute | combinedClicks |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
CombinedAdsOrganicClicksPerQuery
|
CombinedAdsOrganicClicks divided by CombinedAdsOrganicQueries. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Combined Clicks/Query |
XML Attribute | combinedClicksQuery |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
CombinedAdsOrganicQueries
|
Total number of searches that returned pages from your site in the organic search results or triggered one of your ads.
Type | Long |
Display Name | Combined Queries |
XML Attribute | combinedQueries |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
Ctr
|
The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Ad CTR |
XML Attribute | adCTR |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
CustomerDescriptiveName
|
The descriptive name of the Customer.
Type | String |
Display Name | Client name |
XML Attribute | clientName |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
Date
|
The date formatted as yyyy-MM-dd.
Type | Date |
Display Name | Day |
XML Attribute | day |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
|
DayOfWeek
|
The name of the day of the week, e.g., "Monday".
Type | DayOfWeek |
Display Name | Day of week |
XML Attribute | dayOfWeek |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
MONDAY | Monday |
TUESDAY | Tuesday |
WEDNESDAY | Wednesday |
THURSDAY | Thursday |
FRIDAY | Friday |
SATURDAY | Saturday |
SUNDAY | Sunday |
|
ExternalCustomerId
|
The Customer ID.
Type | Long |
Display Name | Customer ID |
XML Attribute | customerID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
Impressions
|
Count of how often your ad has appeared on a search results page or website on the Google Network.
Type | Long |
Display Name | Ad Impressions |
XML Attribute | adImpressions |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
KeywordId
|
The ID of the Keyword that triggered the ad.
Type | long |
Display Name | Keyword ID |
XML Attribute | keywordID |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | False |
|
KeywordTextMatchingQuery
|
Keyword that matched the query and triggered the ad.
Type | String |
Display Name | Keyword |
XML Attribute | keyword |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
Month
|
The first day of the month, formatted as yyyy-MM-dd.
Type | String |
Display Name | Month |
XML Attribute | month |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
|
MonthOfYear
|
The name of the month of the year, e.g., "December".
Type | MonthOfYear |
Display Name | Month of Year |
XML Attribute | monthOfYear |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
JANUARY | January |
FEBRUARY | February |
MARCH | March |
APRIL | April |
MAY | May |
JUNE | June |
JULY | July |
AUGUST | August |
SEPTEMBER | September |
OCTOBER | October |
NOVEMBER | November |
DECEMBER | December |
|
OrganicAveragePosition
|
Average top position of your organic listing (or multiple listings) for each query. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Organic Average Position |
XML Attribute | organicAveragePosition |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
OrganicClicks
|
Number of times someone clicked your site's listing in the unpaid results for a particular query.
Type | Long |
Display Name | Organic Clicks |
XML Attribute | organicClicks |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
OrganicClicksPerQuery
|
Number of clicks you've received on your organic search listings divided by the total number of searches that returned pages from your site. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Organic Clicks/Query |
XML Attribute | organicClicksQuery |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
OrganicImpressions
|
Number of organic search listing impressions.
Type | Long |
Display Name | Organic Listings |
XML Attribute | organicListings |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
OrganicImpressionsPerQuery
|
Average number of times a page from your site was listed per query. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Organic Listings/Query |
XML Attribute | organicListingsQuery |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
OrganicQueries
|
Total number of searches that returned organic search results for your site over the given period.
Type | Long |
Display Name | Organic Queries |
XML Attribute | organicQueries |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | False |
|
Quarter
|
The first day of the quarter, formatted as yyyy-MM-dd. Uses the calendar year for quarters, e.g., the second quarter of 2014 starts on 2014-04-01.
Type | String |
Display Name | Quarter |
XML Attribute | quarter |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
|
QueryMatchType
|
Match type of the keyword that triggered the ad.
Type | QueryMatchType |
Display Name | Match type |
XML Attribute | matchType |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
AUTO | auto |
BROAD | broad |
EXACT | exact |
EXPANDED | broad |
PHRASE | phrase |
|
SearchQuery
|
Query that led to the impression.
Type | String |
Display Name | Query |
XML Attribute | query |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
|
SerpType
|
The type of search result.
Type | SerpType |
Display Name | Search Result Type |
XML Attribute | searchResultType |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
UNKNOWN | unknown |
ADS_ONLY | Ad shown only |
ORGANIC_ONLY | Organic shown only |
ADS_AND_ORGANIC | Both shown |
|
Week
|
The date for the Monday of the week, formatted as yyyy-MM-dd.
Type | String |
Display Name | Week |
XML Attribute | week |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
|
Year
|
The year, formatted as yyyy.
Type | Integer |
Display Name | Year |
XML Attribute | year |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
|