Audience
Stay organized with collections
Save and categorize content based on your preferences.
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 |
resource_name
|
string
Immutable. The resource name of the audience. Audience names have the form: customers/{customer_id}/audiences/{audience_id}
|
id
|
int64
Output only. ID of the audience.
|
status
|
AudienceStatus
Output only. Status of this audience. Indicates whether the audience is enabled or removed.
|
description
|
string
Description of this audience.
|
dimensions[]
|
AudienceDimension
Positive dimensions specifying the audience composition.
|
exclusion_dimension
|
AudienceExclusionDimension
Negative dimension specifying the audience composition.
|
scope
|
AudienceScope
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.
|
asset_group
|
string
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.
|
name
|
string
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.
|
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 2025-08-07 UTC.
[null,null,["Last updated 2025-08-07 UTC."],[],[],null,["# 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.\n\n| Fields ||\n|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `resource_name` | `string` Immutable. The resource name of the audience. Audience names have the form: `customers/{customer_id}/audiences/{audience_id}` |\n| ### `id` | `int64` Output only. ID of the audience. |\n| ### `status` | [AudienceStatus](/google-ads/api/reference/rpc/v19/AudienceStatusEnum.AudienceStatus) Output only. Status of this audience. Indicates whether the audience is enabled or removed. |\n| ### `description` | `string` Description of this audience. |\n| ### `dimensions[]` | [AudienceDimension](/google-ads/api/reference/rpc/v19/AudienceDimension) Positive dimensions specifying the audience composition. |\n| ### `exclusion_dimension` | [AudienceExclusionDimension](/google-ads/api/reference/rpc/v19/AudienceExclusionDimension) Negative dimension specifying the audience composition. |\n| ### `scope` | [AudienceScope](/google-ads/api/reference/rpc/v19/AudienceScopeEnum.AudienceScope) 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. |\n| ### `asset_group` | `string` 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. |\n| ### `name` | `string` 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. |"]]