تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الأحداث

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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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	مصدر زيارات الحملة (مثل 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"
      }
    }]
  })
});

يمكنك إرسال هذا الحدث للإشارة إلى أنّ أحد المستخدمين قد سجّل الدخول إلى موقعك الإلكتروني أو تطبيقك.

المَعلمات

الاسم	Type	عنصر مطلوب	مثال على القيمة	الوصف
`method`	`string`	لا	Google	الطريقة المستخدَمة لتسجيل الدخول.

إرسال الحدث

جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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`	لا	Twitter	الطريقة التي تمت مشاركة المحتوى بها
`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	الطريقة المستخدَمة للاشتراك.

إرسال الحدث

جرِّب هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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_id` أو `item_name`.
`item_name`	`string`	نعم*	قميص مُزيَّن بشخصيات كتاب Stan and Friends	اسم السلعة. *يجب استخدام سمة واحدة من `item_id` أو `item_name`.
`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`	لا	Google	العلامة التجارية للسلعة.
`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	كمية السلعة في حال ترك السياسة بدون ضبط، يتم ضبط `quantity` على 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"
      }
    }]
  })
});

الأحداث

add_payment_info

المَعلمات

معلّمات العناصر

إرسال الحدث

add_shipping_info

المَعلمات

معلّمات العناصر

إرسال الحدث

add_to_cart

المَعلمات

معلّمات العناصر

إرسال الحدث

add_to_wishlist

المَعلمات

معلّمات العناصر

إرسال الحدث

begin_checkout

المَعلمات

معلّمات العناصر

إرسال الحدث

تفاصيل_الحملة

المَعلمات

إرسال الحدث

earn_virtual_currency

المَعلمات

إرسال الحدث

generate_lead

المَعلمات

إرسال الحدث

join_group

المَعلمات

إرسال الحدث

level_up

المَعلمات

إرسال الحدث

تسجيل دخول

المَعلمات

إرسال الحدث

post_score

المَعلمات

إرسال الحدث

purchase

المَعلمات

معلّمات العناصر

إرسال الحدث

refund

المَعلمات

معلّمات العناصر

إرسال الحدث

remove_from_cart

المَعلمات

معلّمات العناصر

إرسال الحدث

search

المَعلمات

إرسال الحدث

select_content

المَعلمات

إرسال الحدث

select_item

المَعلمات

معلّمات العناصر

إرسال الحدث

select_promotion

المَعلمات

معلّمات العناصر

إرسال الحدث

مشاركة

المَعلمات

إرسال الحدث

sign_up

المَعلمات

إرسال الحدث

spend_virtual_currency

المَعلمات

إرسال الحدث

tutorial_begin

المَعلمات

إرسال الحدث