Los anuncios entran al admin, el gasto no se escapa.

00La tesis

La interfaz declara la frontera

El mapa curso→API dejó una lección incómoda: no todo lo que enseña el curso vive en la API. Hay capacidades con endpoint verificado, hay criterio que ningún endpoint reemplaza, y hay cosas que Meta bloqueó por versión o dejó solo en Ads Manager. En vez de esconder esa frontera, el módulo la firma en cada control con cinco sellos: tres dicen el poder del control, dos el origen del dato. Es la regla C13 hecha interfaz: nada finge llamar a Graph, y el «quién» nunca pretende venir de Meta.

Fuente: docs/meta-ads/02 y 05 · counts: api_mapped=18 · not_in_api=13 · el «quién» nunca sale de Graph

01El lugar en el nav

Meta Ads vive en Comunicación

El sidebar es el real de apps/admin (`admin-navigation.config.ts`), sin inventos. «Meta Ads» entra en la categoría Comunicación, junto a Notificaciones y Comunicaciones: es marketing saliente hacia los clientes de Mogos, no una operación ni una finanza. Dos subitems: Campañas y Públicos y píxel.

• El item lleva badge «Nuevo» los primeros 30 días — patrón ya usado por el admin en lanzamientos.
• Los subitems replican la estructura del config real (`items` anidados, como Envíos → Marítimos).

Clases 01 · 04 — pensar el sistema antes que la plataforma.

02Home del módulo

Salud primero, métricas después

Lo primero que se ve no es una campaña: es si el sistema está sano para operar. El GATE V completo (los 8 checks de `03-quality-gates.md`) con evidencia, la cuenta conectada con sus scopes, el gasto contra el tope, la fase de aprendizaje de cada campaña — y el kill switch a un click de distancia, siempre.

• El toggle Sandbox/Live vive en la barra: el sandbox acepta todo pero no entrega ni gasta — ahí corre la Fase 2 del camino agéntico.
• Si un check del GATE V cae, el módulo entero degrada a solo-lectura con el estado correspondiente (sección 15).

Clases 01 · 03 · 10 · Gates V1–V8 · Fases 0–1 de 04-agentic-path.

03Campañas

La lista lee como el negocio

Una fila por campaña con las métricas que el curso enseñó a leer (clase 06): CTR para el creativo, CPC para el costo de atención, CPA para la verdad, ROAS para el negocio y frecuencia para la fatiga. La nomenclatura de la clase 12 hace que el nombre solo ya diga objetivo, país, producto y mes.

• ABO/CBO es una columna, no una configuración escondida — la clase 11 la volvió decisión de negocio.
• «En pausa · espera aprobación» y «Meta revisa» son estados distintos: uno es nuestro (humano), el otro es de Meta (API).

Clases 05 · 06 · 11 · 12 — leer campañas con criterio.

04Detalle

Campaña → conjunto → anuncio, sin perderse

La jerarquía de Meta en un solo panel: a la izquierda el árbol con estado y aprendizaje por nivel; a la derecha los insights del nivel seleccionado con breakdowns, ventana de atribución y el trabajo asíncrono cuando el reporte es grande.

• Los cortes disponibles son los del mapa: edad, género, país, plataforma de publicación — cada chip lleva su parámetro real.
• El nivel seleccionado cambia el edge: GET /{campaign_id}/insights, /{adset_id}/insights o /{ad_id}/insights.

Clases 06 · 13 · 15 — diagnóstico por nivel.

05Canales · la puerta

Entras a Instagram y estás en Instagram

La pregunta de Carlos tiene respuesta de dos capas. ¿Se puede ver por canal con la API? Sí, derivándolo: no existe GET /instagram/campaigns ni «el canal» como carpeta — el enum documentado de publisher_platforms es facebook · instagram · threads · messenger · audience_network, y WhatsApp ni siquiera está ahí: es destino (CTWA). Por eso cada canal es una casa que Mogos arma con tres materiales: insights rebanados por plataforma (API), destino del anuncio (API) y lo first-party que ya es nuestro. Una habitación por pregunta — no un filtro sobre la tabla de campañas.

• Una campaña Advantage+ vive en varias casas a la vez: al entrar a Instagram ves su trozo IG, nunca «esta campaña es de IG».
• Threads aparece porque el enum lo trae — cero teatro: sin gasto, se dice sin gasto.
• «Atendida / por atender» usa la misma regla de la Bandeja, no una inventada: conversación activa en modo humano donde lo último lo dijo el cliente (lastUserMessageAt ≥ lastMessageAt) o hay handoff PENDING — el predicado unanswered de messaging-admin.service.ts. El inbox ya conoce TIKTOK: cuando haya pauta ahí, la casa nace con bandeja.

