Tipi di eventi

Otto tipi di eventi E-Commerce possono essere inviati a Finteza:

Tutti gli altri eventi non saranno inclusi nei rapporti E-Commerce dal lato Finteza.


View Item #

L'evento mostra che un prodotto è stato visualizzato. Le caratteristiche dell'articolo visualizzato sono specificate nell'evento:

fz('ecommerce', {
  "event""View Item",
  "items": [
    {
      "id""P12345",
      "name""USB Charger",
      "brand""ChargeIt",
      "category""Accessories",
      "variant""Black",
      "quantity": 2,
      "currency""USD",
      "price": 2.00,
      "list_name""Search Results",
      "list_position": 1
    },
    {
      "id""P67890",
      "name""Flame challenge TShirt",
      "brand""MyBrand",
      "category""Apparel/T-Shirts",
      "variant""Red",
      "quantity": 1,
      "currency""USD",
      "price": 3.00,
      "list_name""Search Results",
      "list_position": 2
    }
  ]
});

Di conseguenza, in Finteza saranno creati due eventi "View Item", uno per ciascuno degli articoli descritti.

Add To Cart / Remove From Cart #

Questi eventi sono utilizzati quando i prodotti vengono vengono aggiunti o rimossi dal carrello. Oltre alle descrizioni del prodotto, l'evento dovrebbe contenere l'ID carrello nel parametro cart_id (l'ID dovrebbe essere generato dal tuo sito web).

fz('ecommerce', {
  "event""Add To Cart",
  "cart_id""C89367",
  "items": [
    {
      "id""P12345",
      "name""USB Charger",
      "brand""ChargeIt",
      "category""Accessories",
      "variant""Black",
      "quantity": 2,
      "currency""USD",
      "price": 2.00,
      "list_name""Search Results",
      "list_position": 1
    },
    {
      "id""P67890",
      "name""Finteza TShirt",
      "brand""Finteza",
      "category""Apparel/T-Shirts",
      "variant""Red",
      "quantity": 1,
      "currency""USD",
      "price": 3.00,
      "list_name""Search Results",
      "list_position": 2
    }
  ]
});

Di conseguenza, due eventi "Add To Cart" saranno creati in Finteza, uno per ciascuno degli articoli descritti. L'ID carrello specificato sarà aggiunto a ciascun evento.

Non trasferire i parametri list_name e list_position per la rimozione dall'evento carrello. Descrivono l'elenco da cui l'articolo è stato aggiunto al carrello, quindi non hanno alcun significato per un evento di rimozione.

View Cart #

L'evento è legato alla visualizzazione di un carrello. L'evento contiene informazioni sul costo del carrello, nonché ulteriori fornitori, se ce ne sono: tasse, sconto, profitto netto. Per singoli prodotti si possono specificare ulteriori parametri.

fz('ecommerce', {
  "event""View Cart",
  "cart_id""C89367",
  "cart_items": 2,
  "currency""USD",
  "value": 7.07,
  "tax_value": 0.7,
  "tax_name""Tax",
  "tax_type""Tax type",
  "discount_value": 1,
  "discount_name""Black Friday",
  "discount type""B112029",
  "discount type""B112029"
  "items": [
    {
      "id""P12345",
      "name""USB Charger",
      "brand""ChargeIt",
      "category""Accessories",
      "variant""Black",
      "quantity": 2,
      "currency""USD"
      "price": 2.00,
      "value": 4.24
    },
    {
      "id""P67890",
      "name""Finteza TShirt",
      "brand""Finteza",
      "category""Apparel/T-Shirts",
      "variant""Red",
      "quantity": 1,
      "currency""USD"
      "price": 3.00,
      "value": 2.83
    }
  ]
});

I seguenti tre eventi saranno creati in Finteza:

  • Evento "View Cart" per ciascun prodotto. Gli eventi includeranno cart_id.
  • L'evento "View Cart" per il carrello. Se cart_id non è specificato, l'evento non verrà generato.

Checkout Begin / Checkout Progress #

Si tratta degli eventi di inizio e proseguimento dell'acquisto: quando l'utente ha già aggiunto articoli al carrello e procede al checkout.

Oltre ai parametri utilizzati nella fase "View Cart", qui possono essere trasferite informazioni sulla fase di acquisto. Qui possono essere corrette anche le informazioni su sconti e buoni utilizzati.

fz('ecommerce', {
  "event""Checkout Begin",
  "cart_id""C89367",
  "cart_items": 2,
  "currency""USD",
  "value": 7.07,
  "tax_value": 0.7,
  "tax_name""Tax",
  "tax_type""Tax type",
  "discount_value": 1,
  "discount_name""Black Friday",
  "discount type""B112029",
  "shipping_value": 0.3,
  "shipping_name""Shipping",
  "shipping_type""Shipping Type",
  "checkout_step": 1,
  "checkout_option" : "Shipping"
  "items": [
    {
      "id""P12345",
      "name""USB Chargers",
      "brand""ChargeIt",
      "category""Accessories",
      "variant""Black",
      "quantity": 2,
      "currency""USD"
      "price": 2.00,
      "value": 4.24,
      "tax_value": 0.4,
      "tax_name""Tax",
      "tax_type""Tax type",
      "shipping_value": 0.2,
      "shipping_name""Shipping",
      "shipping_type""Standard Post"
    },
    {
      "id""P67890",
      "name""Finteza TShirt",
      "brand""Finteza",
      "category""Apparel/T-Shirts",
      "variant""Red",
      "quantity": 1,
      "currency""USD"
      "price": 3.00,
      "value": 2.83,
      "tax_value": 0.3,
      "tax_name""Tax",
      "tax_type""Tax type",
      "discount_value": 0.6,
      "discount_name""Black Friday",
      "discount type""B112029"
    }
  ]
});

I seguenti tre eventi saranno creati in Finteza:

  • L'evento "Checkout Begin" per ciascun articolo. Gli eventi includeranno cart_id, checkout_step e checkout_option dalla descrizione del carrello.
  • L'evento "Checkout Begin" per il carrello. Se cart_id non è specificato, l'evento non verrà generato.

Checkout Success #

Questo evento indica il corretto completamento dell'acquisto. Oltre alle informazioni dell'evento precedente, è possibile specificare qui l'ID di pagamento (transaction_id) e i dati del negozio (affiliate). È possibile specificare anche quanto segue:

  • Nome dell'acquirente (buyer) e nome del venditore (seller). I rapporti dei migliori venditori e acquirenti sono utili se sul tuo sito ci sono molti venditori terzi.
  • Commissioni del sistema di pagamento per la transazione (transaction_fee).
  • Profitto netto sulle vendite, commissioni nette, tasse e commissioni (profit).

fz('ecommerce', {
  "event""Checkout Success",
  "transaction_id""CH38027",
  "affiliation""Online store",
  "buyer""john_smith",
  "seller""Europe Shop",
  "cart_id""C89367",
  "cart_items": 2,
  "currency""USD",
  "value": 7.07,
  "profit": 2,
  "transaction_fee": 0.07,
  "tax_value": 0.7,
  "tax_name""Tax",
  "tax_type""VAT",
  "discount_value": 1,
  "discount_name""Black Friday",
  "discount type""B112029",
  "shipping_value": 0.3,
  "shipping_name""Shipping",
  "shipping_type""Standard Post",
  "checkout_step": 1,
  "checkout_option" : "Shipping",
  "items": [
    {
      "id""P12345",
      "name""USB Charger",
      "brand""ChargeIt",
      "category""Accessories",
      "variant""Black",
      "quantity": 2,
      "currency""USD"
      "price": 2.00,
      "value": 4.24,
      "profit": 1.6,
      "transaction_fee": 0.04,
      "tax_value": 0.4,
      "tax_name""Tax",
      "tax_type""VAT",
      "discount_value": 0.4,
      "discount_name""Black Friday",
      "discount type""B112029",
      "shipping_value": 0.2,
      "shipping_name""Shipping",
      "shipping_type""Standard Post",
    },
    {
      "id""P67890",
      "name""Finteza TShirt",
      "brand""Finteza",
      "category""T-Shirts",
      "variant""Red",
      "quantity": 1,
      "currency""USD"
      "price": 3.00,
      "value": 2.83,
      "profit": 0.4,
      "transaction_fee": 0.03,
      "tax_value": 0.3,
      "tax_name""Tax",
      "tax_type""VAT",
      "discount_value": 0.6,
      "discount_name""Black Friday",
      "discount type""B112029"
      "shipping_value": 0.1,
      "shipping_name""Shipping",
      "shipping_type""Standard Post",
    }
  ]
});

I seguenti tre eventi saranno creati in Finteza:

  • L'evento "Checkout Success" per ciascun articolo. Gli eventi includeranno transaction_id, affiliation, cart_id, checkout_step e checkout_option dalla descrizione del carrello.
  • L'evento "Checkout Success" per il carrello. Se cart_id non è specificato, l'evento non verrà generato.

Checkout Failed #

Questo evento riflette un tentativo non riuscito di effettuare il pagamento per un ordine. Diversamente dall'evento precedente, non contiene transaction_id ma contiene la descrizione di un errore nel parametro detail .

fz('ecommerce', {
  "event""Checkout Failed",
  "detail""WebMoney Payment Error",
  "cart_id""C89367",
  "cart_items": 2,
  "currency""USD",
  "value": 7.07,
  "checkout_step": 1,
  "checkout_option" : "Shipping",
  "items": [
    {
      "id""P12345",
      "name""USB Charger",
      "brand""ChargeIt",
      "category""Accessories",
      "variant""Black",
      "quantity": 2,
      "currency""USD"
      "price": 2.00,
      "value": 4.24,
    },
    {
      "id""P67890",
      "name""Finteza TShirt",
      "brand""Finteza",
      "category""Apparel/T-Shirts",
      "variant""Red",
      "quantity": 1,
      "currency""USD"
      "price": 3.00,
      "value": 2.83,
    }
  ]
});

I seguenti tre eventi saranno creati in Finteza:

  • L'evento "Checkout Failed" per ciascun articolo. Gli eventi includeranno detail, cart_id, checkout_step e checkout_option, dalla descrizione del carrello.
  • L'evento "Checkout Failed" per il carrello. Se cart_id non è specificato, l'evento non verrà generato.

Refund #

L'evento indica i rimborsi per il prodotto. L'evento contiene l'identificatore di pagamento transaction_id al link del pagamento originale e la descrizione del motivo del rimborso nel parametro detail .

fz('ecommerce', {
  "event""Refund",
  "transaction_id""P7788112313",
  "detail""Broken",
  "cart_id""C89367",
  "cart_items": 2,
  "currency""USD",
  "value": 7.07,
  "items": [
    {
      "id""P12345",
      "name""USB Charger",
      "brand""ChargeIt",
      "category""Accessories",
      "variant""Black",
      "quantity": 2,
      "currency""USD"
      "price": 2.00,
      "value": 4.24,
    },
    {
      "id""P67890",
      "name""Finteza TShirt",
      "brand""Finteza",
      "category""Apparel/T-Shirts",
      "variant""Red",
      "quantity": 1,
      "currency""USD"
      "price": 3.00,
      "value": 2.83,
    }
  ]
});

I seguenti tre eventi saranno creati in Finteza:

  • L'evento "Refund" per ciascun articolo. Gli eventi includeranno transaction_id, detail e cart_id dalla descrizione del carrello.
  • L'evento "Refund" per il carrello. Se cart_id non è specificato, l'evento non verrà generato.