Ad Group Performance Report
An Ad Group performance report lets you view data about how your ad
groups are performing.
Set
DefinedReportJob.selectedReportType
to AdGroup to generate
an Ad Group Performance report. The valid aggregation
types for this type of report are listed below.
For general information on creating valid ReportJob
objects, read the Report Rules.
The tables on this page display the following information about each column:
-
Field Value - the value you specify in
selectedColumns to
include this column in your report.
-
* - Column requires MCC account
-
** - Column requires MCC account or conversion tracking enabled
-
Name - the human-readable name of this column. This column's value in the generated report is either a measure or an attribute:
-
Measure - the value is calculated using historical data. For example, CTR is a measure.
-
Attribute - the value is immediately retrievable. For example, Customer Id is an attribute.
-
Response XML - the XML attribute in the generated report that represents this column.
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.
Daily
Setting DefinedReportJob.aggregationTypes to
["Daily"] causes the ReportJob object to have the following required and optional columns:
Required Columns
You must specify at least one of these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroup |
Ad Group (attribute)
|
adgroup |
| AdGroupId |
Ad Group Id (attribute)
|
adgroupid |
Optional Columns
You can also specify these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroupStatus |
Ad Group Status (attribute)
|
agStatus |
| AdWordsType |
Ad Distribution (attribute)
|
adwordsType |
| AverageConversionValue**
|
Avg Value (measure)
|
avgConvValue |
| AveragePosition |
Avg Position (measure)
|
pos |
| CPC |
Avg CPC (measure)
|
cpc |
| CPM |
Avg CPM (measure)
|
cpm |
| CTR |
CTR (measure)
|
ctr |
| Campaign |
Campaign (attribute)
|
campaign |
| CampaignId |
Campaign Id (attribute)
|
campaignid |
| CampaignStatus |
Campaign Status (attribute)
|
campStatus |
| Clicks |
Clicks (measure)
|
clicks |
| ConversionCost**
|
Conversion Cost (measure)
|
convCost |
| ConversionRate**
|
Conversion Rate (measure)
|
convRate |
| Conversions**
|
Conversions (measure)
|
conv |
| Cost |
Cost (measure)
|
cost |
| CostPerConverstion**
|
Cost/conversion (measure)
|
costPerConv |
| CostPerTransaction**
|
Cost/transaction (measure)
|
cpt |
| CustomerName*
|
Account (attribute)
|
acctname |
| CustomerTimeZone*
|
Time Zone (attribute)
|
timezone |
| DailyBudget |
Daily Budget (attribute)
|
budget |
| DefaultCount**
|
Other Count (measure)
|
defaultConv |
| DefaultValue**
|
Other Value (measure)
|
defaultConvValue |
| ExternalCustomerId*
|
Customer Id (attribute)
|
customerid |
| Impressions |
Impressions (measure)
|
imps |
| LeadCount**
|
Leads Count (measure)
|
leads |
| LeadValue**
|
Leads Value (measure)
|
leadValue |
| PageViewCount**
|
Page View Count (measure)
|
pageviews |
| PageViewValue**
|
Page View Value (measure)
|
pageviewValue |
| SalesCount**
|
Sales Count (measure)
|
purchases |
| SalesValue**
|
Sales Value (measure)
|
purchaseValue |
| SignupCount**
|
Sign-up Count (measure)
|
signups |
| SignupValue**
|
Sign-up Value (measure)
|
signupValue |
| TotalConversionValue**
|
Total Value (measure)
|
convValue |
| Transactions**
|
Transactions (measure)
|
transactions |
| ValuePerClick**
|
Value/click (measure)
|
convVpc |
| ValuePerCost**
|
Value/cost (measure)
|
valueCostRatio |
Day of Week
Setting DefinedReportJob.aggregationTypes to
["DayOfWeek"] causes the ReportJob object to have the following required and optional columns:
Required Columns
You must specify at least one of these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroup |
Ad Group (attribute)
|
adgroup |
| AdGroupId |
Ad Group Id (attribute)
|
adgroupid |
Optional Columns
You can also specify these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroupStatus |
Ad Group Status (attribute)
|
agStatus |
| AdWordsType |
Ad Distribution (attribute)
|
adwordsType |
| AverageConversionValue**
|
Avg Value (measure)
|
avgConvValue |
| AveragePosition |
Avg Position (measure)
|
pos |
| CPC |
Avg CPC (measure)
|
cpc |
| CPM |
Avg CPM (measure)
|
cpm |
| CTR |
CTR (measure)
|
ctr |
| Campaign |
Campaign (attribute)
|
campaign |
| CampaignId |
Campaign Id (attribute)
|
campaignid |
| CampaignStatus |
Campaign Status (attribute)
|
campStatus |
| Clicks |
Clicks (measure)
|
clicks |
| ConversionCost**
|
Conversion Cost (measure)
|
convCost |
| ConversionRate**
|
Conversion Rate (measure)
|
convRate |
| Conversions**
|
Conversions (measure)
|
conv |
| Cost |
Cost (measure)
|
cost |
| CostPerConverstion**
|
Cost/conversion (measure)
|
costPerConv |
| CostPerTransaction**
|
Cost/transaction (measure)
|
cpt |
| CustomerName*
|
Account (attribute)
|
acctname |
| CustomerTimeZone*
|
Time Zone (attribute)
|
timezone |
| DailyBudget |
Daily Budget (attribute)
|
budget |
| DefaultCount**
|
Other Count (measure)
|
defaultConv |
| DefaultValue**
|
Other Value (measure)
|
defaultConvValue |
| ExternalCustomerId*
|
Customer Id (attribute)
|
customerid |
| Impressions |
Impressions (measure)
|
imps |
| LeadCount**
|
Leads Count (measure)
|
leads |
| LeadValue**
|
Leads Value (measure)
|
leadValue |
| PageViewCount**
|
Page View Count (measure)
|
pageviews |
| PageViewValue**
|
Page View Value (measure)
|
pageviewValue |
| SalesCount**
|
Sales Count (measure)
|
purchases |
| SalesValue**
|
Sales Value (measure)
|
purchaseValue |
| SignupCount**
|
Sign-up Count (measure)
|
signups |
| SignupValue**
|
Sign-up Value (measure)
|
signupValue |
| TotalConversionValue**
|
Total Value (measure)
|
convValue |
| Transactions**
|
Transactions (measure)
|
transactions |
| ValuePerClick**
|
Value/click (measure)
|
convVpc |
| ValuePerCost**
|
Value/cost (measure)
|
valueCostRatio |
Hourly (by date)
Setting DefinedReportJob.aggregationTypes to
["HourlyByDate"] causes the ReportJob object to have the following required and optional columns:
Required Columns
You must specify at least one of these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroup |
Ad Group (attribute)
|
adgroup |
| AdGroupId |
Ad Group Id (attribute)
|
adgroupid |
Optional Columns
You can also specify these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroupStatus |
Ad Group Status (attribute)
|
agStatus |
| CPC |
Avg CPC (measure)
|
cpc |
| CPM |
Avg CPM (measure)
|
cpm |
| CTR |
CTR (measure)
|
ctr |
| Campaign |
Campaign (attribute)
|
campaign |
| CampaignId |
Campaign Id (attribute)
|
campaignid |
| CampaignStatus |
Campaign Status (attribute)
|
campStatus |
| Clicks |
Clicks (measure)
|
clicks |
| Cost |
Cost (measure)
|
cost |
| CustomerName*
|
Account (attribute)
|
acctname |
| CustomerTimeZone*
|
Time Zone (attribute)
|
timezone |
| DailyBudget |
Daily Budget (attribute)
|
budget |
| ExternalCustomerId*
|
Customer Id (attribute)
|
customerid |
| Impressions |
Impressions (measure)
|
imps |
Hourly (regardless of date)
Setting DefinedReportJob.aggregationTypes to
["HourlyRegardlessDate"] causes the ReportJob object to have the following required and optional columns:
Required Columns
You must specify at least one of these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroup |
Ad Group (attribute)
|
adgroup |
| AdGroupId |
Ad Group Id (attribute)
|
adgroupid |
Optional Columns
You can also specify these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroupStatus |
Ad Group Status (attribute)
|
agStatus |
| CPC |
Avg CPC (measure)
|
cpc |
| CPM |
Avg CPM (measure)
|
cpm |
| CTR |
CTR (measure)
|
ctr |
| Campaign |
Campaign (attribute)
|
campaign |
| CampaignId |
Campaign Id (attribute)
|
campaignid |
| CampaignStatus |
Campaign Status (attribute)
|
campStatus |
| Clicks |
Clicks (measure)
|
clicks |
| Cost |
Cost (measure)
|
cost |
| CustomerName*
|
Account (attribute)
|
acctname |
| CustomerTimeZone*
|
Time Zone (attribute)
|
timezone |
| DailyBudget |
Daily Budget (attribute)
|
budget |
| ExternalCustomerId*
|
Customer Id (attribute)
|
customerid |
| Impressions |
Impressions (measure)
|
imps |
Monthly
Setting DefinedReportJob.aggregationTypes to
["Monthly"] causes the ReportJob object to have the following required and optional columns:
Required Columns
You must specify at least one of these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroup |
Ad Group (attribute)
|
adgroup |
| AdGroupId |
Ad Group Id (attribute)
|
adgroupid |
Optional Columns
You can also specify these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroupStatus |
Ad Group Status (attribute)
|
agStatus |
| AdWordsType |
Ad Distribution (attribute)
|
adwordsType |
| AverageConversionValue**
|
Avg Value (measure)
|
avgConvValue |
| AveragePosition |
Avg Position (measure)
|
pos |
| CPC |
Avg CPC (measure)
|
cpc |
| CPM |
Avg CPM (measure)
|
cpm |
| CTR |
CTR (measure)
|
ctr |
| Campaign |
Campaign (attribute)
|
campaign |
| CampaignId |
Campaign Id (attribute)
|
campaignid |
| CampaignStatus |
Campaign Status (attribute)
|
campStatus |
| Clicks |
Clicks (measure)
|
clicks |
| ConversionCost**
|
Conversion Cost (measure)
|
convCost |
| ConversionRate**
|
Conversion Rate (measure)
|
convRate |
| Conversions**
|
Conversions (measure)
|
conv |
| Cost |
Cost (measure)
|
cost |
| CostPerConverstion**
|
Cost/conversion (measure)
|
costPerConv |
| CostPerTransaction**
|
Cost/transaction (measure)
|
cpt |
| CustomerName*
|
Account (attribute)
|
acctname |
| CustomerTimeZone*
|
Time Zone (attribute)
|
timezone |
| DailyBudget |
Daily Budget (attribute)
|
budget |
| DefaultCount**
|
Other Count (measure)
|
defaultConv |
| DefaultValue**
|
Other Value (measure)
|
defaultConvValue |
| ExternalCustomerId*
|
Customer Id (attribute)
|
customerid |
| Impressions |
Impressions (measure)
|
imps |
| LeadCount**
|
Leads Count (measure)
|
leads |
| LeadValue**
|
Leads Value (measure)
|
leadValue |
| PageViewCount**
|
Page View Count (measure)
|
pageviews |
| PageViewValue**
|
Page View Value (measure)
|
pageviewValue |
| SalesCount**
|
Sales Count (measure)
|
purchases |
| SalesValue**
|
Sales Value (measure)
|
purchaseValue |
| SignupCount**
|
Sign-up Count (measure)
|
signups |
| SignupValue**
|
Sign-up Value (measure)
|
signupValue |
| TotalConversionValue**
|
Total Value (measure)
|
convValue |
| Transactions**
|
Transactions (measure)
|
transactions |
| ValuePerClick**
|
Value/click (measure)
|
convVpc |
| ValuePerCost**
|
Value/cost (measure)
|
valueCostRatio |
Quarterly
Setting DefinedReportJob.aggregationTypes to
["Quarterly"] causes the ReportJob object to have the following required and optional columns:
Required Columns
You must specify at least one of these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroup |
Ad Group (attribute)
|
adgroup |
| AdGroupId |
Ad Group Id (attribute)
|
adgroupid |
Optional Columns
You can also specify these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroupStatus |
Ad Group Status (attribute)
|
agStatus |
| AdWordsType |
Ad Distribution (attribute)
|
adwordsType |
| AverageConversionValue**
|
Avg Value (measure)
|
avgConvValue |
| AveragePosition |
Avg Position (measure)
|
pos |
| CPC |
Avg CPC (measure)
|
cpc |
| CPM |
Avg CPM (measure)
|
cpm |
| CTR |
CTR (measure)
|
ctr |
| Campaign |
Campaign (attribute)
|
campaign |
| CampaignId |
Campaign Id (attribute)
|
campaignid |
| CampaignStatus |
Campaign Status (attribute)
|
campStatus |
| Clicks |
Clicks (measure)
|
clicks |
| ConversionCost**
|
Conversion Cost (measure)
|
convCost |
| ConversionRate**
|
Conversion Rate (measure)
|
convRate |
| Conversions**
|
Conversions (measure)
|
conv |
| Cost |
Cost (measure)
|
cost |
| CostPerConverstion**
|
Cost/conversion (measure)
|
costPerConv |
| CostPerTransaction**
|
Cost/transaction (measure)
|
cpt |
| CustomerName*
|
Account (attribute)
|
acctname |
| CustomerTimeZone*
|
Time Zone (attribute)
|
timezone |
| DailyBudget |
Daily Budget (attribute)
|
budget |
| DefaultCount**
|
Other Count (measure)
|
defaultConv |
| DefaultValue**
|
Other Value (measure)
|
defaultConvValue |
| ExternalCustomerId*
|
Customer Id (attribute)
|
customerid |
| Impressions |
Impressions (measure)
|
imps |
| LeadCount**
|
Leads Count (measure)
|
leads |
| LeadValue**
|
Leads Value (measure)
|
leadValue |
| PageViewCount**
|
Page View Count (measure)
|
pageviews |
| PageViewValue**
|
Page View Value (measure)
|
pageviewValue |
| SalesCount**
|
Sales Count (measure)
|
purchases |
| SalesValue**
|
Sales Value (measure)
|
purchaseValue |
| SignupCount**
|
Sign-up Count (measure)
|
signups |
| SignupValue**
|
Sign-up Value (measure)
|
signupValue |
| TotalConversionValue**
|
Total Value (measure)
|
convValue |
| Transactions**
|
Transactions (measure)
|
transactions |
| ValuePerClick**
|
Value/click (measure)
|
convVpc |
| ValuePerCost**
|
Value/cost (measure)
|
valueCostRatio |
Summary
Setting DefinedReportJob.aggregationTypes to
["Summary"] causes the ReportJob object to have the following required and optional columns:
Required Columns
You must specify at least one of these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroup |
Ad Group (attribute)
|
adgroup |
| AdGroupId |
Ad Group Id (attribute)
|
adgroupid |
Optional Columns
You can also specify these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroupStatus |
Ad Group Status (attribute)
|
agStatus |
| AdWordsType |
Ad Distribution (attribute)
|
adwordsType |
| AverageConversionValue**
|
Avg Value (measure)
|
avgConvValue |
| AveragePosition |
Avg Position (measure)
|
pos |
| CPC |
Avg CPC (measure)
|
cpc |
| CPM |
Avg CPM (measure)
|
cpm |
| CTR |
CTR (measure)
|
ctr |
| Campaign |
Campaign (attribute)
|
campaign |
| CampaignId |
Campaign Id (attribute)
|
campaignid |
| CampaignStatus |
Campaign Status (attribute)
|
campStatus |
| Clicks |
Clicks (measure)
|
clicks |
| ConversionCost**
|
Conversion Cost (measure)
|
convCost |
| ConversionRate**
|
Conversion Rate (measure)
|
convRate |
| Conversions**
|
Conversions (measure)
|
conv |
| Cost |
Cost (measure)
|
cost |
| CostPerConverstion**
|
Cost/conversion (measure)
|
costPerConv |
| CostPerTransaction**
|
Cost/transaction (measure)
|
cpt |
| CustomerName*
|
Account (attribute)
|
acctname |
| CustomerTimeZone*
|
Time Zone (attribute)
|
timezone |
| DailyBudget |
Daily Budget (attribute)
|
budget |
| DefaultCount**
|
Other Count (measure)
|
defaultConv |
| DefaultValue**
|
Other Value (measure)
|
defaultConvValue |
| ExternalCustomerId*
|
Customer Id (attribute)
|
customerid |
| Impressions |
Impressions (measure)
|
imps |
| LeadCount**
|
Leads Count (measure)
|
leads |
| LeadValue**
|
Leads Value (measure)
|
leadValue |
| PageViewCount**
|
Page View Count (measure)
|
pageviews |
| PageViewValue**
|
Page View Value (measure)
|
pageviewValue |
| SalesCount**
|
Sales Count (measure)
|
purchases |
| SalesValue**
|
Sales Value (measure)
|
purchaseValue |
| SignupCount**
|
Sign-up Count (measure)
|
signups |
| SignupValue**
|
Sign-up Value (measure)
|
signupValue |
| TotalConversionValue**
|
Total Value (measure)
|
convValue |
| Transactions**
|
Transactions (measure)
|
transactions |
| ValuePerClick**
|
Value/click (measure)
|
convVpc |
| ValuePerCost**
|
Value/cost (measure)
|
valueCostRatio |
Weekly
Setting DefinedReportJob.aggregationTypes to
["Weekly"] causes the ReportJob object to have the following required and optional columns:
Required Columns
You must specify at least one of these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroup |
Ad Group (attribute)
|
adgroup |
| AdGroupId |
Ad Group Id (attribute)
|
adgroupid |
Optional Columns
You can also specify these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroupStatus |
Ad Group Status (attribute)
|
agStatus |
| AdWordsType |
Ad Distribution (attribute)
|
adwordsType |
| AverageConversionValue**
|
Avg Value (measure)
|
avgConvValue |
| AveragePosition |
Avg Position (measure)
|
pos |
| CPC |
Avg CPC (measure)
|
cpc |
| CPM |
Avg CPM (measure)
|
cpm |
| CTR |
CTR (measure)
|
ctr |
| Campaign |
Campaign (attribute)
|
campaign |
| CampaignId |
Campaign Id (attribute)
|
campaignid |
| CampaignStatus |
Campaign Status (attribute)
|
campStatus |
| Clicks |
Clicks (measure)
|
clicks |
| ConversionCost**
|
Conversion Cost (measure)
|
convCost |
| ConversionRate**
|
Conversion Rate (measure)
|
convRate |
| Conversions**
|
Conversions (measure)
|
conv |
| Cost |
Cost (measure)
|
cost |
| CostPerConverstion**
|
Cost/conversion (measure)
|
costPerConv |
| CostPerTransaction**
|
Cost/transaction (measure)
|
cpt |
| CustomerName*
|
Account (attribute)
|
acctname |
| CustomerTimeZone*
|
Time Zone (attribute)
|
timezone |
| DailyBudget |
Daily Budget (attribute)
|
budget |
| DefaultCount**
|
Other Count (measure)
|
defaultConv |
| DefaultValue**
|
Other Value (measure)
|
defaultConvValue |
| ExternalCustomerId*
|
Customer Id (attribute)
|
customerid |
| Impressions |
Impressions (measure)
|
imps |
| LeadCount**
|
Leads Count (measure)
|
leads |
| LeadValue**
|
Leads Value (measure)
|
leadValue |
| PageViewCount**
|
Page View Count (measure)
|
pageviews |
| PageViewValue**
|
Page View Value (measure)
|
pageviewValue |
| SalesCount**
|
Sales Count (measure)
|
purchases |
| SalesValue**
|
Sales Value (measure)
|
purchaseValue |
| SignupCount**
|
Sign-up Count (measure)
|
signups |
| SignupValue**
|
Sign-up Value (measure)
|
signupValue |
| TotalConversionValue**
|
Total Value (measure)
|
convValue |
| Transactions**
|
Transactions (measure)
|
transactions |
| ValuePerClick**
|
Value/click (measure)
|
convVpc |
| ValuePerCost**
|
Value/cost (measure)
|
valueCostRatio |
Yearly
Setting DefinedReportJob.aggregationTypes to
["Yearly"] causes the ReportJob object to have the following required and optional columns:
Required Columns
You must specify at least one of these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroup |
Ad Group (attribute)
|
adgroup |
| AdGroupId |
Ad Group Id (attribute)
|
adgroupid |
Optional Columns
You can also specify these values in DefinedReportJob.selectedColumns:
| Field Value |
Name |
Response XML |
| AdGroupStatus |
Ad Group Status (attribute)
|
agStatus |
| AdWordsType |
Ad Distribution (attribute)
|
adwordsType |
| AverageConversionValue**
|
Avg Value (measure)
|
avgConvValue |
| AveragePosition |
Avg Position (measure)
|
pos |
| CPC |
Avg CPC (measure)
|
cpc |
| CPM |
Avg CPM (measure)
|
cpm |
| CTR |
CTR (measure)
|
ctr |
| Campaign |
Campaign (attribute)
|
campaign |
| CampaignId |
Campaign Id (attribute)
|
campaignid |
| CampaignStatus |
Campaign Status (attribute)
|
campStatus |
| Clicks |
Clicks (measure)
|
clicks |
| ConversionCost**
|
Conversion Cost (measure)
|
convCost |
| ConversionRate**
|
Conversion Rate (measure)
|
convRate |
| Conversions**
|
Conversions (measure)
|
conv |
| Cost |
Cost (measure)
|
cost |
| CostPerConverstion**
|
Cost/conversion (measure)
|
costPerConv |
| CostPerTransaction**
|
Cost/transaction (measure)
|
cpt |
| CustomerName*
|
Account (attribute)
|
acctname |
| CustomerTimeZone*
|
Time Zone (attribute)
|
timezone |
| DailyBudget |
Daily Budget (attribute)
|
budget |
| DefaultCount**
|
Other Count (measure)
|
defaultConv |
| DefaultValue**
|
Other Value (measure)
|
defaultConvValue |
| ExternalCustomerId*
|
Customer Id (attribute)
|
customerid |
| Impressions |
Impressions (measure)
|
imps |
| LeadCount**
|
Leads Count (measure)
|
leads |
| LeadValue**
|
Leads Value (measure)
|
leadValue |
| PageViewCount**
|
Page View Count (measure)
|
pageviews |
| PageViewValue**
|
Page View Value (measure)
|
pageviewValue |
| SalesCount**
|
Sales Count (measure)
|
purchases |
| SalesValue**
|
Sales Value (measure)
|
purchaseValue |
| SignupCount**
|
Sign-up Count (measure)
|
signups |
| SignupValue**
|
Sign-up Value (measure)
|
signupValue |
| TotalConversionValue**
|
Total Value (measure)
|
convValue |
| Transactions**
|
Transactions (measure)
|
transactions |
| ValuePerClick**
|
Value/click (measure)
|
convVpc |
| ValuePerCost**
|
Value/cost (measure)
|
valueCostRatio |
API Reference
