ترسل "إحصاءات Google" بعض أنواع الأحداث تلقائيًا. هذه الصفحة يصف أحداثًا إضافية اختيارية يمكنك ضبطها لقياس المزيد وإنشاء تقارير أكثر فائدة لنشاطك التجاري. هذه العناصر الإضافية تستغرق عملية ضبط الأحداث مزيدًا من الجهد قبل استخدامها، لذلك يتعذّر على "إحصاءات Google 4" إرسالها تلقائيًا. للحصول على تعليمات خطوة بخطوة حول كيفية لضبط الأحداث المُقترَحة والمخصّصة لموقعك الإلكتروني أو تطبيقك، اطّلِع على مقالة إعداد الأحداث.
لعرض تفاصيل كل حدث يمكنك استخدامه، اختَر النظام الأساسي لإدارة العلامات:
add_payment_info
يشير هذا الحدث إلى أنّ المستخدِم قد أرسل معلومات الدفع في وعملية الدفع في التجارة الإلكترونية.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. يمكن اعتبار معلمات coupon على مستوى الحدث وعلى مستوى العنصر
مستقلّة.
|
payment_type |
string |
لا | بطاقة ائتمان | طريقة الدفع التي تم اختيارها. |
items |
Array<Item> |
نعم | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
add_shipping_info
يشير هذا الحدث إلى أنّ المستخدم قد أرسل معلومات الشحن في وعملية الدفع في التجارة الإلكترونية.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. يمكن اعتبار معلمات coupon على مستوى الحدث وعلى مستوى العنصر
مستقلّة.
|
shipping_tier |
string |
لا | شحن بري |
فئة الشحن (مثل Ground أو Air
Next-day ) المحددة لتسليم السلعة المشتراة.
|
items |
Array<Item> |
نعم | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
add_to_cart
يشير هذا الحدث إلى إضافة سلعة إلى سلة تسوّق للشراء.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
add_to_wishlist
يشير الحدث إلى إضافة عنصر إلى قائمة الأمنيات. استخدام هذا الحدث من أجل والتعرّف على عناصر الهدايا الشائعة في تطبيقك.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
begin_checkout
يشير هذا الحدث إلى أنّ المستخدم قد بدأ عملية الدفع.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. يمكن اعتبار معلمات coupon على مستوى الحدث وعلى مستوى العنصر
مستقلّة.
|
items |
Array<Item> |
نعم | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
close_convert_lead
يقيس هذا الحدث الحالات التي يتم فيها إجراء إحالة ناجحة للعميل المحتمل وإغلاقه (على سبيل المثال، من خلال عملية شراء).
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
close_unconvert_lead
يقيس هذا الحدث عندما يتم وضع علامة على المستخدم على أنه لا يصبح عميلاً محتملاً أجرى إحالة ناجحة، مع السبب.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
unconvert_lead_reason |
string |
لا | لم يتم الرد مطلقًا | سبب عدم إجراء إحالة ناجحة من العميل المحتمل. |
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
disqualify_lead
يقيس هذا الحدث عندما يتم وضع علامة على المستخدم على أنه غير مؤهل ليصبح عميلاً محتملاً، بالإضافة إلى سبب فقدان الأهلية.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
disqualified_lead_reason |
string |
لا | لا أريد الشراء | سبب وضع علامة على العميل المحتمل على أنّه غير مؤهَّل. |
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
earn_virtual_currency
يقيس هذا الحدث عندما يتم منح المستخدم عملة افتراضية في لعبة. سجِّل هذا مع spend_virtual_currency لفهم للاقتصاد الافتراضي.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
virtual_currency_name |
string |
لا | مجموعات تعليمات Gem | اسم العملة الافتراضية. |
value |
number |
لا | 5 | قيمة العملة الافتراضية. |
مثال
generate_lead
يقيس هذا الحدث وقت اكتساب عميل محتمل (على سبيل المثال، من خلال النموذج). سجل هذا لفهم مدى فعالية حملاتك التسويقية عدد العملاء الذين يعيدون التفاعل مع نشاطك التجاري بعد تجديد النشاط التسويقي الدائمين.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
lead_source |
string |
لا | معرض تجاري | مصدر العميل المحتمل. |
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
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 |
لا | الطريقة المستخدمة لتسجيل الدخول. |
مثال
post_score
يمكنك إرسال هذا الحدث عندما ينشر المستخدم نتيجة. يمكنك استخدام هذا الحدث لفهم كيفية أداء المستخدمين في لعبتك وربط النتائج العالية بالجماهير وسلوكياتهم.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
score |
number |
نعم | 10000 | النتيجة التي سيتم نشرها. |
level |
number |
لا | 5 | تمثّل هذه السمة مستوى النتيجة. |
character |
string |
لا | لاعب رقم 1 | الشخصية التي حققت النتيجة. |
مثال
purchase
يشير هذا الحدث إلى شراء المستخدِم لسلعة واحدة أو أكثر.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
transaction_id |
string |
نعم | T_12345 | المعرّف الفريد للمعاملة. تساعدك المَعلمة transaction_id في تجنُّب الحصول على أحداث مكرّرة لعملية شراء. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. يمكن اعتبار معلمات coupon على مستوى الحدث وعلى مستوى العنصر
مستقلّة.
|
shipping |
number |
لا | 3.33 | تكلفة الشحن المرتبطة بمعاملة معيّنة |
tax |
number |
لا | 1.11 | تكلفة الضريبة المرتبطة بمعاملة معيّنة. |
items |
Array<Item> |
نعم | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
qualify_lead
يقيس هذا الحدث عندما يتم وضع علامة على مستخدم على أنه يستوفي المعايير ليصبح عميل محتمل مؤهَّل.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
refund
يشير هذا الحدث إلى ردّ أموال عنصر واحد أو أكثر إلى أحد المستخدمين.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
transaction_id |
string |
نعم | T_12345 | المعرّف الفريد للمعاملة. |
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. يمكن اعتبار معلمات coupon على مستوى الحدث وعلى مستوى العنصر
مستقلّة.
|
shipping |
number |
لا | 3.33 | تكلفة الشحن المرتبطة بمعاملة معيّنة |
tax |
number |
لا | 1.11 | تكلفة الضريبة المرتبطة بمعاملة معيّنة. |
items |
Array<Item>
|
لا* | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
remove_from_cart
يشير هذا الحدث إلى إزالة سلعة من سلة تسوّق.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
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 |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
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 |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
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 |
نعم | مجموعات تعليمات Gem | اسم العملة الافتراضية. |
item_name |
string |
لا | تعزيز التفعيل | اسم العنصر الذي يتم استخدام العملة الافتراضية له. |
مثال
tutorial_begin
تشير هذه الفعالية إلى بدء عملية الإعداد. استخدام هذا في مسار الإحالة الناجحة باستخدام tutorial_complete لمعرفة عدد المستخدمين الذين أكملوا الدليل التوجيهي.
المعلمات
ما مِن مَعلمات لهذا الحدث.
مثال
tutorial_complete
يشير هذا الحدث إلى أنّ المستخدم قد أكمل عملية الإعداد. استخدام هذه المسودة في مسار الإحالة الناجحة الذي يتضمّن tutorial_begin لمعرفة عدد المستخدمين الذين أكملوا البرنامج التعليمي.
المعلمات
لم يتم اقتراح مَعلمات لهذا الحدث.
مثال
unlock_achievement
تسجيل هذا الحدث عندما فتح المستخدم إنجازًا يمكن أن يساعد هذا الحدث أنك تفهم تجربة المستخدمين للعبتك.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
achievement_id |
string |
نعم | A_12345 | رقم تعريف الإنجاز الذي تم فتحه. |
مثال
view_cart
يشير هذا الحدث إلى أنّ أحد المستخدمين قد شاهد سلة التسوّق.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
view_item
يشير هذا الحدث إلى أنّه تم عرض بعض المحتوى للمستخدم. استخدام هذا الحدث من أجل استكشِف السلع الأكثر رواجًا التي تمت مشاهدتها.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.
مثال
view_item_list
تسجيل هذا الحدث عندما يتم عرض قائمة من عناصر المستخدم فئة معينة.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
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 |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
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 |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
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
.
مثال
working_lead
يقيس هذا الحدث الحالات التي يتواصل فيها المستخدم مع أحد ممثليه أو عندما يتواصل معه أحد ممثليه.
المعلمات
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | الدولار الأمريكي |
عملة السلع المرتبطة بالحدث، بعملة
3 أحرف
ISO 4217 * في حال ضبط value ، ستكون currency مطلوبة.
لاحتساب مقاييس الأرباح بدقة
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث. * ضبط value على مجموع (price * quantity) لكل العناصر في
items لا تضمِّن shipping أو tax .
* تكون السمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
إذا وضعت علامة
الحدث كحدث رئيسي، ننصحك بتحديد
value
* مطلوبة currency في حال ضبط value .
|
lead_status |
string |
لا | المحادثات التي تم بدؤها | حالة العميل المحتمل. |
items |
Array<Item>
|
لا | عناصر الحدث. |
مَعلمات العناصر
الاسم | النوع | مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف السلعة.
*يجب تحديد إما |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب تحديد إما |
affiliation |
string |
لا | Google Store |
ارتباط منتج لتحديد الشركة المقدمة أو
موقع المتجر الفعلي. ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر. |
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 لمدينة سان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي)
موقع المتجر). ويستحسن استخدام
تقويم
رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص
ويمكن أيضًا استخدام مستند تعريف الهوية. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر. |
price |
number |
لا | 10.01 |
سعر الوحدة النقدي للعنصر بوحدات العملة المحدّدة
.
إذا كان هناك خصم ينطبق على السلعة، يمكنك ضبط price على سعر الوحدة المخفّض و
تحديد الخصم على سعر الوحدة في المَعلمة discount
|
quantity |
number |
لا | 3 |
كمية السلعة |
items
.