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

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

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

add_payment_info

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

المعلمات

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

add_shipping_info

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

المعلمات

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل موقع المتجر الجغرافي). ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

add_to_cart

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

المعلمات

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

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

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

add_to_wishlist

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

المعلمات

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

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

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

begin_checkout

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

المعلمات

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصح باستخدام رقم تعريف المكان على Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

close_convert_lead

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

المعلمات

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

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

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

مثال

close_unconvert_lead

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

المعلمات

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

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

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

مثال

disqualify_lead

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

المعلمات

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

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

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

مثال

earn_virtual_currency

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

المعلمات

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

مثال

generate_lead

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

المعلمات

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

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

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

مثال

join_group

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

المعلمات

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

مثال

level_end

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

المعلمات

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

مثال

level_start

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

المعلمات

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

مثال

level_up

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

المعلمات

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

مثال

login

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

المعلمات

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

مثال

post_score

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

المعلمات

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

مثال

purchase

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

المعلمات

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

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

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

تساعدك المَعلمة transaction_id في تجنّب الحصول على أحداث مكرّرة لعملية شراء.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالحدث.

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. ويمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

qualify_lead

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

المعلمات

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

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

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

مثال

refund

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

المعلمات

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

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

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

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

remove_from_cart

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

المعلمات

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

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

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

select_promotion

يشير هذا الحدث إلى اختيار عرض ترويجي من قائمة.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
creative_name string لا summer_banner2 اسم تصميم الإعلان الترويجي

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

يتم تجاهله إذا تم ضبطه على مستوى السلعة.
promotion_id string لا P_12345 رقم تعريف العرض الترويجي المرتبط بالحدث.

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

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل موقع المتجر الجغرافي). ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالسلعة

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

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

كمية السلعة

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

مثال

share

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

المعلمات

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

مثال

sign_up

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

المعلمات

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

مثال

spend_virtual_currency

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
value number نعم 5 قيمة العملة الافتراضية.
virtual_currency_name string نعم Gems اسم العملة الافتراضية.
item_name string لا ميزة "التحسين المبدئي" اسم السلعة التي يتم استخدام العملة الافتراضية فيها.

مثال

tutorial_begin

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

المعلمات

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

مثال

tutorial_complete

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

المعلمات

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

مثال

unlock_achievement

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

المعلمات

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

مثال

view_cart

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

المعلمات

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

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

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

view_item

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

المعلمات

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

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

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

view_item_list

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

المعلمات

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

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

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
quantity number لا 3

كمية السلعة

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

مثال

view_promotion

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
creative_name string لا summer_banner2 اسم تصميم الإعلان الترويجي

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

يتم تجاهله إذا تم ضبطه على مستوى السلعة.
promotion_id string لا P_12345 رقم تعريف العرض الترويجي المرتبط بالحدث.

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

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

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

مَعلمات السلع

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

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

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

اسم السلعة.

*يجب استخدام إحدى السمتَين item_id أو item_name.

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

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

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

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

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

في حال ضبطه، يتم تجاهل item_list_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة item_list_name على مستوى الحدث، إن توفّرت.
item_variant string لا أخضر صيغة السلعة أو الرمز الفريد أو الوصف لمزيد من التفاصيل/خيارات السلعة.
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف مكان Google لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل موقع المتجر الجغرافي). ننصحك باستخدام معرّف مكان في Google المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر الحقل location id إلا على مستوى السلعة.
price number لا 10.01 سعر الوحدة النقدية للسلعة، بوحدات المَعلمة currency المحدّدة
إذا كان هناك خصم ينطبق على السلعة، يجب ضبط price على سعر الوحدة المخفّض وتحديد الخصم على سعر الوحدة في مَعلمة discount.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالسلعة

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

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

كمية السلعة

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

مثال

working_lead

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

المعلمات

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

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

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

مثال