Documentation
Connect your marketing data to Claude, ChatGPT and other LLMs.
Performance Max — deep dive
PMax es el tipo de campaña más opaco de Google. Sin targeting de keywords, sin ad groups en el sentido tradicional, el ML decide todo. gadspilot es el único MCP que expone read Y write sobre toda la superficie PMax — 16 tools dedicados, 3 pestañas insights dedicadas, reglas IA custom.
Cómo funciona PMax realmente
Una campaña PMax difunde en 7 superficies Google automáticamente:
- Search (resultados + partners)
- Display Network (sitios de terceros)
- YouTube (in-stream + in-feed + Shorts)
- Discover feed (móvil)
- Gmail (pestaña promociones)
- Maps (resultados locales)
- Shopping (si feed de producto)
El ML de Google asigna el presupuesto en tiempo real entre estas 7 superficies según la probabilidad de conversión predicha. No eliges dónde. Tu único control va por 4 señales indirectas:
- Search themes — pistas tipo keyword (sugieres «hosting VPS»)
- Audience signals — «aquí están mis mejores clientes» (customer match, similar audiences, custom segments)
- Asset groups — bundles creativos (headlines, descriptions, imágenes, vídeos, logos)
- Listing groups — solo para Shopping
El algo IGNORA o SIGUE estas señales según sus predicciones. Por eso analizar un PMax sin ver estas 3 capas = analizar a ciegas.
3 pestañas dedicadas en /accounts/{id}/insights
Cuando la campaña seleccionada es PMax (o la vista all campaigns con un PMax en la cuenta), aparecen 3 pestañas extra abajo:
🎯 PMax signals
Lista todos los search themes + audience signals attachados a cada asset group. Si el conteo es 0, la IA flagga esto como causa mayor de bajo rendimiento (el algo corre a ciegas durante la fase de aprendizaje). Layout 2 columnas lado a lado.
🔍 PMax search terms
Google no revela las consultas individuales en PMax (a diferencia de Search) pero las agrupa en CATEGORÍAS vía campaign_search_term_insight. Cubre ~20-40 % de las impresiones. Útil para descubrir temas mal alineados a excluir vía shared lists.
⭐ PMax asset perf
Google evalúa cada asset (BEST / GOOD / LOW / PENDING / LEARNING). La tabla muestra tipo de asset + contenido + asset group + label de rendimiento coloreado. Reemplaza los assets LOW en prioridad, monitorea PENDING durante 7-14 días.
16 tools MCP específicos PMax
Read
| Tool | Propósito |
|---|---|
get_pmax_performance | KPIs headline de las campañas PMax |
list_shared_sets | Encontrar listas negative / brand existentes |
list_shared_set_criteria | Inspeccionar lo que hay dentro de una shared list |
list_audiences + get_audience | Descubrir audiencias antes de attacharlas como signals |
Write — targeting
| Tool | Propósito |
|---|---|
asset_group_signal_add | Añadir un search theme O un audience signal a un asset group |
asset_group_signal_remove | Quitar un signal por resource_name |
audience_create_custom_segment | Construir «Competidores X» desde URLs de competidores + keywords |
Write — negatives (el único mecanismo para PMax)
| Tool | Propósito |
|---|---|
shared_set_create | Crear lista NEGATIVE_KEYWORDS / BRANDS / NEGATIVE_PLACEMENTS |
campaign_shared_set_link | Vincular a una campaña PMax |
campaign_shared_set_unlink | Desvincular (preserva la lista, útil para A/B test) |
shared_set_criterion_add | Añadir keywords (con match_type) a una lista |
shared_set_criterion_remove | Quitar por criterion_ids |
add_negative_placements | Bloquear sitios + apps + vídeos/canales YouTube |
Write — assets & creatividades
| Tool | Propósito |
|---|---|
asset_create | Crear asset texto / imagen (URL fetch) / vídeo YouTube |
asset_group_asset_add | Vincular asset a group con field_type (HEADLINE, MARKETING_IMAGE, etc.) |
asset_group_asset_remove | Desvincular (preserva el asset) |
Regla IA 5ter — lo que la IA sabe sobre PMax
Cuando el chat in-app detecta un scope PMax, el system prompt impone un análisis de 3 ejes:
- Search themes: si NINGUNO, esta es una causa mayor de bajo rendimiento — el algo no tiene ningún hint de keyword. La IA debe recomendar 5-10 temas alineados con el producto.
- Audience signals: si NINGUNO, pérdida típica del 30 % de precisión de targeting. La IA recomienda customer match list / similar / custom segments según el producto.
- Asset perf labels: contar los assets LOW y proponer reemplazarlos (citando los ejemplos provistos). Monitorear PENDING (necesita 7-14 días más de datos).
Definir el CPA / ROAS objetivo en PMax (la trampa)
Performance Max NO acepta TARGET_CPA o TARGET_ROAS como estrategias de pujas directas — la API rechaza con error. La forma correcta es usar MAXIMIZE_CONVERSIONS (o MAXIMIZE_CONVERSION_VALUE) con un sub-campo target_cpa_micros / target_roas:
# MAL: será rechazado por la API Google Ads update_bidding_strategy( campaign_id="...", bidding_strategy="TARGET_CPA", # ❌ no permitido en PMax target_cpa_micros=25000000 ) # BIEN: patrón «Maximize conversions with target CPA» update_bidding_strategy( campaign_id="...", bidding_strategy="MAXIMIZE_CONVERSIONS", # ✓ PMax acepta esto target_cpa_micros=25000000 # = 25 € de CPA objetivo ) # Misma lógica para value-based bidding: update_bidding_strategy( campaign_id="...", bidding_strategy="MAXIMIZE_CONVERSION_VALUE", target_roas=2.5 # = 250 % de ROAS objetivo )
TARGET_CPA y TARGET_ROAS directamente — esta restricción de PMax es específica del modelo de pujas híbrido del algo. La descripción del tool MCP detalla ambos casos para que Claude elija el correcto automáticamente.Workflow completo de audit PMax (vía Claude)
Audita mi campaña PMax 23639991014: 1. Saca el rendimiento de los últimos 30 días vía get_pmax_performance y el breakdown por canal 2. Verifica los 3 ejes PMax: - asset_group_signal_add revela: ¿cuántos temas? ¿cuántos signals de audiencia? - notas de rendimiento de los assets: ¿cuántos assets LOW por grupo? - categorías de search terms: ¿cuál es la categoría top-spend? ¿matchea la intención de producto? 3. Encuentra candidatos a añadir como negatives: - get_search_terms (limitado pero útil) - cross-referencia con list_shared_set_criteria para la lista NEGATIVE_KEYWORDS vinculada 4. Propón un plan de acción: - Para los assets LOW: sugiere reemplazos específicos - Para los signals que faltan: sugiere 5 temas + 1 tipo de audiencia - Para las categorías de spend desperdiciado: lista los nuevos negatives a añadir 5. Una vez aprobado, ejecuta los writes (dry_run=true primero, luego false): - shared_set_criterion_add para los negatives - asset_group_signal_add para los signals que faltan - asset_create + asset_group_asset_add para las nuevas creatividades
FAQ
¿Puedo añadir keyword negatives normales a una campaña PMax?
No. PMax no soporta negatives directos a nivel campaña ni ad-group. Solo funcionan las shared lists. Si Claude intenta add_negative_keywords en una campaña PMax, la API rechaza con un error claro. Usa el workflow shared set en su lugar.
¿Cómo reseteo una PMax que se ha descarrilado?
No pauses + recrees (pierde el learning). En su lugar: (1) Añade negatives agresivos vía shared lists, (2) Refuerza search themes (5-10 específicos al producto), (3) Añade audience signals, (4) Reemplaza los assets evaluados como LOW. Dale 7-14 días. Si sigue mal, baja el presupuesto un 30 % (no pauses) para que el algo limpie sus propios datos sin perder la campaña.
¿Qué hacer si no tengo datos de customer match para los audience signals?
Usa audience_create_custom_segment para construir uno desde URLs de competidores (heroku.com, vercel.com para SaaS) + intenciones keyword («alternativa a X», «vs Y»). Google valida en ~24h, luego attacha vía asset_group_signal_add(type=AUDIENCE).
¿Puedo ver exactamente en qué placement (sitio / app / canal YouTube) corren mis anuncios PMax?
Parcialmente. La pestaña «Diffusion» muestra placements con conteos de impresiones (PMax limita los datos — sin spend, sin clicks por placement). Para excluir los malos: add_negative_placements(youtube_channel_ids=[...], urls=[...], app_ids=[...]).
