Types d'Evénements

Huit types d'événements de E-Commerce peuvent être envoyés à Finteza :

Tous les autres événements ne seront pas inclus dans les rapports E-Commerce du côté de Finteza.

View Item #

L'événement montre qu'un produit a été vu. Les caractéristiques de l'élément visualisé sont précisées dans l'événement :

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
    }
  ]
});

En conséquence, deux événements "View Item" seront créés dans Finteza, un pour chacun des éléments décrits.

Add To Cart / Remove From Cart #

Ces événements sont utilisés lorsque des produits sont ajoutés ou supprimés du panier. En plus des descriptions des produits, l'événement doit contenir l'ID du panier dans le paramètre cart_id (l'ID doit être généré par votre site 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
    }
  ]
});

En conséquence, deux événements "Add To Cart" seront créés dans Finteza, un pour chacun des éléments décrits. L'ID de panier spécifié sera ajouté à chaque événement.

Ne transmettez pas les paramètres list_name et list_position pour l'événement de retrait du panier. Ils décrivent la liste à partir de laquelle l'article a été ajouté au panier, ils n'ont donc aucune signification pour un événement de suppression.

View Cart #

L'événement est lié à la visualisation d'un panier. L'événement contient des informations sur le coût du panier, ainsi que des informations supplémentaires, le cas échéant : taxe, réduction, bénéfice net. Des paramètres supplémentaires peuvent également être spécifiés pour les produits individuels.

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
    }
  ]
});

Les trois événements suivants seront créés à Finteza :

  • Événement "View Cart" pour chaque produit. Les événements contiendront le cart_id.
  • L'événement "View Cart" pour le panier. Si cart_id n'est pas spécifié, l'événement ne sera pas généré.

Checkout Begin / Checkout Progress #

Il s'agit d'événements de début d'achat et d'événements continus - lorsque l'utilisateur a déjà ajouté des articles au panier et passe au paiement.

En plus des paramètres utilisés dans l'étape "View Cart", des informations sur l'étape d'achat peuvent être transmises ici. Les informations sur les remises et les bons de réduction utilisés peuvent également être corrigées ici.

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"
    }
  ]
});

Les trois événements suivants seront créés à Finteza :

  • L'événement "Checkout Begin" pour chaque article. Les événements comprendront cart_id, checkout_step et checkout_option à partir de la description du panier.
  • L'événement "Checkout Begin" pour le panier. Si cart_id n'est pas spécifié, l'événement ne sera pas généré.

Checkout Success #

Cet événement signifie la réussite de l'achat. En plus des informations de l'événement précédent, il est possible de spécifier ici l'ID de paiement (transaction_id) et de stocker les données (affiliate). Les éléments suivants peuvent être spécifiés en plus :

  • Nom de l'acheteur (buyer) et nom du vendeur (seller). Les rapports sur les meilleurs vendeurs et acheteurs sont utiles si de nombreux vendeurs tiers opèrent sur votre site.
  • Frais du système de paiement pour la transaction (transaction_fee).
  • Revenu net des ventes, commissions nettes, taxes et frais (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",
    }
  ]
});

Les trois événements suivants seront créés à Finteza :

  • L'événement "Checkout Success" pour chaque article. Les événements incluront transaction_id, affiliation, cart_id, checkout_step et checkout_option à partir de la description du panier.
  • L'événement "Checkout Success" pour le panier. Si cart_id n'est pas spécifié, l'événement ne sera pas généré.

Checkout Failed #

Cet événement reflète l'échec d'une tentative de paiement d'une commande. Contrairement à l'événement précédent, cet événement ne contient pas transaction_id mais contient une description d'erreur dans le paramètre 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,
    }
  ]
});

Les trois événements suivants seront créés à Finteza :

  • L'événement "Checkout Failed" pour chaque élément. Les événements incluront detail, cart_id, checkout_step et checkout_option, à partir de la description du panier.
  • L'événement "Checkout Failed" pour le panier. Si cart_id n'est pas spécifié, l'événement ne sera pas généré.

Refund #

L'événement reflète les remboursements de produits. L'événement contient l'identifiant du paiement transaction_id pour établir un lien vers le paiement d'origine, et la description du motif du remboursement dans le paramètre détail.

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,
    }
  ]
});

Les trois événements suivants seront créés à Finteza :

  • L'événement "Refund" pour chaque article. Les événements incluront transaction_id, detail et cart_id à partir de la description du panier.
  • L'événement "Refund" pour le panier. Si cart_id n'est pas spécifié, l'événement ne sera pas généré.
← 
 →