add_payment_info
يشير هذا الحدث إلى أن المستخدم قد أرسل معلومات الدفع.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
payment_type |
string |
غير متوافق | بطاقة الائتمان | طريقة الدفع التي تم اختيارها |
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
غير متوافق | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
غير متوافق | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
لا | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_payment_info",
"params": {
"currency": "USD",
"value": 7.77,
"coupon": "SUMMER_FUN",
"payment_type": "Credit Card",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
add_shipping_info
يشير هذا الحدث إلى أنّ المستخدم قد قدّم معلومات الشحن.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
shipping_tier |
string |
غير متوافق | شحن بري |
فئة الشحن (مثل Ground أو Air أو
Next-day ) التي تم اختيارها لتوصيل السلعة المشتراة.
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
غير متوافق | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
غير متوافق | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_shipping_info",
"params": {
"currency": "USD",
"value": 7.77,
"coupon": "SUMMER_FUN",
"shipping_tier": "Ground",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
add_to_cart
يشير هذا الحدث إلى أنه تمت إضافة سلعة إلى سلة التسوق لشرائها.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
غير متوافق | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
غير متوافق | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_to_cart",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
add_to_wishlist
يشير الحدث إلى إضافة عنصر إلى قائمة المفضلات. يمكنك استخدام هذا الحدث لتحديد عناصر الهدايا الشائعة في تطبيقك.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
غير متوافق | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
غير متوافق | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
غير متوافق | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_to_wishlist",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
begin_checkout
يشير هذا الحدث إلى أن المستخدم بدأ عملية دفع.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
غير متوافق | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "begin_checkout",
"params": {
"currency": "USD",
"value": 7.77,
"coupon": "SUMMER_FUN",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
تفاصيل_الحملة
استخدِم هذا الحدث لإرسال تفاصيل الحملة التي سيتم تطبيقها على الأحداث المستقبلية.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
campaign_id |
string |
غير متوافق | google_1234 | رقم تعريف الحملة. |
campaign |
string |
غير متوافق | Summer_fun | الاسم المستخدَم لتحديد عرض ترويجي أو حملة استراتيجية معيّنة. |
source |
string |
غير متوافق | مصدر زيارات الحملة (مثل google أو البريد الإلكتروني وما إلى ذلك) | |
medium |
string |
غير متوافق | تكلفة النقرة | وسيط الحملة (مثل البريد الإلكتروني، وتكلفة النقرة، وما إلى ذلك) |
term |
string |
غير متوافق | summer+travel | عبارة الحملة المستخدمة في البحث المدفوع لتوفير الكلمات الرئيسية للإعلانات. |
content |
string |
غير متوافق | logolink | محتوى الحملة المستخدَم في اختبار A/B والإعلانات التي تستهدف المحتوى للتمييز بين الإعلانات أو الروابط التي تشير إلى عنوان URL نفسه. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink"
}
}]
})
});
earn_virtual_currency
يقيس هذا الحدث منح العملة الافتراضية. يمكنك تسجيل هذه العملية إلى جانب spend_virtual_currency لفهم اقتصادك الافتراضي بشكلٍ أفضل.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
virtual_currency_name |
string |
غير متوافق | أحجار كريمة | اسم العملة الافتراضية. |
value |
number |
غير متوافق | 5 | قيمة العملة الافتراضية. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "earn_virtual_currency",
"params": {
"virtual_currency_name": "Gems",
"value": 5
}
}]
})
});
generate_lead
سجِّل هذا الحدث عند إنشاء عميل محتمل لفهم مدى فعالية حملات إعادة الجذب.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "generate_lead",
"params": {
"currency": "USD",
"value": 99.99
}
}]
})
});
join_group
تسجيل هذا الحدث عندما ينضم مستخدم إلى مجموعة مثل رابطة أو فريق أو عائلة. يمكنك استخدام هذا الحدث لتحليل مدى رواج مجموعات أو ميزات اجتماعية معيّنة.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
group_id |
string |
غير متوافق | G_12345 | رقم تعريف المجموعة. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events":[{
"name":"join_group",
"params":{
"group_id":"G_12345"
}
}]
})
});
level_up
يشير هذا الحدث إلى انتقال اللاعب إلى مستوى أعلى. استخدمه لقياس توزيع مستويات قاعدة المستخدمين وتحديد المستويات التي يصعب استكمالها.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
level |
number |
لا | 5 | مستوى الحرف |
character |
string |
غير متوافق | لاعب رقم 1 | الشخصية التي انتقلت إلى مستوى أعلى. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "level_up",
"params": {
"level": 5,
"character": "Player 1"
}
}]
})
});
login
أرسِل هذا الحدث للدلالة على تسجيل مستخدم دخوله.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
غير متوافق | الطريقة المستخدَمة لتسجيل الدخول. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "login",
"params": {
"method": "Google"
}
}]
})
});
post_score
يمكنك إرسال هذا الحدث عندما ينشر المستخدم نتيجة. يمكنك استخدام هذا الحدث لفهم مستوى أداء المستخدمين في لعبتك وربطها بالنتائج العالية لدى الجماهير أو السلوكيات.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
score |
number |
نعم | 10000 | التقييم المطلوب نشره |
level |
number |
غير متوافق | 5 | مستوى النتيجة. |
character |
string |
غير متوافق | لاعب رقم 1 | الشخصية التي حققت النتيجة. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "post_score",
"params": {
"score": 10000,
"level": 5,
"character": "Player 1"
}
}]
})
});
purchase
يشير هذا الحدث إلى شراء عنصر واحد أو أكثر من قِبل مستخدم.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
transaction_id |
string |
نعم | T_12345 | المعرّف الفريد للمعاملة. تساعدك المَعلمة transaction_id في تجنُّب الحصول على أحداث مكرّرة لعملية الشراء. |
value |
number |
نعم* | 12.21 | القيمة المالية للحدث. * يجب استخدام value لإعداد تقارير مفيدة و
ملء الجمهور المتوقّع.
* currency مطلوب في حال ضبط value .
|
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
shipping |
number |
لا | 3.33 | تكلفة الشحن المرتبطة بمعاملة معيّنة. |
tax |
number |
غير متوافق | 11 | تكلفة الضريبة المرتبطة بمعاملة معيّنة. |
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
غير متوافق | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
غير متوافق | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
غير متوافق | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "purchase",
"params": {
"currency": "USD",
"transaction_id": "T_12345",
"value": 12.21,
"coupon": "SUMMER_FUN",
"shipping": 3.33,
"tax": 1.11,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
refund
يشير هذا الحدث إلى ردّ أموال عنصر واحد أو أكثر إلى مستخدم.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
transaction_id |
string |
نعم | T_12345 | المعرّف الفريد للمعاملة. |
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبط بالحدث. إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
shipping |
number |
غير متوافق | 3.33 | تكلفة الشحن المرتبطة بمعاملة معيّنة. |
tax |
number |
غير متوافق | 11 | تكلفة الضريبة المرتبطة بمعاملة معيّنة. |
items |
Array<Item>
|
لا* | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
غير متوافق | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
غير متوافق | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "refund",
"params": {
"currency": "USD",
"transaction_id": "T_12345",
"value": 12.21,
"coupon": "SUMMER_FUN",
"shipping": 3.33,
"tax": 1.11,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
remove_from_cart
يشير هذا الحدث إلى إزالة سلعة من سلة التسوق.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
لا | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
غير متوافق | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
لا | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "remove_from_cart",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
search
سجِّل هذا الحدث للإشارة إلى وقت إجراء المستخدم لعملية بحث. ويمكنك استخدام هذا الحدث لوضع سياق عمليات البحث لتحديد المحتوى الذي يبحث عنه المستخدمون على موقعك الإلكتروني أو تطبيقك. على سبيل المثال، يمكنك إرسال هذا الحدث عندما يشاهد المستخدم صفحة بعد إجراء عملية بحث.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
نعم | القمصان | العبارة التي تم البحث عنها. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "search",
"params": {
"search_term": "t-shirts"
}
}]
})
});
select_content
يشير هذا الحدث إلى أن المستخدم قد اختار بعض المحتوى من نوع معيّن. يمكن أن يساعدك هذا الحدث في تحديد المحتوى وفئات المحتوى الرائج على موقعك الإلكتروني أو تطبيقك.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
content_type |
string |
غير متوافق | product | نوع المحتوى المحدّد |
content_id |
string |
غير متوافق | C_12345 | معرِّف للمحتوى الذي تم اختياره. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_content",
"params": {
"content_type": "product",
"content_id": "C_12345"
}
}]
})
});
select_item
يشير هذا الحدث إلى أنه تم اختيار عنصر من القائمة.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
items |
Array<Item> |
نعم* | عناصر الحدث. * من المتوقّع أن تحتوي الصفيف items على عنصر
واحد يمثّل العنصر المحدّد. وفي حال تقديم عناصر متعددة،
سيتم استخدام العنصر الأول فقط في السمة items .
|
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
لا | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
غير متوافق | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
لا | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
غير متوافق | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
لا | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_item",
"params": {
"item_list_id": "related_products",
"item_list_name": "Related products",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
select_promotion
يشير هذا الحدث إلى اختيار عرض ترويجي من القائمة.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط بالفعالية. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالحدث. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالحدث. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
items |
Array<Item>
|
غير متوافق | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
غير متوافق | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
غير متوافق | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
لا | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
لا | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_promotion",
"params": {
"creative_name": "Summer Banner",
"creative_slot": "featured_app_1",
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"creative_name": "summer_banner2",
"creative_slot": "featured_app_1",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"quantity": 1
}
]
}
}]
})
});
مشاركة
يمكنك استخدام هذا الحدث عندما يشارك المستخدم محتوى.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
غير متوافق | الطريقة التي تمت مشاركة المحتوى بها | |
content_type |
string |
غير متوافق | صورة | نوع المحتوى الذي تمت مشاركته. |
item_id |
string |
غير متوافق | C_12345 | رقم تعريف المحتوى المشترَك |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "share",
"params": {
"method": "Twitter",
"content_type": "image",
"item_id": "C_12345"
}
}]
})
});
sign_up
يشير هذا الحدث إلى اشتراك مستخدم لحساب. يمكنك استخدام هذا الحدث لفهم السلوكيات المختلفة للمستخدمين الذين سجّلوا دخولهم وسجّلوا خروجهم.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
غير متوافق | الطريقة المستخدَمة للاشتراك. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "sign_up",
"params": {
"method": "Google"
}
}]
})
});
spend_virtual_currency
يقيس هذا الحدث بيع السلع الافتراضية في تطبيقك ويساعدك في تحديد السلع الافتراضية الأكثر رواجًا.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
value |
number |
نعم | 5 | قيمة العملة الافتراضية. |
virtual_currency_name |
string |
نعم | أحجار كريمة | اسم العملة الافتراضية. |
item_name |
string |
غير متوافق | تعزيز الصوت للمبتدئين | اسم العنصر الذي يتم استخدام العملة الافتراضية فيه. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "spend_virtual_currency",
"params": {
"value": 5,
"virtual_currency_name": "Gems",
"item_name": "Starter Boost"
}
}]
})
});
tutorial_begin
يشير هذا الحدث إلى بدء عملية الإعداد. استخدِم هذا المسار في مسار الإحالة الناجحة مع السمة tutorial_complete لمعرفة عدد المستخدمين الذين يُكملون البرنامج التعليمي.
المعلّمات
لم يتم اقتراح أي معلَمات لهذا الحدث.
ما مِن معلّمات لهذا الحدث.
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "tutorial_begin"
}]
})
});
tutorial_complete
يشير هذا الحدث إلى إكمال المستخدم لعملية الإعداد. ويمكنك استخدام هذا المسار في مسار الإحالة الناجحة مع tutorial_begin لمعرفة عدد المستخدمين الذين يُكملون البرنامج التعليمي.
المعلّمات
لم يتم اقتراح أي معلَمات لهذا الحدث.
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "tutorial_complete"
}]
})
});
unlock_achievement
يمكنك تسجيل هذا الحدث عندما يفتح المستخدم إنجازًا. يمكن أن يساعدك هذا الحدث في فهم تجربة المستخدمين للعبتك.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
achievement_id |
string |
نعم | A_12345 | رقم تعريف الإنجاز الذي تم فتحه. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "unlock_achievement",
"params": {
"achievement_id": "A_12345"
}
}]
})
});
view_cart
يشير هذا الحدث إلى أن مستخدمًا شاهد سلة التسوق.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
لا | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
غير متوافق | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
لا | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
غير متوافق | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_cart",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
view_item
يشير هذا الحدث إلى أنه تم عرض بعض المحتوى للمستخدم. يمكنك استخدام هذا الحدث لاكتشاف العناصر الأكثر رواجًا التي تمّت مشاهدتها.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * في حال ضبط السياسة value ، يجب احتساب currency
لكي يتم احتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 7.77 | القيمة المالية للحدث. * يكون value مطلوبًا عادةً لإعداد تقارير مفيدة.
إذا ضَعت علامة
على الحدث باعتباره إحالة ناجحة، ننصحك بإعداد
value .
* currency مطلوب في حال ضبط value .
|
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
لا | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
غير متوافق | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
لا | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
غير متوافق | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
غير متوافق | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
لا | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_item",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
],
}
}]
})
});
view_item_list
سجِّل هذا الحدث عندما يتم عرض المستخدم مع قائمة بالعناصر من فئة معيّنة.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_list_id |
string |
لا | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
items |
Array<Item> |
نعم | عناصر الحدث. |
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
غير متوافق | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
لا | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
لا | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
غير متوافق | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
لا | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_item_list",
"params": {
"item_list_id": "related_products",
"item_list_name": "Related products",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"quantity": 1
}
]
}
}]
})
});
view_promotion
يشير هذا الحدث إلى أنه تم عرض عرض ترويجي من إحدى القوائم.
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
creative_slot |
string |
غير متوافق | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط بالفعالية. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالحدث. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالحدث. يتم تجاهل هذه السمة في حال ضبطها على مستوى السلعة. |
items |
Array<Item> |
نعم* | عناصر الحدث. * من المتوقّع أن تحتوي السمة items على عنصر واحد، وهو العنصر الذي يمثّل العرض الترويجي. وإذا تم توفير
عناصر متعددة، سيتم استخدام العنصر الأول فقط في
items .
|
معلّمات العناصر
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
item_id |
string |
نعم* | SKU_12345 |
معرّف العنصر.
*يجب استخدام سمة واحدة من |
item_name |
string |
نعم* | قميص مُزيَّن بشخصيات كتاب Stan and Friends |
اسم السلعة.
*يجب استخدام سمة واحدة من |
affiliation |
string |
غير متوافق | Google Store |
ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه ملاحظة: لا تتوفّر سمة "الارتباط" إلا على مستوى السلعة. |
coupon |
string |
غير متوافق | الدالة SUMMER_FUN | اسم/رمز القسيمة المرتبطة بالعنصر إنّ مَعلمتَي coupon على مستوى الحدث ومستوى السلعة
مستقلتان.
|
creative_name |
string |
غير متوافق | بانر_صيفي2 | اسم تصميم الإعلان الترويجي. في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_name على مستوى الحدث،
في حال توفّرها. |
creative_slot |
string |
لا | المميزة_1_ | اسم خانة تصميم الإعلان الترويجي المرتبط
بالعنصر. في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة creative_slot على مستوى الحدث،
في حال توفّرها. |
discount |
number |
غير متوافق | 2.22 | قيمة الخصم النقدي المرتبطة بالسلعة. |
index |
number |
غير متوافق | 5 | تمثّل هذه السمة فهرس/موضع العنصر في القائمة. |
item_brand |
string |
غير متوافق | العلامة التجارية للسلعة. | |
item_category |
string |
غير متوافق | ملابس | فئة السلعة وإذا تم استخدامها كجزء من التدرج الهرمي أو التصنيف، ستكون هذه هي الفئة الأولى. |
item_category2 |
string |
غير متوافق | للبالغين | التدرج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر. |
item_category3 |
string |
غير متوافق | قمصان | التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر. |
item_category4 |
string |
غير متوافق | طاقم العمل | التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر. |
item_category5 |
string |
غير متوافق | كُم قصير | التدرج الهرمي للفئة الخامسة أو التصنيف الإضافي للعنصر. |
item_list_id |
string |
غير متوافق | ذو صلة_المنتجات | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_id على مستوى الحدث،
في حال توفّرها.
|
item_list_name |
string |
غير متوافق | منتجات ذات صلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة item_list_name على مستوى الحدث،
في حال توفّرها.
|
item_variant |
string |
لا | أخضر | صيغة العنصر أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات العناصر. |
location_id |
string |
غير متوافق | ChIJIQBpAG2ahYAR_6128GcTUEo (رقم تعريف المكان في Google لسان فرانسيسكو) |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالعنصر (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام
معرّف المكان من Google الذي يتوافق مع العنصر المرتبط. يمكن أيضًا استخدام معرّف الموقع المخصص. ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على مستوى العنصر. |
price |
number |
غير متوافق | يورو | السعر النقدي للسلعة، بوحدات معلمة العملة المحدّدة. |
promotion_id |
string |
غير متوافق | P_12345 |
معرّف العرض الترويجي المرتبط بالعنصر. في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_id على مستوى الحدث،
في حال توفّرها.
|
promotion_name |
string |
غير متوافق | تخفيضات موسم الصيف |
اسم العرض الترويجي المرتبط بالسلعة. في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام السياسة promotion_name على مستوى الحدث،
في حال توفّرها.
|
quantity |
number |
غير متوافق | 1 |
كمية السلعة |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_promotion",
"params": {
"creative_name": "Summer Banner",
"creative_slot": "featured_app_1",
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"creative_name": "summer_banner2",
"creative_slot": "featured_app_1",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 9.99,
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"quantity": 1
}
]
}
}]
})
});
view_search_results
سجِّل هذا الحدث عندما تظهر للمستخدم نتائج بحث. تجدر الإشارة إلى أنه يمكنك تفعيل حدث view_search_results لجمع البيانات تلقائيًا من خلال قياس الأحداث المحسّن في "إحصاءات Google".
المعلّمات
الاسم | Type | عنصر مطلوب | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
غير متوافق | ملابس | العبارة المستخدَمة في البحث. |
إرسال الحدث
جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4" (GA4).
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_search_results",
"params": {
"search_term": "Clothing"
}
}]
})
});