Universal Analytics Eventos - Bsale-IO/template-docs GitHub Wiki

Para poder registrar eventos en google analytics UA (universal analytics) debes:

  1. Tener una cuenta en google analytics

  2. Configurar la cuenta para registrar eventos de comercio avanzado

  3. Poner el código de tracking en la Configuración de la Tienda de Bsale, si es Universal analytics el codigo comenzará con UA-

    //Ejemplo
    UA-12345678-9
    

Eventos Enviados

1. Purchase (Venta)

  • Se registra cada vez que un cliente finaliza un proceso de compra, cuando se carga una url /checkout/success/
  • No se diferencia entre ventas por pagar (transferencias) y ventas pagadas
{
        event: 'purchase',
        transaction_id: id,  // ID de la transacción
        currency: "USD",     // Formato de moneda según la moneda configurada en la lista de precio asociada a tu tienda
        value: 30,        // costo total de la venta 
        items:[{
            id: 1234,                      // sku del producto 
            name: "Camisa Negra Talla L",  // nombre del producto
            quantity: 2,                   // cantidad de unidades del producto
            price: 7.5                    // costo unitario del producto
          },{
            id: 6658,                      // sku del producto 
            name: "Pantalon Azul Talla 42",  // nombre del producto
            quantity: 1,                   // cantidad de unidades del producto
            price: 15                    // costo unitario del producto
         }]

}

2. add_to_cart (Agregar al carro)

Se gatilla cada vez que un cliente agrega un producto al carro de compra

  • Al hacer click en un boton de "agregar al carro" con data-bs="card.add" o data-bs="card.add.collection"
  • Al hacer click dentro del carro en un botón de aumentar cantidad del producto con data-bs="cart.quantity.plus"
  • Cuando cambia la cantidad de un producto de forma positiva (+1) en un input con data-bs="cart.quantity"
   {
      event: 'add_to_cart',
        items: [{
          id: 1234,                    //sku del producto
          name: "Camisa Negra Talla M", //nombre del producto
          quantity: 1,                 //cantidad agregada
          price: 1000                  //precio del producto
        }]

    }

3. remove_from_cart (Eliminar del carro)

Se gatilla cada vez que un cliente borra un producto o disminuye la cantidad de este en el carro

  • Al hacer clic dentro del carro en un botón de "Eliminar" con data-bs="cart.remove"
  • Al hacer clic dentro del carro en un botón de aumentar cantidad del producto con data-bs="cart.quantity.minus"
  • Cuando cambia la cantidad de un producto de forma negativa (-1) en un input con data-bs="cart.quantity"
   {
      event: 'remove_from_cart',
        items: [{
          id: 1234,                    //sku del producto
          name: "Camisa Negra Talla M", //nombre del producto
          quantity: 1,                 //cantidad agregada
          price: 1000                  //precio del producto
        }]

    }

4. search (Búsqueda)

Se gatilla un cliente realiza una venta en el sitio web o se carga un url /search

   {
      event: "search",
      search_term: "busqueda" //palabra buscada

    }

5. begin_checkout (Iniciar proceso checkout)

  • Se registra al momento se hacer clic en el botón del carro con data-bs="cart.checkout"
{
        event: 'begin_checkout',
        currency: "USD",     // Formato de moneda según la moneda configurada en la lista de precio asociada a tu tienda
        value: 30,        // costo total de la venta 
        items:[{
            id: 1234,                      // sku del producto 
            name: "Camisa Negra Talla L",  // nombre del producto
            quantity: 2,                   // cantidad de unidades del producto
            price: 7.5                    // costo unitario del producto
          },{
            id: 6658,                      // sku del producto 
            name: "Pantalon Azul Talla 42",  // nombre del producto
            quantity: 1,                   // cantidad de unidades del producto
            price: 15                    // costo unitario del producto
         }]

}

6. view_item (Ver producto)

Se gatilla cada ver que se carga una página de producto con url /product/

   {
      event: 'view_item',
        items: [{
          id: 1234,                    //sku del producto
          name: "Camisa Negra Talla M", //nombre del producto
          price: 1000                  //precio del producto
        }]

    }