قياس التجارة الإلكترونية

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

توضِّح هذه المقالة كلّ حدث من أحداث التجارة الإلكترونية والحالات التي يجب فيها إعداده. للاطّلاع على مثال مفصّل حول كيفية إعداد حدث للتجارة الإلكترونية، راجِع مقالة إعداد حدث شراء.

قبل البدء

إضافة علامة ضبط "إحصاءات Google 4" إلى موقعك الإلكتروني

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

قياس أحداث التجارة الإلكترونية باستخدام علامة حدث "إحصاءات Google 4"

لإرسال أحداث التجارة الإلكترونية ومَعلماتها إلى موقعك على "إحصاءات Google 4":

  1. فتح أداة "إدارة العلامات من Google"
  2. في مساحة العمل، افتح قائمة العلامات.
  3. أنشئ علامة جديدة. انقر على المربّع إعدادات العلامة واختر علامة "إحصاءات Google": حدث "إحصاءات Google 4".
  4. بالنسبة إلى اسم الحدث، استخدِم المتغيّر المضمّن {{Event}}. سيؤدّي ذلك إلى استخدام اسم حدث التجارة الإلكترونية "إحصاءات Google 4" الذي تم إرساله باستخدام واجهة برمجة التطبيقات gtag.js API.
  5. ضمن المزيد من الإعدادات > التجارة الإلكترونية، ضَع علامة في المربّع إرسال بيانات التجارة الإلكترونية.
  6. بالنسبة إلى مصدر البيانات، اختَر طبقة البيانات. إرسال بيانات التجارة الإلكترونية.
  7. عليك إعداد عامل تشغيل لحدث "إحصاءات Google 4"، على سبيل المثال عندما ينقر مستخدِم على زر دفع. اطّلِع على جميع أنواع عوامل التشغيل المتاحة.
  8. أدخِل الاسم واحفظ العلامة.

اقتراحات

  • فعِّل وضع تصحيح الأخطاء لتتمكّن من الاطّلاع على الأحداث في الوقت الفعلي وتحديد المشاكل وحلّها بسهولة أكبر.
  • مراجعة حدود السمات والمقاييس المخصّصة عند إرسال مَعلمات مخصّصة مع أحداث التجارة الإلكترونية
  • اضبط currency عند إرسال بيانات value (الأرباح) لضمان احتساب مقاييس الأرباح بشكلٍ صحيح.
  • ضبط كل مَعلمة تجارة إلكترونية لديك بيانات لها، بغض النظر عمّا إذا كانت المَعلمة اختيارية
  • استخدِم نموذج موقع إلكتروني للتجارة الإلكترونية للاطّلاع على مثال حول كيفية وضع علامات على موقعك الإلكتروني.

التنفيذ

يقيس تنفيذ التجارة الإلكترونية النموذجي أيًا من الإجراءات التالية:

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

يوضح المثال التالي كيفية إنشاء مجموعة من items التي تتم الإشارة إليها في هذا الدليل. يمكن أن تتضمن صفيفة items ما يصل إلى 200 عنصر.

items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      quantity: 2
    }
]

نقل البيانات من إحدى عمليات تنفيذ التجارة الإلكترونية على Universal Analytics

إذا كنت قد نفّذت التجارة الإلكترونية على Universal Analytics، يمكنك تنفيذ أحد الإجراءات التالية لنقل البيانات إلى "إحصاءات Google 4":

  • استخدام عملية تنفيذ التجارة الإلكترونية في Universal Analytics لتعبئة أحداث التجارة الإلكترونية في "إحصاءات Google 4"
  • استبدال عملية تنفيذ التجارة الإلكترونية في Universal Analytics بأحداث التجارة الإلكترونية في "إحصاءات Google 4"

للاطّلاع على معلومات عن كيفية نقل عملية تنفيذ التجارة الإلكترونية من Universal Analytics إلى "إحصاءات Google 4"، اطّلِع على دليل نقل بيانات التجارة الإلكترونية في "إحصاءات Google 4" لأداة "إدارة العلامات من Google".

محو عنصر التجارة الإلكترونية

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

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.

اختيار عنصر من القائمة

عندما تظهر للمستخدم قائمة نتائج، أرسِل حدث view_item_list يتضمّن مَعلمة مصفوفة items تحتوي على العناصر المعروضة. لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: view_item_list
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • رقم تعريف قائمة عناصر التجارة الإلكترونية - ecommerce.item_list_id
    • اسم قائمة عناصر التجارة الإلكترونية - ecommerce.item_list_name
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • item_list_id - {{رقم تعريف قائمة عناصر التجارة الإلكترونية}
    • item_list_name - {{اسم قائمة عناصر التجارة الإلكترونية}rbrace
  • عامل التشغيل: الحدث يساوي view_item_list

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: view_item_list
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

بعد أن يختار مستخدم عنصرًا من القائمة، أرسِل الحدث select_item مع العنصر الذي اخترته في مَعلمة مصفوفة items. لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: select_item
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • رقم تعريف قائمة عناصر التجارة الإلكترونية - ecommerce.item_list_id
    • اسم قائمة عناصر التجارة الإلكترونية - ecommerce.item_list_name
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • item_list_id - {{رقم تعريف قائمة عناصر التجارة الإلكترونية}
    • item_list_name - {{اسم قائمة عناصر التجارة الإلكترونية}rbrace
  • عامل التشغيل: الحدث يساوي select_item

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: select_item
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

عرض تفاصيل العنصر

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

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: view_item
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • قيمة التجارة الإلكترونية - ecommerce.value
    • عملة التجارة الإلكترونية - ecommerce.currency
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • value - {{قيمة التجارة الإلكترونية&rbrace
    • currency - {{عملة التجارة الإلكترونية}&rbrace
  • عامل التشغيل: الحدث يساوي view_item

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: view_item
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

إضافة عنصر إلى سلة التسوّق أو إزالته منه

يمكنك قياس سلعة تتم إضافتها إلى سلّة التسوّق عن طريق إرسال حدث add_to_cart مع السلع ذات الصلة في مصفوفة items. لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: add_to_cart
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • قيمة التجارة الإلكترونية - ecommerce.value
    • عملة التجارة الإلكترونية - ecommerce.currency
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • value - {{قيمة التجارة الإلكترونية&rbrace
    • currency - {{عملة التجارة الإلكترونية}&rbrace
  • عامل التشغيل: الحدث يساوي add_to_cart

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: add_to_cart
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

يمكنك أيضًا قياس وقت إضافة سلعة إلى قائمة الأمنيات عن طريق إرسال حدث add_to_wishlist مع العناصر ذات الصلة في مصفوفة items. لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: add_to_wishlist
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • قيمة التجارة الإلكترونية - ecommerce.value
    • عملة التجارة الإلكترونية - ecommerce.currency
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • value - {{قيمة التجارة الإلكترونية&rbrace
    • currency - {{عملة التجارة الإلكترونية}&rbrace
  • عامل التشغيل: الحدث يساوي add_to_wishlist

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: add_to_wishlist
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

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

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: view_cart
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • قيمة التجارة الإلكترونية - ecommerce.value
    • عملة التجارة الإلكترونية - ecommerce.currency
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • value - {{قيمة التجارة الإلكترونية&rbrace
    • currency - {{عملة التجارة الإلكترونية}&rbrace
  • عامل التشغيل: الحدث يساوي view_cart

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: view_cart
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

لقياس الحالات التي يزيل فيها المستخدم سلعة من سلة التسوّق، أرسِل حدث remove_from_cart. لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، يُرجى الاطّلاع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: remove_from_cart
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • قيمة التجارة الإلكترونية - ecommerce.value
    • عملة التجارة الإلكترونية - ecommerce.currency
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • value - {{قيمة التجارة الإلكترونية&rbrace
    • currency - {{عملة التجارة الإلكترونية}&rbrace
  • عامل التشغيل: الحدث يساوي remove_from_cart

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: remove_from_cart
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

بدء عملية الدفع

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

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: begin_checkout
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • قيمة التجارة الإلكترونية - ecommerce.value
    • عملة التجارة الإلكترونية - ecommerce.currency
    • قسيمة التجارة الإلكترونية - ecommerce.coupon
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • value - {{قيمة التجارة الإلكترونية&rbrace
    • currency - {{عملة التجارة الإلكترونية}&rbrace
    • coupon - {{قسيمة تجارة إلكترونية}&rbrace
  • عامل التشغيل: الحدث يساوي start_checkout

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: begin_checkout
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

عندما ينتقل المستخدم إلى الخطوة التالية في عملية الدفع ويضيف معلومات الشحن، أرسِل حدث add_shipping_info. استخدِم المَعلمة shipping_tier لتحديد خيار التسليم لدى المستخدم، مثل "برّي" أو "هواء" أو "اليوم التالي". لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، يُرجى الاطّلاع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: add_shipping_info
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • قيمة التجارة الإلكترونية - ecommerce.value
    • عملة التجارة الإلكترونية - ecommerce.currency
    • قسيمة التجارة الإلكترونية - ecommerce.coupon
    • فئة شحن التجارة الإلكترونية - ecommerce.shipping_tier
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • value - {{قيمة التجارة الإلكترونية&rbrace
    • currency - {{عملة التجارة الإلكترونية}&rbrace
    • coupon - {{قسيمة تجارة إلكترونية}&rbrace
    • shipping_tier - {{قيمة شحن التجارة الإلكترونية
  • عامل التشغيل: الحدث يساوي add_shipping_info

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: add_shipping_info
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

أرسِل حدث "add_payment_info" عندما يرسل مستخدم معلومات الدفع. يُرجى تضمين "payment_type" مع هذا الحدث لطريقة الدفع التي اخترتها، إن أمكن. لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، يُرجى الاطّلاع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: add_payment_info
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • قيمة التجارة الإلكترونية - ecommerce.value
    • عملة التجارة الإلكترونية - ecommerce.currency
    • قسيمة التجارة الإلكترونية - ecommerce.coupon
    • طريقة الدفع في التجارة الإلكترونية - ecommerce.payment_type
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • value - {{قيمة التجارة الإلكترونية&rbrace
    • currency - {{عملة التجارة الإلكترونية}&rbrace
    • coupon - {{قسيمة تجارة إلكترونية}&rbrace
    • payment_type - {{نوع الدفع في التجارة الإلكترونية}rbrace
  • عامل التشغيل: الحدث يساوي add_payment_info

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: add_payment_info
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

إجراء عملية شراء أو ردّ الأموال

يمكنك قياس عملية شراء عن طريق إرسال حدث "purchase" مع سلعة واحدة أو أكثر محدّدة باستخدام الحقول ذات الصلة. لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: purchase
    • عناصر التجارة الإلكترونية - ecommerce.items
    • معرِّف معاملة التجارة الإلكترونية - ecommerce.transaction_id
    • قيمة التجارة الإلكترونية - ecommerce.value
    • ضريبة التجارة الإلكترونية - ecommerce.tax
    • شحن التجارة الإلكترونية - ecommerce.shipping
    • عملة التجارة الإلكترونية - ecommerce.currency
    • قسيمة التجارة الإلكترونية - ecommerce.coupon
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • transaction_id - {{معرّف معاملة التجارة الإلكترونية
    • value - {{قيمة التجارة الإلكترونية&rbrace
    • tax - {ضريبة التجارة الإلكترونية&rbrace
    • shipping - {شحن التجارة الإلكترونية&rbrace
    • currency - {{عملة التجارة الإلكترونية}&rbrace
    • coupon - {{قسيمة تجارة إلكترونية}&rbrace
  • عامل التشغيل: الحدث يساوي عملية شراء

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: purchase
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

يمكنك قياس عمليات ردّ الأموال عن طريق إرسال حدث refund مع تحديد transaction_id ذي الصلة وعنصر واحد أو أكثر محدّدَين بالسمتَين item_id وquantity. ننصحك بتضمين معلومات عن السلع في حدث "refund" للاطّلاع على مقاييس ردّ الأموال على مستوى السلعة في "إحصاءات Google".

لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، يُرجى الاطّلاع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: refund
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • عناصر التجارة الإلكترونية - ecommerce.items
    • معرِّف معاملة التجارة الإلكترونية - ecommerce.transaction_id
    • قيمة التجارة الإلكترونية - ecommerce.value
    • ضريبة التجارة الإلكترونية - ecommerce.tax
    • شحن التجارة الإلكترونية - ecommerce.shipping
    • عملة التجارة الإلكترونية - ecommerce.currency
    • قسيمة التجارة الإلكترونية - ecommerce.coupon
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • items - {عناصر التجارة الإلكترونية&rbrace
    • transaction_id - {{معرّف معاملة التجارة الإلكترونية
    • value - {{قيمة التجارة الإلكترونية&rbrace
    • tax - {ضريبة التجارة الإلكترونية&rbrace
    • shipping - {شحن التجارة الإلكترونية&rbrace
    • currency - {{عملة التجارة الإلكترونية}&rbrace
    • coupon - {{قسيمة تجارة إلكترونية}&rbrace
  • عامل التشغيل: الحدث يساوي ردّ الأموال

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: refund
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping: 3.33,
    tax: 1.11,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

تطبيق العروض الترويجية

تشمل التجارة الإلكترونية إمكانية قياس مرات الظهور والنقرات المرتبطة بالعروض الترويجية الداخلية، مثل إعلانات البانر التي يتم عرضها للترويج لتخفيضات.

يتم عادةً قياس مرّات ظهور العروض الترويجية باستخدام مشاهدة الشاشة الأولية عن طريق إرسال حدث view_promotion مع مَعلمة سلع لتحديد السلعة المروَّج لها. لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: view_promotion
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • اسم تصميم إعلان التجارة الإلكترونية - ecommerce.creative_name
    • شريحة تصميم إعلان التجارة الإلكترونية - ecommerce.creative_slot
    • رقم تعريف العرض الترويجي في التجارة الإلكترونية - ecommerce.promotion_id
    • اسم العرض الترويجي للتجارة الإلكترونية - ecommerce.promotion_name
    • عناصر التجارة الإلكترونية - ecommerce.items
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • creative_name - {{اسم تصميم إعلان التجارة الإلكترونية}rbrace
    • creative_slot - {{شريحة تصميم إعلان التجارة الإلكترونية}
    • promotion_id - {{رقم تعريف العرض الترويجي في التجارة الإلكترونية&rbrace
    • promotion_name - {{اسم العرض الترويجي للتجارة الإلكترونية}rbrace
    • items - {عناصر التجارة الإلكترونية&rbrace
  • عامل التشغيل: الحدث يساوي view_promotion

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: view_promotion
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

للإشارة إلى نقر مستخدم على عرض ترويجي، أرسِل حدث select_promotion مع إدراج تلك السلعة كمعلّمة للسلعة. لمعرفة تفاصيل عن المَعلمات المطلوب إرسالها، اطّلِع على مرجع الأحداث.

الاطّلاع على إعدادات العلامة

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
    • اسم تصميم إعلان التجارة الإلكترونية - ecommerce.creative_name
    • شريحة تصميم إعلان التجارة الإلكترونية - ecommerce.creative_slot
    • رقم تعريف العرض الترويجي في التجارة الإلكترونية - ecommerce.promotion_id
    • اسم العرض الترويجي للتجارة الإلكترونية - ecommerce.promotion_name
    • عناصر التجارة الإلكترونية - ecommerce.items
  • مَعلمات الأحداث (اسم المَعلمة - القيمة):
    • creative_name - {{اسم تصميم إعلان التجارة الإلكترونية}rbrace
    • creative_slot - {{شريحة تصميم إعلان التجارة الإلكترونية}
    • promotion_id - {{رقم تعريف العرض الترويجي في التجارة الإلكترونية&rbrace
    • promotion_name - {{اسم العرض الترويجي للتجارة الإلكترونية}rbrace
    • items - {عناصر التجارة الإلكترونية&rbrace
  • نوع المتغيّر: متغيّر طبقة البيانات - 'ecommerce.items'
  • عامل التشغيل: الحدث يساوي select_promotion

ضبط المشغِّل:

  • نوع العامل المشغِّل: حدث مخصّص
  • اسم الحدث: select_promotion
  • يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

استخدام متغيّر JavaScript مخصَّص

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

// A Custom JavaScript Variable that returns an ecommerceData object
// that follows the data layer syntax.
function getEcommerceData() {
  var ecommerceProductData = [
    {
      item_name: "Stan and Friends Tee",
      item_id: "SKU_12345",  // ID is required.
      // Rest of the product data should follow the data layer syntax.
    },
    // Multiple products may be included.
  ];
  return ecommerceProductData;
}

إذا اختَرت استخدام متغيّر JavaScript مخصّص، يمكنك استخدامه بالطريقة نفسها التي تستخدمها طبقة البيانات، إذ يمكنك توفير القيمة من المَعلمة 'items' باعتبارها مَعلمة حدث في إعدادات علامتك.

إعدادات العلامة:

  • نوع العلامة: حدث "إحصاءات Google 4"
  • اسم الحدث: أي
  • قراءة البيانات من "المتغيّر": {{gacommerceData}&rbrace
  • عامل التشغيل: الحدث يساوي gtm.dom

إعدادات متغيّرات gacommerceData

  • نوع المتغيّر: رمز JavaScript مخصّص
  • نص الدالة: استخدام المثال أعلاه