يمكنك إعداد أحداث التجارة الإلكترونية لجمع معلومات عن سلوك التسوّق لدى مستخدِميك. تسمح لك هذه الأحداث بتحديد المنتجات الأكثر رواجًا ومعرفة مدى تأثر الإيرادات بالعروض الترويجية وتضمين المنتجات لأغراض ترويجية.
يوضّح هذا المستند كلّ حدث من أحداث التجارة الإلكترونية والحالات التي يجب فيها إعداد الحدث. للحصول على مثال تفصيلي حول كيفية إعداد حدث تجارة إلكترونية، اطّلِع على مقالة إعداد حدث شراء.
قبل البدء
إضافة علامة إعدادات "إحصاءات Google 4" إلى موقعك الإلكتروني
تأكَّد من إضافة علامة "إحصاءات Google": إعدادات "إحصاءات Google 4" إلى موقعك الإلكتروني ومن إمكانية الوصول إلى "إحصاءات Google" ورمز المصدر للموقع الإلكتروني.
قياس أحداث التجارة الإلكترونية باستخدام علامة حدث "إحصاءات Google 4"
لإرسال أحداث التجارة الإلكترونية ومعلَماتها إلى موقعك على "إحصاءات Google"، اتّبِع الخطوات التالية:
في مساحة العمل، افتح قائمة العلامات.
أنشئ علامة جديدة. انقر على مربّع إعدادات العلامة واختَر علامة إحصاءات Google: حدث "إحصاءات Google 4".
بالنسبة إلى اسم الحدث، استخدِم المتغيّر المضمّن
{{Event}}. سيؤدي ذلك إلى استخدام اسم حدث التجارة الإلكترونية في "إحصاءات Google" الذي تم إرساله باستخدام واجهة برمجة التطبيقات gtag.js.ضمن المزيد من الإعدادات > التجارة الإلكترونية، ضَع علامة في المربّع بجانب إرسال بيانات التجارة الإلكترونية.
بالنسبة إلى مصدر البيانات، اختَر طبقة البيانات.
إعداد مشغّل لحدث "إحصاءات Google 4"، مثلاً عندما ينقر مستخدم على زر الدفع الاطّلاع على جميع أنواع المشغّلات المتاحة
حدِّد الاسم واحفظ العلامة.
اقتراحات
- فعِّل وضع تصحيح الأخطاء لتتمكّن من الاطّلاع على الأحداث في الوقت الفعلي وتحديد المشاكل وحلّها.
- راجِع حدود السمات والمقاييس المخصّصة عند إرسال مَعلمات مخصّصة مع أحداث التجارة الإلكترونية.
- اضبط
currencyعند إرسال بياناتvalue(الإيرادات) لضمان احتساب مقاييس الإيرادات بشكل صحيح. - اضبط كل مَعلمة من مَعلمات التجارة الإلكترونية التي تتوفّر لك بيانات بشأنها، بغض النظر عمّا إذا كانت المَعلمة اختيارية.
- استخدِم الموقع الإلكتروني التجريبي للتجارة الإلكترونية للاطّلاع على مثال حول كيفية وضع علامات على موقعك الإلكتروني.
- لضمان ملء البيانات بشكل صحيح في التقارير، اتّبِع التنسيق الوارد في هذا المستند. إذا كنت بحاجة إلى ضبط مصفوفة المنتجات خارج مصفوفة التجارة الإلكترونية، اضبط المَعلمة
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
}
]
اختيار عنصر من قائمة
عندما تظهر للمستخدم قائمة بالنتائج، أرسِل حدث 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: {
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": حدث "إحصاءات 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: {
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": حدث "إحصاءات 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,
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,
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,
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,
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,
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,
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,
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,
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,
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: {
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": حدث "إحصاءات 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: {
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"
- اسم الحدث: أي
- قراءة البيانات من المتغيّر:
{{gaEcommerceData}} - المشغّل: الحدث يساوي
gtm.dom
إعدادات المتغيّر {{gaEcommerceData}}:
- نوع المتغيّر: JavaScript مخصّص
- نص الدالة: استخدِم المثال السابق