يسرد هذا المرجع الأحداث المقترَحة التي تتوافق مع علامات Google.
add_payment_info
يشير هذا الحدث إلى أنّ أحد المستخدِمين قد أرسل معلومات الدفع الخاصة به في عملية دفع للتجارة الإلكترونية.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط 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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
add_shipping_info
يشير هذا الحدث إلى أنّ المستخدم أرسل معلومات الشحن الخاصة به في عملية دفع في التجارة الإلكترونية.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط 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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
add_to_cart
يشير هذا الحدث إلى أنّه تمّت إضافة سلعة إلى سلة التسوّق لشرائها.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط 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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
add_to_wishlist
يشير الحدث إلى أنّه تمّت إضافة سلعة إلى قائمة أمنيات. استخدِم هذا الحدث لتحديد الهدايا الرائجة في تطبيقك.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط 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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
begin_checkout
يشير هذا الحدث إلى أنّ المستخدم قد بدأ عملية دفع.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط 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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
close_convert_lead
يقيس هذا الحدث عندما يتم تحويل عميل محتمل وإغلاقه (على سبيل المثال، من خلال عملية شراء).
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.* في حال ضبط value ، تكون مَعلمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value .
* يجب توفير currency في حال ضبط value .
|
close_unconvert_lead
يقيس هذا الحدث عندما يتمّ تصنيف مستخدم على أنّه ليس عميلاً محتملاً تمّت إحالته بنجاح، بالإضافة إلى السبب.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.* في حال ضبط value ، تكون مَعلمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value .
* يجب توفير currency في حال ضبط value .
|
unconvert_lead_reason |
string |
لا | لم يتم الردّ مطلقًا | سبب عدم تحويل العميل المحتمل إلى عميل |
disqualify_lead
يقيس هذا الحدث عندما يتم تصنيف مستخدم على أنّه غير مؤهَّل ليصبح عميلاً محتملاً، بالإضافة إلى سبب عدم الأهلية.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.* في حال ضبط value ، تكون مَعلمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value .
* يجب توفير currency في حال ضبط value .
|
disqualified_lead_reason |
string |
لا | لا أريد شراء أي منتج | سبب وضع علامة على العميل المحتمل تفيد بأنّه غير مؤهَّل. |
earn_virtual_currency
يقيس هذا الحدث عندما يحصل المستخدم على عملة افتراضية في إحدى الألعاب. سجِّل هذا الحدث مع spend_virtual_currency لفهم اقتصادك الافتراضي بشكلٍ أفضل.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
virtual_currency_name |
string |
لا | Gems | اسم العملة الافتراضية. |
value |
number |
لا | 5 | قيمة العملة الافتراضية. |
exception
يتم تسجيل حدث استثناء عند مقاطعة التدفق العادي لتنفيذ أحد التطبيقات.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
description |
string |
لا | يجب إدخال الحقل المطلوب. | وصف الاستثناء الذي حدث. |
fatal |
boolean |
لا | true |
ما إذا كان الاستثناء فادحًا أم لا |
generate_lead
يقيس هذا الحدث عندما يتم اكتساب عميل محتمل (على سبيل المثال، من خلال نموذج). سجِّل هذا الحدث لمعرفة مدى فعالية حملاتك التسويقية وعدد العملاء الذين يعاودون التفاعل مع نشاطك التجاري بعد تجديد النشاط التسويقي لهم.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.* في حال ضبط value ، تكون مَعلمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value .
* يجب توفير currency في حال ضبط value .
|
lead_source |
string |
لا | المعرض التجاري | تمثّل هذه السمة مصدر العميل المحتمل. |
join_group
سجِّل هذا الحدث عندما ينضم مستخدم إلى مجموعة مثل رابطة أو فريق أو عائلة. يمكنك استخدام هذا الحدث لتحليل مدى رواج مجموعات أو ميزات اجتماعية معيّنة.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
group_id |
string |
لا | G_12345 | رقم تعريف المجموعة. |
level_end
تشير هذه الفعالية إلى أنّ أحد اللاعبين قد وصل إلى نهاية مستوى في إحدى الألعاب.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
level_name |
string |
لا | تبدأ الرحلة... | تمثّل هذه السمة اسم المستوى. |
success |
boolean |
لا | صحيح | يجب ضبط القيمة على true إذا تم إكمال المستوى بنجاح. |
level_start
يشير هذا الحدث إلى أنّ أحد اللاعبين قد بدأ مستوى في إحدى الألعاب.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
level_name |
string |
لا | تبدأ الرحلة... | تمثّل هذه السمة اسم المستوى. |
level_up
يشير هذا الحدث إلى أنّ أحد اللاعبين قد انتقل إلى مستوى أعلى في إحدى الألعاب. استخدِمها لقياس توزيع مستويات قاعدة المستخدمين وتحديد المستويات التي يصعب إكمالها.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
level |
number |
لا | 5 | مستوى الشخصية |
character |
string |
لا | اللاعب 1 | تمثّل هذه السمة الشخصية التي انتقلت إلى مستوى أعلى. |
login
أرسِل هذا الحدث للإشارة إلى أنّ أحد المستخدِمين قد سجّل الدخول إلى موقعك الإلكتروني أو تطبيقك.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدَمة لتسجيل الدخول. |
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 |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط 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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
qualify_lead
يقيس هذا الحدث عندما يتم وضع علامة على مستخدم تفيد بأنّه يستوفي معايير التأهّل ليصبح عميلاً محتملاً مؤهّلاً.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.* في حال ضبط value ، تكون مَعلمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value .
* يجب توفير currency في حال ضبط value .
|
refund
يشير هذا الحدث إلى ردّ أموال سلعة واحدة أو أكثر إلى المستخدم.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط 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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
remove_from_cart
يشير هذا الحدث إلى أنّه تمت إزالة سلعة من سلة التسوّق.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط 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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
search
سجِّل هذا الحدث للإشارة إلى وقت إجراء المستخدم لعملية بحث. يمكنك استخدام هذا الحدث لتحديد ما يبحث عنه المستخدمون على موقعك الإلكتروني أو تطبيقك. على سبيل المثال، يمكنك إرسال هذا الحدث عندما يعرض المستخدم صفحة نتائج البحث بعد إجراء بحث.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
نعم | قمصان | العبارة التي تم البحث عنها. |
select_content
يشير هذا الحدث إلى أنّ المستخدم اختار بعض المحتوى من نوع معيّن. يمكن أن يساعدك هذا الحدث في تحديد المحتوى والفئات الشائعة على موقعك الإلكتروني أو تطبيقك.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
content_type |
string |
لا | المنتج | نوع المحتوى المحدّد |
content_id |
string |
لا | C_12345 | معرّف للمحتوى الذي تمّ اختياره. |
select_item
يشير هذا الحدث إلى أنّه تم اختيار سلعة من قائمة.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهله في حال ضبطه على مستوى السلعة. |
item_list_name |
string |
لا | المنتجات ذات الصلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهله في حال ضبطه على مستوى السلعة. |
items |
Array<Item> |
نعم* | تمثّل هذه السمة السلع الخاصة بالحدث. * من المتوقّع أن تحتوي مصفوفة items على عنصر واحد
يمثّل السلعة المحدّدة. إذا تم تقديم عناصر متعددة، سيتم استخدام العنصر الأول فقط في items .
|
مَعلمات المنتجات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب توفير إحدى السمتين |
item_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
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 |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
تمثّل هذه السمة معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام promotion_id على مستوى الحدث، إذا كانت متوفّرة.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام promotion_name على مستوى الحدث، إذا كانت متوفّرة.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
share
استخدِم هذا الحدث عندما يشارك أحد المستخدمين محتوًى.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة التي تتم بها مشاركة المحتوى | |
content_type |
string |
لا | الصورة | نوع المحتوى الذي تتم مشاركته |
item_id |
string |
لا | C_12345 | معرّف المحتوى المشترَك |
sign_up
يشير هذا الحدث إلى أنّ المستخدم قد اشترك لإنشاء حساب. استخدِم هذا الحدث لفهم السلوكيات المختلفة للمستخدمين الذين سجّلوا دخولهم وسجّلوا خروجهم.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدَمة للاشتراك |
spend_virtual_currency
يقيس هذا الحدث مبيعات السلع الافتراضية في تطبيقك ويساعدك في تحديد السلع الافتراضية الأكثر شيوعًا.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
value |
number |
نعم | 5 | قيمة العملة الافتراضية. |
virtual_currency_name |
string |
نعم | Gems | اسم العملة الافتراضية. |
item_name |
string |
لا | Starter Boost | اسم العنصر الذي يتم استخدام العملة الافتراضية فيه |
tutorial_begin
يشير هذا الحدث إلى بداية عملية الإعداد. استخدِم هذا الحدث في مسار إحالة ناجحة مع الحدث tutorial_complete لمعرفة عدد المستخدمين الذين يكملون الدليل التعليمي.
المعلمات
ما مِن مَعلمات لهذا الحدث.
tutorial_complete
يشير هذا الحدث إلى إكمال المستخدم لعملية الإعداد. استخدِم هذا الحدث في مسار إحالة ناجحة مع الحدث tutorial_begin لمعرفة عدد المستخدمين الذين يكملون البرنامج التعليمي.
المعلمات
لا يتم اقتراح أيّ مَعلمات لهذا الحدث.
unlock_achievement
سجِّل هذا الحدث عندما يحقّق المستخدم إنجازًا. يمكن أن يساعدك هذا الحدث في فهم تجربة المستخدمين للعبتك.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
achievement_id |
string |
نعم | A_12345 | رقم تعريف الإنجاز الذي تم فتحه. |
view_cart
يشير هذا الحدث إلى أنّ أحد المستخدمين اطّلع على سلة التسوّق.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط 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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
view_item
يشير هذا الحدث إلى أنّه تم عرض بعض المحتوى للمستخدم. استخدِم هذا الحدث للتعرّف على العناصر الأكثر رواجًا التي تمّت مشاهدتها.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط 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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
view_item_list
سجِّل هذا الحدث عندما يتم عرض قائمة بعناصر من فئة معيّنة للمستخدم.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات* في حال ضبط value ، تكون currency مطلوبة
لاحتساب مقاييس الإيرادات بدقة.
|
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهله في حال ضبطه على مستوى السلعة. |
item_list_name |
string |
لا | المنتجات ذات الصلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهله في حال ضبطه على مستوى السلعة. |
items |
Array<Item> |
نعم | تمثّل هذه السمة السلع الخاصة بالحدث. |
مَعلمات المنتجات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب توفير إحدى السمتين |
item_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالسلعة. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
|
discount |
number |
لا | 2.22 | قيمة الخصم النقدي للوحدة المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع السلعة في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
quantity |
number |
لا | 3 |
كمية السلعة |
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_name |
string |
نعم* | قميص Stan and Friends |
اسم السلعة.
*يجب توفير إحدى السمتين |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope. |
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 |
لا | العلامة التجارية للسلعة | |
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` إلا على مستوى item-scope. |
price |
number |
لا | 10.01 |
تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض
وحدِّد الخصم على سعر الوحدة في المَعلمة discount .
|
promotion_id |
string |
لا | P_12345 |
تمثّل هذه السمة معرّف العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام promotion_id على مستوى الحدث، إذا كانت متوفّرة.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام promotion_name على مستوى الحدث، إذا كانت متوفّرة.
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
view_search_results
سجِّل هذا الحدث عندما يتم عرض نتائج البحث على المستخدم. يُرجى العِلم أنّه يمكنك تفعيل حدث view_search_results لجمعه تلقائيًا من خلال قياس الأحداث المحسّن في "إحصاءات Google".
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
لا | ملابس | العبارة المستخدَمة في البحث. |
working_lead
يقيس هذا الحدث عندما يتواصل المستخدم مع أحد الممثلين أو يتواصل ممثل معه.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | دولار أمريكي |
تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.* في حال ضبط value ، تكون مَعلمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value .
* يجب توفير currency في حال ضبط value .
|
lead_status |
string |
لا | المحادثات التي بدأتها | حالة العميل المحتمل |