Facebook Pixel Eventos - Bsale-IO/template-docs GitHub Wiki

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

1. Tener una cuenta tipo tienda en facebook

2. Ingresar a administrador de eventos de facebook

3. Poner el código de tracking en la Configuración de la Tienda de Bsale,

   //Ejemplo NO COPIAR
   328251541884150
   

4. Para poder registrar eventos desde dispositivos iOS 14 necesitas configurar Eventos Agrupados

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",
        data:{
        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 
        content_type: "product_group",
        content_ids: ["1234","6658"], // id de productos agregados
        contents:[{
            id: 1234,                      // sku del producto 
            quantity: 2,                   // cantidad de unidades del producto
            price: 7.5                    // costo unitario del producto
          },{
            id: 6658,                      // sku del producto 
            quantity: 1,                   // cantidad de unidades del producto
            price: 15                    // costo unitario del producto
         }]
       }

}

2. AddToCart (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: "AddToCart",
      data: {
        contents_ids: ["1234"],               // sku del producto
        content_type: "product",
        content_name: "Camisa Negra Talla M", // nombre del producto
        value: 7.5,                           // precio del producto
        currency: "USD",                      // Formato de moneda según la moneda configurada en la lista de precio asociada a tu tienda
        contents: [{
          id: 1234,                    // sku del producto
          quantity: 1,                 // cantidad agregada
          price: 7.5                  // precio del producto
        }]
      }
    }

3. RemoveFromCart (Eliminar del carro)

En Facebook no existe el evento RemoveFromCart (eliminar del carro), por lo que este evento se envía cómo un evento personalizado.

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: "RemoveFromCart",
      data: {                     
        contents: [{
          id: 1234,                    // sku del producto
          quantity: 1,                 // cantidad agregada
          name: "Camisa Negra Talla M" // nombre 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_string: "búsqueda" //palabra buscada

    }

5. InitiateCheckout (Iniciar proceso checkout)

• Se registra al momento se hacer clic en el botón del carro con data-bs="cart.checkout"

{
        event: 'InitiateCheckout',
        data:{
          currency: "USD",             // Formato de moneda según la moneda configurada en la lista de precio
          value: 30,                   // costo total de la venta 
          content_ids: ["1234","6658"] // sku de los productos
          content_type: "product_group"
          contents:[{
            id: 1234,                  // sku del producto 
            quantity: 2,               // cantidad de unidades del producto
            price: 7.5                 // costo unitario del producto
          },{
            id: 6658,                  // sku del producto 
            quantity: 1,               // cantidad de unidades del producto
            price: 15                  // costo unitario del producto
         }]

}

6. ViewContent (Ver producto)

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

   {
      event: 'ViewContent',
      data:{
         content_ids: ["1234"],
         content_type: "product",
         content_name: "Camisa Negra Talla M",
         contents: [{
            id: 1234,            // sku del producto
            quiantity: 1,        // cantidad del producto
            item_price: 1000     // precio del producto
         }]
       }
    }