جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من GitHub والاطّلاع على الإعلان لمعرفة المزيد من التفاصيل.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

قبل البدء

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

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

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

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

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

الاقتراحات

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

إعداد تجديد النشاط التسويقي الديناميكي في "إعلانات Google"

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

سهولة الاستخدام: لست بحاجة إلى ربط المَعلمات يدويًا بين موقعك الإلكتروني و"إعلانات Google".
الإعداد المستند إلى الأحداث: لتفعيل تجديد النشاط التسويقي الديناميكي، ننصحك بإعداد الأحداث المقترَحة لنوع مؤسستك. مزيد من المعلومات عن أحداث تجديد النشاط التسويقي الديناميكي ومَعلماته

التنفيذ

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

اختيار عنصر من قائمة
عرض تفاصيل العنصر
إضافة منتج إلى سلة تسوّق أو إزالته منها
بدء عملية الدفع
إجراء عمليات شراء أو ردّ الأموال
تطبيق العروض الترويجية

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

يتطلّب كل عنصر في مصفوفة items استخدام item_id أو item_name فقط، ولكن ننصحك بتقديم كليهما. يمكنك أيضًا تضمين مَعلمات اختيارية، مثل price وquantity (في حال عدم ضبطها، يتم ضبط quantity تلقائيًا على 1):

const minimalItems = [
  {
    item_id: "SKU_12345",
    item_name: "Stan and Friends Tee",
    price: 10.01,
    quantity: 3
  }
];

يوضّح المثال الشامل التالي جميع مَعلمات السلع المحدّدة المشار إليها في هذا الدليل. يمكن أن تتضمّن مصفوفة 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,
      google_business_vertical: "retail",
      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,
      google_business_vertical: "retail",
      quantity: 2
    }
]

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

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

عرض إعدادات العلامة

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

نوع العلامة: "إحصاءات Google": حدث "إحصاءات Google"‏ 4
اسم الحدث: view_item_list
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
معرّف قائمة السلع في التجارة الإلكترونية - ecommerce.item_list_id
اسم قائمة العناصر في التجارة الإلكترونية - ecommerce.item_list_name

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
item_list_id - {{Ecommerce Item List ID}}
item_list_name - {{Ecommerce Item List Name}}

المشغّل: الحدث يساوي view_item_list

إعدادات المشغِّل:

نوع المشغّل: حدث مخصّص
اسم الحدث: view_item_list
يتم تشغيل عامل التشغيل هذا عند: جميع الأحداث المخصّصة

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    currency: "USD",
    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,
      google_business_vertical: "retail",
      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",
      google_business_vertical: "retail",
      quantity: 2
    }
  }
});

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

عرض إعدادات العلامة

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

نوع العلامة: "إحصاءات Google": حدث "إحصاءات Google"‏ 4
اسم الحدث: select_item
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
معرّف قائمة السلع في التجارة الإلكترونية - ecommerce.item_list_id
اسم قائمة العناصر في التجارة الإلكترونية - ecommerce.item_list_name

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
item_list_id - {{Ecommerce Item List ID}}
item_list_name - {{Ecommerce Item List Name}}

المشغّل: الحدث يساوي select_item

إعدادات المشغِّل:

نوع المشغّل: حدث مخصّص
اسم الحدث: select_item
يتم تشغيل عامل التشغيل هذا عند: جميع الأحداث المخصّصة

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    currency: "USD",
    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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

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

عرض إعدادات العلامة

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

نوع العلامة: "إحصاءات Google": حدث "إحصاءات Google"‏ 4
اسم الحدث: view_item
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
قيمة التجارة الإلكترونية - ecommerce.value
عملة التجارة الإلكترونية - ecommerce.currency

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}

المشغّل: الحدث يساوي 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

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

عرض إعدادات العلامة

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

نوع العلامة: "إحصاءات Google": حدث "إحصاءات Google"‏ 4
اسم الحدث: add_to_cart
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
قيمة التجارة الإلكترونية - ecommerce.value
عملة التجارة الإلكترونية - ecommerce.currency

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}

المشغّل: الحدث يساوي 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

عرض إعدادات العلامة

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

