audience

Help me build a query

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