مرجع الحدث

يسرد هذا المرجع الأحداث المقترَحة المتوافقة مع علامات Google.

الترجمة: معطلة

add_payment_info

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

المعلمات

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

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

add_shipping_info

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

المعلمات

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

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

add_to_cart

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

المعلمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
currency	string	نعم*	الدولار الأمريكي	تمثّل هذه السمة عملة السلع المرتبطة بالحدث بتنسيق 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 على مستوى الحدث وعلى مستوى العنصر مستقلّة.
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_wishlist

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

المعلمات

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

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

begin_checkout

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

المعلمات

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

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

close_convert_lead

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

المعلمات

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

close_unconvert_lead

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

المعلمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
currency	string	نعم*	الدولار الأمريكي	عملة value للحدث، بعملة 3 أحرف ISO 4217 * في حال ضبط 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	لا	مجموعات تعليمات Gem	اسم العملة الافتراضية.
value	number	لا	5	قيمة العملة الافتراضية.

exception

يتم تسجيل حدث استثناء عند انقطاع التدفق الطبيعي لتنفيذ أحد التطبيقات.

المعلمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
description	string	لا	يجب إدخال الحقل المطلوب.	وصف الاستثناء الذي حدث.
fatal	boolean	لا	true	ما إذا كان الاستثناء فادحًا أم لا

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	الطريقة المستخدمة لتسجيل الدخول.

page_view

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

المعلمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
page_location	string	لا	https://example.com	تمثّل هذه السمة عنوان URL للصفحة.
client_id	string	لا	ABC_123	معرِّف العميل.
language	string	لا	ar_sa	لغة العميل. اطّلِع على علامات اللغات ورموزها.
page_encoding	string	لا	UTF-8	ترميز الصفحة.
page_title	string	لا	الصفحة الرئيسية	تمثّل هذه السمة عنوان الصفحة.
user_agent	string	لا		وكيل مستخدم العميل

post_score

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

المعلمات

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

purchase

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

المعلمات

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

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

remove_from_cart

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

المعلمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
currency	string	نعم*	الدولار الأمريكي	عملة السلع المرتبطة بالحدث، بعملة 3 أحرف ISO 4217 * في حال ضبط 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 على مستوى الحدث وعلى مستوى العنصر مستقلّة.
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 لمدينة سان فرانسيسكو)	الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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	ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو)	الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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	ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو)	الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر الحقل 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	نعم	مجموعات تعليمات Gem	اسم العملة الافتراضية.
item_name	string	لا	ميزة "التحسين المبدئي"	اسم السلعة التي يتم استخدام العملة الافتراضية فيها

tutorial_begin

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

المعلمات

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

tutorial_complete

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

المعلمات

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

unlock_achievement

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

المعلمات

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

view_cart

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

المعلمات

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

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

view_item

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

المعلمات

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

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

view_item_list

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

المعلمات

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

تسجيل هذا الحدث عندما يتم عرض نتائج البحث للمستخدم تجدر الإشارة إلى أنّه يمكنك تفعيل حدث view_search_results لجمع البيانات تلقائيًا من خلال القياس المحسّن للأحداث في "إحصاءات Google".

المعلمات

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

ملاحظة: يُرسِل الحدث view_search_results المَعلمة unique_search_term بالقيمة 1 إذا كانت عبارة البحث فريدة في الجلسة الحالية. وإذا سبق إرسال عبارة البحث في الجلسة الحالية، تكون قيمة المَعلمة 0.

working_lead

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

المعلمات

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