أصبحت علامة الموقع الشاملة (gtag.js) الآن علامة Google. مزيد من المعلومات

مرجع الحدث

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

add_payment_info

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

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
value number نعم* 7,77 القيمة النقدية للحدث.

* عادةً ما يكون 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 نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

add_shipping_info

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

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
value number نعم* 7,77 القيمة النقدية للحدث.

* عادةً ما يكون 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 نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

add_to_cart

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

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
value number نعم* 7,77 القيمة النقدية للحدث.

* عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد value.
* currency مطلوب في حالة تعيين value.
items Array<Item> نعم عناصر الحدث.

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

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

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

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

item_name string نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

add_to_wishlist

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

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
value number نعم* 7,77 القيمة النقدية للحدث.

* عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد value.
* currency مطلوب في حالة تعيين value.
items Array<Item> نعم عناصر الحدث.

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

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

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

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

item_name string نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

begin_checkout

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

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
value number نعم* 7,77 القيمة النقدية للحدث.

* عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد value.
* currency مطلوب في حالة تعيين value.
coupon string لا الدالة SUMMER_FUN اسم/رمز القسيمة المرتبط بالحدث.
المعلّمات
على مستوى الحدث والسلع على مستوى العنصر coupon مستقلة.
items Array<Item> نعم عناصر الحدث.

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

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

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

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

item_name string نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

earn_virtual_currency

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

المعلَمات

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

الاستثناء

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

المعلَمات

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

generate_lead

سجّل هذا الحدث عند اكتساب عميل محتمل لاستيعاب مدى فاعلية حملات إعادة الجذب.

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
value number نعم* 7,77 القيمة النقدية للحدث.

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

join_group

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

المعلَمات

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

level_end

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

المعلَمات

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

level_start

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

المعلَمات

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

level_up

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

المعلَمات

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

login

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

المعلَمات

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

page_view

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

المعلَمات

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

post_score

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

المعلَمات

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

purchase

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

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
transaction_id string نعم T_12345 المعرّف الفريد للمعاملة.

تساعدك المعلَمة transaction_id على تجنُّب الحصول على أحداث مكرّرة لعملية شراء.
value number نعم* 12.21 القيمة النقدية للحدث.

* يجب توفّر السمة 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 نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

refund

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

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
transaction_id string نعم T_12345 المعرّف الفريد للمعاملة.
value number نعم* 7,77 القيمة النقدية للحدث.

* عادةً ما يكون 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 نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

remove_from_cart

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

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
value number نعم* 7,77 القيمة النقدية للحدث.

* عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد value.
* currency مطلوب في حالة تعيين value.
items Array<Item> نعم عناصر الحدث.

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

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

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

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

item_name string نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

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

المعلَمات

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

select_content

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

المعلَمات

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

select_item

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

المعلَمات

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

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

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

* من المتوقّع أن تحتوي المصفوفة items على عنصر واحد يمثّل العنصر المحدّد. وفي حال تقديم عناصر متعددة، لن يتم استخدام سوى العنصر الأول في items.

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

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

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

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

item_name string نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

select_promotion

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

المعلَمات

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

يتم تجاهلها في حال ضبطها على مستوى السلعة.
creative_slot string لا التطبيق_المميز_1 اسم خانة تصميم الإعلان الترويجي المرتبطة بالفعالية.

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

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

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

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

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

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

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

item_name string نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

مشاركة

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

المعلَمات

الاسم النوع مطلوب مثال على القيمة الوصف
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 نعم أحجار كريمة اسم العملة الافتراضية.
item_name string لا التحسين للمبتدئين اسم العنصر الذي يتم استخدام العملة الافتراضية له.

tutorial_begin

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

المعلَمات

لا توجد معلمات لهذا الحدث.

tutorial_complete

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

المعلَمات

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

unlock_achievement

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

المعلَمات

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

view_cart

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

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
value number نعم* 7,77 القيمة النقدية للحدث.

* عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد value.
* currency مطلوب في حالة تعيين value.
items Array<Item> نعم عناصر الحدث.

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

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

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

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

item_name string نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

view_item

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

المعلَمات

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

* إذا ضبطت السمة value، عليك استخدام السمة currency لاحتساب إحصاءات الأرباح بدقة.
value number نعم* 7,77 القيمة النقدية للحدث.

* عادةً ما يكون value مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد value.
* currency مطلوب في حالة تعيين value.
items Array<Item> نعم عناصر الحدث.

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

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

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

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

item_name string نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

view_item_list

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

المعلَمات

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

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

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

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

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

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

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

item_name string نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

view_promotion

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

المعلَمات

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

يتم تجاهلها في حال ضبطها على مستوى السلعة.
creative_slot string لا التطبيق_المميز_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 نعم* تي شيرت لأصدقائها وأصدقائها

اسم السلعة.

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

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

في حال ضبط السياسة، يتم تجاهل creative_name على مستوى الحدث.
في حال ترك هذه السياسة بدون ضبط، يتم استخدام السمة creative_name على مستوى الحدث، في حال توفرها.
creative_slot string لا التطبيق_المميز_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 لا منتجات ذات صلة رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبط السياسة، يتم تجاهل 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 لا يورو السعر النقدي للعنصر، بوحدات معلمة العملة المحدّدة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالعنصر.

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

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

كمية السلعة.

إذا لم يتم ضبط السياسة، سيتم ضبط quantity على 1.

view_search_results

سجّل هذا الحدث عند تقديم نتائج البحث للمستخدم.

المعلَمات

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