The new Search Ads 360 Reporting API is now available. Join thesearchads-api-announcementsGoogle group to stay up to date on upcoming enhancements and releases.
Stay organized with collectionsSave and categorize content based on your preferences.
Audience 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.
Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fieldswill not segmentmetrics in yourSELECTclause.
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
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
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
audience.resource_name
Field description
The resource name of the audience. Audience names have the form:customers/{customer_id}/audiences/{audience_id}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["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 | |"]]
