The new Search Ads 360 Reporting API is now available. Join the
searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.
audience
Stay organized with collections
Save and categorize content based on your preferences.
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 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eAudience targeting lets you combine different segment attributes like demographics and affinities to create precise audience segments.\u003c/p\u003e\n"],["\u003cp\u003eThis feature enables you to target specific sections within your larger target segments for more effective advertising.\u003c/p\u003e\n"],["\u003cp\u003eYou can access details about your audiences, including their ID, description, and name, through the provided resources and fields.\u003c/p\u003e\n"],["\u003cp\u003eThese audience details are available for selection and filtering in your search ad queries for analysis and reporting.\u003c/p\u003e\n"]]],["Audiences allow for the targeting of specific customer segments by combining attributes like demographics and affinities. Key audience attributes include: a unique ID (`audience.id`), a unique name (`audience.name`) limited to 255 characters, a description (`audience.description`), and a resource name (`audience.resource_name`) that follows a predefined structure. These fields, along with customer data, can be filtered, selected, and sorted, but customer fields will not segment metrics.\n"],null,["# audience\n\nAudience is an effective targeting option that lets you intersect different segment attributes, such as detailed demographics and affinities, to create audiences that represent sections of your target segments.\n\n| Attributed resources |\n|--------------------------------------------------------------------|\n| [customer](/search-ads/reporting/api/reference/fields/v0/customer) |\n\nFields from the above resources may be selected along with this\nresource in your SELECT and WHERE clauses. These fields **will not segment**\nmetrics in your `SELECT` clause.\n\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | audience.description -------------------- || |-------------------|-------------------------------| | Field description | Description of this audience. | | Category | `ATTRIBUTE` | | Data Type | `STRING` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |\n| | audience.id ----------- || |-------------------|---------------------| | Field description | ID of the audience. | | Category | `ATTRIBUTE` | | Data Type | `INT64` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |\n| | audience.name ------------- || |-------------------|-----------------------------------------------------------------------------------------------------------------------------------------| | Field description | Required. Name of the audience. It should be unique across all audiences. It must have a minimum length of 1 and maximum length of 255. | | Category | `ATTRIBUTE` | | Data Type | `STRING` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |\n| | audience.resource_name ---------------------- || |-------------------|--------------------------------------------------------------------------------------------------------------------| | Field description | The resource name of the audience. Audience names have the form: `customers/{customer_id}/audiences/{audience_id}` | | Category | `ATTRIBUTE` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |"]]