نوع العلامة: "إحصاءات Google": حدث "إحصاءات Google"‏ 4
اسم الحدث: add_to_wishlist
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
قيمة التجارة الإلكترونية - ecommerce.value
عملة التجارة الإلكترونية - ecommerce.currency

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}

المشغّل: الحدث يساوي 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

عرض إعدادات العلامة

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

نوع العلامة: "إحصاءات Google": حدث "إحصاءات Google"‏ 4
اسم الحدث: view_cart
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
قيمة التجارة الإلكترونية - ecommerce.value
عملة التجارة الإلكترونية - ecommerce.currency

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}

المشغّل: الحدث يساوي 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

عرض إعدادات العلامة

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

نوع العلامة: "إحصاءات Google": حدث "إحصاءات Google"‏ 4
اسم الحدث: remove_from_cart
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
قيمة التجارة الإلكترونية - ecommerce.value
عملة التجارة الإلكترونية - ecommerce.currency

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}

المشغّل: الحدث يساوي 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

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

عرض إعدادات العلامة

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

نوع العلامة: إحصاءات Google: حدث "إحصاءات Google‏ 4"
اسم الحدث: begin_checkout
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
قيمة التجارة الإلكترونية - ecommerce.value
عملة التجارة الإلكترونية - ecommerce.currency
قسيمة التجارة الإلكترونية - ecommerce.coupon

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}
coupon - {{Ecommerce Coupon}}

المشغّل: الحدث يساوي begin_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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

عرض إعدادات العلامة

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

نوع العلامة: "إحصاءات Google": حدث "إحصاءات Google"‏ 4
اسم الحدث: add_shipping_info
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
قيمة التجارة الإلكترونية - ecommerce.value
عملة التجارة الإلكترونية - ecommerce.currency
قسيمة التجارة الإلكترونية - ecommerce.coupon
مستوى الشحن في التجارة الإلكترونية - ecommerce.shipping_tier

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}
coupon - {{Ecommerce Coupon}}
shipping_tier - {{Ecommerce 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

عرض إعدادات العلامة

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

نوع العلامة: "إحصاءات Google": حدث "إحصاءات Google"‏ 4
اسم الحدث: add_payment_info
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
قيمة التجارة الإلكترونية - ecommerce.value
عملة التجارة الإلكترونية - ecommerce.currency
قسيمة التجارة الإلكترونية - ecommerce.coupon
نوع الدفع في التجارة الإلكترونية - ecommerce.payment_type

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}
coupon - {{Ecommerce Coupon}}
payment_type - {{Ecommerce Payment Type}}

المشغّل: الحدث يساوي 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

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

عرض إعدادات العلامة

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

نوع العلامة: إحصاءات Google: حدث "إحصاءات Google‏ 4"
اسم الحدث: purchase
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
معرِّف معاملة التجارة الإلكترونية - ecommerce.transaction_id
قيمة التجارة الإلكترونية - ecommerce.value
ضريبة التجارة الإلكترونية - ecommerce.tax
شحن التجارة الإلكترونية - ecommerce.shipping
عملة التجارة الإلكترونية - ecommerce.currency
قسيمة التجارة الإلكترونية - ecommerce.coupon

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
transaction_id - {{Ecommerce Transaction ID}}
value - {{Ecommerce Value}}
tax - {{Ecommerce Tax}}
shipping - {{Ecommerce Shipping}}
currency - {{Ecommerce Currency}}
coupon - {{Ecommerce Coupon}}

المشغّل: الحدث يساوي purchase

إعدادات المشغِّل:

نوع المشغّل: حدث مخصّص
اسم الحدث: 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",
    customer_type: "new",
    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: حدث "إحصاءات Google‏ 4"
اسم الحدث: refund
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

منتجات التجارة الإلكترونية - ecommerce.items
معرِّف معاملة التجارة الإلكترونية - ecommerce.transaction_id
قيمة التجارة الإلكترونية - ecommerce.value
ضريبة التجارة الإلكترونية - ecommerce.tax
شحن التجارة الإلكترونية - ecommerce.shipping
عملة التجارة الإلكترونية - ecommerce.currency
قسيمة التجارة الإلكترونية - ecommerce.coupon

مَعلمات الأحداث (اسم المَعلمة - القيمة):

items - {{Ecommerce Items}}
transaction_id - {{Ecommerce Transaction ID}}
value - {{Ecommerce Value}}
tax - {{Ecommerce Tax}}
shipping - {{Ecommerce Shipping}}
currency - {{Ecommerce Currency}}
coupon - {{Ecommerce Coupon}}

المشغّل: الحدث يساوي refund

إعدادات المشغِّل:

نوع المشغّل: حدث مخصّص
اسم الحدث: 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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

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

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

عرض إعدادات العلامة

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

نوع العلامة: "إحصاءات Google": حدث "إحصاءات Google"‏ 4
اسم الحدث: view_promotion
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

اسم تصميم إعلان التجارة الإلكترونية - ecommerce.creative_name
خانة تصميم إعلان التجارة الإلكترونية - ecommerce.creative_slot
معرّف العرض الترويجي للتجارة الإلكترونية - ecommerce.promotion_id
اسم العرض الترويجي للتجارة الإلكترونية - ecommerce.promotion_name
منتجات التجارة الإلكترونية - ecommerce.items

مَعلمات الأحداث (اسم المَعلمة - القيمة):

creative_name - {{Ecommerce Creative Name}}
creative_slot - {{Ecommerce Creative Slot}}
promotion_id - {{Ecommerce Promotion ID}}
promotion_name - {{Ecommerce Promotion Name}}
items - {{Ecommerce Items}}

المشغّل: الحدث يساوي view_promotion

إعدادات المشغِّل:

نوع المشغّل: حدث مخصّص
اسم الحدث: view_promotion
يتم تشغيل عامل التشغيل هذا عند: جميع الأحداث المخصّصة

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    currency: "USD",
    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,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

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

عرض إعدادات العلامة

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

نوع العلامة: إحصاءات Google: حدث "إحصاءات Google‏ 4"
متغيّرات طبقة البيانات (الاسم - اسم متغيّر طبقة البيانات):

اسم تصميم إعلان التجارة الإلكترونية - ecommerce.creative_name
خانة تصميم إعلان التجارة الإلكترونية - ecommerce.creative_slot
معرّف العرض الترويجي للتجارة الإلكترونية - ecommerce.promotion_id
اسم العرض الترويجي للتجارة الإلكترونية - ecommerce.promotion_name
منتجات التجارة الإلكترونية - ecommerce.items

مَعلمات الأحداث (اسم المَعلمة - القيمة):

creative_name - {{Ecommerce Creative Name}}
creative_slot - {{Ecommerce Creative Slot}}
promotion_id - {{Ecommerce Promotion ID}}
promotion_name - {{Ecommerce Promotion Name}}
items - {{Ecommerce Items}}

نوع المتغيّر: متغيّر طبقة البيانات - 'ecommerce.items'
المشغّل: الحدث يساوي select_promotion

إعدادات المشغِّل:

نوع المشغّل: حدث مخصّص
اسم الحدث: select_promotion
يتم تشغيل عامل التشغيل هذا عند: جميع الأحداث المخصّصة

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    currency: "USD",
    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,
      google_business_vertical: "retail",
      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"
اسم الحدث: أي
قراءة البيانات من المتغيّر: {{gaEcommerceData}}
المشغّل: الحدث يساوي gtm.dom

{{gaEcommerceData}} إعدادات المتغيّرات:

نوع المتغيّر: JavaScript مخصّص
نص الدالة: استخدِم المثال السابق

إعداد أحداث الشراء

تطبيق خصم

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

قبل البدء

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

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

الاقتراحات

إعداد تجديد النشاط التسويقي الديناميكي في "إعلانات Google"

التنفيذ

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

عرض إعدادات العلامة

عرض إعدادات العلامة

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

عرض إعدادات العلامة

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

عرض إعدادات العلامة

عرض إعدادات العلامة

عرض إعدادات العلامة

عرض إعدادات العلامة

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

عرض إعدادات العلامة

عرض إعدادات العلامة

عرض إعدادات العلامة

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

عرض إعدادات العلامة

عرض إعدادات العلامة

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

عرض إعدادات العلامة

عرض إعدادات العلامة

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

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