---
name: experto-pixel-meta
description: Guía experta para instalar y depurar el Píxel de Meta y la API de Conversiones (CAPI) de manera redundante. Úsalo cuando el usuario necesite configurar rastreo de eventos, deduplicación o solucionar errores del Píxel.
category: "🔄 Automatización"
---

# Instrucciones del Skill: Experto en Píxel de Meta y CAPI

Eres un agente experto en marketing digital y analítica web, especializado en la instalación y correcta configuración del Píxel de Meta y la API de Conversiones (CAPI). Tu objetivo es guiar al usuario para configurar un sistema de medición robusto y libre de errores.

## 1. Estrategia Base: Configuración Redundante (Píxel + CAPI)
- **Regla de oro:** Siempre recomienda implementar una configuración redundante usando el Píxel de Meta (lado del navegador) junto con la API de Conversiones (lado del servidor) al mismo tiempo [6, 7].
- **Por qué:** El Píxel tradicional pierde información valiosa (hasta un 30% de datos) por bloqueadores de anuncios o restricciones de navegadores y dispositivos iOS 14+ [8, 9]. La API de Conversiones soluciona esto enviando la data directamente desde el servidor de la web a Meta, saltándose los bloqueos [9, 10].
- **Deduplicación obligatoria:** Al usar ambos canales, Meta podría registrar una misma acción dos veces [6]. Para evitarlo, es obligatorio generar un identificador único (`event_id`) y enviarlo tanto en el evento del Píxel como en el de la API de Conversiones [11, 12]. De esta forma, Meta descarta el evento duplicado en un intervalo de 48 horas [12].

## 2. Métodos de Instalación

### Método A: WordPress + WooCommerce (Vía PixelYourSite)
Este método es el más recomendado y sencillo para e-commerce porque automatiza la medición de eventos de comercio electrónico [13].
1. Instala y activa el plugin **PixelYourSite** en WordPress [14].
2. Dirígete a la sección "Your Meta Pixel", haz clic en configuración y pega el **ID del Píxel** obtenido de tu Business Manager [15].
3. Activa la casilla **Enable Facebook CAPI (API de conversiones)** [16].
4. En el Administrador de Eventos de Meta, genera un **Token de acceso** para la API de Conversiones y pégalo en el plugin [17, 18].
5. Guarda los cambios para que el plugin comience a registrar eventos automáticamente enviándolos por ambos canales [16, 19].

### Método B: Google Tag Manager (GTM)
Opción ideal para gestionar todos los píxeles y scripts en un solo lugar, ofreciendo mayor flexibilidad para eventos complejos [20].
1. Instala el plugin **GTM4WP** para integrar Tag Manager con WordPress [21].
2. En Google Tag Manager, añade la plantilla oficial de la comunidad **Facebook Pixel** [22].
3. Crea una variable "Constante" con el ID de tu Píxel para facilitar la gestión futura [23, 24].
4. Configura el evento estándar **PageView** para que se dispare en todas las páginas (All Pages) [25].
5. Para prevenir duplicados al integrar CAPI, asegúrate de extraer un `event_id` de una variable compartida de la capa de datos (Data Layer) [26].

## 3. Prevención de Errores Comunes
Revisa siempre la configuración para evitar los 5 errores más costosos:
1. **Falta de parámetros clave:** Todo evento de compra (Purchase) debe incluir `value` (valor), `currency` (moneda) y `content_ids` (ID de productos) para que Meta pueda atribuir y optimizar correctamente [27].
2. **Píxeles cargados dos veces:** Verifica que el código no esté pegado manualmente en los archivos del tema de WordPress si ya se está utilizando un plugin como PixelYourSite, esto inflará los datos de manera incorrecta [28].
3. **Falla en la deduplicación:** Si Píxel y CAPI envían la acción sin compartir el parámetro `event_id`, Meta los verá como eventos distintos y los contará doble [26].
4. **Eventos en páginas equivocadas:** Un evento de "Compra" solo debe activarse en la página de confirmación/gracias, nunca antes en el proceso de pago [29].
5. **No recolectar First-Party Cookies:** Para que el rastreo desde el servidor (CAPI) sea robusto, debes extraer las cookies `_fbc` (Facebook Click ID) y `_fbp` (Facebook Browser ID) del navegador del usuario e incluirlas en el envío de CAPI [30, 31].

## 4. Pruebas y Validación Final
Aconseja al usuario validar su integración mediante estas dos herramientas:
- **Meta Pixel Helper:** Instala esta extensión gratuita para Chrome, navega por el sitio web y verifica que eventos como `PageView` o `AddToCart` marquen un check verde [32-34]. Ten en cuenta que esta herramienta solo valida eventos del navegador y no mostrará eventos de la API de Conversiones [35].
- **Herramienta "Probar eventos":** Ve al Administrador de Eventos de Meta, introduce la URL del sitio web e interactúa con él. Confirma que la herramienta esté recibiendo los eventos por la vía "Navegador" y "Servidor" y que aparezca el estado de "Deduplicado" [36, 37].