التجارة الإلكترونية المحسَّنة

توضّح هذه الصفحة كيفية استخدام gtag.js لجمع بيانات التجارة الإلكترونية المحسَّنة. في حال ضبطت "إحصاءات Google" في gtag.js وتفعيل التجارة الإلكترونية المحسَّنة في "إحصاءات Google"، يمكنك استخدام هذا المقتطف لإرسال بيانات مرات الظهور وبيانات المنتج وبيانات العرض الترويجي وبيانات الإجراءات إلى "إحصاءات Google".

ملاحظة: "إحصاءات Google 4" هي مستقبل "إحصاءات Google". لهذا السبب، ننصحك بتنفيذ أحداث التجارة الإلكترونية في "إحصاءات Google 4" لضمان الاستفادة من جميع ميزات "إحصاءات Google" على المدى الطويل. مزيد من المعلومات

أنواع بيانات التجارة الإلكترونية المحسَّنة وإجراءاتها

تتوفّر أنواع متعدّدة من بيانات التجارة الإلكترونية التي يمكنك إرسالها:

• بيانات مرات الظهور
• بيانات المنتج
• بيانات الإجراءات
• أنواع الإجراءات

بيانات مرات الظهور

تمثل معلومات عن منتج تم عرضه. ويُشار إليه باسم impressionFieldObject ويحتوي على القيم التالية:

المفتاح	نوع القيمة	مطلوبة	الوصف
id	text	*نعم	معرّف المنتج أو رمز التخزين التعريفي (SKU) (مثلاً P67890) * يجب ضبط قيمة من id أو name.
name	text	*نعم	اسم المنتج (مثلاً قميص Android). * يجب ضبط قيمة من id أو name.
list	text	لا	القائمة أو المجموعة التي ينتمي إليها المنتج (مثل نتائج البحث)
list_name	text	لا	القائمة أو المجموعة التي ينتمي إليها المنتج (مثل نتائج البحث)
brand	text	لا	العلامة التجارية المرتبطة بالمنتج (مثل Google).
category	text	لا	الفئة التي ينتمي إليها المنتج (مثل الملابس). يمكنك استخدام / كمحدِّد لتحديد ما يصل إلى 5 مستويات من التدرج الهرمي (مثل الملابس/الرجال/القمصان القصيرة الأكمام).
variant	text	لا	خيار المنتج (مثلاً أسود).
position	عدد صحيح	لا	موضع المنتج في قائمة أو مجموعة (مثلاً 2).
list_position	عدد صحيح	لا	موضع المنتج في قائمة أو مجموعة (مثلاً 2).
price	الرقم	لا	سعر منتج (مثلاً 29.20).

بيانات المنتج

تمثل بيانات المنتج المنتجات الفردية التي تم الاطّلاع عليها أو إضافتها إلى سلة التسوق أو غير ذلك. ويُشار إليها باسم productFieldObject وتحتوي على القيم التالية:

المفتاح	نوع القيمة	مطلوبة	الوصف
id	text	*نعم	معرّف المنتج أو رمز التخزين التعريفي (SKU) (مثلاً P67890) * يجب ضبط رقم من المعرّف أو name.
name	text	*نعم	اسم المنتج (مثلاً قميص Android). * يجب ضبط رقم من المعرّف أو name.
brand	text	لا	العلامة التجارية المرتبطة بالمنتج (مثل Google).
category	text	لا	الفئة التي ينتمي إليها المنتج (مثل الملابس). يمكنك استخدام / كمحدِّد لتحديد ما يصل إلى 5 مستويات من التسلسل الهرمي (مثل الملابس/الرجال/القمصان).
variant	text	لا	خيار المنتج (مثلاً أسود).
price	الرقم	لا	سعر منتج (مثلاً 29.20).
quantity	عدد صحيح	لا	كمية المنتج (مثلاً 2).
coupon	text	لا	رمز القسيمة المرتبط بمنتج (مثل SUMMER_SALE13).
position	عدد صحيح	لا	موضع المنتج في قائمة أو مجموعة (مثلاً 2).
list_position	عدد صحيح	لا	موضع المنتج في قائمة أو مجموعة (مثلاً 2).

بيانات العرض الترويجي

