VipterCentro de Ayuda
Integraciones

Script de UTM y origen de las ventas

Lleva las UTMs y los identificadores de clic de tu página de ventas hasta el checkout y mira en Origen de las ventas de dónde vinieron las ventas pagadas.

Admin o PropietarioTodos los planesVerificado el 28 sept 2026

Cuando el anuncio lleva directo al checkout, Vipter ya lee las UTMs y los identificadores de clic del enlace. Cuando el anuncio lleva a una página de ventas en tu sitio, esos datos se quedan en la página y se pierden en el clic hacia el checkout. El script de UTMs lo resuelve. Después, la pestaña Origen de las ventas muestra de dónde vinieron las ventas.

Antes de empezar

  • Rol Admin o Propietario en el proyecto de Vipter.
  • Acceso para editar el HTML de tu página de ventas, o un campo de "código en el pie de página" en el constructor de páginas.

Paso 1: copiar el script

  1. Abre GeneralConversionesAjustes.
  2. En Script de UTMs para tu página de ventas, haz clic en el botón de copiar junto al código.
Tarjeta Script de UTMs con el código para copiar

El código es una sola línea:

<script src="https://pay.vipter.com/t.js" async></script>

Con un dominio propio activo, el código copiado ya viene con data-hosts="tu-dominio", como data-hosts="checkout.tutienda.com".

Paso 2: pegar en la página de ventas

Pega el código en todas las páginas desde donde el visitante puede ir al checkout, al final de la página, antes del cierre de la etiqueta </body>. En constructores como WordPress, Elementor o similares, usa el campo de scripts del pie de página.

El script no cambia la apariencia de la página.

Paso 3: comprobar

  1. Abre la página de ventas con UTMs en la dirección, como ?utm_source=teste&utm_campaign=script.
  2. Haz clic en el botón de compra.

Funcionó si

La dirección del checkout se abre con utm_source=teste y utm_campaign=script. Después de una compra de prueba, el pedido muestra ese origen en la tarjeta Origen y conversiones y la venta entra en Origen de las ventas.

Qué hace el script

  • Guarda en el navegador del visitante, por 30 días, las UTMs (utm_source, utm_medium, utm_campaign, utm_content, utm_term, utm_id), el src y el sck. Vale el primer origen: si el visitante vuelve después sin UTMs, o por otra campaña, el origen guardado sigue siendo el primero.
  • Guarda los identificadores de clic de los anuncios (fbclid, gclid, gbraid, wbraid, ttclid, epik, tblci, ob_click_id, msclkid). Para ellos vale el clic más reciente.
  • Al hacer clic en un enlace al checkout, agrega estos datos al enlace, junto con las cookies de Meta (_fbp, _fbc), de TikTok (_ttp) y de Google Analytics (_ga) de tu página. Esto mejora la coincidencia de los eventos enviados desde el servidor.
  • Nunca cambia un parámetro que el enlace ya tiene.
  • También lleva el código de vendedor (?v=), si el visitante llegó por un enlace de vendedor. En ese caso vale el último.

El atributo data-hosts

El script solo actúa en los enlaces que apuntan al checkout de Vipter (pay.vipter.com). data-hosts agrega otras direcciones, separadas por comas:

<script src="https://pay.vipter.com/t.js" data-hosts="checkout.tutienda.com,pago.tutienda.com" async></script>

Úsalo cuando los botones de la página llevan a tu dominio propio de checkout. Si activas un dominio después de pegar el script, copia el código de nuevo o agrega el dominio en data-hosts.

Botones que no son enlaces

El script actúa en enlaces (<a href="…">). Si el botón de compra abre el checkout con JavaScript, pide a quien mantiene la página que pase la dirección por window.vipterDecorate:

window.location.href = window.vipterDecorate('https://checkout.tutienda.com/tu-oferta');

El origen de las ventas

Abre GeneralConversionesOrigen de las ventas. De dónde vienen las ventas pagadas: UTMs, src/sck e IDs de clic capturados en el checkout.

Filtros de Origen de las ventas: período, agrupar por y producto
  1. Elige el período: Últimos 7 días, 30 o 90 días.
  2. En Agrupar por, elige la dimensión.
  3. Si quieres, filtra por un producto y haz clic en Filtrar.
Tabla Ventas por Canal con pedidos, división entre tarjeta y PIX e ingresos de cada canal

Arriba, Pedidos pagados y Con origen identificado (Pedidos con UTM, src/sck, ID de clic de anuncio o sitio de referencia.). La tabla muestra, por fila, los pedidos, la división Tarjeta / PIX y los ingresos.

Cómo se decide el canal

Con Canal, cada venta entra en un canal, en este orden:

Si la venta tieneCanal
fbclid o la cookie _fbcMeta Ads
gclid, gbraid o wbraidGoogle Ads
ttclidTikTok Ads
epikPinterest Ads
tblciTaboola
ob_click_idOutbrain
msclkidMicrosoft Ads
utm_source, sin identificador de clicOtras campañas (UTM)
Solo un sitio de origenSitios de referencia
Nada de estoDirecto / sin origen

El identificador de clic gana sobre la UTM. Una venta de un anuncio de Meta con utm_source=instagram entra en Meta Ads. Para ver la UTM, agrupa por utm_source.

Las otras dimensiones (utm_source, utm_campaign, utm_medium, utm_content, src, sck) agrupan por el valor exacto. Las ventas sin el parámetro aparecen como (sin informar).

Qué se cuenta

  • Solo los pedidos pagados en el período. Los pedidos reembolsados por completo salen; en los reembolsos parciales, los ingresos ya vienen descontados.
  • Solo la primera compra de cada pedido. Las renovaciones de suscripción no entran.
  • Cada moneda tiene su fila. Un canal con ventas en reales y en dólares aparece dos veces.
  • La división Tarjeta / PIX cuenta como tarjeta todo lo que no es PIX (el pago instantáneo de Brasil).
  • El filtro de producto también encuentra el producto cuando se vendió como order bump.
  • Mostrando los 5.000 pedidos más recientes del período. aparece cuando el período tiene más de 5.000 pedidos.

Problemas comunes

  • Las ventas de la página de ventas aparecen como Directo / sin origen

    El script no está en la página, o los botones llevan a un dominio que no está en data-hosts. Revisa el Paso 3.

  • El enlace del checkout se abre sin UTMs

    El botón no es un enlace común. Usa window.vipterDecorate, como en "Botones que no son enlaces".

  • La campaña de la venta es de una visita antigua

    Es el comportamiento esperado: vale el primer origen de los últimos 30 días en el mismo navegador.

Qué hacer después

En esta página