تتيح لك هذه الأحداث قياس ميزات وسلوكيات إضافية وإنشاء تقارير أكثر فائدة في "إحصاءات Google 4". ولأن هذه الأحداث تتطلب سياقًا إضافيًا لكي تكون ذات مغزى، فلا يتم إرسالها تلقائيًا. استخدِم هذا المستند للاطّلاع على المَعلمات المطلوبة والاختيارية لكلّ حدث
add_payment_info
يشير هذا الحدث إلى أنّ المستخدم قد أرسل معلومات الدفع الخاصة به في عملية دفع عبر التجارة الإلكترونية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
payment_type |
string |
لا | بطاقة الائتمان | طريقة الدفع التي اخترتها |
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
add_payment_info
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- قيمة التجارة الإلكترونية -
ecommerce.value
- عملة التجارة الإلكترونية -
ecommerce.currency
- قسيمة التجارة الإلكترونية -
ecommerce.coupon
- طريقة الدفع في التجارة الإلكترونية -
ecommerce.payment_type
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbracevalue
- {{قيمة التجارة الإلكترونية&rbracecurrency
- {{عملة التجارة الإلكترونية}&rbracecoupon
- {{قسيمة تجارة إلكترونية}&rbracepayment_type
- {{نوع الدفع في التجارة الإلكترونية}rbrace- عامل التشغيل: الحدث يساوي add_payment_info
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
add_payment_info
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "add_payment_info",
ecommerce: {
currency: "USD",
value: 30.03,
coupon: "SUMMER_FUN",
payment_type: "Credit Card",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});
add_shipping_info
يشير هذا الحدث إلى أن المستخدم قد أرسل معلومات الشحن في عملية الدفع عبر التجارة الإلكترونية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
shipping_tier |
string |
لا | شحن بري |
فئة الشحن (مثل Ground أو Air أو Next-day ) التي تم اختيارها لتسليم السلعة المشتراة.
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
add_shipping_info
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- قيمة التجارة الإلكترونية -
ecommerce.value
- عملة التجارة الإلكترونية -
ecommerce.currency
- قسيمة التجارة الإلكترونية -
ecommerce.coupon
- فئة شحن التجارة الإلكترونية -
ecommerce.shipping_tier
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbracevalue
- {{قيمة التجارة الإلكترونية&rbracecurrency
- {{عملة التجارة الإلكترونية}&rbracecoupon
- {{قسيمة تجارة إلكترونية}&rbraceshipping_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_to_cart
يشير هذا الحدث إلى أنّه تمت إضافة سلعة إلى سلة التسوّق لشرائها.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
add_to_cart
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- قيمة التجارة الإلكترونية -
ecommerce.value
- عملة التجارة الإلكترونية -
ecommerce.currency
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbracevalue
- {{قيمة التجارة الإلكترونية&rbracecurrency
- {{عملة التجارة الإلكترونية}&rbrace- عامل التشغيل: الحدث يساوي add_to_cart
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
add_to_cart
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "add_to_cart",
ecommerce: {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});
add_to_wishlist
ويشير الحدث إلى أنّه تمت إضافة عنصر إلى قائمة الأمنيات. يمكنك استخدام هذا الحدث لتحديد الهدايا الرائجة في تطبيقك
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
add_to_wishlist
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- قيمة التجارة الإلكترونية -
ecommerce.value
- عملة التجارة الإلكترونية -
ecommerce.currency
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbracevalue
- {{قيمة التجارة الإلكترونية&rbracecurrency
- {{عملة التجارة الإلكترونية}&rbrace- عامل التشغيل: الحدث يساوي add_to_wishlist
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
add_to_wishlist
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "add_to_wishlist",
ecommerce: {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});
begin_checkout
يشير هذا الحدث إلى أنّ مستخدمًا بدأ عملية دفع.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
begin_checkout
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- قيمة التجارة الإلكترونية -
ecommerce.value
- عملة التجارة الإلكترونية -
ecommerce.currency
- قسيمة التجارة الإلكترونية -
ecommerce.coupon
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbracevalue
- {{قيمة التجارة الإلكترونية&rbracecurrency
- {{عملة التجارة الإلكترونية}&rbracecoupon
- {{قسيمة تجارة إلكترونية}&rbrace- عامل التشغيل: الحدث يساوي start_checkout
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
begin_checkout
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "begin_checkout",
ecommerce: {
currency: "USD",
value: 30.03,
coupon: "SUMMER_FUN",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});
earn_virtual_currency
يقيس هذا الحدث عندما يتم منح المستخدم عملة افتراضية في لعبة. يمكنك تسجيل هذه القيمة جنبًا إلى جنب مع spend_virtual_currency لفهم اقتصادك الافتراضي بشكل أفضل.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
virtual_currency_name |
string |
لا | قائمة Gems | اسم العملة الافتراضية. |
value |
number |
لا | 5 | قيمة العملة الافتراضية. |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
earn_virtual_currency
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
virtual_currency_name
- جواهرvalue
- 5- تشغيل الحدث عندما يتم منح شخص عملة افتراضية
generate_lead
يقيس هذا الحدث وقت إنشاء عميل محتمل (من خلال نموذج مثلاً). سجّل هذه البيانات لفهم مدى فعالية حملاتك التسويقية وعدد العملاء الذين يعيدون التفاعل مع نشاطك التجاري بعد تجديد النشاط التسويقي للعملاء.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
generate_lead
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
currency
- دولار أمريكيvalue
- 99,99- تشغيل الحدث عند إنشاء عميل محتمل
join_group
تسجيل هذا الحدث عندما ينضم مستخدم إلى مجموعة، مثل رابطة أو فريق أو عائلة. استخدِم هذا الحدث لتحليل مدى رواج بعض المجموعات أو الميزات الاجتماعية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
group_id |
string |
لا | G_12345 | رقم تعريف المجموعة. |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
join_group
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
group_id
- G_12345- تشغيل الحدث عندما ينضم أحد المستخدِمين إلى مجموعة
level_end
يشير هذا الحدث إلى وصول اللاعب إلى نهاية مستوى في لعبة.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
level_name |
string |
لا | تبدأ الرحلة... | تمثّل هذه السمة اسم المستوى. |
success |
boolean |
لا | صحيح | يمكنك ضبط القيمة على true إذا تمّ إكمال المستوى بنجاح. |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
level_end
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
level_name
- تبدأ الرحلة...- ناجح - صحيح
- يتم تشغيله عند وصول اللاعب إلى نهاية أحد المستويات (على سبيل المثال، صفحة تأكيد المستوى)
level_start
يشير هذا الحدث إلى أنّ لاعبًا قد بدأ مستوى في لعبة.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
level_name |
string |
لا | تبدأ الرحلة... | تمثّل هذه السمة اسم المستوى. |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
level_start
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
level_name
- تبدأ الرحلة...- يتم تشغيله عندما يبدأ أحد المستخدِمين مستوى جديدًا (على سبيل المثال، الصفحة الرئيسية للمستوى).
level_up
يشير هذا الحدث إلى انتقال لاعب إلى مستوى أعلى في لعبة. يمكنك استخدامها لقياس التوزيع على مستوى قاعدة المستخدمين وتحديد المستويات التي يصعب إكمالها.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
level |
number |
لا | 5 | مستوى الشخصية. |
character |
string |
لا | لاعب 1 | الشخصية التي وصلت إلى مستوى أعلى. |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
level_up
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
level
- 5character
- لاعب 1- يبدأ عند انتقال اللاعب إلى مستوى أعلى
تسجيل دخول
أرسِل هذا الحدث للإشارة إلى أنّ المستخدم سجّل الدخول إلى موقعك الإلكتروني أو تطبيقك.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدمة لتسجيل الدخول. |
مثال
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
login
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
method
- Google- يبدأ عند تسجيل دخول المستخدم
post_score
يمكنك إرسال هذا الحدث عندما ينشر المستخدم نتيجة. استخدِم هذا الحدث لفهم مستوى أداء المستخدمين في لعبتك وربط النتائج العالية بالجماهير أو السلوكيات.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
score |
number |
Yes | 10000 | النتيجة المطلوب نشرها. |
level |
number |
لا | 5 | تمثّل هذه السمة مستوى النتيجة. |
character |
string |
لا | لاعب 1 | الشخصية التي حقّقت النتيجة. |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
post_score
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
score
- 10,000level
- 5character
- لاعب 1- يبدأ عندما ينشر المستخدِم نتيجة.
purchase
يشير هذا الحدث إلى شراء منتج واحد أو أكثر من قِبل أحد المستخدمين.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
transaction_id |
string |
Yes | T_12345 | المعرّف الفريد للمعاملة. تساعدك المَعلمة transaction_id في تجنُّب الحصول على أحداث مكرّرة لعملية شراء. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
shipping |
number |
لا | 3.33 | تكلفة الشحن المرتبطة بإحدى المعاملات. |
tax |
number |
لا | 1.11 | تكلفة الضريبة المرتبطة بالمعاملة. |
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
purchase
- عناصر التجارة الإلكترونية -
ecommerce.items
- معرِّف معاملة التجارة الإلكترونية -
ecommerce.transaction_id
- قيمة التجارة الإلكترونية -
ecommerce.value
- ضريبة التجارة الإلكترونية -
ecommerce.tax
- شحن التجارة الإلكترونية -
ecommerce.shipping
- عملة التجارة الإلكترونية -
ecommerce.currency
- قسيمة التجارة الإلكترونية -
ecommerce.coupon
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbracetransaction_id
- {{معرّف معاملة التجارة الإلكترونيةvalue
- {{قيمة التجارة الإلكترونية&rbracetax
- {ضريبة التجارة الإلكترونية&rbraceshipping
- {شحن التجارة الإلكترونية&rbracecurrency
- {{عملة التجارة الإلكترونية}&rbracecoupon
- {{قسيمة تجارة إلكترونية}&rbrace- عامل التشغيل: الحدث يساوي عملية شراء
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
purchase
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "purchase",
ecommerce: {
transaction_id: "T_12345",
// Sum of (price * quantity) for all items.
value: 72.05,
tax: 3.60,
shipping: 5.99,
currency: "USD",
coupon: "SUMMER_SALE",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
},
{
item_id: "SKU_12346",
item_name: "Google Grey Women's Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 3.33,
index: 1,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "gray",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 21.01,
promotion_id: "P_12345",
promotion_name: "Summer Sale",
quantity: 2
}]
}
});
refund
يشير هذا الحدث إلى ردّ أموال سلعة واحدة أو أكثر إلى أحد المستخدمين.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
transaction_id |
string |
Yes | T_12345 | المعرّف الفريد للمعاملة. |
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
shipping |
number |
لا | 3.33 | تكلفة الشحن المرتبطة بإحدى المعاملات. |
tax |
number |
لا | 1.11 | تكلفة الضريبة المرتبطة بالمعاملة. |
items |
Array<Item>
|
لا* | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
refund
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- معرِّف معاملة التجارة الإلكترونية -
ecommerce.transaction_id
- قيمة التجارة الإلكترونية -
ecommerce.value
- ضريبة التجارة الإلكترونية -
ecommerce.tax
- شحن التجارة الإلكترونية -
ecommerce.shipping
- عملة التجارة الإلكترونية -
ecommerce.currency
- قسيمة التجارة الإلكترونية -
ecommerce.coupon
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbracetransaction_id
- {{معرّف معاملة التجارة الإلكترونيةvalue
- {{قيمة التجارة الإلكترونية&rbracetax
- {ضريبة التجارة الإلكترونية&rbraceshipping
- {شحن التجارة الإلكترونية&rbracecurrency
- {{عملة التجارة الإلكترونية}&rbracecoupon
- {{قسيمة تجارة إلكترونية}&rbrace- عامل التشغيل: الحدث يساوي ردّ الأموال
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
refund
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "refund",
ecommerce: {
currency: "USD",
transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
value: 30.03,
coupon: "SUMMER_FUN",
shipping: 3.33,
tax: 1.11,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});
remove_from_cart
يشير هذا الحدث إلى أنّه تمّت إزالة سلعة من سلّة التسوّق.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
remove_from_cart
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- قيمة التجارة الإلكترونية -
ecommerce.value
- عملة التجارة الإلكترونية -
ecommerce.currency
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbracevalue
- {{قيمة التجارة الإلكترونية&rbracecurrency
- {{عملة التجارة الإلكترونية}&rbrace- عامل التشغيل: الحدث يساوي remove_from_cart
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
remove_from_cart
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "remove_from_cart",
ecommerce: {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});
search
سجِّل هذا الحدث للإشارة إلى الوقت الذي أجرى فيه المستخدم عملية بحث. يمكنك استخدام هذا الحدث لتحديد ما يبحث عنه المستخدمون على موقعك الإلكتروني أو تطبيقك. على سبيل المثال، يمكنك إرسال هذا الحدث عندما يشاهد المستخدم صفحة نتائج بحث بعد إجراء عملية بحث.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
Yes | قمصان | العبارة التي تم البحث عنها. |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
search
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
search_term
- قمصان- يبدأ عندما يبحث أحد المستخدِمين في موقعك الإلكتروني.
select_content
يشير هذا الحدث إلى أنّ المستخدم قد اختار محتوى من نوع معيّن. ويمكن أن يساعدك هذا الحدث في تحديد المحتوى الرائج وفئات المحتوى على موقعك الإلكتروني أو تطبيقك.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
content_type |
string |
لا | product | نوع المحتوى المحدّد |
content_id |
string |
لا | C_12345 | معرّف المحتوى الذي تم اختياره |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
select_content
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
content_type
- المنتجcontent_id
- C_12345- عامل التشغيل: الحدث يساوي select_content
select_item
يشير هذا الحدث إلى أنّه تم اختيار عنصر من قائمة.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
items |
Array<Item> |
نعم* | عناصر الحدث * من المتوقّع أن تحتوي مصفوفة items على عنصر واحد
يمثّل العنصر المحدّد. إذا تم توفير عدة عناصر، سيتم استخدام العنصر الأول فقط في items .
|
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
select_item
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- رقم تعريف قائمة عناصر التجارة الإلكترونية -
ecommerce.item_list_id
- اسم قائمة عناصر التجارة الإلكترونية -
ecommerce.item_list_name
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbraceitem_list_id
- {{رقم تعريف قائمة عناصر التجارة الإلكترونية}item_list_name
- {{اسم قائمة عناصر التجارة الإلكترونية}rbrace- عامل التشغيل: الحدث يساوي select_item
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
select_item
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "select_item",
ecommerce: {
item_list_id: "related_products",
item_list_name: "Related products",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});
select_promotion
يشير هذا الحدث إلى أنّه تم اختيار عرض ترويجي من قائمة.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة بالفعالية يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
promotion_id |
string |
لا | P_12345 |
رقم تعريف العرض الترويجي المرتبط بالحدث. يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالحدث يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
items |
Array<Item>
|
لا | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- اسم تصميم إعلان التجارة الإلكترونية -
ecommerce.creative_name
- شريحة تصميم إعلان التجارة الإلكترونية -
ecommerce.creative_slot
- رقم تعريف العرض الترويجي في التجارة الإلكترونية -
ecommerce.promotion_id
- اسم العرض الترويجي للتجارة الإلكترونية -
ecommerce.promotion_name
- عناصر التجارة الإلكترونية -
ecommerce.items
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
creative_name
- {{اسم تصميم إعلان التجارة الإلكترونية}rbracecreative_slot
- {{شريحة تصميم إعلان التجارة الإلكترونية}promotion_id
- {{رقم تعريف العرض الترويجي في التجارة الإلكترونية&rbracepromotion_name
- {{اسم العرض الترويجي للتجارة الإلكترونية}rbraceitems
- {عناصر التجارة الإلكترونية&rbrace- نوع المتغيّر: متغيّر طبقة البيانات - 'ecommerce.items'
- عامل التشغيل: الحدث يساوي select_promotion
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
select_promotion
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "select_promotion",
ecommerce: {
creative_name: "Summer Banner",
creative_slot: "featured_app_1",
promotion_id: "P_12345",
promotion_name: "Summer Sale",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});
مشاركة
يمكنك استخدام هذا الحدث عندما يشارك المستخدم محتوى.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة التي تتم بها مشاركة المحتوى. | |
content_type |
string |
لا | صورة | نوع المحتوى الذي تمّت مشاركته |
item_id |
string |
لا | C_12345 | رقم تعريف المحتوى الذي تمت مشاركته. |
مثال
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
share
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
method
- Twittercontent_type
- صورةitem_id
- C_12345- يبدأ عند مشاركة المستخدم لمحتوى
sign_up
يشير هذا الحدث إلى أنّ مستخدمًا اشترك في حساب. يمكنك استخدام هذا الحدث لفهم السلوكيات المختلفة للمستخدمين الذين سجّلوا الدخول أو الخروج.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدَمة للاشتراك. |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
sign_up
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
method
- Google- يبدأ عند اشتراك أحد المستخدمين في حساب
spend_virtual_currency
يقيس هذا الحدث بيع السلع الافتراضية في تطبيقك ويساعدك في تحديد أي السلع الافتراضية هي الأكثر شعبية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
value |
number |
Yes | 5 | قيمة العملة الافتراضية. |
virtual_currency_name |
string |
Yes | قائمة Gems | اسم العملة الافتراضية. |
item_name |
string |
لا | تعزيز المبتدئين | اسم العنصر الذي تُستخدم العملة الافتراضية له. |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
spend_virtual_currency
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
value
- 5virtual_currency_name
- جواهرitem_name
- تعزيز المبتدئين- التشغيل عندما يشتري أحد الأشخاص سلعة افتراضية
tutorial_begin
ويشير هذا الحدث إلى بداية عملية الإعداد. يمكنك استخدام هذا المقياس في مسار الإحالة الناجحة باستخدام tutorial_complete لمعرفة عدد المستخدمين الذين أكملوا البرنامج التعليمي.
المَعلمات
ما مِن معلَمات لهذا الحدث.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
tutorial_begin
- يبدأ عندما يبدأ أحد الأشخاص عملية الإعداد.
tutorial_complete
ويشير هذا الحدث إلى اكتمال المستخدم لعملية الإعداد. يمكنك استخدام هذا الإجراء في مسار الإحالة الناجحة باستخدام tutorial_begin لمعرفة عدد المستخدمين الذين أكملوا البرنامج التعليمي.
المَعلمات
لم يتم اقتراح أي مَعلمات لهذا الحدث.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
tutorial_complete
- يبدأ عندما يُكمل أحد الأشخاص عملية الإعداد.
unlock_achievement
سجِّل هذا الحدث عندما يفتح المستخدم إنجازًا. ويمكن أن يساعدك هذا الحدث في فهم تجربة المستخدمين للعبتك.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
achievement_id |
string |
Yes | A_12345 | رقم تعريف الإنجاز الذي تم فتحه. |
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
unlock_achievement
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
achievement_id
- A_12345- يبدأ عندما يفتح المستخدم إنجازًا.
view_cart
يشير هذا الحدث إلى أنّ أحد المستخدمين اطّلع على سلة التسوّق.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
view_cart
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- قيمة التجارة الإلكترونية -
ecommerce.value
- عملة التجارة الإلكترونية -
ecommerce.currency
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbracevalue
- {{قيمة التجارة الإلكترونية&rbracecurrency
- {{عملة التجارة الإلكترونية}&rbrace- عامل التشغيل: الحدث يساوي view_cart
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
view_cart
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "view_cart",
ecommerce: {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});
view_item
يشير هذا الحدث إلى أنّه تم عرض بعض المحتوى للمستخدم. يمكنك استخدام هذا الحدث لمعرفة المنتجات الأكثر رواجًا التي تمت مشاهدتها.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
view_item
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- قيمة التجارة الإلكترونية -
ecommerce.value
- عملة التجارة الإلكترونية -
ecommerce.currency
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbracevalue
- {{قيمة التجارة الإلكترونية&rbracecurrency
- {{عملة التجارة الإلكترونية}&rbrace- عامل التشغيل: الحدث يساوي view_item
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
view_item
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "view_item",
ecommerce: {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});
view_item_list
سجِّل هذا الحدث عندما يتم عرض قائمة بالعناصر من فئة معيّنة للمستخدم.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
view_item_list
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- عناصر التجارة الإلكترونية -
ecommerce.items
- رقم تعريف قائمة عناصر التجارة الإلكترونية -
ecommerce.item_list_id
- اسم قائمة عناصر التجارة الإلكترونية -
ecommerce.item_list_name
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
items
- {عناصر التجارة الإلكترونية&rbraceitem_list_id
- {{رقم تعريف قائمة عناصر التجارة الإلكترونية}item_list_name
- {{اسم قائمة عناصر التجارة الإلكترونية}rbrace- عامل التشغيل: الحدث يساوي view_item_list
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
view_item_list
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "view_item_list",
ecommerce: {
item_list_id: "related_products",
item_list_name: "Related products",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.03,
quantity: 3
},
{
item_id: "SKU_12346",
item_name: "Google Grey Women's Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 3.33,
index: 1,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "gray",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 21.01,
promotion_id: "P_12345",
promotion_name: "Summer Sale",
quantity: 2
}]
}
});
view_promotion
يشير هذا الحدث إلى أنّه تم الاطّلاع على عرض ترويجي من قائمة.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة بالفعالية يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
promotion_id |
string |
لا | P_12345 |
رقم تعريف العرض الترويجي المرتبط بالحدث. يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالحدث يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
items |
Array<Item> |
نعم* | عناصر الحدث * يجب أن تحتوي مصفوفة items على عنصر
واحد يمثّل السلعة المرتبطة بالعرض الترويجي. إذا تم توفير عدة عناصر، سيتم استخدام العنصر الأول فقط في items .
|
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب توفير سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب توفير سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة المورّدة أو الموقع الجغرافي للمتجر. ملاحظة: لا يتوفّر "الارتباط" إلا على مستوى العنصر. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
creative_name |
string |
لا | summer_banner2 | اسم تصميم الإعلان الترويجي في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفّرها. |
creative_slot |
string |
لا | featured_app_1 | اسم خانة تصميم الإعلان الترويجي المرتبطة
بالعنصر. في حال ضبط السياسة، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، في حال توفّرها. |
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة إذا تم استخدامها كجزء من تسلسل هرمي أو تصنيف للفئات، ستكون هذه الفئة هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التسلسل الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التسلسل الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التسلسل الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التسلسل الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_id على مستوى الحدث، في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبط السياسة، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان على Google لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة بوحدات معيّنة من معلَمة العملة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في مَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة في حال ضبط السياسة، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، في حال توفّرها.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
يوضّح المثال التالي عمليات تنفيذ أداة "إدارة العلامات من Google":
الاطّلاع على إعدادات العلامة
إعدادات العلامة:
- نوع العلامة: حدث "إحصاءات Google 4"
- اسم الحدث:
view_promotion
- متغيرات طبقة البيانات (الاسم - اسم متغير طبقة البيانات):
- اسم تصميم إعلان التجارة الإلكترونية -
ecommerce.creative_name
- شريحة تصميم إعلان التجارة الإلكترونية -
ecommerce.creative_slot
- رقم تعريف العرض الترويجي في التجارة الإلكترونية -
ecommerce.promotion_id
- اسم العرض الترويجي للتجارة الإلكترونية -
ecommerce.promotion_name
- عناصر التجارة الإلكترونية -
ecommerce.items
- مَعلمات الأحداث (اسم المَعلمة - القيمة):
creative_name
- {{اسم تصميم إعلان التجارة الإلكترونية}rbracecreative_slot
- {{شريحة تصميم إعلان التجارة الإلكترونية}promotion_id
- {{رقم تعريف العرض الترويجي في التجارة الإلكترونية&rbracepromotion_name
- {{اسم العرض الترويجي للتجارة الإلكترونية}rbraceitems
- {عناصر التجارة الإلكترونية&rbrace- عامل التشغيل: الحدث يساوي view_promotion
ضبط المشغِّل:
- نوع العامل المشغِّل: حدث مخصّص
- اسم الحدث:
view_promotion
- يتم تنشيط هذا المشغِّل على: جميع الأحداث المخصّصة.
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "view_promotion",
ecommerce: {
creative_name: "Summer Banner",
creative_slot: "featured_app_1",
promotion_id: "P_12345",
promotion_name: "Summer Sale",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
}
});