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 descriptionImmutable. 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.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

audience.description

Field descriptionDescription of this audience.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

audience.dimensions

Field descriptionPositive dimensions specifying the audience composition.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v18.common.AudienceDimension
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

audience.dimensions.audience_segments.segments.custom_audience.custom_audience

Field descriptionThe custom audience resource.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

audience.dimensions.audience_segments.segments.detailed_demographic.detailed_demographic

Field descriptionThe detailed demographic resource.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

audience.dimensions.audience_segments.segments.life_event.life_event

Field descriptionThe life event resource.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

audience.dimensions.audience_segments.segments.user_interest.user_interest_category

Field descriptionThe user interest resource.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

audience.dimensions.audience_segments.segments.user_list.user_list

Field descriptionThe user list resource.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

audience.exclusion_dimension

Field descriptionNegative dimension specifying the audience composition.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v18.common.AudienceExclusionDimension
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

audience.exclusion_dimension.exclusions.user_list.user_list

Field descriptionThe user list resource.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

audience.id

Field descriptionOutput only. ID of the audience.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

audience.name

Field descriptionName 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.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

audience.resource_name

Field descriptionImmutable. The resource name of the audience. Audience names have the form: customers/{customer_id}/audiences/{audience_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

audience.scope

Field descriptionDefines 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.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.AudienceScopeEnum.AudienceScope
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

audience.status

Field descriptionOutput only. Status of this audience. Indicates whether the audience is enabled or removed.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.AudienceStatusEnum.AudienceStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse