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

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

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

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

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

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

المفتاح نوع القيمة مطلوبة الوصف
id text *نعم

معرّف المنتج أو رمز التخزين التعريفي (مثل 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 *نعم

معرّف المنتج أو رمز التخزين التعريفي (مثل 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 لا تصميم الإعلان المرتبط بالعرض الترويجي (على سبيل المثال،ummer_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'
    }
  ]
});