Configuración de Meta Pixel

Esta guía te muestra cómo conectar tu Meta Pixel a AdTarget para el seguimiento de conversiones.

Requisitos previos

• Una cuenta de Meta Business
• Un Meta Pixel (te mostraremos cómo crear uno si lo necesitas)
• Acceso de administrador a tu Business Manager

Paso 1: Encuentra tu Pixel ID

Si ya tienes un Pixel

1. Ve al Administrador de eventos de Meta 
2. Selecciona tu Pixel de la lista de orígenes de datos
3. Tu Pixel ID se muestra en la parte superior (un número de 15-16 dígitos)

Si necesitas crear un Pixel

1. Ve al Administrador de eventos de Meta 
2. Haz clic en Conectar orígenes de datos
3. Selecciona Web
4. Elige Meta Pixel
5. Ingresa un nombre para tu pixel
6. Haz clic en Crear Pixel
7. Copia el Pixel ID

Paso 2: Genera un token de acceso de Conversions API

AdTarget solo necesita permiso para enviar eventos del lado del servidor al Pixel seleccionado. Para la configuración normal, usa el generador de tokens integrado en el Administrador de eventos de Meta — no necesitas crear una app personalizada, un usuario del sistema ni configurar permisos avanzados en Business Manager.

1. Quédate en el Administrador de eventos de Meta 
2. Selecciona el mismo Pixel que copiaste en el Paso 1
3. Abre la pestaña Configuración
4. Desplázate hasta la sección Conversions API
5. Haz clic en Generar token de acceso
6. Copia el token completo inmediatamente y pégalo en AdTarget

Si no ves Generar token de acceso, confirma que tienes acceso de administrador/gestión al Pixel y que el Pixel pertenece a la cuenta Business que estás usando. Meta también documenta este flujo en su guía de tokens de Conversions API .

Paso 3: Añade el Pixel a AdTarget

Ahora que tienes tu Pixel ID y token de acceso, conéctalos en AdTarget:

1. Ve a tu panel de AdTarget 
2. Selecciona tu sitio, luego abre su Configuración
3. Haz clic en la pestaña Pixels en la barra lateral
4. Haz clic en + Add pixel para abrir el diálogo de configuración
5. Ingresa un Nombre para el pixel (por ejemplo, “Main Pixel”) — completa esto primero, porque el pixel no puede guardarse automáticamente sin un nombre
6. Pega tu Pixel ID (el número de 15-16 dígitos del Administrador de eventos)
7. Pega tu Access Token (Configuración → Conversions API → Generar token de acceso)

La validación se activa automáticamente una vez que el Pixel ID tiene 15-16 dígitos Y el Access Token tiene más de 50 caracteres. Verás un indicador “Verifying credentials…” mientras AdTarget verifica tus credenciales contra la API de Meta.

Después de que la verificación sea exitosa y aparezca “Credentials verified!”, el pixel se guarda automáticamente solo cuando los tres campos son válidos: Name, Pixel ID y Access Token. Si el campo Name está vacío, el pixel no se guardará incluso después de que las credenciales sean verificadas — completa el campo Name y el guardado procederá inmediatamente.

En caso de éxito:

• Aparece una confirmación “Credentials verified!”
• El pixel se guarda automáticamente y se establece como predeterminado para tu sitio (requiere que los tres campos sean válidos)
• El diálogo se cierra y tu nuevo pixel aparece en la lista

Verifica tu configuración

Después de conectar tu pixel:

1. Revisa la pestaña Pixels — tu pixel debería aparecer en la lista con un botón de radio seleccionado, indicando que es el predeterminado
2. Ve al Administrador de eventos de Meta  y abre la pestaña Eventos de prueba
3. Busca un evento de prueba con el código ADTARGET_TEST que fue enviado durante la validación
4. Abre la pestaña Resumen — en unos minutos también deberías ver un evento de configuración por cada nombre de evento que AdTarget enviará para este proyecto (por ejemplo CompleteRegistration, y PageView en proyectos de enlace alojado), enviado con content_name “AdTarget setup test”

