custom_audience

Page Summary

• A custom audience is a list of users based on their interests.

• The unique identifier for a custom audience is its name, and using a name that already exists will result in an error.

• You can select and filter fields from the customer resource along with custom_audience fields, but these will not segment metrics in your SELECT clause.

• Key fields available for a custom audience include description, ID, members, name, resource name, status, and type.

• Custom audience members are added during creation and can be overridden during an update operation.

Help me build a query Proto definition

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