توضّح هذه الصفحة كيفية استخدام gtag.js لجمع بيانات التجارة الإلكترونية المحسَّنة. في حال ضبطت "إحصاءات Google" في مقتطف gtag.js مع تفعيل التجارة الإلكترونية المحسَّنة في "إحصاءات Google"، يمكنك استخدام مقتطف gtag.js لإرسال بيانات مرات الظهور وبيانات المنتج وبيانات العرض الترويجي وبيانات الإجراءات إلى "إحصاءات Google".
أنواع بيانات التجارة الإلكترونية المحسَّنة وإجراءاتها
تتوفّر أنواع متعدّدة من بيانات التجارة الإلكترونية التي يمكنك إرسالها:
بيانات مرات الظهور
تمثل معلومات عن منتج تمت مشاهدته. يُشار إليه باسم impressionFieldObject
ويحتوي على القيم التالية:
المفتاح | نوع القيمة | مطلوبة | الوصف |
---|---|---|---|
id |
text | *نعم |
معرّف المنتج أو رمز التخزين التعريفي (مثل P67890).
* يجب ضبط سمة واحدة من |
name |
text | *نعم |
اسم المنتج (مثل قميص Android).
* يجب ضبط سمة واحدة من |
list |
text | لا | القائمة أو المجموعة التي ينتمي إليها المنتج (مثل نتائج البحث) |
list_name |
text | لا | القائمة أو المجموعة التي ينتمي إليها المنتج (مثل نتائج البحث) |
brand |
text | لا | العلامة التجارية المرتبطة بالمنتج (مثل Google). |
category |
text | لا |
الفئة التي ينتمي إليها المنتج (مثل الملابس). يمكنك استخدام
/ كمُحدِّد لتحديد ما يصل إلى 5 مستويات من العرض الهرمي (على سبيل المثال
الملابس/الرجال/القمصان).
|
variant |
text | لا | خيار المنتج (مثلاً أسود). |
position |
عدد صحيح | لا | موضع المنتج في قائمة أو مجموعة (مثل 2). |
list_position |
عدد صحيح | لا | موضع المنتج في قائمة أو مجموعة (مثل 2). |
price |
الرقم | لا | سعر المنتج (على سبيل المثال: 29.20). |
بيانات المنتج
تمثّل بيانات المنتج المنتجات الفردية التي تمت مشاهدتها أو إضافتها إلى سلّة التسوّق أو غير ذلك. يُشار إليها باسم productFieldObject
وتحتوي على القيم التالية:
المفتاح | نوع القيمة | مطلوبة | الوصف |
---|---|---|---|
id |
text | *نعم |
معرّف المنتج أو رمز التخزين التعريفي (مثل P67890).
* يجب ضبط سمة واحدة من المعرّف أو |
name |
text | *نعم |
اسم المنتج (مثل قميص Android).
* يجب ضبط سمة واحدة من المعرّف أو |
brand |
text | لا | العلامة التجارية المرتبطة بالمنتج (مثل Google). |
category |
text | لا | الفئة التي ينتمي إليها المنتج (مثل الملابس). يمكنك استخدام / كمحدِّد لتحديد ما يصل إلى 5 مستويات من العرض الهرمي (على سبيل المثال الملابس/الرجال/القمصان). |
variant |
text | لا | خيار المنتج (مثلاً أسود). |
price |
الرقم | لا | سعر المنتج (على سبيل المثال: 29.20). |
quantity |
عدد صحيح | لا | كمية منتج (مثلاً 2). |
coupon |
text | لا | رمز القسيمة المرتبط بمنتج (مثل SUMMER_SALE13). |
position |
عدد صحيح | لا | موضع المنتج في قائمة أو مجموعة (مثل 2). |
list_position |
عدد صحيح | لا | موضع المنتج في قائمة أو مجموعة (مثل 2). |
بيانات العرض الترويجي
تمثل معلومات عن عرض ترويجي تمت مشاهدته. يُشار إليه باسم promoFieldObject
ويحتوي على القيم التالية:
المفتاح | نوع القيمة | مطلوبة | الوصف |
---|---|---|---|
id |
text | *نعم |
معرِّف العرض الترويجي (مثل PROMO_1234).
* يجب ضبط سمة واحدة من |
name |
text | *نعم |
اسم العرض الترويجي (على سبيل المثال، تخفيضات للصيف).
* يجب ضبط سمة واحدة من |
creative |
text | لا | تصميم الإعلان المرتبط بالعرض الترويجي (على سبيل المثال،ummer_banner2). |
creative_name |
text | لا | اسم تصميم الإعلان (على سبيل المثال،ummer_banner2). |
position |
text | لا | موضع تصميم الإعلان (على سبيل المثال، بانر_slot_1). |
creative_slot |
text | لا | اسم خانة تصميم الإعلان (على سبيل المثال، بانر_slot_1). |
بيانات الإجراءات
يعرض معلومات عن إجراء مرتبط بالتجارة الإلكترونية تم اتخاذه.
يُشار إليه باسم actionFieldObject
ويحتوي على القيم التالية:
المفتاح | نوع القيمة | مطلوبة | الوصف |
---|---|---|---|
id |
text | *نعم |
معرِّف المعاملة (مثل T1234).
* مطلوب إذا كان نوع الإجراء |
affiliation |
text | لا | المتجر أو الارتباط الذي حدثت منه هذه المعاملة (مثل Google Store). |
revenue |
الرقم | لا |
تحدّد إجمالي الأرباح أو الإجمالي الكلي المرتبط بالمعاملة (على سبيل المثال، 11.99). وقد تشمل هذه القيمة الشحن أو تكاليف الضريبة أو التسويات الأخرى في إجمالي الأرباح التي تريد تضمينها في عمليات احتساب الأرباح. |
القيمة | الرقم | لا | القيمة (أي الأرباح) المرتبطة بالحدث |
tax |
الرقم | لا | إجمالي الضريبة المرتبطة بالمعاملة. |
shipping |
الرقم | لا | تكلفة الشحن المرتبطة بالمعاملة. |
coupon |
text | لا | قسيمة المعاملة التي تم تحصيل قيمتها مع المعاملة. |
list |
text | لا | تشير هذه السمة إلى القائمة التي تنتمي إليها المنتجات المرتبطة. اختياريّ. |
items |
صفيف | لا | المصفوفة التي تحتوي على المنتجات المرتبطة بها |
step |
عدد صحيح | لا | رقم يمثل خطوة في عملية الدفع. اختيارية في إجراءات "الدفع". |
checkout_step |
عدد صحيح | لا | رقم يمثل خطوة في عملية الدفع. |
option |
text | لا |
حقل إضافي لإجراءَي checkout
وcheckout_option الذي يمكن أن يصف معلومات الخيار
في صفحة الدفع، مثل طريقة الدفع المحدّدة.
|
checkout_option |
text | لا | خيار الدفع (أي طريقة الدفع المحدَّدة) |
المفتاح | نوع القيمة | مطلوبة | الوصف |
---|---|---|---|
coupon |
سلسلة | لا | رمز القسيمة لسلعة قابلة للشراء |
الإجراءات المتعلقة بالمنتجات والعروض الترويجية
تحدد الإجراءات كيفية تفسير بيانات المنتجات والعروض الترويجية التي ترسلها إلى "إحصاءات Google".
الإجراء | حدث | الوصف |
---|---|---|
click |
نقرة على رابط منتج أو منتج واحد أو أكثر. | |
detail |
طريقة عرض تفاصيل المنتج. | |
add |
إضافة منتج واحد أو أكثر إلى سلة التسوّق. | |
remove |
أزِل منتجًا أو أكثر من سلة التسوّق. | |
checkout |
بدء عملية الدفع لمنتج واحد أو أكثر. | |
checkout_option |
يتم إرسال قيمة الخيار لخطوة دفع محدّدة. | |
purchase |
بيع منتج واحد أو أكثر | |
refund |
ردّ أموال منتج واحد أو أكثر | |
promo_click |
نقرة على إعلان ترويجي داخلي. | |
add_to_cart |
يضيف المستخدم منتجًا واحدًا أو أكثر إلى سلة التسوّق. | |
begin_checkout |
يبدأ المستخدم عملية الدفع لمنتج واحد أو أكثر. | |
checkout_progress |
يُكمل المستخدم خطوات الدفع بعد خطوة الدفع الأولى. | |
purchase |
يُكمل مستخدم عملية شراء. | |
refund |
يتم ردّ الأموال المدفوعة مقابل منتج واحد أو أكثر. | |
remove_from_cart |
يزيل المستخدم منتجًا واحدًا أو أكثر من سلة التسوّق. | |
select_content |
ينقر أحد المستخدمين على رابط منتج أو منتج. | |
set_checkout_option |
خطوة الدفع التي يكملها المستخدم. | |
view_item |
يشاهد المستخدِم تفاصيل منتج. | |
view_item_list |
يشاهد أحد المستخدمين قائمة تضم منتجًا واحدًا أو أكثر. | |
view_promotion |
ينقر أحد المستخدمين على عرض ترويجي داخلي. | |
view_refund |
يشاهد مستخدم عملية ردّ أموال لمنتج واحد أو أكثر. |
أمثلة
قياس مرات ظهور المنتجات
لقياس مرات ظهور المنتجات، أرسِل السمة view_item_list
مع معلومات المنتج:
gtag('event', 'view_item_list', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": 3
}
]
});
قياس النقرات على المنتج
لقياس نقرة على منتج، أرسِل حدث select_content
، وحدِّد product
على أنه content_type
، ثم قدِّم معلومات المنتج:
gtag('event', 'select_content', {
"content_type": "product",
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
}
]
});
قياس مشاهدات تفاصيل المنتج
بعد النقر على بيانات المنتج، يمكن أن يطّلع المستخدم على صفحة تفاصيل المنتج. لقياس طرق عرض تفاصيل المنتج، أرسِل حدث view_item
مع تفاصيل المنتج:
gtag('event', 'view_item', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
قياس الإضافات وعمليات الإزالة من سلات التسوق
لقياس عملية إضافة منتج إلى سلة التسوّق، أرسِل حدث add_to_cart
مع معلومات المنتج:
gtag('event', 'add_to_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
لقياس عملية إزالة منتج من سلة التسوّق، أرسِل حدث remove_from_cart
مع معلومات المنتج:
gtag('event', 'remove_from_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
قياس عمليات الدفع
لقياس كل خطوة في عملية الدفع:
- أضِف رمز قياس لقياس كل خطوة من خطوات عملية الدفع.
- أضِف رمز القياس لتسجيل خيارات الدفع، إن أمكن.
1- قياس خطوات الدفع
لقياس خطوة الدفع الأولى، أرسِل حدث begin_checkout
يتضمن عناصر الدفع:
gtag('event', 'begin_checkout', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": ""
});
لقياس كل خطوة دفع لاحقة، أرسِل حدث checkout_progress
مع عناصر الدفع:
gtag('event', 'checkout_progress', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": "SUMMER_DISCOUNT"
});
2. قياس خيارات الدفع
لقياس خيار دفع، أرسِل حدث set_checkout_option
مع خيار الدفع:
gtag('event', 'set_checkout_option', {
"checkout_step": 1,
"checkout_option": "shipping method",
"value": 3
});
قياس مرّات ظهور العروض الترويجية
لقياس مرات ظهور الإعلان الترويجي، أرسِل حدث view_promotion
يتضمّن معلومات العرض الترويجي:
gtag('event', 'view_promotion', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
},
{
"id": "xyz987",
"name": "spring savings"
}
]
});
قياس النقرات على العروض الترويجية
لقياس النقرة على عرض ترويجي، أرسِل حدث select_content
وقدِّم العرض الترويجي:
gtag('event', 'select_content', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
}
]
});
قياس عمليات الشراء
لقياس معاملة، أرسِل حدث purchase
مع العناصر في
المعاملة:
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});
قياس عمليات ردّ الأموال
لقياس عملية ردّ الأموال بالكامل لإحدى المعاملات، أرسِل حدث refund
مع معرّف المعاملة:
gtag('event', 'refund', { "transaction_id": "T12345" })
لقياس عملية ردّ جزء من الأموال، أرسِل حدث refund
مع معرّف المعاملة
والعناصر المطلوب ردّ أموالها:
gtag('event', 'refund', {
"transaction_id": "79.18502354114992",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});