audience

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.

Attributed resources
asset_group
customer

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.

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`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

audience.description
Field description	Description of this audience.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

audience.dimensions
Field description	Positive dimensions specifying the audience composition.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v17.common.AudienceDimension`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

audience.dimensions.audience_segments.segments.custom_audience.custom_audience
Field description	The custom audience resource.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	False
Sortable	False
Repeated	False

audience.dimensions.audience_segments.segments.detailed_demographic.detailed_demographic
Field description	The detailed demographic resource.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	False
Sortable	False
Repeated	False

audience.dimensions.audience_segments.segments.life_event.life_event
Field description	The life event resource.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	False
Sortable	False
Repeated	False

audience.dimensions.audience_segments.segments.user_interest.user_interest_category
Field description	The user interest resource.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	False
Sortable	False
Repeated	False

audience.dimensions.audience_segments.segments.user_list.user_list
Field description	The user list resource.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	False
Sortable	False
Repeated	False

audience.exclusion_dimension
Field description	Negative dimension specifying the audience composition.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v17.common.AudienceExclusionDimension`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

audience.exclusion_dimension.exclusions.user_list.user_list
Field description	The user list resource.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	False
Sortable	False
Repeated	False

audience.id
Field description	Output only. ID of the audience.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

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.v17.enums.AudienceScopeEnum.AudienceScope`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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.v17.enums.AudienceStatusEnum.AudienceStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

audience

audience.asset_group

audience.description

audience.dimensions

audience.dimensions.audience_segments.segments.custom_audience.custom_audience

audience.dimensions.audience_segments.segments.detailed_demographic.detailed_demographic

audience.dimensions.audience_segments.segments.life_event.life_event

audience.dimensions.audience_segments.segments.user_interest.user_interest_category

audience.dimensions.audience_segments.segments.user_list.user_list

audience.exclusion_dimension

audience.exclusion_dimension.exclusions.user_list.user_list

audience.id

audience.name

audience.resource_name

audience.scope

audience.status