Gebeurtenistypes

Er kunnen acht soorten e-commerce gebeurtenissen zijn verzenden naar Finteza:

Alle andere evenementen zullen niet worden opgenomen in e-commerce-rapporten aan de Finteza-kant.


View Item #

Het evenement laat zien dat een product is bekeken. De kenmerken van het bekeken item worden gespecificeerd in het evenement:

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

Als resultaat, zullen er twee "View Item" evenementen worden aangemaakt in Finteza, één voor elk van de beschreven items.

Add To Cart / Remove From Cart #

Deze gebeurtenissen worden gebruikt wanneer producten worden toegevoegd aan of verwijderd uit de winkelwagen. Naast productbeschrijvingen moet het evenement de winkelwagen-ID bevatten in de cart_id parameter (de ID moet worden gegenereerd door uw website).

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

Als resultaat, zullen er twee "Add To Cart" evenementen worden aangemaakt in Finteza, één voor elk van de beschreven items. De opgegeven winkelwagen-ID wordt aan elk evenement toegevoegd.

U kunt niet de list_name en list_position parameters gebruiken voor het verwijderen uit de winkelwagen gebeurtenis. Ze beschrijven de lijst van waaruit het item aan de winkelwagen is toegevoegd, dus ze hebben geen betekenis voor een verwijderings gebeurtenis.

View Cart #

De gebeurtenis is gerelateerd aan het bekijken van een winkelwagen. Het evenement bevat informatie over de winkelwagenkosten, evenals eventuele extra aanbieders: belasting, korting, nettowinst. Aanvullende parameters kunnen ook worden gespecificeerd voor individuele producten.

fz('ecommerce', {
  "evenement""Winkelwagen Bekijken",
  "cart_id""C89367",
  "cart_items": 2,
  "valuta""USD",
  "waarde": 7.07,
  "tax_value": 0.7,
  "tax_name""Belasting",
  "tax_type""Belasting type",
  "discount_value": 1,
  "discount_name""Black Friday",
  "kortings type""B112029",
  "kortings type""B112029"
  "items": [
    {
      "id""P12345",
      "naam""USB Charger",
      "merk""ChargeIt",
      "categorie""accessoires",
      "variant""Black",
      "aantal": 2,
      "valuta""USD"
      "prijs": 2.00,
      "waarde": 4.24
    },
    {
      "id""P67890",
      "naam""Finteza TShirt",
      "merk""Finteza",
      "categorie""Apparel/T-Shirts",
      "variant""Rood",
      "aantal": 1,
      "valuta""USD"
      "prijs": 3.00,
      "waarde": 2.83
    }
  ]
});

De volgende drie evenementen worden gecreëerd in Finteza:

  • "View Cart" evenement voor elk product. De evenementen omvatten cart_id.
  • Het "View Cart" evenement voor de winkelwagen. Als cart_id niet is opgegeven, wordt de gebeurtenis niet gegenereerd.

Checkout Begin / Checkout Progress #

Dit zijn begin- en voortzettingsgebeurtenissen - wanneer de gebruiker al items aan de winkelwagen heeft toegevoegd en doorgaat met afrekenen.

Naast de parameters die worden gebruikt in de "View Cart" stadium, informatie over de aankoopfase kan hier worden doorgegeven. Informatie over kortingen en gebruikte coupons kan hier ook worden gecorrigeerd.

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

De volgende drie evenementen worden gemaakt in Finteza:

  • Het "Checkout Begin" evenement voor elk item. De evenementen omvatten: cart_id, checkout_step en checkout_option uit de winkelwagenbeschrijving.
  • Het "Checkout Begin" evenement voor de winkelwagen. Als cart_id niet is opgegeven, wordt de gebeurtenis niet gegenereerd.

Checkout Success #

Dit evenement betekent een succesvolle afronding van de aankoop. Naast informatie van het vorige evenement, is het mogelijk om hier de betalings-ID op te geven(transaction_id) en data op te slaan. (affiliate). Het volgende kan aanvullend worden gespecificeerd:

  • Koper's naam (koper) en verkoper's naam (verkoper). Rapporten over topverkopers en kopers zijn handig als er veel externe verkopers op uw site actief zijn.
  • Betalings systeemkosten voor de transactie(transaction_fee).
  • Netto verkoop opbrengsten, netto commissies, belastingen en vergoedingen (winst).

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

De volgende drie evenementen worden gemaakt in Finteza:

  • Het "Checkout Success" evenement voor elk item. Deze evenementen zijn inclusief: transaction_id, affiliation, cart_id, checkout_step en checkout_option uit de winkelwagenbeschrijving.
  • Het "Checkout Success" evenement voor de winkelwagen. Wanneer cart_id niet is opgegeven, wordt de gebeurtenis niet gegenereerd.

Checkout Failed #

Deze gebeurtenis weerspiegelt een mislukte poging om een ​​betaling voor een bestelling uit te voeren. In tegenstelling tot het vorige evenement bevat dit evenement geen transaction_id maar bevat het een error omschrijving in de detail parameter.

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

De volgende drie evenementen worden gemaakt in Finteza:

  • Het "Checkout Failed" evenement voor elk item. De evenementen zijn inclusief detail, cart_id, checkout_step en checkout_option, uit de winkelwagenbeschrijving.
  • Het "Checkout Failed" evenement voor de winkelwagen. Wanneer cart_id niet is opgegeven, wordt de gebeurtenis niet gegenereerd.

Refund #

Het evenement weerspiegelt productrestituties. De gebeurtenis bevat een betalingsidentificatie transaction_id om te linken naar de oorspronkelijke betaling en de beschrijving van de reden voor terugbetaling in het detail parameter veld.

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

De volgende drie evenementen worden gemaakt in Finteza:

  • Het "Refund" evenement voor elk item. Deze evenementen zijn inclusief transaction_id, detail en cart_id uit de winkelwagenbeschrijving.
  • Het "Refund" evenement voor de winkelwagen. Als cart_id niet is opgegeven, wordt de gebeurtenis niet gegenereerd.