Register for one of our Google Ads API Migration Workshops (October 5, 2021 - October 14, 2021)

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 descriptionDescription of this custom audience.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

custom_audience.id

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

custom_audience.members

Field descriptionList 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.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v8.resources.CustomAudienceMember
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

custom_audience.name

Field descriptionName of the custom audience. It should be unique for all custom audiences created by a customer. This field is required for creating operations.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

custom_audience.resource_name

Field descriptionImmutable. The resource name of the custom audience. Custom audience resource names have the form: `customers/{customer_id}/customAudiences/{custom_audience_id}`
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

custom_audience.status

Field descriptionOutput only. Status of this custom audience. Indicates whether the custom audience is enabled or removed.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.CustomAudienceStatusEnum.CustomAudienceStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

custom_audience.type

Field descriptionType of the custom audience. ("INTEREST" OR "PURCHASE_INTENT" is not allowed for newly created custom audience but kept for existing audiences)
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.CustomAudienceTypeEnum.CustomAudienceType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse