يسرد هذا المرجع الأحداث المقترَحة المتوافقة مع علامات Google.
add_payment_info
يشير هذا الحدث إلى أنّ المستخدم قد أرسل معلومات الدفع الخاصة به في عملية دفع عبر التجارة الإلكترونية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
payment_type |
string |
لا | بطاقة الائتمان | طريقة الدفع التي اخترتها |
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
add_shipping_info
يشير هذا الحدث إلى أن المستخدم قد أرسل معلومات الشحن في عملية الدفع عبر التجارة الإلكترونية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
shipping_tier |
string |
لا | شحن بري |
فئة الشحن (مثل Ground أو Air أو Next-day ) التي تم اختيارها لتسليم السلعة المشتراة.
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
add_to_cart
يشير هذا الحدث إلى أنّه تمت إضافة سلعة إلى سلة التسوّق لشرائها.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
add_to_wishlist
ويشير الحدث إلى أنّه تمت إضافة عنصر إلى قائمة الأمنيات. يمكنك استخدام هذا الحدث لتحديد الهدايا الرائجة في تطبيقك
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
begin_checkout
يشير هذا الحدث إلى أنّ مستخدمًا بدأ عملية دفع.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
earn_virtual_currency
يقيس هذا الحدث عندما يتم منح المستخدم عملة افتراضية في لعبة. يمكنك تسجيل هذه القيمة جنبًا إلى جنب مع spend_virtual_currency لفهم اقتصادك الافتراضي بشكل أفضل.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
virtual_currency_name |
string |
لا | قائمة Gems | اسم العملة الافتراضية. |
value |
number |
لا | 5 | قيمة العملة الافتراضية. |
الاستثناء
يتم تسجيل حدث استثناء عند مقاطعة التدفق العادي لتنفيذ التطبيق.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
description |
string |
لا | يجب إدخال الحقل المطلوب. | وصف الاستثناء الذي حدث. |
fatal |
boolean |
لا | true |
ما إذا كان الاستثناء خطيرًا أم لا. |
generate_lead
يقيس هذا الحدث وقت إنشاء عميل محتمل (من خلال نموذج مثلاً). سجّل هذه البيانات لفهم مدى فعالية حملاتك التسويقية وعدد العملاء الذين يعيدون التفاعل مع نشاطك التجاري بعد تجديد النشاط التسويقي للعملاء.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
join_group
تسجيل هذا الحدث عندما ينضم مستخدم إلى مجموعة، مثل رابطة أو فريق أو عائلة. استخدِم هذا الحدث لتحليل مدى رواج بعض المجموعات أو الميزات الاجتماعية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
group_id |
string |
لا | G_12345 | رقم تعريف المجموعة. |
level_end
يشير هذا الحدث إلى وصول اللاعب إلى نهاية مستوى في لعبة.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
level_name |
string |
لا | تبدأ الرحلة... | تمثّل هذه السمة اسم المستوى. |
success |
boolean |
لا | صحيح | يمكنك ضبط القيمة على true إذا تمّ إكمال المستوى بنجاح. |
level_start
يشير هذا الحدث إلى أنّ لاعبًا قد بدأ مستوى في لعبة.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
level_name |
string |
لا | تبدأ الرحلة... | تمثّل هذه السمة اسم المستوى. |
level_up
يشير هذا الحدث إلى انتقال لاعب إلى مستوى أعلى في لعبة. يمكنك استخدامها لقياس التوزيع على مستوى قاعدة المستخدمين وتحديد المستويات التي يصعب إكمالها.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
level |
number |
لا | 5 | مستوى الشخصية. |
character |
string |
لا | لاعب 1 | الشخصية التي وصلت إلى مستوى أعلى. |
تسجيل دخول
أرسِل هذا الحدث للإشارة إلى أنّ المستخدم سجّل الدخول إلى موقعك الإلكتروني أو تطبيقك.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدمة لتسجيل الدخول. |
page_view
يشير هذا الحدث إلى أن المستخدم قد شاهد إحدى الصفحات.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
page_location |
string |
لا | https://example.com | تمثّل هذه السمة عنوان URL الخاص بالصفحة. |
client_id |
string |
لا | ABC_123 | معرِّف العميل. |
language |
string |
لا | en_us | لغة العميل. راجِع علامات اللغة ورموزها. |
page_encoding |
string |
لا | UTF-8 | ترميز الصفحة. |
page_title |
string |
لا | الصفحة الرئيسية | عنوان الصفحة. |
user_agent |
string |
لا | وكيل المستخدم لدى العميل. |
post_score
يمكنك إرسال هذا الحدث عندما ينشر المستخدم نتيجة. استخدِم هذا الحدث لفهم مستوى أداء المستخدمين في لعبتك وربط النتائج العالية بالجماهير أو السلوكيات.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
score |
number |
Yes | 10000 | النتيجة المطلوب نشرها. |
level |
number |
لا | 5 | تمثّل هذه السمة مستوى النتيجة. |
character |
string |
لا | لاعب 1 | الشخصية التي حقّقت النتيجة. |
purchase
يشير هذا الحدث إلى شراء منتج واحد أو أكثر من قِبل أحد المستخدمين.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
transaction_id |
string |
Yes | T_12345 | المعرّف الفريد للمعاملة. تساعدك المَعلمة transaction_id في تجنُّب الحصول على أحداث مكرّرة لعملية شراء. |
coupon |
string |
لا | SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
shipping |
number |
لا | 3.33 | تكلفة الشحن المرتبطة بإحدى المعاملات. |
tax |
number |
لا | 1.11 | تكلفة الضريبة المرتبطة بالمعاملة. |
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
refund
يشير هذا الحدث إلى ردّ أموال سلعة واحدة أو أكثر إلى أحد المستخدمين.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
transaction_id |
string |
Yes | 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 على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
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 الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
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
.
remove_from_cart
يشير هذا الحدث إلى أنّه تمّت إزالة سلعة من سلّة التسوّق.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
search
سجِّل هذا الحدث للإشارة إلى الوقت الذي أجرى فيه المستخدم عملية بحث. يمكنك استخدام هذا الحدث لتحديد ما يبحث عنه المستخدمون على موقعك الإلكتروني أو تطبيقك. على سبيل المثال، يمكنك إرسال هذا الحدث عندما يشاهد المستخدم صفحة نتائج بحث بعد إجراء عملية بحث.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
Yes | قمصان | العبارة التي تم البحث عنها. |
select_content
يشير هذا الحدث إلى أنّ المستخدم قد اختار محتوى من نوع معيّن. ويمكن أن يساعدك هذا الحدث في تحديد المحتوى الرائج وفئات المحتوى على موقعك الإلكتروني أو تطبيقك.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
content_type |
string |
لا | product | نوع المحتوى المحدّد |
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 على مستوى الحدث وعلى مستوى السلعة
مستقلة.
|
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 الذي يتوافق مع العنصر المرتبط به. ويمكن أيضًا استخدام رقم تعريف موقع جغرافي مخصّص. ملاحظة: لا يتوفّر "رقم تعريف الموقع الجغرافي" إلا على مستوى السلعة. |
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
.
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
مشاركة
يمكنك استخدام هذا الحدث عندما يشارك المستخدم محتوى.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة التي تتم بها مشاركة المحتوى. | |
content_type |
string |
لا | صورة | نوع المحتوى الذي تمّت مشاركته |
item_id |
string |
لا | C_12345 | رقم تعريف المحتوى الذي تمت مشاركته. |
sign_up
يشير هذا الحدث إلى أنّ مستخدمًا اشترك في حساب. يمكنك استخدام هذا الحدث لفهم السلوكيات المختلفة للمستخدمين الذين سجّلوا الدخول أو الخروج.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدَمة للاشتراك. |
spend_virtual_currency
يقيس هذا الحدث بيع السلع الافتراضية في تطبيقك ويساعدك في تحديد أي السلع الافتراضية هي الأكثر شعبية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
value |
number |
Yes | 5 | قيمة العملة الافتراضية. |
virtual_currency_name |
string |
Yes | قائمة Gems | اسم العملة الافتراضية. |
item_name |
string |
لا | تعزيز المبتدئين | اسم العنصر الذي تُستخدم العملة الافتراضية له. |
tutorial_begin
ويشير هذا الحدث إلى بداية عملية الإعداد. يمكنك استخدام هذا المقياس في مسار الإحالة الناجحة باستخدام tutorial_complete لمعرفة عدد المستخدمين الذين أكملوا البرنامج التعليمي.
المَعلمات
ما مِن معلَمات لهذا الحدث.
tutorial_complete
ويشير هذا الحدث إلى اكتمال المستخدم لعملية الإعداد. يمكنك استخدام هذا الإجراء في مسار الإحالة الناجحة باستخدام tutorial_begin لمعرفة عدد المستخدمين الذين أكملوا البرنامج التعليمي.
المَعلمات
لم يتم اقتراح أي مَعلمات لهذا الحدث.
unlock_achievement
سجِّل هذا الحدث عندما يفتح المستخدم إنجازًا. ويمكن أن يساعدك هذا الحدث في فهم تجربة المستخدمين للعبتك.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
achievement_id |
string |
Yes | A_12345 | رقم تعريف الإنجاز الذي تم فتحه. |
view_cart
يشير هذا الحدث إلى أنّ أحد المستخدمين اطّلع على سلة التسوّق.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
view_item
يشير هذا الحدث إلى أنّه تم عرض بعض المحتوى للمستخدم. يمكنك استخدام هذا الحدث لمعرفة المنتجات الأكثر رواجًا التي تمت مشاهدتها.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
view_item_list
سجِّل هذا الحدث عندما يتم عرض قائمة بالعناصر من فئة معيّنة للمستخدم.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | related_products | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل السياسة في حال ضبطها على مستوى العنصر. |
items |
Array<Item> |
Yes | عناصر الحدث |
معلّمات العناصر
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
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 لسان فرانسيسكو) |
الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ننصحك باستخدام رقم تعريف المكان على 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
.
view_search_results
سجِّل هذا الحدث عندما يتم عرض نتائج عملية بحث للمستخدم. تجدر الإشارة إلى أنّه يمكنك تفعيل حدث view_search_results لجمع البيانات تلقائيًا من خلال ميزة قياس الأحداث المحسَّن في "إحصاءات Google".
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
لا | ملابس | العبارة المستخدمة للبحث. |