Conectar Meta Ads (Píxel y API de Conversiones)
Envía las visitas, los leads y las compras del checkout a tu Píxel de Meta, desde el navegador y por la API de Conversiones, incluso el PIX pagado con la página cerrada.
Con Meta Ads conectado, el Píxel de Meta se dispara en el checkout y en la página de agradecimiento, y la API de Conversiones envía los mismos eventos desde el servidor. La compra se reporta cuando se confirma el pago, incluso el PIX (el pago instantáneo de Brasil) pagado después de que el comprador cerró la página. Los dos envíos llevan el mismo identificador, y Meta cuenta cada venta una vez.
Antes de empezar, conviene leer cómo funciona el seguimiento de conversiones.
Antes de empezar
- Un Píxel de Meta (conjunto de datos) en el Administrador de eventos y acceso de administrador al negocio dueño de él.
- Rol Admin o Propietario en el proyecto de Vipter.
- Al menos un producto creado en Vipter.
Paso 1: copiar el ID del píxel y generar el token en Meta
- Abre el Administrador de eventos de Meta y elige tu píxel. Copia su ID, que tiene solo números.
- En el píxel, abre ConfiguraciónAPI de conversiones y haz clic en Generar token de acceso. Copia el token.
- Para probar antes de vender, abre la pestaña Probar eventos del mismo píxel y copia el código de prueba, como
TEST12345.
Guarda el token con cuidado
Con el token, cualquier persona puede enviar eventos a tu píxel. Pega el token solo en Vipter. Una vez guardado, queda cifrado y no vuelve a aparecer; la pantalla solo muestra el final.
Paso 2: conectar la cuenta en Vipter
- En el panel de Vipter, abre GeneralConversionesCuentas y haz clic en Conectar cuenta. Elige Meta Ads.
- Completa los campos numerados. El código de prueba está en Avanzado: modo de prueba.

| # | Campo | Qué pegar |
|---|---|---|
| 1 | Pixel ID | El ID del píxel que copiaste en el paso 1. Solo números. |
| 2 | Nombre de esta cuenta | Un nombre para reconocer la cuenta, como "BM principal" o "Afiliado Juan". Si queda en blanco, se llama "Meta Ads". |
| 3 | Token de la API de Conversiones | El token de la API de Conversiones del paso 1. Sin él, los eventos salen solo desde el navegador y el PIX pagado con la página cerrada no se cuenta. |
| 4 | Código de prueba | El código de la pestaña Probar eventos, solo mientras pruebas. Bórralo cuando termines. |
- Haz clic en Conectar y verificar. Vipter guarda la cuenta y comprueba el ID y el token con Meta. El resultado aparece en Verificación.
- Haz clic en Continuar.
Paso 3: elegir los productos
- En Dónde usar, marca los productos en los que debe dispararse el píxel, o haz clic en Seleccionar todos.
- Activa Usar automáticamente en productos nuevos si los productos creados después también deben usar este píxel. Déjalo desactivado para el píxel de un afiliado o de un solo producto.
- Haz clic en Terminar.
Los productos se pueden cambiar después en GeneralConversionesVista general o en la pestaña Productos de la cuenta.
Paso 4: verificar y probar
Abre la cuenta en Cuentas y quédate en la pestaña Conexión.

- Haz clic en Verificar ahora. Con el código de prueba guardado, Vipter envía un evento de prueba a Meta. Sin el código, comprueba el token sin crear ninguna conversión.
- Para ver llegar un evento, deja el código de prueba guardado, abre la pestaña Probar eventos en Meta y haz clic en Enviar evento de prueba. Vipter envía una compra de prueba de 1,00 en la moneda del proyecto. Este botón solo aparece cuando la cuenta envía desde el servidor.
- Borra el código de prueba en Conexión y haz clic en Guardar.
Funcionó si
La verificación muestra Token aceptado por la plataforma, la prueba muestra Evento de prueba aceptado por la plataforma (HTTP 200). y la compra de prueba aparece en Probar eventos en Meta. Después de la primera venta real, la lista también muestra el primer evento recibido y la primera venta enviada desde el servidor.
Qué envía Vipter a Meta
La pestaña Qué enviar de la cuenta define los eventos y el valor. Nombres que recibe Meta:
| Evento en Vipter | Nombre en Meta |
|---|---|
| Vista de página | PageView |
| Inicio del checkout | InitiateCheckout |
| Lead (contacto completado) | Lead |
| Envío elegido | AddShippingInfo (evento personalizado) |
| Pago iniciado | AddPaymentInfo |
| PIX generado | PixGerado (evento personalizado, nombre editable) |
| Compra | Purchase |
| Suscripción iniciada | Subscribe |
| Renovación | RenovacaoAssinatura (evento personalizado, solo desde el servidor) |

