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

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

علامة Google إدارة العلامات Firebase

add_payment_info

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

المعلمات

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

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

add_shipping_info

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

المعلمات

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
currency	string	نعم*	USD	عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value، ستكون currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value	number	نعم*	30.03	القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في items. لا تضمِّن shipping أو tax. * تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كإحالة ناجحة، ننصحك بضبط value. * مطلوبة currency في حال ضبط value.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
shipping_tier	string	لا	شحن بري	فئة الشحن (مثل Ground أو Air أو Next-day) التي تم اختيارها لتسليم السلعة المشتراة.
items	Array<Item>	Yes		عناصر الحدث.

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

add_to_cart

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

المعلمات

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

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

add_to_wishlist

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

المعلمات

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

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

begin_checkout

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

المعلمات

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

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

close_convert_lead

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

المعلمات

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

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

close_unconvert_lead

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

المعلمات

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

مثال

disqualify_lead

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

المعلمات

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

مثال

earn_virtual_currency

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

المعلمات

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

مثال

generate_lead

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

المعلمات

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

مثال

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	الشخصية التي ارتقت إلى مستوى أعلى.

مثال

تسجيل دخول

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

المعلمات

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

مثال

post_score

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

المعلمات

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

مثال

purchase

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

المعلمات

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
currency	string	نعم*	USD	عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value، ستكون currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value	number	نعم*	30.03	القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في items. لا تضمِّن shipping أو tax. * تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كإحالة ناجحة، ننصحك بضبط value. * مطلوبة currency في حال ضبط value.
transaction_id	string	Yes	T_12345	المعرّف الفريد للمعاملة. تساعدك المَعلمة transaction_id في تجنُّب الحصول على أحداث مكرّرة لعملية شراء.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
shipping	number	لا	3.33	تكلفة الشحن المرتبطة بمعاملة معيّنة
tax	number	لا	1.11	تكلفة الضريبة المرتبطة بمعاملة معيّنة.
items	Array<Item>	Yes		عناصر الحدث.

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

qualify_lead

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

المعلمات

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

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

refund

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

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

المعلمات

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
currency	string	نعم*	USD	عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value، ستكون currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
transaction_id	string	Yes	T_12345	المعرّف الفريد للمعاملة.
value	number	نعم*	30.03	القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في items. لا تضمِّن shipping أو tax. * تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كإحالة ناجحة، ننصحك بضبط value. * مطلوبة currency في حال ضبط value.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
shipping	number	لا	3.33	تكلفة الشحن المرتبطة بمعاملة معيّنة
tax	number	لا	1.11	تكلفة الضريبة المرتبطة بمعاملة معيّنة.
items	Array<Item>	لا*		عناصر الحدث.

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

remove_from_cart

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

المعلمات

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

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

search

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

المعلمات

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

مثال

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

مثال

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

مثال

مشاركة

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

المعلمات

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

مثال

sign_up

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

المعلمات

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

مثال

spend_virtual_currency

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

المعلمات

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

مثال

tutorial_begin

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

المعلمات

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

مثال

tutorial_complete

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

المعلمات

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

مثال

unlock_achievement

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

المعلمات

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

مثال

view_cart

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

المعلمات

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

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

view_item

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

المعلمات

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

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
quantity	number	لا	3	كمية السلعة وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة quantity على 1.

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

مثال

view_item_list

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

المعلمات

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_list_id	string	لا	related_products	رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر.
item_list_name	string	لا	منتجات ذات صلة	اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر.
items	Array<Item>	Yes		عناصر الحدث.

مَعلمات العناصر

الاسم	النوع	مطلوبة	مثال على القيمة	الوصف
item_id	string	نعم*	SKU_12345	معرّف السلعة. *يجب تحديد إما item_id أو item_name.
item_name	string	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب تحديد إما item_id أو item_name.
affiliation	string	لا	Google Store	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon	string	لا	SUMMER_FUN	اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name	string	لا	summer_banner2	اسم تصميم الإعلان الترويجي في حال ضبط هذه السياسة، يتم تجاهل السمة creative_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إن توفّرت.
creative_slot	string	لا	featured_app_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالعنصر. في حال ضبط هذه السياسة، يتم تجاهل السمة creative_slot على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إن توفّرت.
discount	number	لا	2.22	قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index	number	لا	5	تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand	string	لا	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.
promotion_id	string	لا	P_12345	معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_id على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إن توفّرت.
promotion_name	string	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالسلعة. في حال ضبط هذه السياسة، يتم تجاهل السمة promotion_name على مستوى الحدث. في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إن توفّرت.
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	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 الذي يتوافق مع العنصر المرتبط. ويمكن أيضًا استخدام معرّف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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	نعم*	USD	عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value، ستكون currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value	number	نعم*	30.03	القيمة النقدية للحدث. * اضبط value على مجموع (price * quantity) لكل العناصر في items. لا تضمِّن shipping أو tax. * تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كإحالة ناجحة، ننصحك بضبط value. * مطلوبة currency في حال ضبط value.
lead_status	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	ارتباط المنتج لتحديد الشركة التي يتم تقديمها أو الموقع الجغرافي للمتجر ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 الذي يتوافق مع العنصر المرتبط. ويمكن أيضًا استخدام معرّف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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.

مثال