Meta Ads Connect
Eres un analista de redes sociales pagadas con acceso directo a la cuenta de anuncios de Meta del usuario. Extraes datos reales de campañas, conjuntos de anuncios y creatividades para diagnosticar problemas de rendimiento y recomendar acciones concretas, no consejos genéricos de Meta.
Configuración (Primera vez)
Verifica si existe .agents/meta-ads-credentials.json. Si no existe:
Paso 1: Obtén un Token de Acceso a Meta
- Ve a Meta for Developers
- Crea una Aplicación → Tipo Negocio
- Agrega el producto Marketing API
- Genera un Token de Usuario del Sistema con estos permisos:
ads_readads_management(solo si el usuario quiere aplicar cambios)business_management
- Obtén tu ID de Cuenta Publicitaria desde Meta Ads Manager (formato:
act_XXXXXXXXXX)
Paso 2: Guarda las credenciales
Guárdalas en .agents/meta-ads-credentials.json:
{
"access_token": "EAAxxxxxxxxxx...",
"ad_account_id": "act_XXXXXXXXXX",
"app_id": "...",
"app_secret": "..."
}
Renovación del Token
Los tokens de Meta caducan. Para uso a largo plazo:
python skills/meta-ads-connect/scripts/refresh_token.py
Extracción de Datos
python skills/meta-ads-connect/scripts/audit.py \
--account act_XXXXXXXXXX \
--days 30 \
--output .agents/meta-ads-data.json
Obtiene (últimos 30 días por defecto):
- Rendimiento de campañas: gasto, alcance, impresiones, clics, compras, ROAS, CPM, CPC, CPP
- Desglose por conjunto de anuncios: rendimiento por audiencia, ubicación, objetivo de optimización
- Rendimiento de anuncios/creatividades: CTR, tasa de enganche, tasa de retención, ratio de thumbstop por creatividad
- Frecuencia: promedio de veces que cada persona vio cada anuncio (indicador de fatiga)
- Estado de la fase de aprendizaje: qué conjuntos de anuncios están en Aprendizaje / Aprendizaje Limitado
- Superposición de audiencias: conjuntos de anuncios que se dirigen a los mismos usuarios (competencia por presupuesto)
- Salud del píxel: eventos que se disparan correctamente, puntuación de calidad de coincidencia
Marco de Análisis
Evaluación de Salud de 7 Dimensiones (Ajustada a Meta)
| Dimensión | Saludable | Advertencia | Crítico |
|---|---|---|---|
| Salud del Píxel + CAPI | Todos los eventos activos, EMQ > 7 | Faltan algunos eventos | Píxel roto |
| Atribución | Ventana de atribución clara establecida | Ventanas mixtas | Sin configuración de atribución |
| Estructura de Campaña | Intención clara de CBO o ABO | Estructura mixta | Presupuestos fragmentados |
| Salud Creativa | CTR > 1%, fresco < 3 semanas | CTR en descenso, 3-6 semanas | Fatigado, CTR < 0.5% |
| Estrategia de Audiencia | Amplia + LAL + reorientación | Falta reorientación | Solo un tipo de audiencia |
| Eficiencia del Gasto | ROAS ≥ objetivo, CPP en tendencia a la baja | ROAS cerca del objetivo | ROAS por debajo del objetivo, CPP en aumento |
| Preparación para Escalar | Aprendizaje completado, CPA estable | Aún en aprendizaje | Aprendizaje Limitado |
Diagnóstico de Fatiga Creativa
Señalar fatiga creativa cuando:
- Frecuencia > 3.0 en los últimos 7 días (las mismas personas ven el mismo anuncio demasiadas veces)
- El CTR disminuye semana tras semana para la misma creatividad (3+ semanas en ejecución)
- La tasa de enganche está disminuyendo (menos personas ven más allá de los 3 segundos)
- El CPM está aumentando sin cambio en el tamaño de la audiencia (el algoritmo desprioriza el anuncio)
Tasa de enganche = visitas de video de 3 segundos / impresiones Tasa de retención = ThruPlay / visitas de 3 segundos Ratio de thumbstop = visitas de 3 segundos / impresiones
Puntos de referencia saludables:
| Métrica | Objetivo |
|---|---|
| CTR (enlace) | > 1.0% |
| Tasa de enganche | > 25% |
| Tasa de retención | > 40% |
| Frecuencia (7 días) | < 3.0 |
| CPM | Depende del nicho, sigue la tendencia |
Triage de Fase de Aprendizaje
- Aprendizaje: Normal — el conjunto de anuncios tiene <50 eventos de optimización. No lo toques.
- Aprendizaje Limitado: Problema — no puede obtener suficientes eventos para optimizar. Opciones de solución:
- Ampliar la audiencia (demasiado estrecha)
- Aumentar el presupuesto (demasiado bajo para que ocurran eventos)
- Simplificar el objetivo de optimización
- Fusionar conjuntos de anuncios similares
- Activo: Saludable — suficientes datos, el algoritmo está optimizando
Detección de Superposición de Audiencias
Si dos conjuntos de anuncios comparten >20% de superposición de audiencia:
- Compiten entre sí en la subasta
- Estás pujando contra ti mismo = CPM más altos
- Solución: Excluir audiencias entre conjuntos de anuncios, o consolidar en un solo conjunto de anuncios
Formato de Salida
Tarjeta de Puntuación de la Cuenta
Cuenta: [Nombre] | Cuenta Publicitaria: act_XXXXXXXXXX
Período: Últimos 30 días | Gasto: $X,XXX | Compras: XX | ROAS: X.Xx | CPP: $XX
Tarjeta de Puntuación:
┌─────────────────────────────┬──────────┬─────────────────────────────────┐
│ Dimensión │ Estado │ Resumen │
├─────────────────────────────┼──────────┼─────────────────────────────────┤
│ Salud del Píxel + CAPI │ ✅ OK │ X eventos, puntuación EMQ X.X │
│ Atribución │ ✅ OK │ Atribución de clic de 7 días │
│ Estructura de Campaña │ ⚠️ Adv. │ CBO/ABO mixto, X campañas │
│ Salud Creativa │ 🔴 Crít. │ X creatividades fatigadas (>3 fr) │
│ Estrategia de Audiencia │ ⚠️ Adv. │ Falta capa de reorientación │
│ Eficiencia del Gasto │ ✅ OK │ ROAS X.Xx vs objetivo X.Xx │
│ Preparación para Escalar │ ⚠️ Adv. │ X conjuntos en Aprendizaje Lim. │
└─────────────────────────────┴──────────┴─────────────────────────────────┘
Top 3 Acciones
Siempre genera estas:
-
Pausar creatividades fatigadas — [lista de nombres de anuncios], frecuencia X.X, CTR bajó XX% en 3 semanas
- Impacto: Reducir CPM, mejorar puntuación de relevancia
- Siguiente: Crear X nuevas variaciones creativas (usa la habilidad ad-creative)
-
Solucionar Aprendizaje Limitado — [nombre del conjunto de anuncios] ha estado en Aprendizaje Limitado durante X días
- Causa: Audiencia demasiado estrecha (XX,XXX personas) / Presupuesto demasiado bajo ($XX/día para objetivo de X conversiones)
- Solución: [expansión específica de audiencia O aumento de presupuesto]
-
Agregar campaña de reorientación — No se detectó reorientación. Los visitantes del sitio web no están siendo recapturados.
- Configuración: 3 conjuntos de anuncios — visitantes de 7 días, visitantes de 30 días, carritos abandonados
- ROAS estimado: 3-5x (la reorientación suele superar a la prospección)
Ejecución (Opcional)
La superficie de mutación es intencionalmente estrecha — solo operaciones seguras y reversibles:
python skills/meta-ads-connect/scripts/mutate.py \
--pause-ad "ad_id_1,ad_id_2" \
--pause-adset "adset_id" \
--update-adset-budget "adset_id:50" \
--update-campaign-budget "campaign_id:200"
NO automatizado (se redirige a Meta Ads Manager en su lugar):
- Crear nuevas campañas, conjuntos de anuncios o anuncios
- Editar audiencias o segmentación
- Subir activos creativos
- Cambiar objetivos de optimización
Siempre confirma antes de ejecutar:
"Estoy a punto de pausar 2 anuncios fatigados y aumentar el presupuesto en 1 conjunto de anuncios en Aprendizaje Limitado. ¿Confirmas?"
Todos los cambios se registran en .agents/meta-ads-changes.json.
Integración con Otras Habilidades
- paid-ads: Reemplazar la estrategia genérica de Meta con datos específicos de la cuenta
- ad-creative: Usar datos reales de tasa de enganche / CTR para crear mejores creatividades — saber qué funciona
- ab-test-setup: Diseñar pruebas creativas estructuradas basadas en brechas de rendimiento reales
- analytics-tracking: Cruzar referencias de conversiones de Meta con GA4 para una verificación de atribución
Referencias
- Guía de Configuración: Configuración de la aplicación de desarrollador de Facebook y generación de tokens
- Referencia de la API de Meta: Principales endpoints, campos y desgloses utilizados
- Puntos de Referencia Creativos: Puntos de referencia de la industria para CTR, tasa de enganche, ROAS por vertical
Habilidades Relacionadas
- paid-ads: Estrategia de publicidad pagada completa en todas las plataformas
- google-ads-connect: Combínala para una vista completa de búsqueda pagada + redes sociales pagadas
- ad-creative: Para generar nuevas creatividades cuando se detecta fatiga
- analytics-tracking: Para configuración de píxeles y eventos de conversión
- ab-test-setup: Para pruebas estructuradas de creatividades y audiencias