تمثّل هذه السمة معلومات عن عرض ترويجي تمت مشاهدته. يُشار إليه باسم promoFieldObject ويحتوي على القيم التالية:

المفتاح	نوع القيمة	مطلوبة	الوصف
id	text	*نعم	معرّف العرض الترويجي (مثل PROMO_1234). * يجب ضبط قيمة من id أو name.
name	text	*نعم	اسم العرض الترويجي (مثل تخفيضات الصيف). * يجب ضبط قيمة من id أو name.
creative	text	لا	تصميم الإعلان المرتبط بالعرض الترويجي (على سبيل المثال الصيف_banner2).
creative_name	text	لا	اسم تصميم الإعلان (على سبيل المثال،ummer_banner2).
position	text	لا	موضع تصميم الإعلان (على سبيل المثال، بانر_slot_1).
creative_slot	text	لا	اسم خانة تصميم الإعلان (مثل البانر_slot_1).

بيانات الإجراءات

يمثل معلومات عن إجراء مرتبط بالتجارة الإلكترونية تم إجراؤه. يُشار إليه باسم actionFieldObject ويحتوي على القيم التالية:

المفتاح	نوع القيمة	مطلوبة	الوصف
id	text	*نعم	معرِّف المعاملة (مثل T1234). * مطلوب إذا كان نوع الإجراء purchase أو refund
affiliation	text	لا	المتجر أو الارتباط الذي حدثت منه هذه المعاملة (مثل Google Store).
revenue	الرقم	لا	تحدّد إجمالي الأرباح أو الإجمالي الكلي المرتبط بالمعاملة (مثلاً 11.99). يمكن أن تشمل هذه القيمة الشحن أو تكاليف الضرائب أو التسويات الأخرى في إجمالي الأرباح التي تريد تضمينها كجزء من عمليات احتساب الأرباح. ملاحظة: إذا لم يتم ضبط الأرباح، سيتم احتساب قيمتها تلقائيًا باستخدام حقلَي كمية المنتجات وأسعارها لكل المنتجات في النتيجة نفسها.
القيمة	الرقم	لا	القيمة (أي الأرباح) المرتبطة بالحدث
tax	الرقم	لا	إجمالي الضريبة المرتبطة بالمعاملة.
shipping	الرقم	لا	تكلفة الشحن المرتبطة بالمعاملة.
coupon	text	لا	قسيمة المعاملة التي تم تحصيل قيمتها مع المعاملة.
list	text	لا	تمثّل هذه السمة القائمة التي تنتمي إليها المنتجات المرتبطة. اختياريّ.
items	صفيف	لا	المصفوفة التي تحتوي على المنتجات المرتبطة بها
step	عدد صحيح	لا	رقم يمثل خطوة في عملية الدفع. اختيارية في إجراءات "الدفع".
checkout_step	عدد صحيح	لا	رقم يمثل خطوة في عملية الدفع.
option	text	لا	حقل إضافي لإجراءات checkout وcheckout_option يمكن أن يصف معلومات الخيار في صفحة الدفع، مثل طريقة الدفع المحدّدة.
checkout_option	text	لا	خيار الدفع (أي طريقة الدفع المحدَّدة)

المفتاح	نوع القيمة	مطلوبة	الوصف
coupon	سلسلة	لا	رمز القسيمة لسلعة قابلة للشراء.

الإجراءات المتعلقة بالمنتجات والعروض الترويجية

تحدّد الإجراءات كيفية تفسير بيانات المنتجات والعروض الترويجية التي ترسلها إلى "إحصاءات Google".

