custom_audience

A custom audience. This is a list of users by interest.

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.v18.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.v18.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.v18.enums.CustomAudienceTypeEnum.CustomAudienceType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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 2024-12-18 UTC.

Blog
Visit our blog for important announcements.
Forum
Interact with our community of developer experts.
Client Libraries
Use our officially supported client libraries.
YouTube
Access our video contents.