VipterCentro de Ayuda
Integraciones

Conectar Google Tag Manager

Carga tu contenedor de GTM en el checkout y recibe los eventos de compra en el dataLayer, con el estándar de comercio electrónico de GA4, para disparar tus propias etiquetas.

Admin o PropietarioTodos los planesVerificado el 28 sept 2026

Con Google Tag Manager conectado, Vipter carga tu contenedor en el checkout y en la página de agradecimiento y envía cada evento al dataLayer, con el estándar de comercio electrónico de GA4. Dentro de GTM, decides qué etiquetas se disparan con cada evento. Usa GTM para plataformas que Vipter no conecta directamente o para etiquetas que ya mantienes ahí.

Antes de empezar, conviene leer cómo funciona el seguimiento de conversiones.

Antes de empezar

  • Un contenedor web en Google Tag Manager, con permiso para publicar.
  • Rol Admin o Propietario en el proyecto de Vipter.
  • Al menos un producto creado en Vipter.

GTM solo recibe desde el navegador

Esta plataforma solo recibe eventos desde el navegador: un PIX pagado después de que el comprador cerró la página no se cuenta. Si la etiqueta es de Meta, TikTok o GA4, mejor conecta la plataforma directamente en Vipter, con envío desde el servidor.

Paso 1: copiar el ID del contenedor

En Google Tag Manager, abre el contenedor web. El ID aparece arriba del espacio de trabajo y empieza con GTM-, como GTM-AB12CD3. Copia ese ID.

Paso 2: conectar la cuenta en Vipter

  1. En el panel de Vipter, abre GeneralConversionesCuentas y haz clic en Conectar cuenta. Elige Google Tag Manager.
  2. Completa los campos numerados.
Formulario Conectar Google Tag Manager con Container ID y nombre de la cuenta numerados
#CampoQué pegar
1Container IDObligatorioEl ID del contenedor del paso 1, con el prefijo GTM-.
2Nombre de esta cuentaOpcionalUn nombre para reconocer la cuenta, como "GTM de la tienda". Si queda en blanco, se llama "Google Tag Manager".
  1. Haz clic en Conectar y verificar y después en Continuar.
  2. Marca los productos en los que debe cargarse el contenedor y haz clic en Terminar. Activa Usar automáticamente en productos nuevos para incluir los productos creados después.

Paso 3: crear los activadores en GTM

Vipter no crea nada dentro de tu contenedor. Para que una etiqueta se dispare con un evento del checkout:

  1. En GTM, crea un activador de tipo evento personalizado con el nombre del evento, como purchase. La lista de nombres está en la tabla de abajo.
  2. Para leer el valor, la moneda o el ID del pedido, crea variables de capa de datos, como ecommerce.value, ecommerce.currency y ecommerce.transaction_id.
  3. Vincula el activador a las etiquetas que deben dispararse y publica el contenedor.

Cada evento llega al dataLayer en este formato:

dataLayer.push({ ecommerce: null }); // limpia el evento anterior
dataLayer.push({
  event: 'purchase',
  event_id: 'ord_…:purchase',
  vipter_event: 'purchase',
  payment_type: 'pix',
  ecommerce: {
    currency: 'BRL',
    value: 197,
    transaction_id: 'ord_…',
    items: [{ item_id: '…', item_name: 'Curso de ejemplo', price: 197, quantity: 1 }],
  },
  user_data: { email: 'comprador@ejemplo.com', phone_number: '…' },
});
  • event_id es el mismo identificador que Vipter usa en los envíos desde el servidor. Úsalo como ID del evento en las etiquetas que deduplican.
  • vipter_event es el nombre del evento en Vipter, igual en todas las plataformas.
  • transaction_id solo existe cuando ya hay pedido.
  • user_data solo se envía con E-mail activado en Datos de coincidencia. El teléfono se envía con Teléfono activado. Los datos van tal como los escribió el comprador, sin hash.

Paso 4: probar

  1. En GTM, abre el modo de vista previa (Preview) e indica la dirección del checkout de un producto vinculado a la cuenta.
  2. Recorre el checkout. Cada evento aparece en la lista de la vista previa con los datos del dataLayer.
  3. En Vipter, la pestaña Conexión de la cuenta muestra cuándo se recibió el primer evento, después de que alguien completa sus datos en el checkout.

Funcionó si

La vista previa de GTM muestra begin_checkout al abrir el checkout y purchase en la página de agradecimiento, y tus etiquetas aparecen como disparadas.

Qué envía Vipter al dataLayer

Evento en VipterEvento en el dataLayer
Vista de páginavipter_page_view
Inicio del checkoutbegin_checkout
Lead (contacto completado)generate_lead
Envío elegidoadd_shipping_info
Pago iniciadoadd_payment_info
PIX generadopix_generated
Comprapurchase
Suscripción iniciadasubscribe
  • La visualización de la página va como vipter_page_view, y no como page_view. Usa ese nombre en el activador.
  • Renovación y Reembolso / contracargo no llegan a GTM, porque ocurren después de que el comprador salió del checkout.
  • En Qué enviar, elige los eventos, el Valor de la conversión y la Moneda del valor. Consulta eventos y valores.

Problemas comunes

  • Formato inválido en el campo del ID

    El ID debe empezar con GTM-. No pegues el código de instalación entero ni un ID de GA4 (G-).

  • Las compras aparecen duplicadas en GA4 o en Meta

    La misma plataforma está conectada directamente en Vipter y también tiene una etiqueta dentro de GTM. Mantén solo uno de los dos caminos.

  • Las etiquetas no se disparan

    El contenedor no se publicó después de crear los activadores, o el nombre del evento en el activador no es igual al de la tabla. Los nombres distinguen mayúsculas de minúsculas.

  • No se carga nada cuando el comprador rechaza las cookies

    Con el banner de consentimiento activado, el contenedor solo se carga después de la aceptación.

Qué hacer después

  • Conecta Google Analytics 4 directamente en Vipter para contar también las ventas confirmadas desde el servidor.
  • Pega el script de UTMs en tu página de ventas para mantener el origen de la visita hasta el checkout.

En esta página