AccountCurrencyCode
|
The currency of the Customer account.
| Type | String |
| Display Name | Currency |
| XML Attribute | currency |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
|
AccountDescriptiveName
|
The descriptive name of the Customer account.
| Type | String |
| Display Name | Account |
| XML Attribute | account |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
|
AccountTimeZoneId
|
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 | True |
|
ActiveViewCpm
|
Average cost of viewable impressions (ActiveViewImpressions).
| Type | Money |
| Display Name | Active View avg. CPM |
| XML Attribute | activeViewAvgCPM |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
ActiveViewImpressions
|
How often your ad has become viewable on a Display Network site.
| Type | Long |
| Display Name | Active View viewable impressions |
| XML Attribute | activeViewViewableImpressions |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
AdGroupId
|
The ID of the AdGroup.
| Type | Long |
| Display Name | Ad group ID |
| XML Attribute | adGroupID |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
|
AdGroupName
|
The name of the AdGroup.
| Type | String |
| Display Name | Ad group |
| XML Attribute | adGroup |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
|
AdGroupStatus
|
Status of the ad group.
| Type | AdGroupStatus |
| Display Name | Ad group state |
| XML Attribute | adGroupState |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | unknown |
ENABLED | enabled |
PAUSED | paused |
REMOVED | removed |
|
AdNetworkType1
|
First level network type.
| Type | AdNetworkType1 |
| Display Name | Network |
| XML Attribute | network |
| Behavior | Segment |
| Filterable | True |
| Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | unknown |
SEARCH | Search Network |
CONTENT | Display Network |
|
AdNetworkType2
|
Second level network type (includes search partners).
| Type | AdNetworkType2 |
| Display Name | Network (with search partners) |
| XML Attribute | networkWithSearchPartners |
| Behavior | Segment |
| Filterable | True |
| Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | unknown |
SEARCH | Google search |
SEARCH_PARTNERS | Search partners |
CONTENT | Display Network |
|
AverageCpc
|
The total cost of all clicks divided by the total number of clicks received.
| Type | Money |
| Display Name | Avg. CPC |
| XML Attribute | avgCPC |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
AverageCpm
|
Average Cost-per-thousand impressions (CPM).
| Type | Money |
| Display Name | Avg. CPM |
| XML Attribute | avgCPM |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
AveragePosition
|
Your ad's position relative to those of other advertisers.
| Type | Double |
| Display Name | Avg. position |
| XML Attribute | avgPosition |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
CampaignId
|
The ID of the Campaign.
| Type | Long |
| Display Name | Campaign ID |
| XML Attribute | campaignID |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
|
CampaignName
|
The name of the Campaign.
| Type | String |
| Display Name | Campaign |
| XML Attribute | campaign |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
|
CampaignStatus
|
The status of the Campaign.
| Type | CampaignStatus |
| Display Name | Campaign state |
| XML Attribute | campaignState |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | unknown |
ENABLED | enabled |
PAUSED | paused |
REMOVED | removed |
|
ClickConversionRate
|
The number of converted clicks divided by your total clicks that can be tracked to a conversion. This is how often a click on your ad resulted in a conversion. Percentage returned as "x.xx%".
| Type | Double |
| Display Name | Click conversion rate |
| XML Attribute | clickConversionRate |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
|
Clicks
|
The number of clicks.
| Type | Long |
| Display Name | Clicks |
| XML Attribute | clicks |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
ClickType
|
The Impressions field will reflect how often the ad was served with that click type available. Since ads can serve with multiple click types displayed, impressions may be double counted and the totals may not be accurate.
| Type | ClickType |
| Display Name | Click type |
| XML Attribute | clickType |
| Behavior | Segment |
| Filterable | True |
| Supports Zero Impressions | False |
Predicate values / display values
URL_CLICKS | Headline |
CALLS | Phone calls |
OTHER | Other |
PRODUCT_EXTENSION_CLICKS | Product plusbox offer |
SITELINKS | Sitelink |
PRODUCT_LISTING_AD_CLICKS | Product listing ad |
GET_DIRECTIONS | Driving direction |
OFFER_PRINTS | Print offer |
BREADCRUMBS | Breadcrumbs |
CALL_TRACKING | Manually dialed phone calls |
MOBILE_CALL_TRACKING | Mobile phone calls |
LOCATION_EXPANSION | Get location details |
UNKNOWN | unknown |
|
ConversionCategoryName
|
Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. Values: "Other", "View of a key page", "Purchase/Sale", "Signup", "Lead"
| Type | String |
| Display Name | Conversion category |
| XML Attribute | conversionCategory |
| Behavior | Segment |
| Filterable | True |
| Supports Zero Impressions | False |
Not compatible with the following fields:
ActiveViewCpm
ActiveViewImpressions
AverageCpc
AverageCpm
AveragePosition
Clicks
Cost
Ctr
GmailForwards
GmailSaves
GmailSecondaryClicks
Impressions
|
ConversionRateManyPerClick
|
The number of conversions divided by total clicks that can be tracked to conversions. Percentage returned as "x.xx%".
| Type | Double |
| Display Name | Conv. rate |
| XML Attribute | convRate |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
|
ConversionsManyPerClick
|
This column reports total conversions, across all the conversion actions you're tracking. How you've chosen to count your conversions (unique or all) affects the number shown in this column.
| Type | Long |
| Display Name | Conversions |
| XML Attribute | conversions |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
|
ConversionTrackerId
|
ID of the conversion tracker.
| Type | Long |
| Display Name | Conversion Tracker Id |
| XML Attribute | conversionTrackerId |
| Behavior | Segment |
| Filterable | True |
| Supports Zero Impressions | False |
Not compatible with the following fields:
ActiveViewCpm
ActiveViewImpressions
AverageCpc
AverageCpm
AveragePosition
Clicks
Cost
Ctr
GmailForwards
GmailSaves
GmailSecondaryClicks
Impressions
|
ConversionTypeName
|
Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned.
| Type | String |
| Display Name | Conversion name |
| XML Attribute | conversionName |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | False |
Not compatible with the following fields:
ActiveViewCpm
ActiveViewImpressions
AverageCpc
AverageCpm
AveragePosition
Clicks
Cost
Ctr
GmailForwards
GmailSaves
GmailSecondaryClicks
Impressions
|
ConversionValue
|
The sum of conversion values for all conversions.
| Type | Double |
| Display Name | Total conv. value |
| XML Attribute | totalConvValue |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
|
ConvertedClicks
|
The number of clicks that converted within your chosen conversion window.
| Type | Long |
| Display Name | Converted clicks |
| XML Attribute | convertedClicks |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
|
Cost
|
The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. Other costs such as cost-per-call aren't included. For a sum of all costs, use the TotalCost column on the Ad Group Performance Report or Campaign Performance Report.
| Type | Money |
| Display Name | Cost |
| XML Attribute | cost |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
CostPerConversionManyPerClick
|
Total cost divided by your total conversions.
| Type | Money |
| Display Name | Cost / conv. |
| XML Attribute | costConv |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
|
CostPerConvertedClick
|
Cost divided by your total converted clicks.
| Type | Money |
| Display Name | Cost / converted click |
| XML Attribute | costConvertedClick |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
|
CriteriaDestinationUrl
|
Destination URL of the criterion that triggered ads. In the Destination URL report, this field behaves as a segment.
| Type | String |
| Display Name | Keyword/Placement destination URL |
| XML Attribute | keywordPlacementDestinationURL |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | False |
|
CriteriaParameters
|
Descriptive string for the Criterion. In the Destination URL report, this field behaves as a segment.
| Type | String |
| Display Name | Keyword / Placement |
| XML Attribute | keywordPlacement |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | False |
|
CriteriaStatus
|
The status of the Criterion. In the Destination URL report, this field behaves as a segment.
| Type | UserStatus |
| Display Name | Keyword/Placement state |
| XML Attribute | keywordPlacementState |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | False |
Predicate values / display values
ENABLED | enabled |
REMOVED | removed |
PAUSED | paused |
|
CriteriaTypeName
|
The descriptive name of the CriteriaType.
| Type | String |
| Display Name | Match type |
| XML Attribute | matchType |
| Behavior | Attribute |
| 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%".
| Type | Double |
| Display Name | CTR |
| XML Attribute | ctr |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
CustomerDescriptiveName
|
The descriptive name of the Customer.
| Type | String |
| Display Name | Client name |
| XML Attribute | clientName |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
|
Date
|
The date formatted as yyyy-MM-dd.
| Type | Date |
| Display Name | Day |
| XML Attribute | day |
| Behavior | Segment |
| Filterable | True |
| Supports Zero Impressions | True |
|
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 | True |
Predicate values / display values
MONDAY | Monday |
TUESDAY | Tuesday |
WEDNESDAY | Wednesday |
THURSDAY | Thursday |
FRIDAY | Friday |
SATURDAY | Saturday |
SUNDAY | Sunday |
|
Device
|
Device type where the impression was shown.
| Type | DeviceType |
| Display Name | Device |
| XML Attribute | device |
| Behavior | Segment |
| Filterable | True |
| Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | Other |
DESKTOP | Computers |
HIGH_END_MOBILE | Mobile devices with full browsers |
TABLET | Tablets with full browsers |
|
EffectiveDestinationUrl
|
Effective destination URL of the impressions.
| Type | String |
| Display Name | Destination URL |
| XML Attribute | destinationURL |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
|
ExternalCustomerId
|
The Customer ID.
| Type | Long |
| Display Name | Customer ID |
| XML Attribute | customerID |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
|
GmailForwards
|
The number of times your ad was forwarded to someone else as a message.
| Type | Long |
| Display Name | Gmail forwards |
| XML Attribute | gmailForwards |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
GmailSaves
|
The number of times someone has saved your Gmail ad to their inbox as a message.
| Type | Long |
| Display Name | Gmail saves |
| XML Attribute | gmailSaves |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
GmailSecondaryClicks
|
The number of clicks to your landing page on the expanded state of Gmail ads.
| Type | Long |
| Display Name | Gmail clicks to website |
| XML Attribute | gmailClicksToWebsite |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
Impressions
|
Count of how often your ad has appeared on a search results page or website on the Google Network.
| Type | Long |
| Display Name | Impressions |
| XML Attribute | impressions |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionCategoryName
ConversionTrackerId
ConversionTypeName
|
IsNegative
|
Indicates if the criterion for this row is a negative (exclusion) criterion.
| Type | Enum |
| Display Name | Is negative |
| XML Attribute | isNegative |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | False |
Predicate values / display values
|
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 | True |
|
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 | True |
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 |
|
PrimaryCompanyName
|
Company name of the account.
| Type | String |
| Display Name | Company name |
| XML Attribute | companyName |
| Behavior | Attribute |
| Filterable | True |
| Supports Zero Impressions | True |
|
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 | True |
|
Slot
|
The position of the Ad.
| Type | Slot |
| Display Name | Top vs. Other |
| XML Attribute | topVsOther |
| Behavior | Segment |
| Filterable | True |
| Supports Zero Impressions | True |
Predicate values / display values
SearchRhs | Google search: Side |
SearchTop | Google search: Top |
SearchOther | Google search: Other |
Content | Google Display Network |
AfsTop | Search partners: Top |
AfsOther | Search partners: Other |
Unknown | |
|
ValuePerConversionManyPerClick
|
The total value of all conversions divided by the total number of conversions.
| Type | Double |
| Display Name | Value / conv. |
| XML Attribute | valueConv |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
|
ValuePerConvertedClick
|
The total value of all conversions divided by the total number of converted clicks.
| Type | Double |
| Display Name | Value / converted click |
| XML Attribute | valueConvertedClick |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
|
ViewThroughConversions
|
The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad.
| Type | Long |
| Display Name | View-through conv. |
| XML Attribute | viewThroughConv |
| Behavior | Metric |
| Filterable | True |
| Supports Zero Impressions | True |
|
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 | True |
|
Year
|
The year, formatted as yyyy.
| Type | Integer |
| Display Name | Year |
| XML Attribute | year |
| Behavior | Segment |
| Filterable | True |
| Supports Zero Impressions | True |
|
