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

Habilitado desde la versión 5.5 de Bsale

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

1. Tener una cuenta en google analytics

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

   //Ejemplo
   G-ABC01DEFG2
   

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 (incluye costo de despacho)
        shipping: 5         //costo de despacho
        items:[{
            item_id: 1234,                      // sku del producto 
            item_name: "Camisa Negra Talla L",  // nombre del producto
            quantity: 2,                        // cantidad de unidades del producto
            price: 7.5                          // costo unitario del producto
          },{
            item_id: 6658,                        // sku del producto 
            item_name: "Pantalon Azul Talla 42",  // nombre del producto
            quantity: 1,                          // cantidad de unidades del producto
            price: 10                             // 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',
      {
        currency: "USD" // formato de moneda cargada en la lista de precio
        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: [{
          item_id: 1234,                     //sku del producto
          item_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: 25,        // costo total de la venta 
        items:[{
            item_id: 1234,                      // sku del producto 
            item_name: "Camisa Negra Talla L",  // nombre del producto
            quantity: 2,                   // cantidad de unidades del producto
            price: 7.5                    // costo unitario del producto
          },{
            item_id: 6658,                      // sku del producto 
            item_name: "Pantalon Azul Talla 42",  // nombre del producto
            quantity: 1,                   // cantidad de unidades del producto
            price: 10                    // 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: [{
          item_id: 1234,                    //sku del producto
          item_name: "Camisa Negra Talla M", //nombre del producto
          price: 1000                  //precio del producto
        }]

    }