Opus Growth

List Audiences

Lists the account's audiences (remarketing / rule-based / customer-match / lookalike): id, name, type, membership status, membership duration (days), Display/Search network size.

Tipo
Solo lectura
Créditos
1
Plataforma
Google Ads
Aprobación
No hace falta, nada cambia

Qué hace

Lists the account's audiences (remarketing / rule-based / customer-match / lookalike): id, name, type, membership status, membership duration (days), Display/Search network size.

definition=true also returns WHAT DEFINES each list, which the name alone does not tell you and which you need before attaching or — far more dangerous — EXCLUDING one: for a RULE_BASED list the URL/event rule items with their operators and lookback window; for a LOGICAL/COMBINED list the constituent lists resolved to NAMES with their ANY/ALL/NONE operator; for a SIMILAR list the seed list; for CRM_BASED the upload key and data source. Excluding a list that turns out to be "anyone who reached any thank-you page" silently suppresses real prospects, so check the rule rather than trusting the name. Google does NOT store a readable rule for every list — older ones come back with definition_available=false, and then the Google Ads interface (Tools, Audience manager) is the only place to read it. Every audience is retained: limit controls only this response page and page_token continues from cache without a new query or credit. Read-only.

La descripción está en inglés porque es el texto oficial que ve tu IA.

MCP: list_audiences

Cómo usarla

No llamas a las herramientas por su nombre. Escribe lo que quieres en ChatGPT, Claude u otro asistente conectado a Opus Growth; la IA elige esta herramienta cuando encaja.

Parámetros

NombreTipoObligatorioPor defecto
customer_idstringObligatorio·Google Ads customer account ID to query or change. Use the numeric ID returned by list_accounts; omit separators unless this tool explicitly says otherwise.
limitintegerOpcional0Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete.
definitionbooleanOpcionalfalseWhether to enable definition for this operation.
page_tokenstringOpcional·Continuation token returned as next_page_token by a previous call. Leave empty for the first page; pass it unchanged to retrieve the cached next page.