Eventos de configuración

El evento de validación ADTARGET_TEST solo aparece en la pestaña Eventos de prueba, por lo que nunca se registra como evento recibido del conjunto de datos. Por eso el Administrador de anuncios puede seguir diciendo «El conjunto de datos que has seleccionado no tiene eventos de conversión configurados».

Para solucionarlo, AdTarget envía además eventos de configuración reales — sin código de prueba — en cuanto se conecta un pixel a un proyecto, cada vez que guardas el evento de conversión de un canal y cada vez que llega un nombre de evento nuevo a través de la API de eventos. Se envía un evento por cada nombre de evento que AdTarget enviará realmente para el proyecto, de modo que Meta los muestre en el Administrador de eventos y puedas seleccionarlos como evento de optimización.

Los nombres de evento provienen de tres fuentes:

• PageView — solo en proyectos de enlace alojado (directos), donde AdTarget envía la vista de página desde la pasarela de redirección. Los proyectos de sitio web reciben PageView de tu propio pixel de navegador, así que no se envía un evento de configuración para él.
• Conversiones de canales — el evento de conversión configurado en cada canal activo del proyecto (por ejemplo CompleteRegistration).
• Historial de la API de eventos — los nombres de evento distintos ya recibidos en la API de eventos para este proyecto en los últimos 90 días (hasta 10 nombres).

Estos eventos de configuración no se atribuyen a ningún anuncio ni tienen valor, salvo Purchase, que se envía con value: 0 y una moneda porque Meta rechaza un Purchase sin ellos. Los eventos PageView de configuración no llevan ningún custom_data. Puedes reenviarlos en cualquier momento desde Configuración -> Pixels -> «Enviar evento de prueba» (una vez por minuto y pixel).

Indicadores de éxito:

• Tu pixel está listado en la pestaña Pixels
• El evento de prueba es visible en el Administrador de eventos
• La puntuación de calidad del evento muestra “Bueno” o mejor

Gestión de Pixels

Seleccionar un Pixel predeterminado

Si tienes múltiples pixels, haz clic en cualquier pixel de la lista para establecerlo como el predeterminado de tu sitio. El pixel predeterminado se usa para todos los eventos de conversión.

Eliminar un Pixel

Haz clic en el icono de papelera junto a un pixel para eliminarlo. Puedes añadir hasta 10 pixels por cuenta.

Solución de problemas

“Pixel ID must be a 15-16 digit number”

• Asegúrate de copiar el número completo de 15-16 dígitos
• El campo solo acepta caracteres numéricos

“Access token appears to be incomplete”

• Los tokens de acceso de Meta son cadenas largas (más de 50 caracteres)
• Asegúrate de copiar el token completo

“Invalid or expired access token”

• Los tokens solo se pueden ver una vez cuando se crean
• Si lo perdiste, genera un nuevo token desde la Configuración del negocio
• Asegúrate de que el token tenga los permisos necesarios

“Pixel ID not found or not accessible with this token”

• Verifica que el token se generó desde la pestaña Configuración del mismo Pixel
• Confirma que tu usuario de Meta tiene acceso de administrador/gestión al Pixel

“Access token lacks permission to send events to this pixel”

• Genera un token nuevo desde Administrador de eventos → Pixel → Configuración → Conversions API
• Asegúrate de usar la cuenta Business que posee o gestiona ese Pixel

¿Los eventos no aparecen en el Administrador de eventos?

• Espera 5-10 minutos para que los eventos se procesen
• Revisa la pestaña “Eventos de prueba” para depuración
• Verifica que no hay filtros de eventos ocultando los eventos

Puntuación de calidad del evento

Meta califica tus eventos según la calidad de los datos:

Para mejorar la calidad del evento:

• Asegúrate de que el fbclid se capture desde los clics de anuncios
• Usa nombres de eventos consistentes
• Envía los eventos rápidamente después de las conversiones

Siguientes pasos

Ahora que tu pixel está conectado, configura qué eventos CAPI enviar.