Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields will not segment
metrics in your SELECT clause.
Fields/Segments/Metrics
This page shows all metrics and segments that can be put in the same SELECT clause as the fields of campaign_group.
However, when you specify campaign_group in the FROM clause, some metrics and segments
cannot be used.
Use the following filter to show only the fields that can be used when campaign_group is specified in the FROM clause.
Is campaign_group specified in the FROM clause of your query?
The name of the campaign group. This field is required and should not be empty when creating new campaign groups. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
campaign_group.resource_name
Field description
Immutable. The resource name of the campaign group. Campaign group resource names have the form: customers/{customer_id}/campaignGroups/{campaign_group_id}
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
campaign_group.status
Field description
The status of the campaign group. When a new campaign group is added, the status defaults to ENABLED.
Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
Category
SEGMENT
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.device
Field description
Device to which metrics apply.
Category
SEGMENT
Data Type
ENUM
CONNECTED_TV
DESKTOP
MOBILE
OTHER
TABLET
UNKNOWN
UNSPECIFIED
Type URL
google.ads.googleads.v17.enums.DeviceEnum.Device
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.hour
Field description
Hour of day as a number between 0 and 23, inclusive.
Category
SEGMENT
Data Type
INT32
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.month
Field description
Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Category
SEGMENT
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.quarter
Field description
Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Category
SEGMENT
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.week
Field description
Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Category
SEGMENT
Data Type
DATE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
segments.year
Field description
Year, formatted as yyyy.
Category
SEGMENT
Data Type
INT32
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.average_cost
Field description
The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.average_cpv
Field description
The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.conversions
Field description
The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.cost_per_conversion
Field description
The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.interaction_rate
Field description
How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Category
METRIC
Data Type
DOUBLE
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
metrics.interactions
Field description
The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-18 UTC."],[[["This page helps you build Google Ads API queries for campaign groups, allowing you to select specific fields, segments, and metrics."],["When 'campaign_group' is specified in the FROM clause, only certain fields, segments, and metrics are available for use."],["Use the provided filter to see which fields, segments, and metrics can be used with 'campaign_group' in the FROM clause to ensure your queries are valid."],["The page provides detailed information on each field, segment, and metric, including its description, data type, and whether it can be filtered or sorted."],["Campaign groups are identified by a unique ID and can be accessed using their resource name, which follows a specific format."]]],[]]
