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

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

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

gtag.js إدارة العلامات من Google Firebase

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 إلا على مستوى السلعة.
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 المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
price	number	لا	10.01	سعر الوحدة النقدية للسلعة، بوحدات مَعلمة العملة المحدّدة إذا كان هناك خصم على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity	number	لا	3	كمية السلعة في حال عدم ضبط القيمة، يتم ضبط quantity على 1.

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

مثال

close_convert_lead

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

المعلمات

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

مثال

close_unconvert_lead

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

المعلمات

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

مثال

disqualify_lead

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

المعلمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
currency	string	نعم*	دولار أمريكي	تمثّل هذه السمة عملة value للفعالية، بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط 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 المكوّن من 3 أحرف. * في حال ضبط 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 إلا على مستوى السلعة.
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 المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى السلعة.
price	number	لا	10.01	سعر الوحدة النقدية للسلعة، بوحدات مَعلمة العملة المحدّدة إذا كان هناك خصم على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity	number	لا	3	كمية السلعة في حال عدم ضبط القيمة، يتم ضبط quantity على 1.

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

مثال

qualify_lead

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

المعلمات

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

مثال

refund

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

ملاحظة: ننصحك بتضمين معلومات السلعة في حدث refund لاطلاع على مقاييس ردّ الأموال على مستوى السلعة في "إحصاءات Google".

المعلمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
price	number	لا	10.01	سعر الوحدة النقدية للسلعة، بوحدات مَعلمة العملة المحدّدة إذا كان هناك خصم على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity	number	لا	3	كمية السلعة في حال عدم ضبط القيمة، يتم ضبط quantity على 1.

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

مثال

search

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

المعلمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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	لا	ميزة "التحسين المبدئي"	اسم السلعة التي يتم استخدام العملة الافتراضية فيها.

مثال

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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 المكوّن من 3 أحرف. * في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value	number	نعم*	30.03	القيمة المالية للحدث. * تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. إذا وضعت علامة على الحدث باعتباره حدثًا رئيسيًا، ننصحك بضبط value. * يجب ضبط currency إذا ضبطت value.
lead_status	string	لا	المحادثات التي بدأتها	حالة العميل المحتمل

مثال