rudy-io/construir-centros-de-control-de-anuncios

Construir Centros de Control de Anuncios

Objetivo

Construir un cockpit publicitario fiable para Google Ads y Meta Ads. Preservar la procedencia de los números, las diferencias entre plataformas, el aislamiento de las organizaciones y la seguridad de las acciones enviadas a las plataformas.

Clasificar el producto antes de construir

• Reporting: conexión, sincronización y solo lectura.
• Pilotaje asistido: recomendaciones, previsualización y luego validación humana de presupuestos, pausas y reanudaciones.
• SaaS autoservicio: OAuth multiusuario, selección de cuentas, gestión de derechos, facturación, conformidad y soporte.

No prometer el tercer nivel si solo existen una conexión de administrador y pruebas simuladas.

Comenzar por el contexto real

Inspeccionar el repositorio y la infraestructura existentes antes de elegir una pila tecnológica. Recopilar los usuarios objetivo, la cantidad de cuentas, la frecuencia de actualización, el histórico esperado, la fuente de verdad de las conversiones, las monedas, las zonas horarias, el alojamiento y las restricciones de conformidad.

Dimensionar la solución al nivel seleccionado. Para una herramienta interna de una sola organización en solo lectura, basta con una organización única, roles simples y un monolito. No imponer OAuth autoservicio, microservicios, facturación ni flujo de aprobación sin una necesidad correspondiente.

Cargar las referencias útiles

• Leer siempre architecture-data-sync.md.
• Para Google Ads, leer google-ads.md.
• Para Meta Ads, leer meta-ads.md.
• Antes de cualquier escritura externa o puesta en producción, leer production-safety.md.
• Antes de declarar el sistema terminado, aplicar las secciones pertinentes de acceptance-checklist.md.

Las versiones de API, permisos, procedimientos de revisión y cuotas cambian. Verificar las documentaciones oficiales en el momento de la implementación.

Flujo de trabajo

1. Establecer una matriz de capacidades: plataforma, lectura/escritura, fuente, estado probado y límites.
2. Diseñar organizaciones, miembros, roles, conexiones, cuentas publicitarias y registro de auditoría.
3. Implementar primero los conectores en solo lectura y conservar la procedencia en bruto.
4. Sincronizar mediante tareas idempotentes hacia una base normalizada. Mostrar frescura, errores, cobertura y contexto de atribución.
5. Reconciliar una muestra en un período cerrado con las interfaces nativas de Google y Meta.
6. Generar las recomendaciones mediante reglas y cálculos deterministas. Usar un LLM solo para explicarlas o reformularlas.
7. Añadir cada escritura por separado con previsualización, autorización, límites, idempotencia, auditoría, relectura remota y procedimiento de retroceso.
8. Probar el aislamiento entre organizaciones, la expiración de OAuth, las cuotas, las reanudaciones de tareas y las métricas faltantes.

Invariantes

• Ningún secreto en el repositorio, el navegador, los registros, las capturas, las exportaciones ni los prompts.
• Nunca sumar de forma ingenua las conversiones de Google y Meta: conservar plataforma, acción, ventana y modelo de atribución.
• Una sincronización programada no es tiempo real.
• Nunca probar una mutación en una cuenta de producción sin autorización explícita y alcance preciso.
• Calificar cada capacidad: implementada, probada en sandbox, validada en producción o parcial.

Entregable esperado

Proporcionar la arquitectura y sus supuestos, el esquema de datos, los flujos de conexión de Google y Meta, la estrategia de sincronización, la matriz de permisos, las barreras de seguridad en escritura, las pruebas de reconciliación y el runbook de operaciones. Separar claramente lo que está realizado de lo que queda por validar.