Enums citados: publisher_platforms · instagram_positions · whatsapp_positions:"status" · messenger_positions (doc placement-targeting v25.0).

06Canales · Instagram

La casa Instagram: todo lo que es IG, en un solo lugar

Dentro del canal hay habitaciones, no un filtro: resumen, campañas con su trozo IG, creativos que corrieron ahí, posiciones (el enum real: stream · story · reels · explore…), quién llegó con utm_medium=instagram, y la señal que alimenta la entrega. El Resumen junta una vista de cada habitación.

Identidad IG del mapa (gap-agent Page/IG) · breakdowns VERIFIED · enum de posiciones citado.

07Canales · WhatsApp

La casa WhatsApp: el canal de Mogos, no un Ads Manager falso

WhatsApp no es un publisher_platform (el enum citado no lo trae) — es destino. Su casa se arma con lo que Mogos ya tiene: campañas CTWA, los creativos que llevan al chat, la Bandeja con sus hilos (con y sin referral), y las plantillas que usamos alrededor del anuncio. Existe además whatsapp_positions: "status" como targeting documentado — si algún día pautamos en Status, la habitación ya tiene percha.

• Vacíos honestos listos: «no hay campañas CTWA» invita a crear una (queda en pausa); «hay chats sin referral» cuenta cuántos y por qué no se atribuyen.

Clase 16 · CTWA VERIFIED · whatsapp_positions citado · Bandeja y plantillas = activo Mogos.

08Resultados Mogos · qué funcionó

Éxito no es CTR: es en qué se volvió

Ads Manager rankea por métricas de Meta. Mogos rankea por lo que entró al negocio: cotizaciones, órdenes, conversaciones que se volvieron cliente. La definición es nuestra y está a la vista — y al abrir una campaña no cae un dump de columnas: cae el cruce, la cadena completa de gasto a margen.

• La fila «sin UTM · ciego» existe a propósito: el catálogo dice cuánto gasto no podemos explicar — y empuja la guarda del wizard.
• Insights aporta gasto y CPA (GET /{campaign_id}/insights); todo lo demás de la cadena es tubería Mogos.

Clases 06 · 13 · 14 — leer con criterio; el ranking es de negocio.

09Resultados Mogos · dónde

Instagram, Facebook o donde Meta decidió

El «dónde» agregado sale de Insights con breakdowns=publisher_platform,platform_position (VERIFIED; también existen device_platform e impression_device). El «quién por plataforma» solo existe si el UTM lleva la plataforma — Meta no da personas por placement, y la pantalla lo dice.

Clase 09 (placements broad) · 13 (breakdowns) — el dónde agregado es de Meta; el dónde con nombre es nuestro.

10Resultados Mogos · quién (web)

Del clic a la cotización, con nombre cuando lo hay

PostHog ya vive en la página de Mogos (apps/client/lib/posthog/: provider, identify al login, consentimiento opt-in, funnel cotización→orden). Lo que falta —y esta pantalla asume construido— es el catálogo de atribución: utm_* + fbclid guardados en la persona. Cada fila declara si es un cliente identificado o un visitante anónimo.

• «Solo con consentimiento» no es un filtro decorativo: sin opt-in PostHog no captura, y la fila no existe. El % ciego del home sale de aquí.
• La fila «entrada directa» mantiene la honestidad: cotizó, pero atribuirla a Meta sería inventar.

Sello PostHog — comportamiento web propio; Meta nunca entrega este nivel.

11Resultados Mogos · quién (WhatsApp)

El chat que llegó desde un anuncio, dicho con pruebas

Cloud API manda en el primer mensaje de un CTWA un bloque referral (source_id, source_url, headline, ctwa_clid). La Bandeja ya existe; el hueco natural para persistirlo es Conversation.context — hoy un JSON vacío por defecto. Cuando la conversación tiene userId, el «quién» es un cliente Mogos con nombre; si no, es un teléfono en inbox. Y si no hay referral, se dice.

Clase 16 (mensajes) — la conversación es el resultado; el referral es la prueba.

12Alta con guardas

El agente propone, el humano dispone

El wizard puede llenarlo una persona o el agente de Mogos — da igual: las guardas son las mismas. El payload se ve completo antes de tocar Meta, el dry-run es el default, el estado PAUSED va fijo en el código, y activar es otra acción, con otro registro. Los checks C del gate acompañan todo el flujo.

• Después de crear: conjunto (POST /act_{id}/adsets), creativo (/adcreatives) y anuncio (/ads) siguen el mismo patrón payload-visible.
• Fase 2 del camino agéntico: este mismo wizard corre idéntico contra la cuenta sandbox antes de tocar la real.

Clases 04 · 05 · Gates C3 C5 C6 C7 C13 · Fases 2–3.

