La nouvelle API Search Ads 360 Reporting est désormais disponible. Rejoignez le groupe Google
searchads-api-announcements pour vous tenir informé des améliorations et versions à venir.
audience
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (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 | |"]]
