مرجع الحدث

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

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.

earn_virtual_currency

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

المَعلمات

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

الاستثناء

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

المَعلمات

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

generate_lead

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

المَعلمات

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

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

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

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

page_view

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

المَعلمات

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

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.

refund

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

المَعلمات

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

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

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

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

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

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

معرّف العنصر.

*يجب توفير سمة واحدة من item_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_term string Yes قمصان العبارة التي تم البحث عنها.

select_content

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

المَعلمات

الاسم النوع مطلوبة مثال على القيمة الوصف
content_type string لا product نوع المحتوى المحدّد
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 قائمة Gems اسم العملة الافتراضية.
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.

view_search_results

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

المَعلمات

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