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

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

add_payment_info

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

المعلمات

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

وفي حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إذا حاليًا.
promotion_name string لا تخفيضات موسم الصيف اسم العرض الترويجي المرتبط بالسلعة.

وفي حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إذا حاليًا.
quantity number لا 3

كمية السلعة

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

مثال

close_convert_lead

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

المعلمات

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

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

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

مثال

close_unconvert_lead

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

المعلمات

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

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

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

مثال

disqualify_lead

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

المعلمات

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

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

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

مثال

earn_virtual_currency

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

المعلمات

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

مثال

generate_lead

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

المعلمات

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

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

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

مثال

join_group

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

المعلمات

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

مثال

level_end

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

المعلمات

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

مثال

level_start

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

المعلمات

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

مثال

level_up

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

المعلمات

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

مثال

تسجيل دخول

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

المعلمات

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

مثال

post_score

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

المعلمات

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

مثال

purchase

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

المعلمات

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

وفي حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إذا حاليًا.
promotion_name string لا تخفيضات موسم الصيف اسم العرض الترويجي المرتبط بالسلعة.

وفي حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إذا حاليًا.
quantity number لا 3

كمية السلعة

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

مثال

qualify_lead

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

المعلمات

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

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

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

مثال

refund

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

المعلمات

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

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

مثال

select_content

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

المعلمات

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

مثال

select_item

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

المعلمات

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

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

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

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

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

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

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

*يجب تحديد إما item_id أو item_name.

item_name string نعم* قميص مُزيَّن بشخصيات كتاب Stan and Friends

اسم السلعة.

*يجب تحديد إما item_id أو item_name.

affiliation string لا Google Store ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

يمكن اعتبار معلمات coupon على مستوى الحدث وعلى مستوى العنصر مستقلّة.
creative_name string لا summer_banner2 اسم تصميم الإعلان الترويجي

وفي حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، إذا حاليًا.
creative_slot string لا featured_app_1 اسم خانة تصميم الإعلان الترويجي المرتبط عنصر واحد.

وفي حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال ترك السياسة بدون ضبط، يتم استخدام السمة creative_slot على مستوى الحدث، إذا حاليًا.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس العنصر أو موضعه في القائمة.
item_brand string لا Google العلامة التجارية للسلعة.
item_category string لا ملابس فئة السلعة. إذا تم استخدامه كجزء من تسلسل هرمي للفئات أو فالتصنيف حينئذٍ ستكون هذه هي الفئة الأولى.
item_category2 string لا للبالغين التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر.
item_category3 string لا قمصان التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر.
item_category4 string لا طاقم العمل التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر.
item_category5 string لا أكمام قصيرة التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر.
item_list_id string لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

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

وفي حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إذا حاليًا.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لسلعة إضافية التفاصيل/الخيارات.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 نعم 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 نعم* USD عملة السلع المرتبطة بالحدث، بعملة 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 على مستوى الحدث وعلى مستوى العنصر مستقلّة.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 عملة السلع المرتبطة بالحدث، بعملة 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 على مستوى الحدث وعلى مستوى العنصر مستقلّة.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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> نعم عناصر الحدث.

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

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

وفي حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال ترك السياسة بدون ضبط، يتم استخدام السمة promotion_id على مستوى الحدث، إذا حاليًا.
promotion_name string لا تخفيضات موسم الصيف اسم العرض الترويجي المرتبط بالسلعة.

وفي حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال ترك السياسة بدون ضبط، يتم استخدام السمة promotion_name على مستوى الحدث، إذا حاليًا.
quantity number لا 3

كمية السلعة

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

مثال

working_lead

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

المعلمات

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

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

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

مثال