- Valor de la conversión: Subtotal (Productos menos descuentos, sin envío ni intereses de cuotas.) o Total pagado (Lo que pagó el comprador, con envío e intereses.).
- Moneda del valor: Usa la moneda del proyecto si la cuenta publicitaria no acepta la moneda de la venta. La conversión usa la cotización del día.
- Nombre del evento de PIX generado: Evento personalizado enviado cuando aparece el código QR del PIX. Por defecto: PixGerado. Cambia el nombre si ya usas otro evento para el PIX en tus campañas.
- Datos de coincidencia: correo, teléfono, nombre, dirección e ID del cliente, enviados con hash SHA-256 para que Meta encuentre a quien hizo clic en el anuncio.
Haz clic en Guardar. Los productos con ajustes propios mantienen los campos que ajustaron.
Verificar el dominio en Meta (opcional)
Si el checkout usa un dominio propio, puedes verificarlo en Meta con la metaetiqueta.
- En la configuración de tu negocio en Meta, abre el área de dominios (en Seguridad de la marca), elige el dominio y la verificación por metaetiqueta.
- Copia solo el código de adentro de la metaetiqueta, el valor de
content. - En Vipter, abre GeneralConversionesAjustes, pega el código en Meta (facebook-domain-verification) y haz clic en Guardar.
- Vuelve a Meta y haz clic en Verificar.
Problemas comunes
-
El token no fue aceptado: genera uno nuevo en el Administrador de Eventos (Configuración → API de Conversiones → Generar token de acceso) y pégalo aquí.
El token se borró, venció o se copió a medias. Genera otro y pégalo en Conexión.
-
El token es válido, pero no tiene permiso para este conjunto de datos. En el Administrador Comercial abre Configuración del negocio → Orígenes de datos → el píxel y dale al usuario del sistema (o a quien generó el token) el permiso Administrar píxel; el token debe venir del negocio dueño de este píxel.
El token es de otro negocio o del usuario equivocado. Sigue el camino del mensaje para dar el permiso, o genera el token en el negocio dueño del píxel.
-
Meta no encontró este ID de píxel para el token indicado. Verifica que el ID sea del conjunto de datos correcto y del mismo negocio que el token.
El ID no es del píxel correcto. Copia de nuevo el ID en el Administrador de eventos.
-
Completa y guarda primero el código de prueba: sin él, la prueba cuenta como una conversión real.
Sin código de prueba, la compra de prueba contaría como una venta real. Guarda el código de la pestaña Probar eventos e inténtalo de nuevo.
-
Meta rechazó el evento de prueba. Revisa el código de prueba en el Administrador de Eventos → Probar eventos.
El código de prueba está mal o es de otro píxel. Cópialo de nuevo en la pestaña Probar eventos.
-
Tu plan no permite otra cuenta con envío desde el servidor. Mejora el plan para conectar una más.
El plan llegó al límite de cuentas con envío desde el servidor. Quita el token de una cuenta que ya no usas o cambia de plan en Plan Vipter.
Qué hacer después
- Pega el script de UTMs en tu página de ventas para no perder el origen del clic.
- Conecta también Google Analytics 4.
Actividad y reenvío de eventos
Mira cada evento reportado a las plataformas, con la respuesta de cada una, entiende los reintentos automáticos y reenvía lo que falló.
Conectar TikTok Ads (Píxel y Events API)
Envía las visitas, los leads y las compras del checkout a tu píxel de TikTok, desde el navegador y por la Events API, incluso el PIX pagado con la página cerrada.