أنواع الأحداث

يمكن إرسال ثمانية أنواع من أحداث التجارة الإلكترونية إلى Finteza:

لن يتم تضمين جميع الأحداث الأخرى في تقارير التجارة الإلكترونية من جانب Finteza.

View Item #

الحدث يوضح أنه تم عرض المنتج. يتم تحديد خصائص العنصر المعروض في الحدث:

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

نتيجة لذلك، سيتم إنشاء حدثين من "View Item" في Finteza، واحد لكل عنصر من العناصر الموصوفة.

Add To Cart / Remove From Cart #

يتم استخدام هذه الأحداث عند إضافة المنتجات أو إزالتها من سلة التسوق. بالإضافة إلى أوصاف المنتج، يجب أن يحتوي الحدث على معرف سلة التسوق في معلمة cart_id (يجب أن يتم إنشاء المعرف بواسطة موقعك الإلكتروني).

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

نتيجة لذلك، سيتم إنشاء حدثين من "Add To Cart" في Finteza، واحد لكل عنصر من العناصر الموصوفة. ستتم إضافة معرف سلة التسوق المحدد إلى كل حدث.

لا تمرر معلمات list_name و list_position للإزالة من حدث عربة التسوق. فهي تصف القائمة التي تمت إضافة العنصر منها إلى سلة التسوق، لذلك ليس لديها أي معنى لحدث الإزالة.

View Cart #

الحدث مرتبط بعرض سلة التسوق. يحتوي الحدث على معلومات حول تكلفة سلة التسوق، بالإضافة إلى مقدمي الخدمات الإضافيين، إذا كان هناك أي: ضريبة، خصم، صافي الربح. يمكن أيضًا تحديد معلمات إضافية للمنتجات الفردية.

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

سيتم إنشاء الأحداث الثلاثة التالية في Finteza:

  • حدث "View Cart" لكل منتج. سوف تشمل الأحداث cart_id.
  • حدث "View Cart" لسلة التسوق. إذا كان cart_id غير محدد، لن يتم إنشاء الحدث.

Checkout Begin / Checkout Progress #

هذه هي أحداث بداية واستمرار الشراء - عندما يضيف المستخدم بالفعل عناصر إلى سلة التسوق ويبدأ في الخروج.

بالإضافة إلى المعلمات المستخدمة في مرحلة "View Cart"، يمكن هنا تمرير معلومات حول مرحلة الشراء. يمكن أيضًا تصحيح المعلومات المتعلقة بالخصومات والقسائم المستخدمة هنا.

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

سيتم إنشاء الأحداث الثلاثة التالية في Finteza:

  • حدث "Checkout Begin" لكل عنصر. سوف تشمل الأحداث ة التسوق cart_id، checkout_stepو checkout_option من وصف عربة التسوق.
  • حدث "Checkout Begin" لسلة التسوق. إذا كان cart_id غير محدد، لن يتم إنشاء الحدث.

Checkout Success #

هذه الأحداث تعني إتمام الشراء بنجاح. بالإضافة إلى المعلومات من الحدث السابق، من الممكن تحديد معرف الدفع هنا (transaction_id) وبيانات المتجر (affiliate). يمكن تحديد ما يلي بشكل إضافي:

  • اسم المشتري (buyer) واسم البائع (seller). تعد تقارير أفضل البائعين والمشترين مفيدة إذا كان العديد من البائعين الخارجيين يعملون على موقعك.
  • رسوم نظام الدفع للمعاملة (transaction_fee).
  • صافي دخل المبيعات وصافي العمولات والضرائب والرسوم (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",
    }
  ]
});

سيتم إنشاء الأحداث الثلاثة التالية في Finteza:

  • حدث "Checkout Success" لكل عنصر. سوف تشمل الأحداث transaction_id، affiliation، cart_id، checkout_stepو checkout_option من وصف سلة التسوق.
  • حدث "Checkout Success" لسلة التسوق. إذا كان cart_id غير محدد، لن يتم إنشاء الحدث.

Checkout Failed #

يعكس هذا الحدث محاولة فاشلة لإجراء الدفع لأحد الطلبات. على عكس الحدث السابق، لا يحتوي هذا الحدث على transaction_id ولكنه يحتوي على وصف للخطأ في معلمة 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,
    }
  ]
});

سيتم إنشاء الأحداث الثلاثة التالية في Finteza:

  • حدث "Checkout Failed" لكل عنصر. سوف تشمل الأحداث detail، cart_id، checkout_stepو checkout_option، من وصف سلة التسوق.
  • حدث "Checkout Failed" لسلة التسوق. إذا كان ة التسوقcart_id غير محدد، لن يتم إنشاء الحدث.

Refund #

يعكس الحدث المبالغ المستردة للمنتج. يحتوي الحدث على معرف الدفع transaction_id للربط بالدفع الأصلي ووصف سبب الاسترداد في معلمة 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,
    }
  ]
});

سيتم إنشاء الأحداث الثلاثة التالية في Finteza:

  • حدث "Refund" لكل عنصر. سوف تشمل الأحداث transaction_id، detailو cart_id من وصف سلة التسوق.
  • حدث "Refund" لسلة التسوق. إذا كان cart_id غير محدد، لن يتم إنشاء الحدث.
← 
 →