user_interest

Page Summary

A user interest represents a particular interest-based vertical for targeting.
User interests have availability information which is an output-only field.
The launched_to_all field indicates if a user interest is available across all channels and locales.
User interests have a name, resource name, taxonomy type, ID, and a parent, all of which are output-only fields.
Various fields within user interest are filterable and selectable.

A user interest: a particular interest-based vertical to be targeted.

user_interest.availabilities
Field description	Output only. Availability information of the user interest.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v22.common.CriterionCategoryAvailability`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

user_interest.launched_to_all
Field description	Output only. True if the user interest is launched to all channels and locales.
Category	`ATTRIBUTE`
Data Type	`BOOLEAN`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

user_interest.name
Field description	Output only. The name of the user interest.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

user_interest.resource_name
Field description	Output only. The resource name of the user interest. User interest resource names have the form: `customers/{customer_id}/userInterests/{user_interest_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

user_interest.taxonomy_type
Field description	Output only. Taxonomy type of the user interest.
Category	`ATTRIBUTE`
Data Type	`ENUM AFFINITY IN_MARKET MOBILE_APP_INSTALL_USER NEW_SMART_PHONE_USER UNKNOWN UNSPECIFIED VERTICAL_GEO`
Type URL	`google.ads.googleads.v22.enums.UserInterestTaxonomyTypeEnum.UserInterestTaxonomyType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

user_interest.user_interest_id
Field description	Output only. The ID of the user interest.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

user_interest.user_interest_parent
Field description	Output only. The parent of the user interest.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
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 2026-04-22 UTC.

Blog
Visit our blog for important announcements.
Client Libraries
Use our officially supported client libraries.
YouTube
Access our video contents.
Discord
Join the Google Ads Discord server.