Qué eventos describen el recorrido
| Evento | Acción que representa |
|---|---|
| view_item_list | Se muestra un listado de artículos |
| select_item | Se selecciona un artículo de un listado |
| view_item | Se consulta el detalle de un artículo |
| add_to_cart | Se añade un artículo al carrito |
| remove_from_cart | Se retira un artículo del carrito |
| begin_checkout | Empieza el proceso de finalización de compra |
| add_shipping_info | Se aporta información de envío |
| add_payment_info | Se aporta información de pago |
| purchase | Se completa la compra |
| refund | Se registra una devolución |
También existen eventos para promociones y otras interacciones. Implementa los que correspondan a tu experiencia de compra; no generes pasos inexistentes solo para completar una lista.
Qué datos necesita cada producto
Dentro de items, utiliza los campos recomendados para identificador, nombre, marca, categorías, variante, precio y cantidad. Mantén el mismo identificador del artículo a lo largo del recorrido.
El valor numérico no debe incluir el símbolo de moneda. currency utiliza un código como EUR, no €. Cuando envíes value, define la moneda al nivel correspondiente del evento.
En una configuración mediante GTM, acuerda la estructura con desarrollo y comprueba cómo pasa desde el dataLayer a la etiqueta de GA4.
Ejemplo de una compra
Este ejemplo es ficticio y supone que la etiqueta de Google ya está preparada. El evento debe ejecutarse al confirmar el pedido y utilizar los datos reales del sistema.
gtag('event', 'purchase', {
transaction_id: 'PEDIDO-EJEMPLO-001',
currency: 'EUR',
value: 80,
tax: 16.80,
shipping: 5,
items: [{
item_id: 'CURSO-01',
item_name: 'Recurso de ejemplo',
price: 40,
quantity: 2
}]
});En este caso, value corresponde a la suma del precio por cantidad de los artículos, sin incorporar los campos separados de impuestos y envío. Alinea la lógica de descuentos y cantidades con tu sistema de pedidos y con la definición de cada campo.
No envíes el email, la dirección postal o los datos de pago como parámetros. La analítica debe recibir la información necesaria para medir el resultado, no el contenido completo del pedido.
Cómo evitar compras duplicadas
Utiliza un identificador de transacción consistente y diseña el envío para no repetirlo por una simple recarga o reintento. No dependas exclusivamente de que una herramienta deduplique datos: una implementación correcta debe controlar cuándo comunica la compra.
Revisa plugins, integraciones nativas y GTM. Si dos de ellos envían purchase, puedes obtener registros incoherentes aunque ambos parezcan funcionar por separado.
Para devoluciones, utiliza refund y los identificadores y artículos que correspondan. Comprueba también cómo se reflejan devoluciones parciales en tus informes y en el sistema de negocio.
Dónde analizar el ecommerce
Los informes de compras permiten estudiar ingresos, artículos y transacciones según las colecciones disponibles. Las exploraciones ayudan a construir embudos y comparaciones más concretas.
Lee la definición de cada métrica antes de combinarla. Un número de artículos no equivale a un número de compras, y comenzar un checkout no equivale a finalizarlo. No sustituyas una métrica por otra solo porque tengan nombres parecidos.
Si necesitas consultar pedidos con más detalle, puedes utilizar BigQuery o construir un dashboard con definiciones explícitas.
Plan mínimo de pruebas
- Consulta un artículo y añádelo al carrito: verifica identidad, precio y cantidad.
- Cambia cantidades y elimina un artículo: comprueba qué acción se envía.
- Completa una compra de prueba y revisa el identificador de transacción.
- Recarga la confirmación y simula un pago fallido: no deben crear compras nuevas.
- Comprueba moneda, descuentos, impuestos, envío y devoluciones.
- Contrasta un periodo con el sistema de pedidos explicando diferencias de alcance y consentimiento.
Si el checkout utiliza otro dominio, incluye una prueba de medición multidominio. Un evento de compra correcto puede convivir con una atribución incorrecta si el recorrido se rompe antes.
Fuentes y documentación
Documentación revisada el 29 de septiembre de 2026. Los ejemplos ilustran el método; adapta las comprobaciones a tu proyecto.