Ereignistypen

Acht Arten von E-Commerce-Ereignissen können an Finteza gesendet werden:

Alle anderen Ereignisse werden nicht in die E-Commerce-Berichte auf der Finteza-Seite aufgenommen.

View Item #

Das Ereignis zeigt an, dass ein Produkt angesehen wurde. Die Eigenschaften des angesehenen Artikels werden im Ereignis angegeben:

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 Ergebnis werden zwei "View Item"-Ereignisse in Finteza erstellt, eines für jeden der beschriebenen Artikel.

Add To Cart / Remove From Cart #

Diese Ereignisse werden verwendet, wenn Produkte zum Warenkorb hinzugefügt oder aus dem Warenkorb entfernt werden. Zusätzlich zu den Produktbeschreibungen sollte das Ereignis die Warenkorb-ID im Parameter cart_id enthalten (die ID sollte von Ihrer Website generiert werden).

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 Ergebnis werden zwei Ereignisse "Add To Cart" in Finteza erstellt, eines für jeden der beschriebenen Artikel. Die angegebene ID des Einkaufswagens wird zu jedem Ereignis hinzugefügt.

Übergeben Sie nicht die Parameter list_name und list_position für das Ereignis "Aus dem Warenkorb entfernen". Sie beschreiben die Liste, aus der der Artikel in den Warenkorb gelegt wurde, haben also keine Bedeutung für das Ereignis eines Entfernens.

View Cart #

Das Ereignis bezieht sich auf das Anzeigen des Warenkorbs. Das Ereignis enthält Informationen über die Kosten des Warenkorbs sowie zusätzliche Anbieter, falls es welche gibt: Steuer, Rabatt, Nettogewinn. Zusätzliche Parameter können auch für einzelne Produkte angegeben werden.

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

Die folgenden drei Ereignisse werden in Finteza erstellt:

  • Das Ereignis "View Cart" für jedes Produkt. Die Ereignisse enthalten cart_id
  • Das Ereignis "View Cart" für den Warenkorb. Wenn cart_id nicht angegeben wird, wird das Ereignis nicht erzeugt.

Checkout Begin / Checkout Progress #

Dies sind die Ereignisse des Kaufbeginns und der Fortschritte – wenn der Benutzer bereits Artikel in den Warenkorb gelegt hat und zur Kasse geht.

Zusätzlich zu den Parametern, die in der Phase von "View Cart" verwendet werden, können hier Informationen über die Kaufphase übergeben werden. Auch Informationen über Rabatte und verwendete Gutscheine können hier korrigiert werden.

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

Die folgenden drei Ereignisse werden in Finteza erstellt:

  • Das Ereignis "Checkout Begin" für jeden Artikel.Die Ereignisse enthalten cart_id, checkout_step und checkout_option aus der Warenkorbbeschreibung.
  • Das Ereignis "Checkout Begin" für den Warenkorb. Wenn cart_id nicht angegeben wird, wird das Ereignis nicht erzeugt.

Checkout Success #

Dieses Ereignis bedeutet einen erfolgreichen Kaufabschluss. Zusätzlich zu den Informationen aus dem vorherigen Ereignis können hier die Zahlungs-ID (transaction_id) und Filialdaten (affiliate) angegeben werden. Zusätzlich kann das Folgende angegeben werden:

  • Name des Käufers (buyer) und Name des Verkäufers (seller). Die Berichte zu den Top-Verkäufern und -Käufern sind nützlich, wenn viele Drittanbieter auf Ihrer Seite aktiv sind.
  • Zahlungssystemgebühren für die Transaktion (transaction_fee).
  • Nettoumsatzerlöse, Nettoprovisionen, Steuern und Gebühren (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",
    }
  ]
});

Die folgenden drei Ereignisse werden in Finteza erstellt:

  • Das Ereignis "Checkout Success" für jeden Artikel. Die Ereignisse enthalten transaction_id, affiliation, cart_id, checkout_step und checkout_option aus der Warenkorbbeschreibung.
  • Das Ereignis "Checkout Success" für den Warenkorb. Wenn cart_id nicht angegeben wird, wird das Ereignis nicht erzeugt.

Checkout Failed #

Dieses Ereignis reflektiert den fehlgeschlagenen Versuch, eine Zahlung für eine Bestellung durchzuführen. Anders als das vorherige Ereignis enthält dieses Ereignis keine transaction_id, sondern eine Fehlerbeschreibung im Parameter 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,
    }
  ]
});

Die folgenden drei Ereignisse werden in Finteza erstellt:

  • Das Ereignis "Checkout Failed" für jeden Artikel. Die Ereignisse umfassen detail, cart_id, checkout_step und checkout_option, aus der Beschreibung des Warenkorbs.
  • Das Ereignis "Checkout Failed" für den Warenkorb. Wenn cart_id nicht angegeben wird, wird das Ereignis nicht erzeugt.

Refund #

Das Ereignis spiegelt Produktrückerstattungen wider. Das Ereignis enthält die Zahlungskennung transaction_id zur Verknüpfung mit der ursprünglichen Zahlung und die Beschreibung des Rückerstattungsgrundes im Parameter 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,
    }
  ]
});

Die folgenden drei Ereignisse werden in Finteza erstellt:

  • Das Ereignis "Refund" für jeden Artikel. Die Ereignisse enthalten transaction_id, detail und cart_id aus der Beschreibung des Warenkorbs.
  • Das Ereignis "Refund" für den Warenkorb. Wenn cart_id nicht angegeben wird, wird das Ereignis nicht erzeugt.
← 
 →