VipterCentro de Ayuda
Integraciones

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.

Admin o PropietarioTodos los planesVerificado el 28 sept 2026

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

  1. Abre el Administrador de eventos de Meta y elige tu píxel. Copia su ID, que tiene solo números.
  2. En el píxel, abre ConfiguraciónAPI de conversiones y haz clic en Generar token de acceso. Copia el token.
  3. 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

  1. En el panel de Vipter, abre GeneralConversionesCuentas y haz clic en Conectar cuenta. Elige Meta Ads.
  2. Completa los campos numerados. El código de prueba está en Avanzado: modo de prueba.
Formulario Conectar Meta Ads con Pixel ID, nombre de la cuenta, token de la API de Conversiones y código de prueba numerados
#CampoQué pegar
1Pixel IDObligatorioEl ID del píxel que copiaste en el paso 1. Solo números.
2Nombre de esta cuentaOpcionalUn nombre para reconocer la cuenta, como "BM principal" o "Afiliado Juan". Si queda en blanco, se llama "Meta Ads".
3Token de la API de ConversionesOpcional · queda oculto después de guardarEl 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.
4Código de pruebaOpcionalEl código de la pestaña Probar eventos, solo mientras pruebas. Bórralo cuando termines.
  1. 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.
  2. Haz clic en Continuar.

Paso 3: elegir los productos

  1. En Dónde usar, marca los productos en los que debe dispararse el píxel, o haz clic en Seleccionar todos.
  2. 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.
  3. 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.

Tarjeta Verificación de la cuenta de Meta con la lista de comprobaciones y los botones Verificar ahora y Enviar evento de prueba
  1. 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.
  2. 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.
  3. 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 VipterNombre en Meta
Vista de páginaPageView
Inicio del checkoutInitiateCheckout
Lead (contacto completado)Lead
Envío elegidoAddShippingInfo (evento personalizado)
Pago iniciadoAddPaymentInfo
PIX generadoPixGerado (evento personalizado, nombre editable)
CompraPurchase
Suscripción iniciadaSubscribe
RenovaciónRenovacaoAssinatura (evento personalizado, solo desde el servidor)
Valor de la conversión en la pestaña Qué enviar, con el campo Nombre del evento de PIX generado resaltado
  • 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.

  1. 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.
  2. Copia solo el código de adentro de la metaetiqueta, el valor de content.
  3. En Vipter, abre GeneralConversionesAjustes, pega el código en Meta (facebook-domain-verification) y haz clic en Guardar.
  4. 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

En esta página