ad_impression
استخدِم هذا الحدث عندما يرى مستخدِم مرّة ظهور للإعلان.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
ad_platform |
string |
لا | MoPub | النظام الأساسي لعرض الإعلانات |
ad_source |
string |
لا | AdColony | مصدر الإعلان. |
ad_format |
string |
لا | بانر | شكل الإعلان |
ad_unit_name |
string |
لا | Banner_03 | اسم الوحدة الإعلانية. |
currency |
string |
لا | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
لا | يورو | قيمة مرة ظهور الإعلان. * يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
* يجب توفُّر currency في حال ضبط value .
|
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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":"ad_impression",
"params":{
"ad_platform": "MoPub",
"ad_source": "AdColony",
"ad_format": "Banner",
"ad_unit_name": "Banner_03",
"currency": "USD",
"value": 3.99
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 30.03,
"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": 10.01,
"quantity": 3
}
]
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 30.03,
"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": 10.01,
"quantity": 3
}
]
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 30.03,
"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": 10.01,
"quantity": 3
}
]
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 30.03,
"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": 10.01,
"quantity": 3
}
]
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 30.03,
"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": 10.01,
"quantity": 3
}
]
}
}]
})
});
campaign_details
استخدِم هذا الحدث لإرسال تفاصيل الحملة التي سيتم تطبيقها على الأحداث المستقبلية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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"
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 لفهم اقتصادك الافتراضي بشكل أفضل.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
virtual_currency_name |
string |
لا | قائمة Gems | اسم العملة الافتراضية. |
value |
number |
لا | 5 | قيمة العملة الافتراضية. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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
يقيس هذا الحدث وقت إنشاء عميل محتمل (من خلال نموذج مثلاً). سجّل هذه البيانات لفهم مدى فعالية حملاتك التسويقية وعدد العملاء الذين يعيدون التفاعل مع نشاطك التجاري بعد تجديد النشاط التسويقي للعملاء.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
currency |
string |
نعم* | USD |
عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف. * في حال ضبط السمة value ، تكون السمة currency مطلوبة
لاحتساب مقاييس الأرباح بدقة.
|
value |
number |
نعم* | 30.03 | القيمة النقدية للحدث * يجب ضبط value على مجموع (price * quantity) لكل العناصر في items . لا تضمِّن shipping أو tax .
* يكون value عادةً مطلوبًا لإعداد تقارير ذات مغزى.
إذا وضعت علامة
على الحدث كإحالة ناجحة، ننصحك بإعداد
value .
* يجب توفُّر currency في حال ضبط value .
|
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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
تسجيل هذا الحدث عندما ينضم مستخدم إلى مجموعة، مثل رابطة أو فريق أو عائلة. استخدِم هذا الحدث لتحليل مدى رواج بعض المجموعات أو الميزات الاجتماعية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
group_id |
string |
لا | G_12345 | رقم تعريف المجموعة. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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
يشير هذا الحدث إلى انتقال لاعب إلى مستوى أعلى في لعبة. يمكنك استخدامها لقياس التوزيع على مستوى قاعدة المستخدمين وتحديد المستويات التي يصعب إكمالها.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
level |
number |
لا | 5 | مستوى الشخصية. |
character |
string |
لا | لاعب 1 | الشخصية التي وصلت إلى مستوى أعلى. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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"
}
}]
})
});
تسجيل دخول
أرسِل هذا الحدث للإشارة إلى أنّ المستخدم سجّل الدخول إلى موقعك الإلكتروني أو تطبيقك.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدمة لتسجيل الدخول. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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
يمكنك إرسال هذا الحدث عندما ينشر المستخدم نتيجة. استخدِم هذا الحدث لفهم مستوى أداء المستخدمين في لعبتك وربط النتائج العالية بالجماهير أو السلوكيات.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
score |
number |
Yes | 10000 | النتيجة المطلوب نشرها. |
level |
number |
لا | 5 | تمثّل هذه السمة مستوى النتيجة. |
character |
string |
لا | لاعب 1 | الشخصية التي حقّقت النتيجة. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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
يشير هذا الحدث إلى شراء منتج واحد أو أكثر من قِبل أحد المستخدمين.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 30.03,
"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": 10.01,
"quantity": 3
}
]
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 30.03,
"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": 10.01,
"quantity": 3
}
]
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 30.03,
"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": 10.01,
"quantity": 3
}
]
}
}]
})
});
screen_view
يمكنك استخدام هذا الحدث للإشارة إلى حدوث انتقال للشاشة.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
screen_class |
string |
لا | MainActivity | فئة الشاشة. |
screen_name |
string |
لا | لمحة عامة | اسم الشاشة. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": "screen_view",
"params": {
"screen_class": "MainActivity",
"screen_name": "About"
}
}]
})
});
search
سجِّل هذا الحدث للإشارة إلى الوقت الذي أجرى فيه المستخدم عملية بحث. يمكنك استخدام هذا الحدث لتحديد ما يبحث عنه المستخدمون على موقعك الإلكتروني أو تطبيقك. على سبيل المثال، يمكنك إرسال هذا الحدث عندما يشاهد المستخدم صفحة نتائج بحث بعد إجراء عملية بحث.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
Yes | قمصان | العبارة التي تم البحث عنها. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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
يشير هذا الحدث إلى أنّ المستخدم قد اختار محتوى من نوع معيّن. ويمكن أن يساعدك هذا الحدث في تحديد المحتوى الرائج وفئات المحتوى على موقعك الإلكتروني أو تطبيقك.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
content_type |
string |
لا | product | نوع المحتوى المحدّد |
content_id |
string |
لا | C_12345 | معرّف المحتوى الذي تم اختياره |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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
يشير هذا الحدث إلى أنّه تم اختيار عنصر من قائمة.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 10.01,
"quantity": 3
}
]
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 10.01,
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"quantity": 3
}
]
}
}]
})
});
مشاركة
يمكنك استخدام هذا الحدث عندما يشارك المستخدم محتوى.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة التي تتم بها مشاركة المحتوى. | |
content_type |
string |
لا | صورة | نوع المحتوى الذي تمّت مشاركته |
item_id |
string |
لا | C_12345 | رقم تعريف المحتوى الذي تمت مشاركته. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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
يشير هذا الحدث إلى أنّ مستخدمًا اشترك في حساب. يمكنك استخدام هذا الحدث لفهم السلوكيات المختلفة للمستخدمين الذين سجّلوا الدخول أو الخروج.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
method |
string |
لا | الطريقة المستخدَمة للاشتراك. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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
يقيس هذا الحدث بيع السلع الافتراضية في تطبيقك ويساعدك في تحديد أي السلع الافتراضية هي الأكثر شعبية.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
value |
number |
Yes | 5 | قيمة العملة الافتراضية. |
virtual_currency_name |
string |
Yes | قائمة Gems | اسم العملة الافتراضية. |
item_name |
string |
لا | تعزيز المبتدئين | اسم العنصر الذي تُستخدم العملة الافتراضية له. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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"
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"
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
سجِّل هذا الحدث عندما يفتح المستخدم إنجازًا. ويمكن أن يساعدك هذا الحدث في فهم تجربة المستخدمين للعبتك.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
achievement_id |
string |
Yes | A_12345 | رقم تعريف الإنجاز الذي تم فتحه. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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
يشير هذا الحدث إلى أنّ أحد المستخدمين اطّلع على سلة التسوّق.
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 10.01,
"quantity": 3
}
]
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 10.01,
"quantity": 3
}
],
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 10.01,
"quantity": 3
}
]
}
}]
})
});
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
.
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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": 10.01,
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"quantity": 3
}
]
}
}]
})
});
view_search_results
سجِّل هذا الحدث عندما يتم عرض نتائج عملية بحث للمستخدم. تجدر الإشارة إلى أنّه يمكنك تفعيل حدث view_search_results لجمع البيانات تلقائيًا من خلال ميزة قياس الأحداث المحسَّن في "إحصاءات Google".
المَعلمات
الاسم | النوع | مطلوبة | مثال على القيمة | الوصف |
---|---|---|---|---|
search_term |
string |
لا | ملابس | العبارة المستخدمة للبحث. |
إرسال الحدث
تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google 4"
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"
}
}]
})
});