Conectar Utmify
Envía los pedidos de Vipter a Utmify desde el servidor, con UTMs, src y sck, desde el PIX generado hasta el pago, el reembolso y el contracargo.
Con Utmify conectada, Vipter envía cada pedido a Utmify desde el servidor, con el origen de la venta (UTMs, src y sck). Utmify recibe el pedido cuando se genera el PIX (el pago instantáneo de Brasil) y se actualiza cuando se paga, se reembolsa o se disputa. No hay píxel en el navegador: todo sale del servidor, incluso el PIX pagado con la página cerrada.
Antes de empezar, conviene leer cómo funciona el seguimiento de conversiones.
Antes de empezar
- Una cuenta en Utmify.
- Rol Admin o Propietario en el proyecto de Vipter.
- Al menos un producto creado en Vipter.
Paso 1: crear la credencial de API en Utmify
- En Utmify, abre IntegraçõesWebhooksCredenciais de API (Integraciones › Webhooks › Credenciales de API).
- Haz clic en Adicionar Credencial (Agregar credencial) y después en Criar Credencial (Crear credencial).
- Copia la credencial creada.
Guarda la credencial con cuidado
Con la credencial, cualquier persona puede registrar pedidos en tu cuenta de Utmify. Pégala solo en Vipter. Una vez guardada, queda cifrada 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 Utmify.
- Completa los campos numerados. El modo de prueba está en Avanzado: modo de prueba.
| # | Campo | Qué pegar |
|---|---|---|
| 1 | Nombre de esta cuenta | Un nombre para reconocer la cuenta, como "Utmify de la tienda". Si queda en blanco, se llama "Utmify". |
| 2 | Credencial de API (x-api-token) | La credencial del paso 1. Obligatoria: sin ella, Utmify no recibe nada. |
| 3 | Nombre de la plataforma en Utmify | El nombre que aparece en Utmify como origen de los pedidos. Si queda en blanco, se llama "Vipter". |
| 4 | Modo de prueba | Activado, Utmify revisa cada pedido pero no lo guarda. Déjalo desactivado para vender. |
- Haz clic en Conectar y verificar. Vipter guarda la cuenta y envía un pedido de prueba para confirmar la credencial. Utmify revisa ese pedido y no lo guarda.
- Haz clic en Continuar, marca los productos cuyos pedidos deben ir a Utmify y haz clic en Terminar. Activa Usar automáticamente en productos nuevos para incluir los productos creados después.
Paso 3: activar renovaciones y reembolsos
Una cuenta nueva envía el PIX generado y el pago. Renovación y Reembolso / contracargo empiezan desactivados.
- Abre la cuenta en Cuentas y ve a la pestaña Qué enviar.
- Activa Renovación si vendes suscripciones y quieres ver cada cobro recurrente en Utmify.
- Activa Reembolso / contracargo para que Utmify descuente los reembolsos y los contracargos.
- Haz clic en Guardar.
Paso 4: verificar y probar
- En la pestaña Conexión de la cuenta, haz clic en Verificar ahora para comprobar la credencial de nuevo.
- Haz clic en Enviar evento de prueba. Vipter envía un pedido pagado de prueba de 1,00 en la moneda del proyecto, siempre marcado como prueba. Utmify revisa el pedido y no lo guarda, así que no aparece en su panel.
Funcionó si
La verificación muestra Token aceptado por la plataforma y la prueba muestra Evento de prueba aceptado por la plataforma (HTTP 200).. Después de la primera venta real, el pedido aparece en Utmify y la verificación muestra la primera venta enviada desde el servidor.
Si activaste el modo de prueba, desactívalo en Conexión y haz clic en Guardar.
Qué envía Vipter a Utmify
| Evento en Vipter | Estado del pedido en Utmify |
|---|---|
| PIX generado | waiting_payment |
| Compra | paid |
| Renovación | paid, como un pedido nuevo por cada cobro |
| Reembolso / contracargo | refunded en el reembolso, chargedback en el contracargo |
- Cada pedido lleva el cliente (nombre, correo, teléfono, documento y país), los productos, el medio de pago y el origen:
utm_source,utm_medium,utm_campaign,utm_content,utm_term,srcysck. El script de UTMs lleva ese origen de tu página de ventas hasta el checkout. - La comisión enviada es el total del pedido, sin descontar tarifas.
- Utmify no tiene las opciones de valor ni de Datos de coincidencia en Qué enviar: siempre va el total del pedido.
Problemas comunes
-
Obligatorio en el campo de la credencial
Utmify solo funciona con la credencial. Pega la credencial del paso 1.
-
Token rechazado por la plataforma
La credencial se borró en Utmify o se pegó a medias. Crea otra y pégala en Conexión. La respuesta de Utmify aparece debajo del elemento.
-
Los pedidos llegan sin origen
El comprador llegó al checkout sin UTMs,
srcnisck. Revisa los enlaces de los anuncios y pega el script de UTMs en la página de ventas. -
Los pedidos no aparecen en Utmify
El modo de prueba está activado. Desactívalo en Conexión y haz clic en Guardar.
-
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. Borra una cuenta con envío desde el servidor 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.
- Mira el origen de las ventas también en el propio Vipter, en la pestaña Origen de las ventas.
Conectar Fathom
Registra las visitas al checkout y los eventos de checkout, lead, PIX generado y compra, con el valor, en tu sitio de Fathom Analytics.
Cómo funcionan las automatizaciones
Entiende qué eventos de venta envía Vipter a Voxuy, Voxuy Enterprise y Hotzapp, cómo leer los envíos recientes y cómo probar sin botón de prueba.