This page lists and describes the fields in available reports. For general information about performance reports, see the AdWords Help Center.
For specific general information about reports, visit Reporting basics and Reporting concepts guides
- Available Reports
-
- Account Performance
- Account Reach Frequency
- Ad Performance
- Ad Extensions Performance
- Ad Group Performance
- Ad Group Reach Frequency
- Age Range Performance
- Audience Performance
- Automatic Placements Performance
- Bid Goal Performance
- Budget Performance
- Call Metrics Call Details
- Campaign Performance
- Campaign Ad Schedule Target
- Campaign Location Target
- Campaign Negative Keywords Performance
- Campaign Negative Locations
- Campaign Negative Placements Performance
- Campaign Platform Target
- Campaign Reach Frequency
- Campaign Shared Set
- Click Performance
- Creative Conversion
- Criteria Performance
- Destination URL
- Display Keyword Performance
- Display Topics Performance
- Gender Performance
- Geo Performance
- Keywordless Category
- Keywordless Query
- Keywords Performance
- Paid and Organic Query
- Placeholder
- Placeholder Feed Item
- Placement Performance
- Product Partition
- Search Query Performance
- Shared Set Criteria
- Shared Set
- Shopping Performance
- URL Performance
- Name
- The field name to be used in a
<fields>element when requesting reports. - Display Name
- The human-readable name of this field, returned in a CSV header row.
- XML Attribute
- The XML attribute in the generated report that corresponds to this field (only applicable if a report definition's download format is XML).
- Type
- The data type of this field in the generated report.
- Supports Zero Impressions
- Indicates whether the field supports
zero impressions
(
true) in reports or not. - Behavior
- The three possible Behavior values are:
- AttributeThe field contains settings or other fixed data. The values returned will always reflect the current state of the account, ignoring the timespan of the report. The field is generally compatible with zero-impression reports.
- MetricThe field contains numerical performance data. The values returned reflect the performance over the timespan of the report.
- SegmentThe field contains dimension data that is used to group metrics. Including the field in a report may split a single row into multiple rows. The values returned and number of segmented rows reflect the performance over the timespan of the report. The field is likely to be incompatible with zero-impression reports, see the Notes and Support Zero Impressions columns to verify.
- Notes
- Additional information about the field, including formats, enum values, and special behaviors. This column will also indicate when the report data will differ from the specified Data Type.
Account Performance Report
The Account Performance report includes all statistics aggregated by default at the account level, one row per account. If other segment fields are used, you may get more than one row per account. See segmentation for more information.
ReportType:
ACCOUNT_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ContentBudgetLostImpressionShare | Content Lost IS (budget) | contentLostISBudget | Double | True | Metric | |
| ContentImpressionShare | Content Impr. share | contentImprShare | Double | True | Metric | |
| ContentRankLostImpressionShare | Content Lost IS (rank) | contentLostISRank | Double | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionTrackerId | Conversion Tracker Id | conversionTrackerId | Long | False | Segment | |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CostPerEstimatedTotalConversion | Cost / est. total conv. | costEstTotalConv | Double | True | Metric | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| EstimatedCrossDeviceConversions | Est. cross-device conv. | estCrossDeviceConv | Long | True | Metric | |
| EstimatedTotalConversionRate | Est. total conv. rate | estTotalConvRate | Double | True | Metric | |
| EstimatedTotalConversionValue | Est. total conv. value | estTotalConvValue | Double | True | Metric | |
| EstimatedTotalConversionValuePerClick | Est. total conv. value / click | estTotalConvValueClick | Double | True | Metric | |
| EstimatedTotalConversionValuePerCost | Est. total conv. value / cost | estTotalConvValueCost | Double | True | Metric | |
| EstimatedTotalConversions | Est. total conv. | estTotalConv | Long | True | Metric | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| HourOfDay | Hour of day | hourOfDay | Integer | False | Segment | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| InvalidClickRate | Invalid click rate | invalidClickRate | Double | True | Metric | Percentage returned as "x.xx%". |
| InvalidClicks | Invalid clicks | invalidClicks | Long | True | Metric | |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| SearchBudgetLostImpressionShare | Search Lost IS (budget) | searchLostISBudget | Double | True | Metric | |
| SearchExactMatchImpressionShare | Search Exact match IS | searchExactMatchIS | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the field ClickType. |
| SearchImpressionShare | Search Impr. share | searchImprShare | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the fields ClickType and HourOfDay on any report. Not compatible with the field Device on the Product Partition Report. |
| SearchRankLostImpressionShare | Search Lost IS (rank) | searchLostISRank | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the field ClickType. |
| Slot | Top vs. Other | topVsOther | Slot | True | Segment | 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 / |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ValuePerEstimatedTotalConversion | Value / est. total conv. | valueEstTotalConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Account Reach Frequency Report
The Account Reach Frequency report includes all stats aggregated at the account level, one row per account. This report can also be segmented by date and frequency using ReachFrequencyDate and ReachFrequency respectively. See segmentation for more information. Visit this help center page to learn more about measuring reach and frequency.
ReportType:
ACCOUNT_REACH_FREQUENCY_REPORTNote: This report is deprecated and only available in v201406 or earlier.
| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| PrimaryCompanyName | Company name | companyName | String | False | Attribute | |
| ReachFrequency | Frequency | frequency | Integer | False | Attribute | |
| ReachFrequencyClicks | Clicks | clicks | Double | False | Metric | |
| ReachFrequencyConv | Conv. | conv | Double | False | Metric | |
| ReachFrequencyConvRate | Conv. rate | convRate | Double | False | Metric | |
| ReachFrequencyCtr | CTR | ctr | Double | False | Metric | |
| ReachFrequencyDate | Day | day | Date | False | Segment | |
| UniqueUserCountAsLong | Unique Users | uniqueUsers | Long | False | Metric |
Ad Performance Report
The Ad Performance report includes all statistics aggregated at the ad level, one row per ad. If other segment fields are used, you may get more than one row per ad. See segmentation for more information. This is a single attribution report when KeywordId is requested. The KeywordId field will return any criteria that triggered the ad, not just keywords.
ReportType:
AD_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupAdDisapprovalReasons | Disapproval reasons | disapprovalReasons | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AdType | Ad type | adType | Type | True | Attribute | Predicate values / display values: DEPRECATED_AD / Other IMAGE_AD / Image ad MOBILE_AD / Mobile ad MOBILE_IMAGE_AD / Mobile ad PRODUCT_AD / Product listing ad TEMPLATE_AD / Display ad TEXT_AD / Text ad THIRD_PARTY_REDIRECT_AD / Third party ad DYNAMIC_SEARCH_AD / Dynamic search ad CALL_ONLY_AD / Call only ad UNKNOWN / unknown |
| AdvertiserExperimentSegmentationBin | ACE split | aCESplit | AdvertiserExperimentSegmentationBin | True | Segment | Predicate values / display values: OUTSIDE_OF_EXPERIMENT / outside experiment CONTROL / control EXPERIMENT / experiment |
| AssistClicks | Assist Clicks | assistClicks | Long | True | Metric | |
| AssistImpressions | Assist Impr. | assistImpr | Long | True | Metric | |
| AssistImpressionsOverLastClicks | Assist Impr. / Last Clicks | assistImprLastClicks | Double | True | Metric | |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePageviews | Pages / visit | pagesVisit | Double | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| AverageTimeOnSite | Avg. visit duration (seconds) | avgVisitDurationSeconds | Double | True | Metric | |
| BounceRate | Bounce rate | bounceRate | Double | True | Metric | |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickAssistedConversionValue | Click Assisted Conv. Value | clickAssistedConvValue | Double | True | Metric | |
| ClickAssistedConversions | Click Assisted Conv. | clickAssistedConv | Long | True | Metric | |
| ClickAssistedConversionsOverLastClickConversions | Click Assisted Conv. / Last Click Conv. | clickAssistedConvLastClickConv | Double | True | Metric | |
| ClickSignificance | Clicks ACE indicator | clicksACEIndicator | SignificanceData | True | Metric | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionManyPerClickSignificance | Conversion ACE indicator | conversionACEIndicator | SignificanceData | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClickSignificance | Conversion rate ACE indicator | conversionRateACEIndicator | SignificanceData | True | Metric | |
| ConversionRateSignificance | Click conversion rate ACE indicator | clickConversionRateACEIndicator | SignificanceData | True | Metric | |
| ConversionSignificance | Converted clicks ACE indicator | convertedClicksACEIndicator | SignificanceData | True | Metric | |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CostPerConversionManyPerClickSignificance | Cost/conversion ACE indicator | costConversionACEIndicator | SignificanceData | True | Metric | |
| CostPerConversionSignificance | Cost/converted click ACE indicator | costConvertedClickACEIndicator | SignificanceData | True | Metric | |
| CostSignificance | Cost ACE indicator | costACEIndicator | SignificanceData | True | Metric | |
| CpcSignificance | CPC ACE indicator | cPCACEIndicator | SignificanceData | True | Metric | |
| CpmSignificance | CPM ACE indicator | cPMACEIndicator | SignificanceData | True | Metric | |
| CreativeApprovalStatus | Ad Approval Status | adApprovalStatus | ApprovalStatus | True | Attribute | Predicate values / display values: APPROVED / approved FAMILY_SAFE / approved NON_FAMILY_SAFE / approved (non family) PORN / approved (adult) UNCHECKED / pending review DISAPPROVED / disapproved |
| CreativeDestinationUrl | Destination URL | destinationURL | String | True | Attribute | |
| CreativeFinalAppUrls | App final URL | appFinalURL | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| CreativeFinalMobileUrls | Mobile final URL | mobileFinalURL | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| CreativeFinalUrls | Final URL | finalURL | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| CreativeTrackingUrlTemplate | Tracking template | trackingTemplate | String | True | Attribute | |
| CreativeUrlCustomParameters | Custom parameter | customParameter | CustomParameters | True | Attribute | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CtrSignificance | CTR ACE indicator | cTRACEIndicator | SignificanceData | True | Metric | |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Description1 | Description line 1 | descriptionLine1 | String | True | Attribute | |
| Description2 | Description line 2 | descriptionLine2 | String | True | Attribute | |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| DevicePreference | Device preference | devicePreference | Long | True | Attribute | |
| DisplayUrl | Display URL | displayURL | String | True | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Headline | Ad | ad | String | True | Attribute | |
| Id | Ad ID | adID | Long | True | Attribute | |
| ImageAdUrl | Image Ad URL | imageAdURL | String | True | Attribute | Prefix this value with "https://tpc.googlesyndication.com/pageadimg/imgad?id=" to get the full URL. |
| ImageCreativeName | Image ad name | imageAdName | String | True | Attribute | |
| ImpressionAssistedConversionValue | Impr. Assisted Conv. Value | imprAssistedConvValue | Double | True | Metric | |
| ImpressionAssistedConversions | Impr. Assisted Conv. | imprAssistedConv | Long | True | Metric | |
| ImpressionAssistedConversionsOverLastClickConversions | Impr. Assisted Conv. / Last Click Conv. | imprAssistedConvLastClickConv | Double | True | Metric | |
| ImpressionSignificance | Impressions ACE indicator | impressionsACEIndicator | SignificanceData | True | Metric | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | False | Attribute | |
| KeywordId | Keyword ID | keywordID | Long | False | Attribute | In the Ad Performance Report this field contains the ID of the criterion that triggered the ad, segmenting the report and preventing zero impressions. The ID can be for any type of criterion, including placements, verticals, etc. Cross-reference with the Criteria Report to determine the criteria type and details. |
| LabelIds | Label IDs | labelIDs | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| Labels | Labels | labels | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 |
| PercentNewVisitors | % new visits | newVisits | Double | True | Metric | |
| PositionSignificance | Position ACE indicator | positionACEIndicator | SignificanceData | True | Metric | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute | |
| PromotionLine | Ad | ad | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| SharedSetName | List name | listName | String | True | Attribute | |
| Slot | Top vs. Other | topVsOther | Slot | True | Segment | 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 / |
| Status | Ad state | adState | Status | True | Attribute | Predicate values / display values: ENABLED / enabled PAUSED / paused DISABLED / disabled |
| Url | Destination URL | destinationURL | String | True | Attribute | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| ViewThroughConversionsSignificance | View-through conv. ACE indicator | viewThroughConvACEIndicator | SignificanceData | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Ad Extensions Performance Report
The Ad Extensions Performance report includes all statistics aggregated at the ad extension level, one row per ad extension, and it is filtered in the UI by the type of extension. This report will only return legacy campaign extensions. For upgraded extensions, use the Placeholder Feed Item report - they will not be reflected in this report. If other segment fields are used, you may get more than one row per ad extension. See segmentation for more information.
ReportType:
AD_EXTENSIONS_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdExtensionId | Ad Extension ID | adExtensionID | Long | True | Attribute | |
| AdExtensionType | Ad Extension Type | adExtensionType | AdExtensionType | True | Attribute | Predicate values / display values: LOCATION_EXTENSION / location extension LOCATION_SYNC_EXTENSION / location sync extension MOBILE_EXTENSION / mobile extension PRODUCT_EXTENSION / product extension STORE_LOCATOR_EXTENSION / store locator extension SITELINKS_EXTENSION / site links extension DOMAIN_INFO_EXTENSION / domain info extension UNKNOWN / unknown |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| ApprovalStatus | Status | status | ApprovalStatus | True | Attribute | Predicate values / display values: APPROVED / eligible UNCHECKED / eligible DISAPPROVED / disapproved |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| AvgCostForOfflineInteraction | Avg. CPP | avgCPP | Money | True | Metric | |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| LocationExtensionSource | Location Extension Source | locationExtensionSource | Source | True | Attribute | Predicate values / display values: ADWORDS_FRONTEND / AdWords frontend LBC_SYNC / lbc sync |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 |
| NumOfflineImpressions | Phone impressions | phoneImpressions | Long | True | Metric | |
| NumOfflineInteractions | Phone calls | phoneCalls | Long | True | Metric | |
| OfflineInteractionCost | Phone cost | phoneCost | Money | True | Metric | |
| OfflineInteractionRate | PTR | ptr | Double | True | Metric | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Slot | Top vs. Other | topVsOther | Slot | True | Segment | 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 / |
| Status | State | state | Status | True | Attribute | Predicate values / display values: ENABLED / enabled REMOVED / removed |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Ad Group Performance Report
The Ad Group Performance report includes all statistics aggregated by default at the ad group level, one row per ad group. If other segment fields are used, you may get more than one row per ad group. See segmentation for more information.
ReportType:
ADGROUP_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AdvertiserExperimentSegmentationBin | ACE split | aCESplit | AdvertiserExperimentSegmentationBin | True | Segment | Predicate values / display values: OUTSIDE_OF_EXPERIMENT / outside experiment CONTROL / control EXPERIMENT / experiment |
| AssistClicks | Assist Clicks | assistClicks | Long | True | Metric | |
| AssistImpressions | Assist Impr. | assistImpr | Long | True | Metric | |
| AssistImpressionsOverLastClicks | Assist Impr. / Last Clicks | assistImprLastClicks | Double | True | Metric | |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePageviews | Pages / visit | pagesVisit | Double | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| AverageTimeOnSite | Avg. visit duration (seconds) | avgVisitDurationSeconds | Double | True | Metric | |
| AvgCostForOfflineInteraction | Avg. CPP | avgCPP | Money | True | Metric | |
| BidType | Conversion optimizer bid type | conversionOptimizerBidType | BidType | True | Attribute | Predicate values / display values: TARGET_CPA / target cpa |
| BiddingStrategyId | Bid Strategy ID | bidStrategyID | Long | True | Attribute | |
| BiddingStrategyName | Bid Strategy Name | bidStrategyName | String | True | Attribute | |
| BiddingStrategyType | Bid Strategy Type | bidStrategyType | BiddingStrategyType | True | Attribute | Predicate values / display values: BUDGET_OPTIMIZER / auto CONVERSION_OPTIMIZER / max/target cpa MANUAL_CPC / cpc MANUAL_CPM / cpm PAGE_ONE_PROMOTED / Target search page location TARGET_SPEND / Maximize clicks ENHANCED_CPC / Enhanced CPC TARGET_CPA / Target CPA TARGET_ROAS / Target ROAS NONE / None UNKNOWN / unknown |
| BounceRate | Bounce rate | bounceRate | Double | True | Metric | |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickAssistedConversionValue | Click Assisted Conv. Value | clickAssistedConvValue | Double | True | Metric | |
| ClickAssistedConversions | Click Assisted Conv. | clickAssistedConv | Long | True | Metric | |
| ClickAssistedConversionsOverLastClickConversions | Click Assisted Conv. / Last Click Conv. | clickAssistedConvLastClickConv | Double | True | Metric | |
| ClickSignificance | Clicks ACE indicator | clicksACEIndicator | SignificanceData | True | Metric | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ContentBidCriterionTypeGroup | Content Network Bid Dimension | contentNetworkBidDimension | CriterionTypeGroup | True | Attribute | Predicate values / display values: KEYWORD / Keyword USER_INTEREST_AND_LIST / User Interest and List VERTICAL / Vertical GENDER / Gender AGE_RANGE / Age PLACEMENT / Placement NONE / None UNKNOWN / unknown |
| ContentImpressionShare | Content Impr. share | contentImprShare | Double | True | Metric | |
| ContentRankLostImpressionShare | Content Lost IS (rank) | contentLostISRank | Double | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionManyPerClickSignificance | Conversion ACE indicator | conversionACEIndicator | SignificanceData | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClickSignificance | Conversion rate ACE indicator | conversionRateACEIndicator | SignificanceData | True | Metric | |
| ConversionRateSignificance | Click conversion rate ACE indicator | clickConversionRateACEIndicator | SignificanceData | True | Metric | |
| ConversionSignificance | Converted clicks ACE indicator | convertedClicksACEIndicator | SignificanceData | True | Metric | |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CostPerConversionManyPerClickSignificance | Cost/conversion ACE indicator | costConversionACEIndicator | SignificanceData | True | Metric | |
| CostPerConversionSignificance | Cost/converted click ACE indicator | costConvertedClickACEIndicator | SignificanceData | True | Metric | |
| CostPerEstimatedTotalConversion | Cost / est. total conv. | costEstTotalConv | Double | True | Metric | |
| CostSignificance | Cost ACE indicator | costACEIndicator | SignificanceData | True | Metric | |
| CpcBid | Default max. CPC | defaultMaxCPC | Money | True | Attribute | |
| CpcSignificance | CPC ACE indicator | cPCACEIndicator | SignificanceData | True | Metric | |
| CpmBid | Max. CPM | maxCPM | Money | True | Attribute | |
| CpmSignificance | CPM ACE indicator | cPMACEIndicator | SignificanceData | True | Metric | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CtrSignificance | CTR ACE indicator | cTRACEIndicator | SignificanceData | True | Metric | |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| EnhancedCpcEnabled | Enhanced CPC enabled | enhancedCPCEnabled | Boolean | True | Attribute | |
| EstimatedCrossDeviceConversions | Est. cross-device conv. | estCrossDeviceConv | Long | True | Metric | |
| EstimatedTotalConversionRate | Est. total conv. rate | estTotalConvRate | Double | True | Metric | |
| EstimatedTotalConversionValue | Est. total conv. value | estTotalConvValue | Double | True | Metric | |
| EstimatedTotalConversionValuePerClick | Est. total conv. value / click | estTotalConvValueClick | Double | True | Metric | |
| EstimatedTotalConversionValuePerCost | Est. total conv. value / cost | estTotalConvValueCost | Double | True | Metric | |
| EstimatedTotalConversions | Est. total conv. | estTotalConv | Long | True | Metric | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| HourOfDay | Hour of day | hourOfDay | Integer | False | Segment | |
| Id | Ad group ID | adGroupID | Long | True | Attribute | |
| ImpressionAssistedConversionValue | Impr. Assisted Conv. Value | imprAssistedConvValue | Double | True | Metric | |
| ImpressionAssistedConversions | Impr. Assisted Conv. | imprAssistedConv | Long | True | Metric | |
| ImpressionAssistedConversionsOverLastClickConversions | Impr. Assisted Conv. / Last Click Conv. | imprAssistedConvLastClickConv | Double | True | Metric | |
| ImpressionSignificance | Impressions ACE indicator | impressionsACEIndicator | SignificanceData | True | Metric | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| LabelIds | Label IDs | labelIDs | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| Labels | Labels | labels | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 |
| Name | Ad group | adGroup | String | True | Attribute | |
| NumOfflineImpressions | Phone impressions | phoneImpressions | Long | True | Metric | |
| NumOfflineInteractions | Phone calls | phoneCalls | Long | True | Metric | |
| OfflineInteractionCost | Phone cost | phoneCost | Money | True | Metric | |
| OfflineInteractionRate | PTR | ptr | Double | True | Metric | |
| PercentNewVisitors | % new visits | newVisits | Double | True | Metric | |
| PositionSignificance | Position ACE indicator | positionACEIndicator | SignificanceData | True | Metric | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| RelativeCtr | Relative CTR | relativeCTR | Double | True | Metric | |
| SearchExactMatchImpressionShare | Search Exact match IS | searchExactMatchIS | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the field ClickType. |
| SearchImpressionShare | Search Impr. share | searchImprShare | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the fields ClickType and HourOfDay on any report. Not compatible with the field Device on the Product Partition Report. |
| SearchRankLostImpressionShare | Search Lost IS (rank) | searchLostISRank | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the field ClickType. |
| Slot | Top vs. Other | topVsOther | Slot | True | Segment | 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 / |
| Status | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| TargetCpa | Max. CPA (converted clicks) | maxCPAConvertedClicks | Money | True | Attribute | |
| TotalCost | Total cost | totalCost | Money | True | Metric | |
| TrackingUrlTemplate | Tracking template | trackingTemplate | String | True | Attribute | |
| UrlCustomParameters | Custom parameter | customParameter | CustomParameters | True | Attribute | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ValuePerEstimatedTotalConversion | Value / est. total conv. | valueEstTotalConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| ViewThroughConversionsSignificance | View-through conv. ACE indicator | viewThroughConvACEIndicator | SignificanceData | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Ad Group Reach Frequency Report
The Ad Group Reach Frequency report includes all stats aggregated at the ad group level, one row per ad group. This report can also be segmented by date and frequency using ReachFrequencyDate and ReachFrequency respectively. See segmentation for more information. Visit this help center page to learn more about measuring reach and frequency.
ReportType:
ADGROUP_REACH_FREQUENCY_REPORTNote: This report is deprecated and only available in v201406 or earlier.
| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| PrimaryCompanyName | Company name | companyName | String | False | Attribute | |
| ReachFrequency | Frequency | frequency | Integer | False | Attribute | |
| ReachFrequencyClicks | Clicks | clicks | Double | False | Metric | |
| ReachFrequencyConv | Conv. | conv | Double | False | Metric | |
| ReachFrequencyConvRate | Conv. rate | convRate | Double | False | Metric | |
| ReachFrequencyCtr | CTR | ctr | Double | False | Metric | |
| ReachFrequencyDate | Day | day | Date | False | Segment | |
| UniqueUserCountAsLong | Unique Users | uniqueUsers | Long | False | Metric |
Age Range Performance Report
The Age Range Performance report includes all display network statistics aggregated by age range. It also includes automatic audience performance. If other segment fields are used, you may get more than one row per age range. See segmentation for more information. This is a multiple attribution report.
ReportType:
AGE_RANGE_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| BidModifier | Bid adj. | bidAdj | Double | True | Attribute | |
| BidType | Conversion optimizer bid type | conversionOptimizerBidType | BidType | True | Attribute | Predicate values / display values: TARGET_CPA / target cpa |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CpcBid | Max. CPC | maxCPC | Money | True | Attribute | |
| CpcBidSource | Max CPC source | maxCPCSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| CpmBid | Max. CPM | maxCPM | Money | True | Attribute | |
| CpmBidSource | Max CPM Source | maxCPMSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| Criteria | Age Range | ageRange | String | True | Attribute | |
| CriteriaDestinationUrl | Destination URL | destinationURL | String | True | Attribute | In the Destination URL report, this field behaves as a segment. |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DestinationUrl | Destination URL | destinationURL | String | True | Attribute | |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Criterion ID | criterionID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| IsRestrict | Is restricting | isRestricting | boolean | True | Attribute | Defines if criterion is used for targeting (true) or bidding only (false). |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Status | Age Range state | ageRangeState | UserStatus | True | Attribute | Predicate values / display values: ENABLED / enabled REMOVED / removed PAUSED / paused |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Audience Performance Report
The Audience Performance report includes performance data from interests and remarketing lists for display ads, and remarketing lists for search ads (RLSA), aggregated at the audience level—one row per audience. If other segment fields are used, you may get more than one row per topic. See segmentation for more information. This is a multiple attribution report.
ReportType:
AUDIENCE_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| BidModifier | Bid adj. | bidAdj | Double | True | Attribute | |
| BidType | Conversion optimizer bid type | conversionOptimizerBidType | BidType | True | Attribute | Predicate values / display values: TARGET_CPA / target cpa |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CpcBid | Max. CPC | maxCPC | Money | True | Attribute | |
| CpcBidSource | Max CPC source | maxCPCSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| CpmBid | Max. CPM | maxCPM | Money | True | Attribute | |
| CpmBidSource | Max CPM Source | maxCPMSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| Criteria | Audience | audience | String | True | Attribute | |
| CriteriaDestinationUrl | Destination URL | destinationURL | String | True | Attribute | In the Destination URL report, this field behaves as a segment. |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DestinationUrl | Destination URL | destinationURL | String | True | Attribute | |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Criterion ID | criterionID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| IsRestrict | Is restricting | isRestricting | boolean | True | Attribute | Defines if criterion is used for targeting (true) or bidding only (false). |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Slot | Top vs. Other | topVsOther | Slot | True | Segment | 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 / |
| Status | Audience state | audienceState | UserStatus | True | Attribute | Predicate values / display values: ENABLED / enabled REMOVED / removed PAUSED / paused |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Automatic Placements Performance Report
The Automatic Placements Performance report includes all statistics aggregated at the placement level, one row per placement. If other segment fields are used, you may get more than one row per placement. See segmentation for more information. This is a single attribution report.
ReportType:
AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdFormat | Ad type | adType | AdFormat | False | Segment | Predicate values / display values: UNKNOWN / unknown TEXT / text IMAGE / image DYNAMIC_IMAGE / dynamic_image FLASH / flash VIDEO / video HTML / html AUDIO / audio COMPOSITE / composite PRINT / print |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | False | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | False | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | False | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | False | Metric | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| Clicks | Clicks | clicks | Long | False | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | False | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | False | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | False | Metric | |
| Cost | Cost | cost | Money | False | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | False | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | False | Metric | |
| CriteriaParameters | URL | url | String | False | Attribute | In the Destination URL report, this field behaves as a segment. |
| Ctr | CTR | ctr | Double | False | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| Date | Day | day | Date | False | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | False | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DisplayName | Criteria Display Name | criteriaDisplayName | String | False | Attribute | |
| Domain | Domain | domain | String | False | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| Impressions | Impressions | impressions | Long | False | Metric | |
| IsAutoOptimized | Targeting Mode | targetingMode | boolean | False | Segment | |
| IsBidOnPath | Added | added | boolean | False | Attribute | |
| IsPathExcluded | Excluded | excluded | boolean | False | Attribute | |
| Month | Month | month | String | False | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | False | Segment | 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 | companyName | String | False | Attribute | |
| Quarter | Quarter | quarter | String | False | Segment | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | False | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | False | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | False | Metric | |
| Week | Week | week | String | False | Segment | |
| Year | Year | year | Integer | False | Segment |
Bid Goal Performance Report
The Bid Goal Performance report includes statistics for your bid strategies.
ReportType:
BID_GOAL_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AdGroupCount | Ad Groups | adGroups | Integer | True | Metric | |
| AdGroupCriteriaCount | Keywords | keywords | Integer | True | Metric | |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| CampaignCount | Campaigns | campaigns | Integer | True | Metric | |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| HourOfDay | Hour of day | hourOfDay | Integer | False | Segment | |
| Id | Bid Strategy ID | bidStrategyID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 |
| Name | Bid Strategy Name | bidStrategyName | String | True | Attribute | |
| NonRemovedAdGroupCount | Non-Removed Ad Groups | nonRemovedAdGroups | Integer | True | Metric | |
| NonRemovedAdGroupCriteriaCount | Non-Removed Keywords | nonRemovedKeywords | Integer | True | Metric | |
| NonRemovedCampaignCount | Non-Removed Campaigns | nonRemovedCampaigns | Integer | True | Metric | |
| PageOnePromotedBidCeiling | Bid limit (Target search page location) | bidLimitTargetSearchPageLocation | Money | True | Attribute | |
| PageOnePromotedBidChangesForRaisesOnly | Bid automation (Target search page location) | bidAutomationTargetSearchPageLocation | Boolean | True | Attribute | |
| PageOnePromotedBidModifier | Bid adjustment (Target search page location) | bidAdjustmentTargetSearchPageLocation | Double | True | Attribute | |
| PageOnePromotedRaiseBidWhenBudgetConstained | Limited budgets (Target search page location) | limitedBudgetsTargetSearchPageLocation | Boolean | True | Attribute | |
| PageOnePromotedRaiseBidWhenBudgetConstrained | Limited budgets (Target search page location) | limitedBudgetsTargetSearchPageLocation | Boolean | True | Attribute | |
| PageOnePromotedRaiseBidWhenLowQualityScore | Low quality keywords (Target search page location) | lowQualityKeywordsTargetSearchPageLocation | Boolean | True | Attribute | |
| PageOnePromotedStrategyGoal | Location (Target search page location) | locationTargetSearchPageLocation | StrategyGoal | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Status | State | state | BiddingStrategyStatus | True | Attribute | Predicate values / display values: ENABLED / Enabled REMOVED / Removed UNKNOWN / unknown |
| TargetCpa | Target CPA | targetCPA | Money | True | Attribute | |
| TargetCpaMaxCpcBidCeiling | Upper Bid limit (Target CPA) | upperBidLimitTargetCPA | Money | True | Attribute | |
| TargetCpaMaxCpcBidFloor | Lower Bid limit (Target CPA) | lowerBidLimitTargetCPA | Money | True | Attribute | |
| TargetRoas | Target ROAS | targetROAS | Double | True | Attribute | |
| TargetRoasBidCeiling | Upper Bid limit (Target ROAS) | upperBidLimitTargetROAS | Money | True | Attribute | |
| TargetRoasBidFloor | Lower Bid limit (Target ROAS) | lowerBidLimitTargetROAS | Money | True | Attribute | |
| TargetSpendBidCeiling | Bid limit (Maximize clicks) | bidLimitMaximizeClicks | Money | True | Attribute | |
| TargetSpendSpendTarget | Target spend (Maximize clicks) | targetSpendMaximizeClicks | Money | True | Attribute | |
| Type | Bid Strategy Type | bidStrategyType | BiddingStrategyType | True | Attribute | Predicate values / display values: BUDGET_OPTIMIZER / auto CONVERSION_OPTIMIZER / max/target cpa MANUAL_CPC / cpc MANUAL_CPM / cpm PAGE_ONE_PROMOTED / Target search page location TARGET_SPEND / Maximize clicks ENHANCED_CPC / Enhanced CPC TARGET_CPA / Target CPA TARGET_ROAS / Target ROAS NONE / None UNKNOWN / unknown |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Budget Performance Report
The Budget Performance report includes all statistics aggregated by default at the budget level, one row per budget. If other segment fields are used, you may get more than one row per budget. See segmentation for more information.
ReportType:
BUDGET_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| Amount | Budget | budget | Money | True | Attribute | |
| AssociatedCampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| AssociatedCampaignName | Campaign | campaign | String | True | Attribute | |
| AssociatedCampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: ENABLED / enabled PAUSED / paused REMOVED / removed UNKNOWN / unknown |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| BudgetCampaignAssociationStatus | Budget usage | budgetUsage | BudgetCampaignAssociationStatus | True | Attribute | Predicate values / display values: ENABLED / Enabled REMOVED / Removed UNKNOWN / unknown |
| BudgetId | Budget ID | budgetID | Long | True | Attribute | |
| BudgetName | Budget Name | budgetName | String | True | Attribute | |
| BudgetReferenceCount | # Campaigns | campaigns | Integer | True | Attribute | |
| BudgetStatus | Budget state | budgetState | BudgetStatus | True | Attribute | Predicate values / display values: ENABLED / Enabled REMOVED / Removed UNKNOWN / unknown |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| DeliveryMethod | Delivery method | deliveryMethod | BudgetDeliveryMethod | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsBudgetExplicitlyShared | Explicitly shared | explicitlyShared | Boolean | True | Attribute | |
| Period | Budget period | budgetPeriod | BudgetPeriod | True | Attribute | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric |
Call Metrics Call Details Report
The Call Metrics Call Details report includes call details for your call extension including call duration and the caller's area code.
Note: This report includes data from all dates, regardless of the dateRange (XML) or
DURING clause (AWQL) in the report definition.
ReportType:
CALL_METRICS_CALL_DETAILS_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdvertiserPhoneNumber | Business phone number | businessPhoneNumber | String | False | Attribute | |
| CallDuration | Duration (seconds) | durationSeconds | Long | False | Attribute | |
| CallEndTime | End time | endTime | Long | False | Attribute | |
| CallStartTime | Start time | startTime | Long | False | Attribute | |
| CallStatus | Status | status | CallStatus | False | Segment | Predicate values / display values: RECEIVED / Received MISSED / Missed UNKNOWN / unknown |
| CallType | Call type | callType | CallType | False | Segment | Predicate values / display values: GOOGLE_SEARCH / Manually dialed HIGH_END_MOBILE_SEARCH / Mobile click-to-call UNKNOWN / unknown |
| CallerCountryCallingCode | Caller country code | callerCountryCode | String | False | Attribute | |
| CallerNationalDesignatedCode | Caller area code | callerAreaCode | String | False | Attribute | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| OfflineInteractionCost | Phone cost | phoneCost | Money | False | Metric | |
| PrimaryCompanyName | Company name | companyName | String | False | Attribute |
Campaign Performance Report
The Campaigns Performance report includes all statistics aggregated by default at the campaign level, one row per campaign. If other segment fields are used, you may get more than one row per campaign. See segmentation for more information.
ReportType:
CAMPAIGN_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AdvertiserExperimentSegmentationBin | ACE split | aCESplit | AdvertiserExperimentSegmentationBin | True | Segment | Predicate values / display values: OUTSIDE_OF_EXPERIMENT / outside experiment CONTROL / control EXPERIMENT / experiment |
| AdvertisingChannelSubType | Advertising Sub Channel | advertisingSubChannel | AdvertisingChannelSubType | True | Attribute | Predicate values / display values: UNKNOWN / Unknown SEARCH_MOBILE_APP / Search Mobile App DISPLAY_MOBILE_APP / Display Mobile App SEARCH_EXPRESS / Search Express DISPLAY_EXPRESS / Display Express |
| AdvertisingChannelType | Advertising Channel | advertisingChannel | AdvertisingChannelType | True | Attribute | Predicate values / display values: UNKNOWN / unknown SEARCH / Search DISPLAY / Display SHOPPING / Shopping |
| Amount | Budget | budget | Money | True | Attribute | |
| AssistClicks | Assist Clicks | assistClicks | Long | True | Metric | |
| AssistImpressions | Assist Impr. | assistImpr | Long | True | Metric | |
| AssistImpressionsOverLastClicks | Assist Impr. / Last Clicks | assistImprLastClicks | Double | True | Metric | |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePageviews | Pages / visit | pagesVisit | Double | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| AverageTimeOnSite | Avg. visit duration (seconds) | avgVisitDurationSeconds | Double | True | Metric | |
| AvgCostForOfflineInteraction | Avg. CPP | avgCPP | Money | True | Metric | |
| BidType | Conversion optimizer bid type | conversionOptimizerBidType | BidType | True | Attribute | Predicate values / display values: TARGET_CPA / target cpa |
| BiddingStrategyId | Bid Strategy ID | bidStrategyID | Long | True | Attribute | |
| BiddingStrategyName | Bid Strategy Name | bidStrategyName | String | True | Attribute | |
| BiddingStrategyType | Bid Strategy Type | bidStrategyType | BiddingStrategyType | True | Attribute | Predicate values / display values: BUDGET_OPTIMIZER / auto CONVERSION_OPTIMIZER / max/target cpa MANUAL_CPC / cpc MANUAL_CPM / cpm PAGE_ONE_PROMOTED / Target search page location TARGET_SPEND / Maximize clicks ENHANCED_CPC / Enhanced CPC TARGET_CPA / Target CPA TARGET_ROAS / Target ROAS NONE / None UNKNOWN / unknown |
| BounceRate | Bounce rate | bounceRate | Double | True | Metric | |
| BudgetId | Budget ID | budgetID | Long | True | Attribute | |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickAssistedConversionValue | Click Assisted Conv. Value | clickAssistedConvValue | Double | True | Metric | |
| ClickAssistedConversions | Click Assisted Conv. | clickAssistedConv | Long | True | Metric | |
| ClickAssistedConversionsOverLastClickConversions | Click Assisted Conv. / Last Click Conv. | clickAssistedConvLastClickConv | Double | True | Metric | |
| ClickSignificance | Clicks ACE indicator | clicksACEIndicator | SignificanceData | True | Metric | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ContentBudgetLostImpressionShare | Content Lost IS (budget) | contentLostISBudget | Double | True | Metric | |
| ContentImpressionShare | Content Impr. share | contentImprShare | Double | True | Metric | |
| ContentRankLostImpressionShare | Content Lost IS (rank) | contentLostISRank | Double | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionManyPerClickSignificance | Conversion ACE indicator | conversionACEIndicator | SignificanceData | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClickSignificance | Conversion rate ACE indicator | conversionRateACEIndicator | SignificanceData | True | Metric | |
| ConversionRateSignificance | Click conversion rate ACE indicator | clickConversionRateACEIndicator | SignificanceData | True | Metric | |
| ConversionSignificance | Converted clicks ACE indicator | convertedClicksACEIndicator | SignificanceData | True | Metric | |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CostPerConversionManyPerClickSignificance | Cost/conversion ACE indicator | costConversionACEIndicator | SignificanceData | True | Metric | |
| CostPerConversionSignificance | Cost/converted click ACE indicator | costConvertedClickACEIndicator | SignificanceData | True | Metric | |
| CostPerEstimatedTotalConversion | Cost / est. total conv. | costEstTotalConv | Double | True | Metric | |
| CostSignificance | Cost ACE indicator | costACEIndicator | SignificanceData | True | Metric | |
| CpcSignificance | CPC ACE indicator | cPCACEIndicator | SignificanceData | True | Metric | |
| CpmSignificance | CPM ACE indicator | cPMACEIndicator | SignificanceData | True | Metric | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CtrSignificance | CTR ACE indicator | cTRACEIndicator | SignificanceData | True | Metric | |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| EnhancedCpcEnabled | Enhanced CPC enabled | enhancedCPCEnabled | Boolean | True | Attribute | |
| EstimatedCrossDeviceConversions | Est. cross-device conv. | estCrossDeviceConv | Long | True | Metric | |
| EstimatedTotalConversionRate | Est. total conv. rate | estTotalConvRate | Double | True | Metric | |
| EstimatedTotalConversionValue | Est. total conv. value | estTotalConvValue | Double | True | Metric | |
| EstimatedTotalConversionValuePerClick | Est. total conv. value / click | estTotalConvValueClick | Double | True | Metric | |
| EstimatedTotalConversionValuePerCost | Est. total conv. value / cost | estTotalConvValueCost | Double | True | Metric | |
| EstimatedTotalConversions | Est. total conv. | estTotalConv | Long | True | Metric | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| HourOfDay | Hour of day | hourOfDay | Integer | False | Segment | |
| Id | Campaign ID | campaignID | Long | True | Attribute | |
| ImpressionAssistedConversionValue | Impr. Assisted Conv. Value | imprAssistedConvValue | Double | True | Metric | |
| ImpressionAssistedConversions | Impr. Assisted Conv. | imprAssistedConv | Long | True | Metric | |
| ImpressionAssistedConversionsOverLastClickConversions | Impr. Assisted Conv. / Last Click Conv. | imprAssistedConvLastClickConv | Double | True | Metric | |
| ImpressionSignificance | Impressions ACE indicator | impressionsACEIndicator | SignificanceData | True | Metric | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| InvalidClickRate | Invalid click rate | invalidClickRate | Double | True | Metric | Percentage returned as "x.xx%". |
| InvalidClicks | Invalid clicks | invalidClicks | Long | True | Metric | |
| IsBudgetExplicitlyShared | Budget explicitly shared | budgetExplicitlyShared | Boolean | True | Attribute | |
| LabelIds | Label IDs | labelIDs | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| Labels | Labels | labels | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 |
| Name | Campaign | campaign | String | True | Attribute | |
| NumOfflineImpressions | Phone impressions | phoneImpressions | Long | True | Metric | |
| NumOfflineInteractions | Phone calls | phoneCalls | Long | True | Metric | |
| OfflineInteractionCost | Phone cost | phoneCost | Money | True | Metric | |
| OfflineInteractionRate | PTR | ptr | Double | True | Metric | |
| PercentNewVisitors | % new visits | newVisits | Double | True | Metric | |
| Period | Budget period | budgetPeriod | BudgetPeriod | True | Attribute | |
| PositionSignificance | Position ACE indicator | positionACEIndicator | SignificanceData | True | Metric | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| RelativeCtr | Relative CTR | relativeCTR | Double | True | Metric | |
| SearchBudgetLostImpressionShare | Search Lost IS (budget) | searchLostISBudget | Double | True | Metric | |
| SearchExactMatchImpressionShare | Search Exact match IS | searchExactMatchIS | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the field ClickType. |
| SearchImpressionShare | Search Impr. share | searchImprShare | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the fields ClickType and HourOfDay on any report. Not compatible with the field Device on the Product Partition Report. |
| SearchRankLostImpressionShare | Search Lost IS (rank) | searchLostISRank | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the field ClickType. |
| ServingStatus | Campaign serving status | campaignServingStatus | ServingStatus | True | Attribute | Predicate values / display values: SERVING / eligible NONE / none ENDED / ended PENDING / pending SUSPENDED / suspended |
| Slot | Top vs. Other | topVsOther | Slot | True | Segment | 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 / |
| Status | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| TotalBudget | Budget | budget | Money | True | Attribute | |
| TotalCost | Total cost | totalCost | Money | True | Metric | |
| TrackingUrlTemplate | Tracking template | trackingTemplate | String | True | Attribute | |
| UrlCustomParameters | Custom parameter | customParameter | CustomParameters | True | Attribute | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ValuePerEstimatedTotalConversion | Value / est. total conv. | valueEstTotalConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| ViewThroughConversionsSignificance | View-through conv. ACE indicator | viewThroughConvACEIndicator | SignificanceData | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Campaign Ad Schedule Target Report
ReportType:
CAMPAIGN_AD_SCHEDULE_TARGET_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| BidModifier | Bid adj. | bidAdj | Double | True | Attribute | |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Ad Schedule | adSchedule | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Campaign Location Target Report
ReportType:
CAMPAIGN_LOCATION_TARGET_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| BidModifier | Bid adj. | bidAdj | Double | True | Attribute | |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Location | location | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Campaign Negative Keywords Performance Report
Although negative keywords do not hold statistics, a report called Campaign Negative Keywords Performance report is available in the API to retrieve a structured report.
ReportType:
CAMPAIGN_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Keyword ID | keywordID | Long | True | Attribute | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| KeywordMatchType | Match type | matchType | KeywordMatchType | True | Attribute | Predicate values / display values: EXACT / Exact PHRASE / Phrase BROAD / Broad |
| KeywordText | Negative keyword | negativeKeyword | String | True | Attribute | |
| PlacementUrl | Negative keyword | negativeKeyword | String | True | Attribute | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute | |
| UserListId | Negative keyword | negativeKeyword | Long | True | Attribute |
Campaign Negative Locations Report
Although negative locations do not hold statistics, a report called Campaign Negative Locations is available in the API to retrieve a structured report.
ReportType:
CAMPAIGN_NEGATIVE_LOCATIONS_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Location | location | Long | True | Attribute | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute |
Campaign Negative Placements Performance Report
Although negative placements do not hold statistics, a report called Campaign Negative Placements Performance report is available in the API to retrieve this structured report.
ReportType:
CAMPAIGN_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| DisplayName | Criteria Display Name | criteriaDisplayName | String | True | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Keyword ID | keywordID | Long | True | Attribute | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| KeywordMatchType | Match type | matchType | KeywordMatchType | True | Attribute | Predicate values / display values: EXACT / Exact PHRASE / Phrase BROAD / Broad |
| KeywordText | Exclusion | exclusion | String | True | Attribute | |
| PlacementUrl | Exclusion | exclusion | String | True | Attribute | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute | |
| UserListId | Exclusion | exclusion | Long | True | Attribute |
Campaign Platform Target Report
ReportType:
CAMPAIGN_PLATFORM_TARGET_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| BidModifier | Bid adj. | bidAdj | Double | True | Attribute | |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Platform | platform | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Campaign Reach Frequency Report
The Campaign Reach Frequency report includes all stats aggregated at the ad group level, one row per campaign. This report can also be segmented by date and frequency using ReachFrequencyDate and ReachFrequency respectively. See segmentation for more information. Visit this help center page to learn more about measuring reach and frequency.
ReportType:
CAMPAIGN_REACH_FREQUENCY_REPORTNote: This report is deprecated and only available in v201406 or earlier.
| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| PrimaryCompanyName | Company name | companyName | String | False | Attribute | |
| ReachFrequency | Frequency | frequency | Integer | False | Attribute | |
| ReachFrequencyClicks | Clicks | clicks | Double | False | Metric | |
| ReachFrequencyConv | Conv. | conv | Double | False | Metric | |
| ReachFrequencyConvRate | Conv. rate | convRate | Double | False | Metric | |
| ReachFrequencyCtr | CTR | ctr | Double | False | Metric | |
| ReachFrequencyDate | Day | day | Date | False | Segment | |
| UniqueUserCountAsLong | Unique Users | uniqueUsers | Long | False | Metric |
Campaign Shared Set Report
The Campaign Shared Set report includes all relationships between SharedSets and campaigns.
ReportType:
CAMPAIGN_SHARED_SET_REPORTNote: The Shared Sets feature is available only to existing whitelisted users.
| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| SharedSetName | Shared Set Name | sharedSetName | String | False | Attribute | |
| SharedSetType | Shared Set Type | sharedSetType | SharedSetType | False | Attribute | Predicate values / display values: NEGATIVE_KEYWORDS / NEGATIVE_PLACEMENTS / UNKNOWN / unknown |
| Status | State | state | Status | False | Attribute | Predicate values / display values: ENABLED / Enabled REMOVED / Removed UNKNOWN / unknown |
Click Performance Report
The Click Performance report includes stats aggregated at each click level. The KeywordId field will return any criteria that triggered the click, not just keywords. This report can be run only for a single day.
ReportType:
CLICK_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AdFormat | Ad type | adType | AdFormat | False | Segment | Predicate values / display values: UNKNOWN / unknown TEXT / text IMAGE / image DYNAMIC_IMAGE / dynamic_image FLASH / flash VIDEO / video HTML / html AUDIO / audio COMPOSITE / composite PRINT / print |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdNetworkType1 | Network | network | AdNetworkType1 | False | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | False | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CityCriteriaId | City | city | Integer | False | Attribute | Name of the city as a string. |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| CountryCriteriaId | Country/Territory | countryTerritory | Integer | False | Attribute | Name of the country as a string. |
| CreativeId | Ad ID | adID | Long | False | Attribute | |
| CriteriaId | Keyword ID | keywordID | Long | False | Attribute | |
| CriteriaParameters | Keyword / Placement | keywordPlacement | String | False | Attribute | In the Destination URL report, this field behaves as a segment. |
| Date | Day | day | Date | False | Segment | |
| Device | Device | device | DeviceType | False | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| GclId | Google Click ID | googleClickID | String | False | Attribute | |
| MetroCriteriaId | Metro area | metroArea | Integer | False | Attribute | Name of the metro as a string. |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | False | Segment | 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 |
| Page | Page | page | Integer | False | Attribute | |
| RegionCriteriaId | Region | region | Integer | False | Attribute | Name of the region as a string. |
| Slot | Top vs. Other | topVsOther | Slot | False | Segment | 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 / |
| UserListId | User List ID | userListID | Long | False | Attribute |
Creative Conversion Report
Free clicks are interactions that take place before a clickthrough for video ads, display ads, product extensions and location extensions, interactions like a "Video play" or a "Get directions". Visit this help page to learn more about free clicks.
ReportType:
CREATIVE_CONVERSION_REPORTThis report is called "Free clicks" in the AdWords web interface.
| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdNetworkType1 | Network | network | AdNetworkType1 | False | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | False | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| ConversionRate | Free click rate | freeClickRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionTrackerId | Free click type | freeClickType | Long | False | Segment | |
| Conversions | Free clicks | freeClicks | Long | False | Metric | |
| CreativeId | Ad ID | adID | Long | False | Attribute | |
| CriteriaParameters | Keyword / Placement | keywordPlacement | String | False | Attribute | In the Destination URL report, this field behaves as a segment. |
| CriteriaTypeName | Match type | matchType | String | False | Attribute | |
| CriterionId | Keyword ID | keywordID | Long | False | Attribute | |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| Date | Day | day | Date | False | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | False | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| Impressions | Impressions | impressions | Long | False | Metric | |
| Month | Month | month | String | False | Segment | |
| PrimaryCompanyName | Company name | companyName | String | False | Attribute | |
| Quarter | Quarter | quarter | String | False | Segment | |
| Week | Week | week | String | False | Segment | |
| Year | Year | year | Integer | False | Segment |
Criteria Performance Report
The Criteria Performance report includes statistics aggregated at the ad group criteria level, one row per ad group and criteria combination. If other segment fields are used, you may get more than one row per criteria. See segmentation for more information. This is a single attribution report. The KeywordId field will return any criteria that triggered the ad, not just keywords with the exception of keyword ID 3000000.
Note : The Display Network tab in the AdWords reports in the User Interface (UI) is multiple attribution. There might be a different number from this report due to how the impressions are counted between single vs multiple attribution.
ReportType:
CRITERIA_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AdvertiserExperimentSegmentationBin | ACE split | aCESplit | AdvertiserExperimentSegmentationBin | True | Segment | Predicate values / display values: OUTSIDE_OF_EXPERIMENT / outside experiment CONTROL / control EXPERIMENT / experiment |
| ApprovalStatus | Approval Status | approvalStatus | ApprovalStatus | True | Attribute | Predicate values / display values: APPROVED / approved PENDING_REVIEW / pending review UNDER_REVIEW / under review DISAPPROVED / disapproved |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| BidModifier | Bid adj. | bidAdj | Double | True | Attribute | |
| BidType | Conversion optimizer bid type | conversionOptimizerBidType | BidType | True | Attribute | Predicate values / display values: TARGET_CPA / target cpa |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickSignificance | Clicks ACE indicator | clicksACEIndicator | SignificanceData | True | Metric | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionManyPerClickSignificance | Conversion ACE indicator | conversionACEIndicator | SignificanceData | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClickSignificance | Conversion rate ACE indicator | conversionRateACEIndicator | SignificanceData | True | Metric | |
| ConversionRateSignificance | Click conversion rate ACE indicator | clickConversionRateACEIndicator | SignificanceData | True | Metric | |
| ConversionSignificance | Converted clicks ACE indicator | convertedClicksACEIndicator | SignificanceData | True | Metric | |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CostPerConversionManyPerClickSignificance | Cost/conversion ACE indicator | costConversionACEIndicator | SignificanceData | True | Metric | |
| CostPerConversionSignificance | Cost/converted click ACE indicator | costConvertedClickACEIndicator | SignificanceData | True | Metric | |
| CostSignificance | Cost ACE indicator | costACEIndicator | SignificanceData | True | Metric | |
| CpcBid | Max. CPC | maxCPC | Money | True | Attribute | |
| CpcBidSource | Max CPC source | maxCPCSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| CpcSignificance | CPC ACE indicator | cPCACEIndicator | SignificanceData | True | Metric | |
| CpmBid | Max. CPM | maxCPM | Money | True | Attribute | |
| CpmSignificance | CPM ACE indicator | cPMACEIndicator | SignificanceData | True | Metric | |
| Criteria | Keyword / Placement | keywordPlacement | String | True | Attribute | |
| CriteriaDestinationUrl | Keyword/Placement destination URL | keywordPlacementDestinationURL | String | True | Attribute | In the Destination URL report, this field behaves as a segment. |
| CriteriaType | Criteria Type | criteriaType | Type | True | Attribute | Predicate values / display values: CONTENT_LABEL / Content Label KEYWORD / Keyword PLACEMENT / Placement VERTICAL / Vertical USER_LIST / User List USER_INTEREST / User Interest MOBILE_APPLICATION / Mobile Application MOBILE_APP_CATEGORY / Mobile App Category PRODUCT / Product PRODUCT_PARTITION / Product Partition IP_BLOCK / IP Block WEBPAGE / Webpage LANGUAGE / Language LOCATION / Location AGE_RANGE / Age CARRIER / Carrier OPERATING_SYSTEM_VERSION / Operating System Version MOBILE_DEVICE / Mobile Device GENDER / Gender PROXIMITY / Proximity PLATFORM / Platform AD_SCHEDULE / Ad Schedule LOCATION_GROUPS / Location Groups PRODUCT_SCOPE / Product Scope APP_PAYMENT_MODEL / App Payment Model UNKNOWN / unknown |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CtrSignificance | CTR ACE indicator | cTRACEIndicator | SignificanceData | True | Metric | |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| DisplayName | Criteria Display Name | criteriaDisplayName | String | True | Attribute | |
| EnhancedCpcEnabled | Enhanced CPC enabled | enhancedCPCEnabled | Boolean | True | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| FinalAppUrls | App final URL | appFinalURL | AppUrlList | True | Attribute | |
| FinalMobileUrls | Mobile final URL | mobileFinalURL | UrlList | True | Attribute | |
| FinalUrls | Final URL | finalURL | UrlList | True | Attribute | |
| FirstPageCpc | First page CPC | firstPageCPC | Bid | True | Attribute | Usually a number in micros, but may be prefixed with "auto: " or may simply be the string "auto" if automatic bidding is used. |
| Id | Keyword ID | keywordID | Long | True | Attribute | |
| ImpressionSignificance | Impressions ACE indicator | impressionsACEIndicator | SignificanceData | True | Metric | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| LabelIds | Label IDs | labelIDs | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| Labels | Labels | labels | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 |
| Parameter | Dynamic ad target | dynamicAdTarget | WebpageParameter | True | Attribute | |
| PositionSignificance | Position ACE indicator | positionACEIndicator | SignificanceData | True | Metric | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute | |
| QualityScore | Quality score | qualityScore | Integer | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Slot | Top vs. Other | topVsOther | Slot | True | Segment | 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 / |
| Status | Keyword/Placement state | keywordPlacementState | UserStatus | True | Attribute | Predicate values / display values: ENABLED / enabled REMOVED / removed PAUSED / paused |
| TopOfPageCpc | Top of page CPC | topOfPageCPC | Bid | True | Attribute | Usually a number in micros, but may be prefixed with "auto: " or may simply be the string "auto" if automatic bidding is used. |
| TrackingUrlTemplate | Tracking template | trackingTemplate | String | True | Attribute | |
| UrlCustomParameters | Custom parameter | customParameter | CustomParameters | True | Attribute | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| ViewThroughConversionsSignificance | View-through conv. ACE indicator | viewThroughConvACEIndicator | SignificanceData | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Destination URL Report
The Destination URL report includes all statistics aggregated at the destination URL level, one row per destination URL (specified on the keyword or the ad). If other segment fields are used, you may get more than one row per placement. See segmentation for more information.
ReportType:
DESTINATION_URL_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionTrackerId | Conversion Tracker Id | conversionTrackerId | Long | False | Segment | |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CriteriaDestinationUrl | Keyword/Placement destination URL | keywordPlacementDestinationURL | String | False | Attribute | In the Destination URL report, this field behaves as a segment. |
| CriteriaParameters | Keyword / Placement | keywordPlacement | String | False | Attribute | In the Destination URL report, this field behaves as a segment. |
| CriteriaStatus | Keyword/Placement state | keywordPlacementState | UserStatus | False | Attribute | In the Destination URL report, this field behaves as a segment. Predicate values / display values: ENABLED / enabled REMOVED / removed PAUSED / paused |
| CriteriaTypeName | Match type | matchType | String | False | Attribute | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| EffectiveDestinationUrl | Destination URL | destinationURL | String | True | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | False | Attribute | |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Slot | Top vs. Other | topVsOther | Slot | True | Segment | 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 / |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Display Keyword Performance Report
The Display Keyword Performance report includes all display network statistics aggregated at the keyword level, one row per keyword. If other segment fields are used, you may get more than one row per keyword. See segmentation for more information. This is a multiple attribution report.
ReportType:
DISPLAY_KEYWORD_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| BidType | Conversion optimizer bid type | conversionOptimizerBidType | BidType | True | Attribute | Predicate values / display values: TARGET_CPA / target cpa |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CpcBid | Max. CPC | maxCPC | Money | True | Attribute | |
| CpcBidSource | Max CPC source | maxCPCSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| CpmBid | Max. CPM | maxCPM | Money | True | Attribute | |
| CpmBidSource | Max CPM Source | maxCPMSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| CriteriaDestinationUrl | Destination URL | destinationURL | String | True | Attribute | In the Destination URL report, this field behaves as a segment. |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DestinationUrl | Destination URL | destinationURL | String | True | Attribute | |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Keyword ID | keywordID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| IsRestrict | Is restricting | isRestricting | boolean | True | Attribute | Defines if criterion is used for targeting (true) or bidding only (false). |
| KeywordText | Keyword | keyword | String | True | Attribute | |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Status | Keyword state | keywordState | UserStatus | True | Attribute | Predicate values / display values: ENABLED / enabled REMOVED / removed PAUSED / paused |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Display Topics Performance Report
The Display Topics Performance report includes all display network statistics aggregated at the topic level, one row per topic. If other segment fields are used, you may get more than one row per topic. See segmentation for more information. This is a multiple attribution report.
ReportType:
DISPLAY_TOPICS_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| BidModifier | Bid adj. | bidAdj | Double | True | Attribute | |
| BidType | Conversion optimizer bid type | conversionOptimizerBidType | BidType | True | Attribute | Predicate values / display values: TARGET_CPA / target cpa |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CpcBid | Max. CPC | maxCPC | Money | True | Attribute | |
| CpcBidSource | Max CPC source | maxCPCSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| CpmBid | Max. CPM | maxCPM | Money | True | Attribute | |
| CpmBidSource | Max CPM Source | maxCPMSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| Criteria | Topic | topic | String | True | Attribute | |
| CriteriaDestinationUrl | Destination URL | destinationURL | String | True | Attribute | In the Destination URL report, this field behaves as a segment. |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DestinationUrl | Destination URL | destinationURL | String | True | Attribute | |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Criterion ID | criterionID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| IsRestrict | Is restricting | isRestricting | boolean | True | Attribute | Defines if criterion is used for targeting (true) or bidding only (false). |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Status | Topic state | topicState | UserStatus | True | Attribute | Predicate values / display values: ENABLED / enabled REMOVED / removed PAUSED / paused |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Gender Performance Report
The Gender Performance report includes all statistics aggregated by gender. It also includes automatic audience performance. If other segment fields are used, you may get more than one row per gender. See segmentation for more information. This is a multi attribution report.
ReportType:
GENDER_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| BidModifier | Bid adj. | bidAdj | Double | True | Attribute | |
| BidType | Conversion optimizer bid type | conversionOptimizerBidType | BidType | True | Attribute | Predicate values / display values: TARGET_CPA / target cpa |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CpcBid | Max. CPC | maxCPC | Money | True | Attribute | |
| CpcBidSource | Max CPC source | maxCPCSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| CpmBid | Max. CPM | maxCPM | Money | True | Attribute | |
| CpmBidSource | Max CPM Source | maxCPMSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| Criteria | Gender | gender | String | True | Attribute | |
| CriteriaDestinationUrl | Destination URL | destinationURL | String | True | Attribute | In the Destination URL report, this field behaves as a segment. |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DestinationUrl | Destination URL | destinationURL | String | True | Attribute | |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Criterion ID | criterionID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| IsRestrict | Is restricting | isRestricting | boolean | True | Attribute | Defines if criterion is used for targeting (true) or bidding only (false). |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Status | Gender state | genderState | UserStatus | True | Attribute | Predicate values / display values: ENABLED / enabled REMOVED / removed PAUSED / paused |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Geo Performance Report
The Geo Performance report includes all statistics aggregated at the country/territory level, one row per country/territory. If other segment fields are used, you may get more than one row per placement. See segmentation for more information. This is a single attribution report.
ReportType:
GEO_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdFormat | Ad type | adType | AdFormat | False | Segment | Predicate values / display values: UNKNOWN / unknown TEXT / text IMAGE / image DYNAMIC_IMAGE / dynamic_image FLASH / flash VIDEO / video HTML / html AUDIO / audio COMPOSITE / composite PRINT / print |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | False | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | False | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | False | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | False | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | False | Metric | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| CityCriteriaId | City | city | Integer | False | Attribute | Name of the city as a string. |
| Clicks | Clicks | clicks | Long | False | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionTrackerId | Conversion Tracker Id | conversionTrackerId | Long | False | Segment | |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | False | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | False | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | False | Metric | |
| Cost | Cost | cost | Money | False | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | False | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | False | Metric | |
| CountryCriteriaId | Country/Territory | countryTerritory | Integer | False | Attribute | Name of the country as a string. |
| Ctr | CTR | ctr | Double | False | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| Date | Day | day | Date | False | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | False | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | False | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| Impressions | Impressions | impressions | Long | False | Metric | |
| IsTargetingLocation | Is Targetable | isTargetable | Boolean | False | Attribute | |
| LocationType | Location type | locationType | GeoTargetType | False | Segment | Predicate values / display values: AREA_OF_INTEREST / Location of interest LOCATION_OF_PRESENCE / Physical location UNKNOWN / unknown |
| MetroCriteriaId | Metro area | metroArea | Integer | False | Attribute | Name of the metro as a string. |
| Month | Month | month | String | False | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | False | Segment | 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 |
| MostSpecificCriteriaId | Most specific location | mostSpecificLocation | Long | False | Attribute | |
| PrimaryCompanyName | Company name | companyName | String | False | Attribute | |
| Quarter | Quarter | quarter | String | False | Segment | |
| RegionCriteriaId | Region | region | Integer | False | Attribute | Name of the region as a string. |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | False | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | False | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | False | Metric | |
| Week | Week | week | String | False | Segment | |
| Year | Year | year | Integer | False | Segment |
Keywordless Category Report
The Keywordless Category Performance report includes keywordless ads (dynamic search ads) statistics aggregated by category.
ReportType:
KEYWORDLESS_CATEGORY_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AverageCpc | Avg. CPC | avgCPC | Money | False | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | False | Metric | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| Category0 | Top level categories | topLevelCategories | String | False | Attribute | |
| Category1 | First level sub-categories | firstLevelSubCategories | String | False | Attribute | |
| Category2 | Second level sub-categories | secondLevelSubCategories | String | False | Attribute | |
| Clicks | Clicks | clicks | Long | False | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | False | Metric | Percentage returned as "x.xx%". |
| Conversions | Converted clicks | convertedClicks | Long | False | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | False | Metric | |
| Cost | Cost | cost | Money | False | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | False | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | False | Metric | |
| CriterionId | Keyword ID | keywordID | Long | False | Attribute | |
| Ctr | CTR | ctr | Double | False | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| Date | Day | day | Date | False | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | False | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Domain | Domain | domain | String | False | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| Impressions | Impressions | impressions | Long | False | Metric | |
| Month | Month | month | String | False | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | False | Segment | 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 | companyName | String | False | Attribute | |
| Quarter | Quarter | quarter | String | False | Segment | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | False | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | False | Metric | |
| Week | Week | week | String | False | Segment | |
| Year | Year | year | Integer | False | Segment |
Keywordless Query Report
The Keywordless Query report includes keywordless ads (dynamic search ads) statistics based on search terms.
ReportType:
KEYWORDLESS_QUERY_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AverageCpc | Avg. CPC | avgCPC | Money | False | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | False | Metric | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| CategoryPaths | Categories | categories | String | False | Attribute | |
| Clicks | Clicks | clicks | Long | False | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | False | Metric | Percentage returned as "x.xx%". |
| Conversions | Converted clicks | convertedClicks | Long | False | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | False | Metric | |
| Cost | Cost | cost | Money | False | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | False | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | False | Metric | |
| CriterionId | Keyword ID | keywordID | Long | False | Attribute | |
| Ctr | CTR | ctr | Double | False | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| Date | Day | day | Date | False | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | False | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Domain | Domain | domain | String | False | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| Impressions | Impressions | impressions | Long | False | Metric | |
| Line1 | Dynamically generated Headline | dynamicallyGeneratedHeadline | String | False | Attribute | |
| Month | Month | month | String | False | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | False | Segment | 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 | companyName | String | False | Attribute | |
| Quarter | Quarter | quarter | String | False | Segment | |
| Query | Search term | searchTerm | String | False | Attribute | If the string for this attribute is longer than 128 char bytes, the returned result will NOT be a single aggregated row. |
| Title | Landing Page Title | landingPageTitle | String | False | Attribute | |
| Url | URL | url | String | False | Attribute | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | False | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | False | Metric | |
| Week | Week | week | String | False | Segment | |
| Year | Year | year | Integer | False | Segment |
Keywords Performance Report
The Keywords Performance report includes all statistics aggregated at the keyword level, one row per keyword. If other segment fields are used, you may get more than one row per keyword. See segmentation for more information. This is a single attribution report. If a keyword triggers an ad on Display Network, the ID is represented as ID 3000000.
ReportType:
KEYWORDS_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AdvertiserExperimentSegmentationBin | ACE split | aCESplit | AdvertiserExperimentSegmentationBin | True | Segment | Predicate values / display values: OUTSIDE_OF_EXPERIMENT / outside experiment CONTROL / control EXPERIMENT / experiment |
| ApprovalStatus | Approval Status | approvalStatus | ApprovalStatus | True | Attribute | Predicate values / display values: APPROVED / approved PENDING_REVIEW / pending review UNDER_REVIEW / under review DISAPPROVED / disapproved |
| AssistClicks | Assist Clicks | assistClicks | Long | True | Metric | |
| AssistImpressions | Assist Impr. | assistImpr | Long | True | Metric | |
| AssistImpressionsOverLastClicks | Assist Impr. / Last Clicks | assistImprLastClicks | Double | True | Metric | |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePageviews | Pages / visit | pagesVisit | Double | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| AverageTimeOnSite | Avg. visit duration (seconds) | avgVisitDurationSeconds | Double | True | Metric | |
| BidType | Conversion optimizer bid type | conversionOptimizerBidType | BidType | True | Attribute | Predicate values / display values: TARGET_CPA / target cpa |
| BiddingStrategyId | Bid Strategy ID | bidStrategyID | Long | True | Attribute | |
| BiddingStrategyName | Bid Strategy Name | bidStrategyName | String | True | Attribute | |
| BiddingStrategyType | Bid Strategy Type | bidStrategyType | BiddingStrategyType | True | Attribute | Predicate values / display values: BUDGET_OPTIMIZER / auto CONVERSION_OPTIMIZER / max/target cpa MANUAL_CPC / cpc MANUAL_CPM / cpm PAGE_ONE_PROMOTED / Target search page location TARGET_SPEND / Maximize clicks ENHANCED_CPC / Enhanced CPC TARGET_CPA / Target CPA TARGET_ROAS / Target ROAS NONE / None UNKNOWN / unknown |
| BounceRate | Bounce rate | bounceRate | Double | True | Metric | |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickAssistedConversionValue | Click Assisted Conv. Value | clickAssistedConvValue | Double | True | Metric | |
| ClickAssistedConversions | Click Assisted Conv. | clickAssistedConv | Long | True | Metric | |
| ClickAssistedConversionsOverLastClickConversions | Click Assisted Conv. / Last Click Conv. | clickAssistedConvLastClickConv | Double | True | Metric | |
| ClickSignificance | Clicks ACE indicator | clicksACEIndicator | SignificanceData | True | Metric | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionManyPerClickSignificance | Conversion ACE indicator | conversionACEIndicator | SignificanceData | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClickSignificance | Conversion rate ACE indicator | conversionRateACEIndicator | SignificanceData | True | Metric | |
| ConversionRateSignificance | Click conversion rate ACE indicator | clickConversionRateACEIndicator | SignificanceData | True | Metric | |
| ConversionSignificance | Converted clicks ACE indicator | convertedClicksACEIndicator | SignificanceData | True | Metric | |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CostPerConversionManyPerClickSignificance | Cost/conversion ACE indicator | costConversionACEIndicator | SignificanceData | True | Metric | |
| CostPerConversionSignificance | Cost/converted click ACE indicator | costConvertedClickACEIndicator | SignificanceData | True | Metric | |
| CostSignificance | Cost ACE indicator | costACEIndicator | SignificanceData | True | Metric | |
| CpcBid | Max. CPC | maxCPC | Money | True | Attribute | |
| CpcBidSource | Max CPC source | maxCPCSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| CpcSignificance | CPC ACE indicator | cPCACEIndicator | SignificanceData | True | Metric | |
| CpmBid | Max. CPM | maxCPM | Money | True | Attribute | |
| CpmSignificance | CPM ACE indicator | cPMACEIndicator | SignificanceData | True | Metric | |
| CriteriaDestinationUrl | Destination URL | destinationURL | String | True | Attribute | In the Destination URL report, this field behaves as a segment. |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CtrSignificance | CTR ACE indicator | cTRACEIndicator | SignificanceData | True | Metric | |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DestinationUrl | Destination URL | destinationURL | String | True | Attribute | |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| EnhancedCpcEnabled | Enhanced CPC enabled | enhancedCPCEnabled | Boolean | True | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| FinalAppUrls | App final URL | appFinalURL | AppUrlList | True | Attribute | |
| FinalMobileUrls | Mobile final URL | mobileFinalURL | UrlList | True | Attribute | |
| FinalUrls | Final URL | finalURL | UrlList | True | Attribute | |
| FirstPageCpc | First page CPC | firstPageCPC | Bid | True | Attribute | Usually a number in micros, but may be prefixed with "auto: " or may simply be the string "auto" if automatic bidding is used. |
| Id | Keyword ID | keywordID | Long | True | Attribute | |
| ImpressionAssistedConversionValue | Impr. Assisted Conv. Value | imprAssistedConvValue | Double | True | Metric | |
| ImpressionAssistedConversions | Impr. Assisted Conv. | imprAssistedConv | Long | True | Metric | |
| ImpressionAssistedConversionsOverLastClickConversions | Impr. Assisted Conv. / Last Click Conv. | imprAssistedConvLastClickConv | Double | True | Metric | |
| ImpressionSignificance | Impressions ACE indicator | impressionsACEIndicator | SignificanceData | True | Metric | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| KeywordMatchType | Match type | matchType | KeywordMatchType | True | Attribute | Predicate values / display values: EXACT / Exact PHRASE / Phrase BROAD / Broad |
| KeywordText | Keyword | keyword | String | True | Attribute | |
| LabelIds | Label IDs | labelIDs | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| Labels | Labels | labels | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 |
| PercentNewVisitors | % new visits | newVisits | Double | True | Metric | |
| PlacementUrl | Keyword | keyword | String | True | Attribute | |
| PositionSignificance | Position ACE indicator | positionACEIndicator | SignificanceData | True | Metric | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute | |
| QualityScore | Quality score | qualityScore | Integer | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| SearchExactMatchImpressionShare | Search Exact match IS | searchExactMatchIS | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the field ClickType. |
| SearchImpressionShare | Search Impr. share | searchImprShare | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the fields ClickType and HourOfDay on any report. Not compatible with the field Device on the Product Partition Report. |
| SearchRankLostImpressionShare | Search Lost IS (rank) | searchLostISRank | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the field ClickType. |
| Slot | Top vs. Other | topVsOther | Slot | True | Segment | 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 / |
| Status | Keyword state | keywordState | UserStatus | True | Attribute | Predicate values / display values: ENABLED / enabled REMOVED / removed PAUSED / paused |
| TopOfPageCpc | Top of page CPC | topOfPageCPC | Bid | True | Attribute | Usually a number in micros, but may be prefixed with "auto: " or may simply be the string "auto" if automatic bidding is used. |
| TrackingUrlTemplate | Tracking template | trackingTemplate | String | True | Attribute | |
| UrlCustomParameters | Custom parameter | customParameter | CustomParameters | True | Attribute | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| ViewThroughConversionsSignificance | View-through conv. ACE indicator | viewThroughConvACEIndicator | SignificanceData | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Paid and Organic Query Report
The Paid and Organic Query report provides a holistic view of your search stats across ads and organic listings at the query level. This lets you analyze strengths and gaps in your overall search presence, and gives insight into how your paid and organic search listings work together to connect your business with people searching on Google.
ReportType:
PAID_ORGANIC_QUERY_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AverageCpc | Ad Avg. CPC | adAvgCPC | Money | False | Metric | |
| AveragePosition | Ad Avg. position | adAvgPosition | Double | False | Metric | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| Clicks | Ad Clicks | adClicks | Long | False | Metric | |
| CombinedAdsOrganicClicks | Combined Clicks | combinedClicks | Long | False | Metric | |
| CombinedAdsOrganicClicksPerQuery | Combined Clicks/Query | combinedClicksQuery | Double | False | Metric | |
| CombinedAdsOrganicQueries | Combined Queries | combinedQueries | Long | False | Metric | |
| Ctr | Ad CTR | adCTR | Double | False | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| Date | Day | day | Date | False | Segment | |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| Impressions | Ad Impressions | adImpressions | Long | False | Metric | |
| KeywordId | Keyword ID | keywordID | long | False | Attribute | In the Ad Performance Report this field contains the ID of the criterion that triggered the ad, segmenting the report and preventing zero impressions. The ID can be for any type of criterion, including placements, verticals, etc. Cross-reference with the Criteria Report to determine the criteria type and details. |
| KeywordTextMatchingQuery | Keyword | keyword | String | False | Attribute | |
| MatchType | Match type | matchType | QueryMatchType | False | Segment | Predicate values / display values: AUTO / auto BROAD / broad BROAD_SESSION / broad (session-based) EXACT / exact EXPANDED / broad PHRASE / phrase |
| OrganicAveragePosition | Organic Average Position | organicAveragePosition | Double | False | Metric | |
| OrganicClicks | Organic Clicks | organicClicks | Long | False | Metric | |
| OrganicClicksPerQuery | Organic Clicks/Query | organicClicksQuery | Double | False | Metric | |
| OrganicImpressions | Organic Listings | organicListings | Long | False | Metric | |
| OrganicImpressionsPerQuery | Organic Listings/Query | organicListingsQuery | Double | False | Metric | |
| OrganicQueries | Organic Queries | organicQueries | Long | False | Metric | |
| PrimaryCompanyName | Company name | companyName | String | False | Attribute | |
| SearchQuery | Query | query | String | False | Attribute | |
| SerpType | Search Result Type | searchResultType | SerpType | False | Segment | Predicate values / display values: UNKNOWN / unknown ADS_ONLY / Ad shown only ORGANIC_ONLY / Organic shown only ADS_AND_ORGANIC / Both shown |
Placeholder Report
The Placeholder Report provides statistics for feed-based ad extensions, one row per placeholder type. If other segment fields are used, you may get more than one row per placeholder type. See segmentation for more information.
ReportType:
PLACEHOLDER_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdNetworkType1 | Network | network | AdNetworkType1 | False | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | False | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | False | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | False | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | False | Metric | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | False | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | False | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | False | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | False | Metric | |
| Cost | Cost | cost | Money | False | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | False | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | False | Metric | |
| Ctr | CTR | ctr | Double | False | Metric | Percentage returned as "x.xx%". |
| Date | Day | day | Date | False | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | False | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | False | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| ExtensionPlaceholderCreativeId | Ad ID | adID | Long | False | Attribute | |
| ExtensionPlaceholderType | Feed placeholder type | feedPlaceholderType | int | False | Attribute | |
| Impressions | Impressions | impressions | Long | False | Metric | |
| Month | Month | month | String | False | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | False | Segment | 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 |
| Quarter | Quarter | quarter | String | False | Segment | |
| Slot | Top vs. Other | topVsOther | Slot | False | Segment | 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 / |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | False | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | False | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | False | Metric | |
| Week | Week | week | String | False | Segment | |
| Year | Year | year | Integer | False | Segment |
Placeholder Feed Item Report
The Placeholder Feed Item report includes all statistics at the feed-item level (e.g., a single sitelink). If other segment fields are used, you may get more than one row per feed item. See segmentation for more information.
The stats in the row for sitelink X show all clicks and costs when X was shown. This includes headline clicks on X, as well as clicks on other sitelinks and other ad extensions (e.g., a call extension) when X was also shown. Also included are the costs accrued by all clicks.
To see the clicks/costs/etc. for just sitelink X, use segment "IsSelfAction", and look at the "This extension" rows. To see a breakdown by type of click (e.g., headline vs. sitelink), use segment "ClickType".
ReportType:
PLACEHOLDER_FEED_ITEM_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdId | Ad ID | adID | Long | False | Attribute | |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AttributeValues | Attribute Values | attributeValues | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | True | Metric | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| DevicePreference | Device preference | devicePreference | FeedItemDevicePreference | True | Attribute | |
| EndTime | End date | endDate | DateTime | True | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| FeedId | Feed ID | feedID | Long | True | Attribute | |
| FeedItemId | Item ID | itemID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsSelfAction | This extension vs. Other | thisExtensionVsOther | Boolean | False | Attribute | |
| KeywordMatchType | Target keyword match type | targetKeywordMatchType | KeywordMatchType | True | Attribute | Predicate values / display values: EXACT / Exact PHRASE / Phrase BROAD / Broad |
| KeywordText | Target keyword text | targetKeywordText | String | True | Attribute | |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 |
| PlaceholderType | Feed placeholder type | feedPlaceholderType | Integer | True | Attribute | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Scheduling | Scheduling | scheduling | FeedItemScheduling | True | Attribute | |
| Slot | Top vs. Other | topVsOther | Slot | True | Segment | 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 / |
| StartTime | Start date | startDate | DateTime | True | Attribute | |
| Status | Item state | itemState | Status | True | Attribute | Predicate values / display values: ENABLED / Enabled REMOVED / Removed UNKNOWN / unknown |
| UrlCustomParameters | Custom parameter | customParameter | CustomParameters | True | Attribute | |
| ValidationDetails | Approval Status | approvalStatus | List | True | Attribute | List elements are delimited by the semicolon character (;) |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Placement Performance Report
The Placements Performance report includes all statistics aggregated at the placement level, one row per placement. If other segment fields are used, you may get more than one row per placement. See segmentation for more information. This is a multiple attribution report.
Use the isRestrict column to distinguish between placements you target vs. placements only used for bidding.
ReportType:
PLACEMENT_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | True | Attribute | |
| AccountDescriptiveName | Account | account | String | True | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | True | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | True | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | True | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| BidModifier | Bid adj. | bidAdj | Double | True | Attribute | |
| BidType | Conversion optimizer bid type | conversionOptimizerBidType | BidType | True | Attribute | Predicate values / display values: TARGET_CPA / target cpa |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | True | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CpcBid | Max. CPC | maxCPC | Money | True | Attribute | |
| CpcBidSource | Max CPC source | maxCPCSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| CpmBid | Max. CPM | maxCPM | Money | True | Attribute | |
| CpmBidSource | Max CPM Source | maxCPMSource | BidSource | True | Attribute | Predicate values / display values: ADGROUP / ad groups CRITERION / ad group criteria |
| CriteriaDestinationUrl | Destination URL | destinationURL | String | True | Attribute | In the Destination URL report, this field behaves as a segment. |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | True | Attribute | |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DestinationUrl | Destination URL | destinationURL | String | True | Attribute | |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| DisplayName | Criteria Display Name | criteriaDisplayName | String | True | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | True | Attribute | |
| Id | Criterion ID | criterionID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| IsRestrict | Is restricting | isRestricting | boolean | True | Attribute | Defines if criterion is used for targeting (true) or bidding only (false). |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 |
| PlacementUrl | Placement | placement | String | True | Attribute | |
| PrimaryCompanyName | Company name | companyName | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| Status | Placement state | placementState | UserStatus | True | Attribute | Predicate values / display values: ENABLED / enabled REMOVED / removed PAUSED / paused |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Product Partition Report
The Product Partition report provides shopping campaign statistics aggregated at the product partition
(Id field) level. If other segment fields are used, you may get more than one row per
product partition. For product-level results, see the
Shopping Performance Report.
- Results always reflect the current set of product partitions.
- An impression for a product will be attributed to the row for every product partition that contains the
product. For example, if a product with three impressions falls under leaf partition All products
-> Arts & Entertainment -> Hobbies & Creative Arts -> Party & Celebration, then
those three impressions will contribute to the Impressions count on four rows:
- All products
- Arts & Entertainment
- Hobbies & Creative Arts
- Party & Celebration
ReportType:
PRODUCT_PARTITION_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AdGroupId | Ad group ID | adGroupID | Long | True | Attribute | |
| AdGroupName | Ad group | adGroup | String | True | Attribute | |
| AverageCpc | Avg. CPC | avgCPC | Money | True | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | True | Metric | |
| BenchmarkAverageMaxCpc | Benchmark Max. CPC | benchmarkMaxCPC | Money | True | Metric | Not compatible with the field Device on the Product Partition Report. |
| BenchmarkCtr | Benchmark CTR | benchmarkCTR | Double | True | Metric | Not compatible with the field Device on the Product Partition Report. |
| CampaignId | Campaign ID | campaignID | Long | True | Attribute | |
| CampaignName | Campaign | campaign | String | True | Attribute | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | True | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | True | Metric | Percentage returned as "x.xx%". |
| ConversionValue | Total conv. value | totalConvValue | Double | True | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | True | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | True | Metric | |
| Cost | Cost | cost | Money | True | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | True | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | True | Metric | |
| CpcBid | Max. CPC | maxCPC | Money | True | Attribute | |
| CriteriaDestinationUrl | Keyword/Placement destination URL | keywordPlacementDestinationURL | String | True | Attribute | In the Destination URL report, this field behaves as a segment. |
| Ctr | CTR | ctr | Double | True | Metric | Percentage returned as "x.xx%". |
| Date | Day | day | Date | True | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | True | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DestinationUrl | Keyword/Placement destination URL | keywordPlacementDestinationURL | String | True | Attribute | |
| Device | Device | device | DeviceType | True | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| FinalAppUrls | App final URL | appFinalURL | AppUrlList | True | Attribute | |
| FinalMobileUrls | Mobile final URL | mobileFinalURL | UrlList | True | Attribute | |
| FinalUrls | Final URL | finalURL | UrlList | True | Attribute | |
| Id | Criterion ID | criterionID | Long | True | Attribute | |
| Impressions | Impressions | impressions | Long | True | Metric | |
| IsNegative | Is negative | isNegative | Boolean | True | Attribute | |
| Month | Month | month | String | True | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | True | Segment | 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 |
| ParentCriterionId | Parent Criterion ID | parentCriterionID | Long | True | Attribute | |
| PartitionType | Partition Type | partitionType | ProductPartitionType | True | Segment | Predicate values / display values: UNKNOWN / Unknown SUBDIVISION / Subdivision UNIT / Unit |
| ProductGroup | Product Group | productGroup | String | True | Attribute | |
| Quarter | Quarter | quarter | String | True | Segment | |
| SearchImpressionShare | Search Impr. share | searchImprShare | Double | True | Metric | A percentage returned as "xx.xx%", or the special values "< 10%" or "> 90%". Not compatible with the fields ClickType and HourOfDay on any report. Not compatible with the field Device on the Product Partition Report. |
| TrackingUrlTemplate | Tracking template | trackingTemplate | String | True | Attribute | |
| UrlCustomParameters | Custom parameter | customParameter | CustomParameters | True | Attribute | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | True | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | True | Metric | |
| Week | Week | week | String | True | Segment | |
| Year | Year | year | Integer | True | Segment |
Search Query Performance Report
The Search Terms report includes all statistics aggregated at the search terms level, one row per combination of search terms. If other segment fields are used, you may get more than one row per combination of search terms. See segmentation for more information.
Note: We only show the first 128 char bytes of a query; so two rows with seemingly identical query strings just indicates that there were some differences past the 128th byte.
ReportType:
SEARCH_QUERY_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdFormat | Ad type | adType | AdFormat | False | Segment | Predicate values / display values: UNKNOWN / unknown TEXT / text IMAGE / image DYNAMIC_IMAGE / dynamic_image FLASH / flash VIDEO / video HTML / html AUDIO / audio COMPOSITE / composite PRINT / print |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | False | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | False | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | False | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | False | Metric | |
| AveragePosition | Avg. position | avgPosition | Double | False | Metric | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| Clicks | Clicks | clicks | Long | False | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | False | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | False | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | False | Metric | |
| Cost | Cost | cost | Money | False | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | False | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | False | Metric | |
| CreativeId | Ad ID | adID | Long | False | Attribute | |
| Ctr | CTR | ctr | Double | False | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| Date | Day | day | Date | False | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | False | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DestinationUrl | Destination URL | destinationURL | String | False | Attribute | |
| Device | Device | device | DeviceType | False | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| Impressions | Impressions | impressions | Long | False | Metric | |
| KeywordId | Keyword ID | keywordID | long | False | Attribute | In the Ad Performance Report this field contains the ID of the criterion that triggered the ad, segmenting the report and preventing zero impressions. The ID can be for any type of criterion, including placements, verticals, etc. Cross-reference with the Criteria Report to determine the criteria type and details. |
| KeywordTextMatchingQuery | Keyword | keyword | String | False | Attribute | |
| MatchType | Match type | matchType | QueryMatchType | False | Segment | Predicate values / display values: AUTO / auto BROAD / broad BROAD_SESSION / broad (session-based) EXACT / exact EXPANDED / broad PHRASE / phrase |
| MatchTypeWithVariant | Match type | matchType | QueryMatchTypeWithVariant | False | Segment | Predicate values / display values: AUTO / auto BROAD / broad BROAD_SESSION / broad (session-based) EXACT / exact EXPANDED / broad PHRASE / phrase NEAR_EXACT / exact (close variant) NEAR_PHRASE / phrase (close variant) |
| Month | Month | month | String | False | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | False | Segment | 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 | companyName | String | False | Attribute | |
| Quarter | Quarter | quarter | String | False | Segment | |
| Query | Search term | searchTerm | String | False | Attribute | If the string for this attribute is longer than 128 char bytes, the returned result will NOT be a single aggregated row. |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | False | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | False | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | False | Metric | |
| Week | Week | week | String | False | Segment | |
| Year | Year | year | Integer | False | Segment |
Shared Set Criteria Report
The Shared Set Criteria report includes criteria for each SharedSet.
ReportType:
SHARED_SET_CRITERIA_REPORTNote: The Shared Sets feature is available only to existing whitelisted users.
| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| Id | Keyword ID | keywordID | Long | False | Attribute | |
| KeywordMatchType | Match type | matchType | KeywordMatchType | False | Attribute | Predicate values / display values: EXACT / Exact PHRASE / Phrase BROAD / Broad |
| KeywordText | Negative keyword | negativeKeyword | String | False | Attribute | |
| SharedSetId | Shared Set ID | sharedSetID | Long | False | Attribute |
Shared Set Report
The Shared Set report includes all SharedSets that can be shareable across campaigns.
ReportType:
SHARED_SET_REPORTNote: The Shared Sets feature is available only to existing whitelisted users.
| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| MemberCount | Member Count | memberCount | int | False | Metric | The number of entities in the shared set. |
| Name | Shared Set Name | sharedSetName | String | False | Attribute | |
| ReferenceCount | Reference Count | referenceCount | int | False | Metric | The number of campaigns that actively use the shared set. |
| SharedSetId | Shared Set ID | sharedSetID | Long | False | Attribute | |
| Status | State | state | Status | False | Attribute | Predicate values / display values: ENABLED / Enabled REMOVED / Removed UNKNOWN / unknown |
| Type | Shared Set Type | sharedSetType | SharedSetType | False | Attribute | Predicate values / display values: NEGATIVE_KEYWORDS / NEGATIVE_PLACEMENTS / UNKNOWN / unknown |
Shopping Performance Report
The Shopping Performance report provides shopping campaign statistics aggregated at the product
(OfferId field) level. Product dimension values from Merchant Center such as brand,
category, custom attributes, product condition and product type will reflect the state of each
dimension as of the date and time when AdWords recorded the corresponding event.
ReportType:
SHOPPING_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AggregatorId | MCA Id | mCAId | Long | False | Attribute | |
| AverageCpc | Avg. CPC | avgCPC | Money | False | Metric | |
| Brand | Brand | brand | String | False | Attribute | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| CategoryL1 | Category (1st level) | category1stLevel | String | False | Attribute | |
| CategoryL2 | Category (2nd level) | category2ndLevel | String | False | Attribute | |
| CategoryL3 | Category (3rd level) | category3rdLevel | String | False | Attribute | |
| CategoryL4 | Category (4th level) | category4thLevel | String | False | Attribute | |
| CategoryL5 | Category (5th level) | category5thLevel | String | False | Attribute | |
| ClickType | Click type | clickType | ClickType | False | Segment | 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. 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 |
| Clicks | Clicks | clicks | Long | False | Metric | |
| ConversionRate | Click conversion rate | clickConversionRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionValue | Total conv. value | totalConvValue | Double | False | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | False | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | False | Metric | |
| Cost | Cost | cost | Money | False | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | False | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | False | Metric | |
| CountryCriteriaId | Country/Territory | countryTerritory | Integer | False | Attribute | Name of the country as a string. |
| Ctr | CTR | ctr | Double | False | Metric | Percentage returned as "x.xx%". |
| CustomAttribute0 | Custom label 0 | customLabel0 | String | False | Attribute | |
| CustomAttribute1 | Custom label 1 | customLabel1 | String | False | Attribute | |
| CustomAttribute2 | Custom label 2 | customLabel2 | String | False | Attribute | |
| CustomAttribute3 | Custom label 3 | customLabel3 | String | False | Attribute | |
| CustomAttribute4 | Custom label 4 | customLabel4 | String | False | Attribute | |
| Date | Day | day | Date | False | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | False | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| Device | Device | device | DeviceType | False | Segment | Predicate values / display values: UNKNOWN / Other DESKTOP / Computers HIGH_END_MOBILE / Mobile devices with full browsers TABLET / Tablets with full browsers |
| Impressions | Impressions | impressions | Long | False | Metric | |
| LanguageCriteriaId | Language | language | Integer | False | Attribute | |
| MerchantId | MC Id | mCId | Long | False | Attribute | |
| Month | Month | month | String | False | Segment | |
| OfferId | Item Id | itemId | String | False | Attribute | |
| ProductCondition | Condition | condition | ShoppingProductCondition | False | Segment | Predicate values / display values: UNKNOWN / unknown OLD / Used NEW / New REFURBISHED / Refurbished |
| ProductTypeL1 | Product type (1st level) | productType1stLevel | String | False | Attribute | |
| ProductTypeL2 | Product type (2nd level) | productType2ndLevel | String | False | Attribute | |
| ProductTypeL3 | Product type (3rd level) | productType3rdLevel | String | False | Attribute | |
| ProductTypeL4 | Product type (4th level) | productType4thLevel | String | False | Attribute | |
| ProductTypeL5 | Product type (5th level) | productType5thLevel | String | False | Attribute | |
| Quarter | Quarter | quarter | String | False | Segment | |
| StoreId | Store Id | storeId | String | False | Attribute | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | False | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | False | Metric | |
| Week | Week | week | String | False | Segment | |
| Year | Year | year | Integer | False | Segment |
URL Performance Report
The URL Performance report includes all statistics aggregated at the URL level, one row per URL where your ads have been displayed. This is similar to the placements performance report, except that this breaks it down by URLs your ads have been displayed at rather than the manual placements or automatic placements (criteria). If other segment fields are used, you may get more than one row per URL. See segmentation for more information. This is a single attribution report.
ReportType:
URL_PERFORMANCE_REPORT| Name | Display Name | XML Attribute | Type | Supports Zero Impressions | Behavior | Notes |
|---|---|---|---|---|---|---|
| AccountCurrencyCode | Currency | currency | String | False | Attribute | |
| AccountDescriptiveName | Account | account | String | False | Attribute | |
| AccountTimeZoneId | Time zone | timeZone | String | False | Attribute | Name of the timezone. For example: "(GMT-05:00) Eastern Time". |
| AdFormat | Ad type | adType | AdFormat | False | Segment | Predicate values / display values: UNKNOWN / unknown TEXT / text IMAGE / image DYNAMIC_IMAGE / dynamic_image FLASH / flash VIDEO / video HTML / html AUDIO / audio COMPOSITE / composite PRINT / print |
| AdGroupCriterionStatus | Keyword/Placement state | keywordPlacementState | UserStatus | False | Attribute | Predicate values / display values: ENABLED / enabled REMOVED / removed PAUSED / paused |
| AdGroupId | Ad group ID | adGroupID | Long | False | Attribute | |
| AdGroupName | Ad group | adGroup | String | False | Attribute | |
| AdGroupStatus | Ad group state | adGroupState | AdGroupStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| AdNetworkType1 | Network | network | AdNetworkType1 | False | Segment | Predicate values / display values: SEARCH / Search Network CONTENT / Display Network |
| AdNetworkType2 | Network (with search partners) | networkWithSearchPartners | AdNetworkType2 | False | Segment | Predicate values / display values: SEARCH / Google search SEARCH_PARTNERS / Search partners CONTENT / Display Network |
| AverageCpc | Avg. CPC | avgCPC | Money | False | Metric | |
| AverageCpm | Avg. CPM | avgCPM | Money | False | Metric | |
| CampaignId | Campaign ID | campaignID | Long | False | Attribute | |
| CampaignName | Campaign | campaign | String | False | Attribute | |
| CampaignStatus | Campaign state | campaignState | CampaignStatus | False | Attribute | Predicate values / display values: UNKNOWN / unknown ENABLED / enabled PAUSED / paused REMOVED / removed |
| Clicks | Clicks | clicks | Long | False | Metric | |
| ConversionCategoryName | Conversion category | conversionCategory | String | False | Segment | 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" |
| ConversionRate | Click conversion rate | clickConversionRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionRateManyPerClick | Conv. rate | convRate | Double | False | Metric | Percentage returned as "x.xx%". |
| ConversionTypeName | Conversion name | conversionName | String | False | Attribute | Not compatible with non-conversion stats (AverageCpc, Clicks, etc). Prevents zero-conversion rows from being returned. |
| ConversionValue | Total conv. value | totalConvValue | Double | False | Metric | |
| Conversions | Converted clicks | convertedClicks | Long | False | Metric | |
| ConversionsManyPerClick | Conversions | conversions | Long | False | Metric | |
| Cost | Cost | cost | Money | False | Metric | |
| CostPerConversion | Cost / converted click | costConvertedClick | Money | False | Metric | |
| CostPerConversionManyPerClick | Cost / conv. | costConv | Money | False | Metric | |
| CriteriaParameters | Keyword / Placement | keywordPlacement | String | False | Attribute | In the Destination URL report, this field behaves as a segment. |
| Ctr | CTR | ctr | Double | False | Metric | Percentage returned as "x.xx%". |
| CustomerDescriptiveName | Client name | clientName | String | False | Attribute | |
| Date | Day | day | Date | False | Segment | |
| DayOfWeek | Day of week | dayOfWeek | DayOfWeek | False | Segment | Predicate values / display values: MONDAY / Monday TUESDAY / Tuesday WEDNESDAY / Wednesday THURSDAY / Thursday FRIDAY / Friday SATURDAY / Saturday SUNDAY / Sunday |
| DisplayName | Criteria Display Name | criteriaDisplayName | String | False | Attribute | |
| Domain | Domain | domain | String | False | Attribute | |
| ExternalCustomerId | Customer ID | customerID | Long | False | Attribute | |
| Impressions | Impressions | impressions | Long | False | Metric | |
| IsAutoOptimized | Targeting Mode | targetingMode | boolean | False | Segment | |
| IsBidOnPath | Added | added | boolean | False | Attribute | |
| IsPathExcluded | Excluded | excluded | boolean | False | Attribute | |
| Month | Month | month | String | False | Segment | |
| MonthOfYear | Month of Year | monthOfYear | MonthOfYear | False | Segment | 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 | companyName | String | False | Attribute | |
| Quarter | Quarter | quarter | String | False | Segment | |
| Url | URL | url | String | False | Attribute | |
| ValuePerConversion | Value / converted click | valueConvertedClick | Double | False | Metric | |
| ValuePerConversionManyPerClick | Value / conv. | valueConv | Double | False | Metric | |
| ViewThroughConversions | View-through conv. | viewThroughConv | Long | False | Metric | |
| Week | Week | week | String | False | Segment | |
| Year | Year | year | Integer | False | Segment |