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