To discuss and provide feedback on our products, join the official Google Ads Discord channel in the Google Advertising and Measurement Community server.

custom_audience

AI-generated Key Takeaways

A custom audience is a list of users defined by interest, with "name" serving as the unique key, and duplicate names resulting in an error.
Fields from the customer resource can be selected along with custom audience fields but will not segment metrics.
Custom audience fields include description, ID, members, name, resource_name, status, and type, with various data types and filter/select/sort capabilities.
The custom_audience.members field is a repeated message field containing the list of members, which can be overridden during an update operation.
Custom audiences have a status indicating if they are enabled or removed, and a type, though "INTEREST" or "PURCHASE_INTENT" are not allowed for new audiences.

A custom audience. This is a list of users by interest. The unique key of a custom audience consists of the following fields: name. Violating the unique key constraint produces error: CustomAudienceError.NAME_ALREADY_USED

Attributed resources
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.

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

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

custom_audience.members
Field description	List of custom audience members that this custom audience is composed of. Members can be added during CustomAudience creation. If members are presented in UPDATE operation, existing members will be overridden.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v22.resources.CustomAudienceMember`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

custom_audience.name
Field description	Name of the custom audience. It should be unique for all custom audiences created by a customer. This field is required for creating operations.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

custom_audience.resource_name
Field description	Immutable. The resource name of the custom audience. Custom audience resource names have the form: `customers/{customer_id}/customAudiences/{custom_audience_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

custom_audience.status
Field description	Output only. Status of this custom audience. Indicates whether the custom audience is enabled or removed.
Category	`ATTRIBUTE`
Data Type	`ENUM ENABLED REMOVED UNKNOWN UNSPECIFIED`
Type URL	`google.ads.googleads.v22.enums.CustomAudienceStatusEnum.CustomAudienceStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

custom_audience.type
Field description	Type of the custom audience. ("INTEREST" OR "PURCHASE_INTENT" is not allowed for newly created custom audience but kept for existing audiences)
Category	`ATTRIBUTE`
Data Type	`ENUM AUTO INTEREST PURCHASE_INTENT SEARCH UNKNOWN UNSPECIFIED`
Type URL	`google.ads.googleads.v22.enums.CustomAudienceTypeEnum.CustomAudienceType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

custom_audience Stay organized with collections Save and categorize content based on your preferences.

AI-generated Key Takeaways

custom_audience.description

custom_audience.id

custom_audience.members

custom_audience.name

custom_audience.resource_name

custom_audience.status

custom_audience.type

custom_audience