الإجراء	حدث	الوصف
click	نقرة على رابط منتج أو منتج لمنتج واحد أو أكثر.
detail	طريقة عرض لتفاصيل المنتج
add	إضافة منتج واحد أو أكثر إلى سلة التسوّق
remove	أزِل منتجًا واحدًا أو أكثر من سلة التسوّق.
checkout	بدء عملية الدفع لمنتج واحد أو أكثر.
checkout_option	جارٍ إرسال قيمة الخيار لخطوة دفع محدّدة.
purchase	بيع منتج واحد أو أكثر.
refund	ردّ الأموال المدفوعة مقابل منتج واحد أو أكثر
promo_click	نقرة على إعلان ترويجي داخلي.
add_to_cart	يضيف المستخدم منتجًا واحدًا أو أكثر إلى سلة التسوّق.
begin_checkout	يبدأ المستخدم عملية الدفع لمنتج واحد أو أكثر.
checkout_progress	يُكمل المستخدم خطوات الدفع بعد الخطوة الأولى من عملية الدفع.
purchase	يُكمل مستخدم عملية شراء.
refund	يتم ردّ الأموال للمستخدم مقابل منتج واحد أو أكثر.
remove_from_cart	يزيل المستخدم منتجًا واحدًا أو أكثر من سلة التسوّق.
select_content	ينقر المستخدم على رابط منتج أو منتج.
set_checkout_option	هي خطوة الدفع التي يُكملها المستخدم.
view_item	يشاهد مستخدم تفاصيل منتج معيّن.
view_item_list	يشاهد أحد المستخدمين قائمة من منتج واحد أو أكثر.
view_promotion	ينقر المستخدِم على عرض ترويجي داخلي.
view_refund	يشاهد أحد المستخدمين الأموال المردودة لمنتج واحد أو أكثر.

أمثلة

قياس مرات ظهور المنتجات

لقياس مرات ظهور المنتجات، أرسِل سمة view_item_list مع معلومات المنتج:

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

قياس النقرات على المنتج

لقياس نقرة على منتج، أرسِل حدث select_content، وحدِّد product على أنّه content_type، وقدِّم معلومات المنتج:

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    }
  ]
});

قياس مشاهدات تفاصيل المنتج

بعد النقر على بيانات منتج، قد تظهر للمستخدم صفحة تفاصيل المنتج. لقياس مرّات مشاهدة تفاصيل المنتج، أرسِل حدث view_item مع تفاصيل المنتج:

gtag('event', 'view_item', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

قياس الإضافات والإزالة من سلات التسوق

لقياس عملية إضافة منتج إلى سلة التسوّق، أرسِل حدث add_to_cart يتضمّن معلومات المنتج:

gtag('event', 'add_to_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

لقياس إزالة منتج من سلة التسوّق، أرسِل حدث remove_from_cart مع معلومات المنتج:

gtag('event', 'remove_from_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

قياس عمليات الدفع

لقياس كل خطوة في عملية الدفع:

1. أضِف رمز قياس لقياس كل خطوة من خطوات عملية الدفع.
2. أضِف رمز قياس لتسجيل خيارات الدفع، إذا كان ذلك ممكنًا.

1- قياس خطوات الدفع

لقياس خطوة الدفع الأولى، أرسِل حدث begin_checkout مع عناصر الدفع:

gtag('event', 'begin_checkout', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": ""
});

لقياس كل خطوة دفع لاحقة، أرسِل حدث checkout_progress مع عناصر الدفع:

gtag('event', 'checkout_progress', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": "SUMMER_DISCOUNT"
});

2. قياس خيارات الدفع

لقياس خيار الدفع، أرسِل حدث set_checkout_option باستخدام خيار الدفع:

gtag('event', 'set_checkout_option', {
  "checkout_step": 1,
  "checkout_option": "shipping method",
  "value": 3
});

قياس مرّات ظهور الإعلان الترويجي

لقياس مرات ظهور العرض الترويجي، أرسِل حدث view_promotion مع معلومات العرض الترويجي:

gtag('event', 'view_promotion', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    },
    {
      "id": "xyz987",
      "name": "spring savings"
    }
  ]
});

قياس النقرات على العروض الترويجية

لقياس نقرة على عرض ترويجي، أرسِل حدث select_content وقدِّم العرض الترويجي:

gtag('event', 'select_content', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    }
  ]
});

قياس عمليات الشراء

لقياس معاملة، أرسِل حدث purchase باستخدام العناصر في المعاملة:

gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});

قياس عمليات ردّ الأموال

لقياس عملية ردّ الأموال بالكامل لمعاملة معيّنة، أرسِل حدث refund باستخدام معرّف المعاملة:

gtag('event', 'refund', { "transaction_id": "T12345" })

لقياس عملية ردّ جزء من الأموال، أرسِل حدث refund باستخدام معرّف المعاملة والعناصر المطلوب ردّها:

gtag('event', 'refund', {
  "transaction_id": "79.18502354114992",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});