13Creativos

El anuncio es el targeting

La clase 07 dio la estructura (gancho, contexto, valor, prueba, CTA) y la 08 el sistema de variaciones. El builder arma el object_story_spec; las variaciones van en asset_feed_spec con el conjunto en dinámico; y las mejoras Advantage+ se prenden por feature, nunca en bloque.

• El copy de los ganchos lleva sello Humano dentro del builder: la estructura la da el admin, la voz la pone el equipo.
• Imagen y video suben por act_{id}/adimages y /advideos a la librería de la cuenta.

Clases 07 · 08 · 09 — creativo como palanca principal.

14Públicos

Audiencias con origen y candados honestos

Cada audiencia dice su subtipo y su origen. Subir clientes hashea en la máquina del equipo antes de salir (SHA256, exigencia de la API). Y donde Meta no da endpoint — crear audiencias guardadas — el panel lo dice con todas las letras en vez de esconder el botón.

• El botón de subir dice lo que pasa: el hasheo ocurre antes de salir de la máquina — la API rechaza PII en claro.
• Remarketing de carritos (clase 03): audiencia WEBSITE filtrada por evento AddToCart sin Purchase.

Clases 03 · 09 — públicos como señal.

15Píxel y señal

La señal es el producto

La clase 02 lo dejó claro: sin señal el sistema no optimiza. El panel muestra el píxel, la calidad de coincidencia y el flujo de eventos con su deduplicación navegador+servidor — el event_id pareado es visible, no magia.

• Conversiones personalizadas (act_{id}/customconversions, máx. 100) para «Cotización enviada» sin tocar el código del sitio.

Clases 02 · 04 · 05 — señal confiable antes de gastar.

16Multi-objetivo

Tráfico, leads y mensajes — cada uno con su verdad

La clase 16 enseñó a repartir presupuesto por objetivo según los datos. El módulo lo refleja: tres flujos con sus endpoints reales — y el único pedazo que Meta cerró (lead ads dentro de Messenger) aparece cerrado, con la versión que lo cerró.

Clases 03 · 16 — objetivo según los datos del negocio.

17Catálogo

Los productos se venden solos, el feed se cuida

La clase 17 armó el catálogo y sus anuncios dinámicos. Aquí: el feed con su revisión diaria, los conjuntos de productos, y el creativo plantilla que Meta llena por persona — con la cadena completa de endpoints confirmada en el mapa.

Clase 17 — catálogos y anuncios dinámicos, cadena completa confirmada.

18Reglas y nombres

El sistema se cuida solo de noche

Las reglas de la clase 12 corren en Meta, no en un cron nuestro: adrules_library evalúa y ejecuta aunque nadie mire. El admin las redacta en lenguaje de negocio y muestra la traducción exacta. La nomenclatura tiene validador en vivo: si el nombre no cuenta la campaña, no pasa.

Clase 12 — nombres que informan, reglas que apagan.

19Reportes

Los datos son de la API, la historia es nuestra

Las columnas guardadas y las tablas dinámicas que el curso armó en Ads Manager (clase 13) viven aquí, en el admin — la API entrega los datos, las vistas son nuestras, y eso convierte un NOT_IN_API en una ventaja. La clase 14 aporta la plantilla de narrativa: es un formulario para humanos, no un botón de IA.

Clases 13 · 14 — Contexto → Hallazgo → Interpretación → Acción.

20Loop y escala

Lanzar, medir, decidir, iterar, escalar

El árbol de decisión de la clase 15 como interfaz: tres síntomas, cada uno con su diagnóstico y su acción — y las acciones distinguen su sello. Escalar existe en dos direcciones; la heurística del 20–30% acompaña como consejo, porque es criterio, no un parámetro de Graph.

Clases 10 · 15 · 18 — sistemas, no campañas.

21Auditoría y límites

Todo queda escrito, nada se agota en silencio

Cada llamada Graph —humana o del agente— deja fila: quién, qué path, con qué scope, qué respondió. Los dos tokens viven separados: ads_read para todos los que leen, ads_management solo en el servicio backend. Y el rate limit se administra como presupuesto, leyendo el header de Meta en cada respuesta.

Gates V3 · V7 · V8 · C9 · C11 — el porqué de cada fila.

22Estados

Los días malos también están diseñados

Siete estados reales del sistema, cada uno con qué pasó y qué hacer — en la voz del admin, sin disculpas vacías.

Post-processing y revisión — la API decide el ritmo, el admin lo cuenta.

23Zona humana

Lo que ningún endpoint hace

El curso insistió más en criterio que en botones. Estas cuatro superficies existen en el módulo justamente para no pretender que son API.

Clases 01 · 02 · 07 · 08 · 10 · 14 · 18 — el criterio es la diferencia.