الأحداث المقترحة

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

للاطّلاع على تفاصيل كل حدث يمكنك استخدامه، اختَر منصة إدارة العلامات:

add_payment_info

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط 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> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

add_shipping_info

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط 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> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

add_to_cart

يشير هذا الحدث إلى أنّه تمّت إضافة سلعة إلى سلة التسوّق لشرائها.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

add_to_wishlist

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

begin_checkout

يشير هذا الحدث إلى أنّ المستخدم قد بدأ عملية دفع.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالحدث.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

close_convert_lead

يقيس هذا الحدث عندما يتم تحويل عميل محتمل وإغلاقه (على سبيل المثال، من خلال عملية شراء).

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.

مثال

close_unconvert_lead

يقيس هذا الحدث عندما يتمّ تصنيف مستخدم على أنّه ليس عميلاً محتملاً تمّت إحالته بنجاح، بالإضافة إلى السبب.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
unconvert_lead_reason string لا لم يتم الردّ مطلقًا سبب عدم تحويل العميل المحتمل إلى عميل

مثال

disqualify_lead

يقيس هذا الحدث عندما يتم تصنيف مستخدم على أنّه غير مؤهَّل ليصبح عميلاً محتملاً، بالإضافة إلى سبب عدم الأهلية.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
disqualified_lead_reason string لا لا أريد شراء أي منتج سبب وضع علامة على العميل المحتمل تفيد بأنّه غير مؤهَّل.

مثال

earn_virtual_currency

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
virtual_currency_name string لا Gems اسم العملة الافتراضية.
value number لا 5 قيمة العملة الافتراضية.

مثال

generate_lead

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
lead_source string لا المعرض التجاري تمثّل هذه السمة مصدر العميل المحتمل.

مثال

join_group

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
group_id string لا G_12345 رقم تعريف المجموعة.

مثال

level_end

تشير هذه الفعالية إلى أنّ أحد اللاعبين قد وصل إلى نهاية مستوى في إحدى الألعاب.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
level_name string لا تبدأ الرحلة... تمثّل هذه السمة اسم المستوى.
success boolean لا صحيح يجب ضبط القيمة على true إذا تم إكمال المستوى بنجاح.

مثال

level_start

يشير هذا الحدث إلى أنّ أحد اللاعبين قد بدأ مستوى في إحدى الألعاب.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
level_name string لا تبدأ الرحلة... تمثّل هذه السمة اسم المستوى.

مثال

level_up

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
level number لا 5 مستوى الشخصية
character string لا اللاعب 1 تمثّل هذه السمة الشخصية التي انتقلت إلى مستوى أعلى.

مثال

login

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
method string لا Google الطريقة المستخدَمة لتسجيل الدخول.

مثال

post_score

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
score number نعم 10000 النتيجة المطلوب نشرها.
level number لا 5 مستوى النتيجة
character string لا اللاعب 1 الحرف الذي حقّق النتيجة.

مثال

purchase

يشير هذا الحدث إلى وقت شراء مستخدم لسلعة واحدة أو أكثر.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
transaction_id string نعم T_12345 المعرّف الفريد للمعاملة

تساعدك المَعلمة transaction_id في تجنّب الحصول على أحداث مكرّرة لعملية شراء.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالحدث.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
shipping number لا 3.33 تكلفة الشحن المرتبطة بمعاملة معيّنة.
tax number لا 1.11 تكلفة الضريبة المرتبطة بمعاملة معيّنة.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

qualify_lead

يقيس هذا الحدث عندما يتم وضع علامة على مستخدم تفيد بأنّه يستوفي معايير التأهّل ليصبح عميلاً محتملاً مؤهّلاً.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.

مثال

refund

يشير هذا الحدث إلى ردّ أموال سلعة واحدة أو أكثر إلى المستخدم.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
transaction_id string نعم 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_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

remove_from_cart

يشير هذا الحدث إلى أنّه تمت إزالة سلعة من سلة التسوّق.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
search_term string نعم قمصان العبارة التي تم البحث عنها.

مثال

select_content

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
content_type string لا المنتج نوع المحتوى المحدّد
content_id string لا C_12345 معرّف للمحتوى الذي تمّ اختياره.

مثال

select_item

يشير هذا الحدث إلى أنّه تم اختيار سلعة من قائمة.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
item_list_id string لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

يتم تجاهله في حال ضبطه على مستوى السلعة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

يتم تجاهله في حال ضبطه على مستوى السلعة.
items Array<Item> نعم* تمثّل هذه السمة السلع الخاصة بالحدث.

* من المتوقّع أن تحتوي مصفوفة items على عنصر واحد يمثّل السلعة المحدّدة. إذا تم تقديم عناصر متعددة، سيتم استخدام العنصر الأول فقط في items.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

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_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
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 لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
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

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

share

استخدِم هذا الحدث عندما يشارك أحد المستخدمين محتوًى.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
method string لا Twitter الطريقة التي تتم بها مشاركة المحتوى
content_type string لا الصورة نوع المحتوى الذي تتم مشاركته
item_id string لا C_12345 معرّف المحتوى المشترَك

مثال

sign_up

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
method string لا Google الطريقة المستخدَمة للاشتراك

مثال

spend_virtual_currency

يقيس هذا الحدث مبيعات السلع الافتراضية في تطبيقك ويساعدك في تحديد السلع الافتراضية الأكثر شيوعًا.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
value number نعم 5 قيمة العملة الافتراضية.
virtual_currency_name string نعم Gems اسم العملة الافتراضية.
item_name string لا Starter Boost اسم العنصر الذي يتم استخدام العملة الافتراضية فيه

مثال

tutorial_begin

يشير هذا الحدث إلى بداية عملية الإعداد. استخدِم هذا الحدث في مسار إحالة ناجحة مع الحدث tutorial_complete لمعرفة عدد المستخدمين الذين يكملون الدليل التعليمي.

المعلمات

ما مِن مَعلمات لهذا الحدث.

مثال

tutorial_complete

يشير هذا الحدث إلى إكمال المستخدم لعملية الإعداد. استخدِم هذا الحدث في مسار إحالة ناجحة مع الحدث tutorial_begin لمعرفة عدد المستخدمين الذين يكملون البرنامج التعليمي.

المعلمات

لا يتم اقتراح أيّ مَعلمات لهذا الحدث.

مثال

unlock_achievement

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
achievement_id string نعم A_12345 رقم تعريف الإنجاز الذي تم فتحه.

مثال

view_cart

يشير هذا الحدث إلى أنّ أحد المستخدمين اطّلع على سلة التسوّق.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

view_item

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

view_item_list

سجِّل هذا الحدث عندما يتم عرض قائمة بعناصر من فئة معيّنة للمستخدم.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
item_list_id string لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

يتم تجاهله في حال ضبطه على مستوى السلعة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

يتم تجاهله في حال ضبطه على مستوى السلعة.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

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_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
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 لا Google العلامة التجارية للسلعة
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 الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
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

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

working_lead

يقيس هذا الحدث عندما يتواصل المستخدم مع أحد الممثلين أو يتواصل ممثل معه.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
lead_status string لا المحادثات التي بدأتها حالة العميل المحتمل

مثال