Google Ads Master

• Estás configurando una nueva cuenta de Google Ads o incorporando una cuenta existente y necesitas recopilar configuración, acciones de conversión, presupuestos y límites de protección antes de tocar cualquier cosa.
• Quieres informes de rendimiento a nivel de campaña o de palabra clave —CTR, ROAS, Cuota de Impresiones en Búsqueda, CPA— interpretados según tu acción de conversión principal real en lugar de los totales mixtos de la interfaz.
• Necesitas investigar un CTR bajo, diagnosticar discrepancias en el valor de conversión, o analizar datos de términos de búsqueda y geografía para tomar decisiones de puja, negativos o segmentación.
• Quieres crear nuevas campañas de Búsqueda, grupos de anuncios o palabras clave en estado pausado a partir de una especificación estructurada, con una lectura de verificación GAQL posterior a la escritura para confirmar lo que se creó.

• Necesitas gestionar tipos de campaña que no sean de Búsqueda o plataformas fuera de Google Ads—esta habilidad está orientada a flujos de trabajo de Búsqueda en Google Ads.
• Deseas una optimización de campañas totalmente automatizada y sin intervención humana; esta habilidad requiere permiso explícito antes de cualquier operación de escritura.
• Aún no has completado la configuración mínima inicial (ID de cliente, autenticación, zona horaria de informes, acción de conversión principal)—la habilidad solicitará estos datos antes de continuar con el análisis o las escrituras.

Antes de cualquier análisis o modificación de cuenta, la habilidad recopila un conjunto mínimo de datos requeridos: ID de cliente, ruta OAuth/autenticación, token de desarrollador, zona horaria de informes, modelo de negocio, acción de conversión principal, objetivos de ROAS/CPA y permisos de escritura. Esto evita actuar sobre un contexto de cuenta incompleto o incompatible.

Toda creación de campañas, grupos de anuncios y palabras clave se establece de forma predeterminada en estado EN PAUSA, a menos que el usuario solicite explícitamente lo contrario. Los presupuestos y las pujas nunca se modifican sin confirmación, y cada escritura va seguida de una lectura de verificación en GAQL para resumir los IDs y estados correspondientes.

El análisis de rendimiento está anclado a la acción de conversión principal confirmada por el usuario: nunca se asume que sea una compra, un lead o un registro. Los totales de conversiones combinados en la interfaz de Google Ads se marcan como poco confiables hasta que el usuario confirme qué acciones cuentan.

Cuatro scripts se incluyen con la habilidad: un asistente compartido de cliente/configuración, un informe de resumen de campaña (diagnósticos de CTR/ROAS/IS), un informe de conversiones primarias a nivel de palabra clave, y un constructor de campañas de Búsqueda pausadas a partir de una especificación JSON. Todos los scripts utilizan el cliente gRPC de Python google-ads.

Las recomendaciones siguen un flujo de trabajo consistente: segmentar por grupo de intención utilizando las palabras clave reales del usuario y su mercado, aplicar acciones de mantener/observar/reducir/pausar/dividir/agregar negativos, y siempre hacer referencia a los nombres de campañas y palabras clave junto con las métricas para facilitar la acción.

La habilidad hace referencia a patrones internos de GAQL y advertencias de la API para evitar problemas conocidos de incompletitud en REST, dando preferencia al cliente gRPC. Las verificaciones de lectura posteriores a la escritura confirman el id/nombre/estado/presupuesto de la campaña, el id/estado del grupo de anuncios y el texto/concordancia/estado de las palabras clave.

Un nuevo usuario conecta su cuenta de Google Ads y la habilidad recorre la lista de verificación de incorporación —recopilando el ID de cliente, autenticación, acción de conversión, objetivos y límites de seguridad— antes de ejecutar report_campaigns.py para generar un resumen base de CTR, ROAS y Cuota de Impresiones.

Un anunciante sospecha que su acción de conversión principal está siendo diluida por microconversiones en la interfaz. La habilidad ejecuta purchase_keywords.py enfocado en la acción principal confirmada y muestra qué palabras clave están generando resultados reales en comparación con recuentos inflados.

El CTR de la campaña ha caído y la causa no está clara. La habilidad extrae datos de términos de búsqueda y palabras clave, diagnostica si el problema es relevancia del anuncio, desviación del tipo de concordancia o pérdida de cuota de impresiones por clasificación, y recomienda acciones específicas de conservar/pausar/dividir/negativizar con evidencia métrica.

Un usuario proporciona un resumen de campaña con presupuestos, estrategia de puja, lista de palabras clave, tipos de concordancia, negativos, textos de anuncio y URLs. La habilidad formatea una especificación JSON, ejecuta create_search_skeleton.py en modo de prueba primero, luego crea la estructura en estado PAUSADO y lee de vuelta todos los IDs y estados para su confirmación.