audience
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition
Audience is an effective targeting option that lets you
intersect different segment attributes, such as detailed demographics and
affinities, to create audiences that represent sections of your target
segments.
Fields from the preceding resources can be selected along with this
resource in your SELECT and WHERE clauses. These fields do not segment
metrics in your SELECT clause.
audience.asset_group
Field description Immutable. The asset group that this audience is scoped under. Must be set
if and only if scope is ASSET_GROUP. Immutable after creation. If an
audience with ASSET_GROUP scope is upgraded to CUSTOMER scope, this field
will automatically be cleared.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Capabilities Selectable: True Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.description
Field description Description of this audience.
Category ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.dimensions
Field description Positive dimensions specifying the audience composition.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v26.common.AudienceDimension
Capabilities Selectable: True Filterable: False Sortable: False Repeated: True
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.dimensions.audience_segments.segments.custom_audience.custom_audience
Field description The custom audience resource.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Capabilities Selectable: False Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.dimensions.audience_segments.segments.detailed_demographic.detailed_demographic
Field description The detailed demographic resource.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Capabilities Selectable: False Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.dimensions.audience_segments.segments.life_event.life_event
Field description The life event resource.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Capabilities Selectable: False Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.dimensions.audience_segments.segments.user_interest.user_interest_category
Field description The user interest resource.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Capabilities Selectable: False Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.dimensions.audience_segments.segments.user_list.user_list
Field description The user list resource.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Capabilities Selectable: False Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.exclusion_dimension
Field description Negative dimension specifying the audience composition.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v26.common.AudienceExclusionDimension
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.exclusion_dimension.exclusions.user_list.user_list
Field description The user list resource.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Capabilities Selectable: False Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.id
Field description Output only. ID of the audience.
Category ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: audience
audience.name
Field description Name of the audience. It should be unique across all audiences within the
account. It must have a minimum length of 1 and maximum length of 255.
Required when scope is not set or is set to CUSTOMER. Cannot be set or
updated when scope is ASSET_GROUP.
Category ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as audience.id .
audience.resource_name
Field description Immutable. The resource name of the audience.
Audience names have the form:
customers/{customer_id}/audiences/{audience_id}
Category ATTRIBUTE
Data Type RESOURCE_NAME
Capabilities Selectable: True Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as audience.id .
audience.scope
Field description Defines the scope this audience can be used in. By default, the scope is
CUSTOMER. Audiences can be created with a scope of ASSET_GROUP for
exclusive use by a single asset_group. Scope may change from ASSET_GROUP to
CUSTOMER but not from CUSTOMER to ASSET_GROUP.
Category ATTRIBUTE
Data Type ENUM
ASSET_GROUP
CUSTOMER
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.AudienceScopeEnum.AudienceScope
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as audience.id .
audience.status
Field description Output only. Status of this audience. Indicates whether the audience
is enabled or removed.
Category ATTRIBUTE
Data Type ENUM
ENABLED
REMOVED
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.AudienceStatusEnum.AudienceStatus
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as audience.id .
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-11-17 UTC.
[null,null,["Last updated 2026-11-17 UTC."],[],[]]