My favorites | English | Sign in

Search Query Performance Report

A Search Query Performance report shows performance data for the search queries that triggered the ads which appeared after receiving clicks. This report is only available for the search network.

Set DefinedReportJob.selectedReportType to Query to generate a Search Query Performance report. The valid aggregation types for this type of report are listed below.

The tables on this page display the following information about each column:

  • selectedColumns Value: The value you specify in selectedColumns to include this column in your report.
  • Name: The human-readable name of this column. (measure) indicates the value in the generated report is calculated using historical data (for example, CTR). (attribute) indicates the value in the generated report is not calculated (for example, Customer ID).
  • Response XML: The XML attribute in the generated report that represents this column.

Column Notes

  • 1 Column requires MCC account
  • 2 Column requires MCC account or conversion tracking enabled

Valid aggregationTypes Values

Choose an aggregationTypes value--a set of one or more aggregation types--to see the corresponding list of required and optional columns.

Account, Daily

Setting DefinedReportJob.aggregationTypes to ["Account", "Daily"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CustomerName Account (attribute) acctname
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerTimeZone1 Time Zone (attribute) timezone
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Account, Day of Week

Setting DefinedReportJob.aggregationTypes to ["Account", "DayOfWeek"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CustomerName Account (attribute) acctname
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerTimeZone1 Time Zone (attribute) timezone
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Account, Monthly

Setting DefinedReportJob.aggregationTypes to ["Account", "Monthly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CustomerName Account (attribute) acctname
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerTimeZone1 Time Zone (attribute) timezone
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Account, Quarterly

Setting DefinedReportJob.aggregationTypes to ["Account", "Quarterly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CustomerName Account (attribute) acctname
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerTimeZone1 Time Zone (attribute) timezone
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Account, Summary

Setting DefinedReportJob.aggregationTypes to ["Account", "Summary"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CustomerName Account (attribute) acctname
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerTimeZone1 Time Zone (attribute) timezone
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Account, Weekly

Setting DefinedReportJob.aggregationTypes to ["Account", "Weekly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CustomerName Account (attribute) acctname
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerTimeZone1 Time Zone (attribute) timezone
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Account, Yearly

Setting DefinedReportJob.aggregationTypes to ["Account", "Yearly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CustomerName Account (attribute) acctname
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerTimeZone1 Time Zone (attribute) timezone
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Ad Group, Daily

Setting DefinedReportJob.aggregationTypes to ["AdGroup", "Daily"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
AdGroup Ad Group (attribute) adgroup
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroupMaxCpa1 Max CPA (attribute) agMaxCpa
AdGroupStatus Ad Group Status (attribute) agStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Ad Group, Day of Week

Setting DefinedReportJob.aggregationTypes to ["AdGroup", "DayOfWeek"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
AdGroup Ad Group (attribute) adgroup
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroupMaxCpa1 Max CPA (attribute) agMaxCpa
AdGroupStatus Ad Group Status (attribute) agStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Ad Group, Monthly

Setting DefinedReportJob.aggregationTypes to ["AdGroup", "Monthly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
AdGroup Ad Group (attribute) adgroup
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroupMaxCpa1 Max CPA (attribute) agMaxCpa
AdGroupStatus Ad Group Status (attribute) agStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Ad Group, Quarterly

Setting DefinedReportJob.aggregationTypes to ["AdGroup", "Quarterly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
AdGroup Ad Group (attribute) adgroup
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroupMaxCpa1 Max CPA (attribute) agMaxCpa
AdGroupStatus Ad Group Status (attribute) agStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Ad Group, Summary

Setting DefinedReportJob.aggregationTypes to ["AdGroup", "Summary"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
AdGroup Ad Group (attribute) adgroup
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroupMaxCpa1 Max CPA (attribute) agMaxCpa
AdGroupStatus Ad Group Status (attribute) agStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Ad Group, Weekly

Setting DefinedReportJob.aggregationTypes to ["AdGroup", "Weekly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
AdGroup Ad Group (attribute) adgroup
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroupMaxCpa1 Max CPA (attribute) agMaxCpa
AdGroupStatus Ad Group Status (attribute) agStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Ad Group, Yearly

Setting DefinedReportJob.aggregationTypes to ["AdGroup", "Yearly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
AdGroup Ad Group (attribute) adgroup
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroupMaxCpa1 Max CPA (attribute) agMaxCpa
AdGroupStatus Ad Group Status (attribute) agStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Campaign, Daily

Setting DefinedReportJob.aggregationTypes to ["Campaign", "Daily"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
Campaign Campaign (attribute) campaign
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Campaign, Day of Week

Setting DefinedReportJob.aggregationTypes to ["Campaign", "DayOfWeek"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
Campaign Campaign (attribute) campaign
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Campaign, Monthly

Setting DefinedReportJob.aggregationTypes to ["Campaign", "Monthly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
Campaign Campaign (attribute) campaign
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Campaign, Quarterly

Setting DefinedReportJob.aggregationTypes to ["Campaign", "Quarterly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
Campaign Campaign (attribute) campaign
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Campaign, Summary

Setting DefinedReportJob.aggregationTypes to ["Campaign", "Summary"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
Campaign Campaign (attribute) campaign
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Campaign, Weekly

Setting DefinedReportJob.aggregationTypes to ["Campaign", "Weekly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
Campaign Campaign (attribute) campaign
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Campaign, Yearly

Setting DefinedReportJob.aggregationTypes to ["Campaign", "Yearly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
Campaign Campaign (attribute) campaign
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CustomerName1 Account (attribute) acctname
CustomerTimeZone1 Time Zone (attribute) timezone
DailyBudget Daily Budget (attribute) budget
DeliveryType Ad Delivery Channel (attribute) dvType
ExternalCustomerId1 Customer Id (attribute) customerid
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType

Back to Top

Ad, Daily

Setting DefinedReportJob.aggregationTypes to ["Creative", "Daily"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CreativeId Ad Id (attribute) creativeid
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroup Ad Group (attribute) adgroup
AdGroupId Ad Group Id (attribute) adgroupid
AdGroupStatus Ad Group Status (attribute) agStatus
AdStatus Ad Status (attribute) creativeStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CreativeDestUrl Destination URL (attribute) creativeDestUrl
CreativeType Ad Variation (attribute) creativeType
DeliveryType Ad Delivery Channel (attribute) dvType
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType
Preview Ad Preview (attribute) preview
VisibleUrl Display URL (attribute) creativeVisUrl

Back to Top

Ad, Day of Week

Setting DefinedReportJob.aggregationTypes to ["Creative", "DayOfWeek"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CreativeId Ad Id (attribute) creativeid
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroup Ad Group (attribute) adgroup
AdGroupId Ad Group Id (attribute) adgroupid
AdGroupStatus Ad Group Status (attribute) agStatus
AdStatus Ad Status (attribute) creativeStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CreativeDestUrl Destination URL (attribute) creativeDestUrl
CreativeType Ad Variation (attribute) creativeType
DeliveryType Ad Delivery Channel (attribute) dvType
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType
Preview Ad Preview (attribute) preview
VisibleUrl Display URL (attribute) creativeVisUrl

Back to Top

Ad, Monthly

Setting DefinedReportJob.aggregationTypes to ["Creative", "Monthly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CreativeId Ad Id (attribute) creativeid
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroup Ad Group (attribute) adgroup
AdGroupId Ad Group Id (attribute) adgroupid
AdGroupStatus Ad Group Status (attribute) agStatus
AdStatus Ad Status (attribute) creativeStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CreativeDestUrl Destination URL (attribute) creativeDestUrl
CreativeType Ad Variation (attribute) creativeType
DeliveryType Ad Delivery Channel (attribute) dvType
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType
Preview Ad Preview (attribute) preview
VisibleUrl Display URL (attribute) creativeVisUrl

Back to Top

Ad, Quarterly

Setting DefinedReportJob.aggregationTypes to ["Creative", "Quarterly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CreativeId Ad Id (attribute) creativeid
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroup Ad Group (attribute) adgroup
AdGroupId Ad Group Id (attribute) adgroupid
AdGroupStatus Ad Group Status (attribute) agStatus
AdStatus Ad Status (attribute) creativeStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CreativeDestUrl Destination URL (attribute) creativeDestUrl
CreativeType Ad Variation (attribute) creativeType
DeliveryType Ad Delivery Channel (attribute) dvType
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType
Preview Ad Preview (attribute) preview
VisibleUrl Display URL (attribute) creativeVisUrl

Back to Top

Ad, Summary

Setting DefinedReportJob.aggregationTypes to ["Creative", "Summary"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CreativeId Ad Id (attribute) creativeid
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroup Ad Group (attribute) adgroup
AdGroupId Ad Group Id (attribute) adgroupid
AdGroupStatus Ad Group Status (attribute) agStatus
AdStatus Ad Status (attribute) creativeStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CreativeDestUrl Destination URL (attribute) creativeDestUrl
CreativeType Ad Variation (attribute) creativeType
DeliveryType Ad Delivery Channel (attribute) dvType
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType
Preview Ad Preview (attribute) preview
VisibleUrl Display URL (attribute) creativeVisUrl

Back to Top

Ad, Weekly

Setting DefinedReportJob.aggregationTypes to ["Creative", "Weekly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CreativeId Ad Id (attribute) creativeid
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroup Ad Group (attribute) adgroup
AdGroupId Ad Group Id (attribute) adgroupid
AdGroupStatus Ad Group Status (attribute) agStatus
AdStatus Ad Status (attribute) creativeStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CreativeDestUrl Destination URL (attribute) creativeDestUrl
CreativeType Ad Variation (attribute) creativeType
DeliveryType Ad Delivery Channel (attribute) dvType
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType
Preview Ad Preview (attribute) preview
VisibleUrl Display URL (attribute) creativeVisUrl

Back to Top

Ad, Yearly

Setting DefinedReportJob.aggregationTypes to ["Creative", "Yearly"] causes the report job to have the following required and optional columns:

Required Columns

You must include these values in DefinedReportJob.selectedColumns:

selectedColumns Value Name Response XML
CreativeId Ad Id (attribute) creativeid
Query Search Query (attribute) Query

Optional Columns

You can also include these columns in selectedColumns:

selectedColumns Value Name Response XML
AdDistributionWithSearchPartners Ad Distribution: with search partners (attribute) adDistributionWithSearchPartners
AdGroup Ad Group (attribute) adgroup
AdGroupId Ad Group Id (attribute) adgroupid
AdGroupStatus Ad Group Status (attribute) agStatus
AdStatus Ad Status (attribute) creativeStatus
AdWordsType Ad Distribution (attribute) adwordsType
AveragePosition Avg Position (measure) pos
CPC Avg CPC (measure) cpc
CTR CTR (measure) ctr
Campaign Campaign (attribute) campaign
CampaignId Campaign Id (attribute) campaignid
CampaignStatus Campaign Status (attribute) campStatus
Clicks Clicks (measure) clicks
ConversionCategory1 Action Category (attribute) conversioncategory
ConversionDescription1 Action Description (attribute) conversiondescription
ConversionName1 Action Name (attribute) conversionname
ConversionRate2 Conv. Rate (1-per-click) (measure) convRate
Conversions2 Conversions (1-per-click) (measure) conv
Cost Cost (measure) cost
CostPerConverstion2 Cost/Conv. (1-per-click) (measure) costPerConv
CreativeDestUrl Destination URL (attribute) creativeDestUrl
CreativeType Ad Variation (attribute) creativeType
DeliveryType Ad Delivery Channel (attribute) dvType
Impressions Impressions (measure) imps
MatchType Search Query Match Type (attribute) MatchType
Preview Ad Preview (attribute) preview
VisibleUrl Display URL (attribute) creativeVisUrl

Back to Top