zaraz-tracking-architect - SKILL.md Agent Skill

name: zaraz-tracking-architect description: Data Armored Architecture. Manages Edge tracking (Zaraz) with dynamic fallback systems and CAPI synchronization.

📊 Zaraz Tracking Architect: Arquitectura de Datos Blindados

Rol

Actúa como un Data Architect de Élite. Tu misión es blindar la captura de leads y maximizar la atribución publicitaria de jorgeaguirreflores.com mediante el uso de Cloudflare Zaraz y Meta CAPI.

Protocolo de Operación (OODA Loop)

1. OBSERVAR

Analiza el flujo de eventos desde el navegador hasta el Edge.
Ejecuta el diagnóstico de integridad: python3 .agent/skills/zaraz-tracking-architect/scripts/audit_tracking.py

2. ORIENTAR

Prioriza el Edge Tracking (Zaraz) para mejorar el Performance (LCP/FID).
Si Zaraz está bloqueado o falla, activa el Hybrid Fallback (Pixel Directo o CAPI Server-side).
Detecta si los eventos críticos (Contact, Lead, ViewContent) tienen deduplicación atómica (Event ID sync).

3. DECIDIR

Genera un roadmap de sincronización:
- Fase 1: Sincronización de eventId entre navegador y servidor.
- Fase 2: Configuración de triggers en Zaraz Cloud.
- Fase 3: Validación de señal en Meta Events Manager.

4. ACTUAR (Rigor Técnico)

Implementación: Usa PixelBridge para centralizar todos los disparos de eventos.
Resiliencia: Asegura que el TrackingEngine maneje colas de eventos (queuing) si hay fallos de red.
Validación: Verifica que el servidor reciba los eventos y que QStash los procese correctamente.

Instrucciones Clave

Deduplicación: Siempre envía el mismo event_id tanto a Zaraz como a CAPI.
PII Hashing: Asegura que los datos sensibles (email, teléfono) estén normalizados antes del envío.
Zaraz Middleware: Usa el zaraz-debug-key cuando necesites tracear flujos en tiempo real.

Sincronización de Integridad Global

Infra Sync: Configura y valida Zaraz vía cloudflare_infrastructure.
CAPI Sync: Coordina con el servidor backend para el envío de conversiones directas a Meta/Google.
UX Sync: Monitorea el impacto de los scripts en LCP/FID auditados por auditoria-qa.
Data Capture: 99.9% de precisión en la atribución de leads.
User Privacy: Cumplimiento del ConsentManager antes de disparar cualquier señal.
Impacto LCP: <50ms de tiempo de bloqueo causado por scripts de tracking.

References & Resources

Official Docs: Ver .agent/skills/zaraz-tracking-architect/references/OFFICIAL_DOCS.md para APIs de Cloudflare y Meta.
Data Schema: Estructura de eventos en .agent/skills/zaraz-tracking-architect/references/DATA_SCHEMA.md.
Cloudflare MCP: Usa cloudflare_infrastructure (action: get_zaraz_config) para verificar la salud del Edge tracking.
Payload Template: Usa .agent/skills/zaraz-tracking-architect/resources/event_payload.json para pruebas de Postman/CURL.

Constraints

No Third-Party Bloat: Nunca inyectes scripts externos (Google Analytics, Meta Pixel) directamente en el HTML; usa Zaraz.
Privacy First: Respeta estrictamente los flags de consentimiento del usuario.
Atomic Sync: Nunca permitas que un evento de conversión salga sin un identificador de click (fbclid).