AdGroup
An ad group.
Table Specific Information
Select
Google Ads does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the Ads console.
To use the nondefault fields, explicitly select them in your query.
Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the Ads API.
Columns
Name
Type
Behavior
Description
AdGroupAdRotationMode
String
Attribute
AdRotationMode column for table AdGroup
AdGroupBaseAdGroup
String
Attribute
BaseAdGroup column for table AdGroup
AdGroupCampaign
String
Attribute
Campaign column for table AdGroup
AdGroupCpcBidMicros
Long
Attribute
CpcBidMicros column for table AdGroup
AdGroupCpmBidMicros
Long
Attribute
CpmBidMicros column for table AdGroup
AdGroupCpvBidMicros
Long
Attribute
CpvBidMicros column for table AdGroup
AdGroupDisplayCustomBidDimension
String
Attribute
DisplayCustomBidDimension column for table AdGroup
AdGroupEffectiveTargetCpaMicros
Long
Attribute
EffectiveTargetCpaMicros column for table AdGroup
AdGroupEffectiveTargetCpaSource
String
Attribute
EffectiveTargetCpaSource column for table AdGroup
AdGroupEffectiveTargetRoas
Double
Attribute
EffectiveTargetRoas column for table AdGroup
AdGroupEffectiveTargetRoasSource
String
Attribute
EffectiveTargetRoasSource column for table AdGroup
AdGroupExcludedParentAssetFieldTypes
String
Attribute
ExcludedParentAssetFieldTypes column for table AdGroup
AdGroupExplorerAutoOptimizerSettingOptIn
Bool
Attribute
ExplorerAutoOptimizerSettingOptIn column for table AdGroup
AdGroupFinalUrlSuffix
String
Attribute
FinalUrlSuffix column for table AdGroup
AdGroupId
Long
Attribute
Id column for table AdGroup
AdGroupLabels
String
Attribute
Labels column for table AdGroup
AdGroupName
String
Attribute
Name column for table AdGroup
AdGroupPercentCpcBidMicros
Long
Attribute
PercentCpcBidMicros column for table AdGroup
AdGroupResourceName
String
Attribute
ResourceName column for table AdGroup
AdGroupStatus
String
Attribute
Status column for table AdGroup
AdGroupTargetCpaMicros
Long
Attribute
TargetCpaMicros column for table AdGroup
AdGroupTargetCpmMicros
Long
Attribute
TargetCpmMicros column for table AdGroup
AdGroupTargetRoas
Double
Attribute
TargetRoas column for table AdGroup
AdGroupTargetingSettingTargetRestrictions
String
Attribute
TargetingSettingTargetRestrictions column for table AdGroup
AdGroupTrackingUrlTemplate
String
Attribute
TrackingUrlTemplate column for table AdGroup
AdGroupType
String
Attribute
Type column for table AdGroup
AdGroupUrlCustomParameters
String
Attribute
UrlCustomParameters column for table AdGroup
CustomerId
Long
Attribute
ClientCustomerId column for table AdGroup
AbsoluteTopImpressionPercentage
Double
Metric
AbsoluteTopImpressionPercentage column for table Metrics
ActiveViewCpm
Double
Metric
ActiveViewCpm column for table Metrics
ActiveViewCtr
Double
Metric
ActiveViewCtr column for table Metrics
ActiveViewImpressions
Long
Metric
ActiveViewImpressions column for table Metrics
ActiveViewMeasurability
Double
Metric
ActiveViewMeasurability column for table Metrics
ActiveViewMeasurableCostMicros
Long
Metric
ActiveViewMeasurableCostMicros column for table Metrics
ActiveViewMeasurableImpressions
Long
Metric
ActiveViewMeasurableImpressions column for table Metrics
ActiveViewViewability
Double
Metric
ActiveViewViewability column for table Metrics
AllConversions
Double
Metric
AllConversions column for table Metrics
AllConversionsByConversionDate
Double
Metric
AllConversionsByConversionDate column for table Metrics
AllConversionsFromInteractionsRate
Double
Metric
AllConversionsFromInteractionsRate column for table Metrics
AllConversionsValue
Double
Metric
AllConversionsValue column for table Metrics
AllConversionsValueByConversionDate
Double
Metric
AllConversionsValueByConversionDate column for table Metrics
AverageCost
Double
Metric
AverageCost column for table Metrics
AverageCpc
Double
Metric
AverageCpc column for table Metrics
AverageCpe
Double
Metric
AverageCpe column for table Metrics
AverageCpm
Double
Metric
AverageCpm column for table Metrics
AverageCpv
Double
Metric
AverageCpv column for table Metrics
AveragePageViews
Double
Metric
AveragePageViews column for table Metrics
AverageTimeOnSite
Double
Metric
AverageTimeOnSite column for table Metrics
BounceRate
Double
Metric
BounceRate column for table Metrics
Clicks
Long
Metric
Clicks column for table Metrics
ContentImpressionShare
Double
Metric
ContentImpressionShare column for table Metrics
ContentRankLostImpressionShare
Double
Metric
ContentRankLostImpressionShare column for table Metrics
Conversions
Double
Metric
Conversions column for table Metrics
ConversionsByConversionDate
Double
Metric
ConversionsByConversionDate column for table Metrics
ConversionsFromInteractionsRate
Double
Metric
ConversionsFromInteractionsRate column for table Metrics
ConversionsValue
Double
Metric
ConversionsValue column for table Metrics
ConversionsValueByConversionDate
Double
Metric
ConversionsValueByConversionDate column for table Metrics
CostMicros
Long
Metric
CostMicros column for table Metrics
CostPerAllConversions
Double
Metric
CostPerAllConversions column for table Metrics
CostPerConversion
Double
Metric
CostPerConversion column for table Metrics
CostPerCurrentModelAttributedConversion
Double
Metric
CostPerCurrentModelAttributedConversion column for table Metrics
CrossDeviceConversions
Double
Metric
CrossDeviceConversions column for table Metrics
Ctr
Double
Metric
Ctr column for table Metrics
CurrentModelAttributedConversions
Double
Metric
CurrentModelAttributedConversions column for table Metrics
CurrentModelAttributedConversionsValue
Double
Metric
CurrentModelAttributedConversionsValue column for table Metrics
EngagementRate
Double
Metric
EngagementRate column for table Metrics
Engagements
Long
Metric
Engagements column for table Metrics
GmailForwards