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

الأحداث

add_payment_info

يشير هذا الحدث إلى أن المستخدم قد أرسل معلومات الدفع.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`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>`	نعم		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

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

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`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>`	نعم		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

يشير هذا الحدث إلى أنه تمت إضافة عنصر إلى سلة التسوق للشراء.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`currency`	`string`	نعم*	USD	تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة `value`، عليك استخدام السمة `currency` لاحتساب إحصاءات الأرباح بدقة.
`value`	`number`	نعم*	7,77	القيمة النقدية للحدث. * عادةً ما يكون `value` مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد `value`. * `currency` مطلوب في حالة تعيين `value`.
`items`	`Array<Item>`	نعم		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

يشير الحدث إلى أنه تمت إضافة عنصر إلى قائمة المفضلات. استخدم هذا الحدث لتحديد هدايا شائعة في تطبيقك.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`currency`	`string`	نعم*	USD	تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة `value`، عليك استخدام السمة `currency` لاحتساب إحصاءات الأرباح بدقة.
`value`	`number`	نعم*	7,77	القيمة النقدية للحدث. * عادةً ما يكون `value` مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد `value`. * `currency` مطلوب في حالة تعيين `value`.
`items`	`Array<Item>`	نعم		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

يشير هذا الحدث إلى أن المستخدم قد بدأ عملية دفع.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`currency`	`string`	نعم*	USD	تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة `value`، عليك استخدام السمة `currency` لاحتساب إحصاءات الأرباح بدقة.
`value`	`number`	نعم*	7,77	القيمة النقدية للحدث. * عادةً ما يكون `value` مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد `value`. * `currency` مطلوب في حالة تعيين `value`.
`coupon`	`string`	لا	الدالة SUMMER_FUN	اسم/رمز القسيمة المرتبط بالحدث. المعلّمات على مستوى الحدث والسلع على مستوى العنصر `coupon` مستقلة.
`items`	`Array<Item>`	نعم		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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
          }
        ]
      }
    }]
  })
});

earn_virtual_currency

يقيس هذا الحدث منح العملة الافتراضية. يمكنك تسجيل هذه العملية مع spend_virtual_currency لفهم اقتصادك الافتراضي بشكل أفضل.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`virtual_currency_name`	`string`	لا	أحجار كريمة	اسم العملة الافتراضية.
`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`	نعم*	7,77	القيمة النقدية للحدث. * عادةً ما يكون `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	الطريقة المستخدمة لتسجيل الدخول.

إرسال الحدث

جرِّب هذا الحدث في أداة إنشاء أحداث "إحصاءات 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`	نعم	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` لاحتساب إحصاءات الأرباح بدقة.
`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`	لا	1,11	تكلفة الضريبة المرتبطة بالمعاملة.
`items`	`Array<Item>`	نعم		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

يشير هذا الحدث إلى ردّ أموال عنصر أو أكثر إلى مستخدم.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`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`	لا	1,11	تكلفة الضريبة المرتبطة بالمعاملة.
`items`	`Array<Item>`	لا*		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

يشير هذا الحدث إلى أنه تمت إزالة عنصر من سلة التسوق.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`currency`	`string`	نعم*	USD	تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة `value`، عليك استخدام السمة `currency` لاحتساب إحصاءات الأرباح بدقة.
`value`	`number`	نعم*	7,77	القيمة النقدية للحدث. * عادةً ما يكون `value` مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد `value`. * `currency` مطلوب في حالة تعيين `value`.
`items`	`Array<Item>`	نعم		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

استخدم هذا الحدث لوضع سياق لعمليات البحث ضمن السياق. يمكن أن يساعدك هذا الحدث في تحديد المحتوى الأكثر رواجًا في تطبيقك

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`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": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

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

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`content_type`	`string`	لا	المنتج	نوع المحتوى المحدد.
`item_id`	`string`	لا	I_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",
        "item_id": "I_12345"
      }
    }]
  })
});

select_item

يشير هذا الحدث إلى أنه تم اختيار عنصر من قائمة.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_list_id`	`string`	لا	منتجات ذات صلة	رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهلها في حال ضبطها على مستوى السلعة.
`item_list_name`	`string`	لا	منتجات ذات صلة	اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهلها في حال ضبطها على مستوى السلعة.
`items`	`Array<Item>`	نعم*		عناصر الحدث. * من المتوقّع أن تحتوي المصفوفة `items` على عنصر واحد يمثّل العنصر المحدّد. وفي حال تقديم عناصر متعددة، لن يتم استخدام سوى العنصر الأول في `items`.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

يشير هذا الحدث إلى أنه تم اختيار عرض ترويجي من قائمة.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`creative_name`	`string`	لا	بانر_صيف2	اسم تصميم الإعلان الترويجي. يتم تجاهلها في حال ضبطها على مستوى السلعة.
`creative_slot`	`string`	لا	التطبيق_المميز_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالفعالية. يتم تجاهلها في حال ضبطها على مستوى السلعة.
`promotion_id`	`string`	لا	P_12345	رقم تعريف العرض الترويجي المرتبط بالحدث. يتم تجاهلها في حال ضبطها على مستوى السلعة.
`promotion_name`	`string`	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالحدث. يتم تجاهلها في حال ضبطها على مستوى السلعة.
`items`	`Array<Item>`	لا		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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
          }
        ]
      }
    }]
  })
});

استخدم هذا الحدث عندما يشارك المستخدم محتوى.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`method`	`string`	لا	Twitter	الطريقة التي تتم بها مشاركة المحتوى.
`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	الطريقة المستخدمة للاشتراك.

إرسال الحدث

جرِّب هذا الحدث في أداة إنشاء أحداث "إحصاءات 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`	نعم	5	قيمة العملة الافتراضية.
`virtual_currency_name`	`string`	نعم	أحجار كريمة	اسم العملة الافتراضية.
`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`	نعم	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`	نعم*	7,77	القيمة النقدية للحدث. * عادةً ما يكون `value` مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد `value`. * `currency` مطلوب في حالة تعيين `value`.
`items`	`Array<Item>`	نعم		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

يشير هذا الحدث إلى أنه تم عرض بعض المحتوى للمستخدم. استخدم هذا الحدث لاكتشاف أكثر العناصر الشائعة مشاهدة.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`currency`	`string`	نعم*	USD	تمثّل هذه السمة عملة العناصر المرتبطة بالفعالية بتنسيق ISO 4217 المكوّن من 3 أحرف. * إذا ضبطت السمة `value`، عليك استخدام السمة `currency` لاحتساب إحصاءات الأرباح بدقة.
`value`	`number`	نعم*	7,77	القيمة النقدية للحدث. * عادةً ما يكون `value` مطلوبًا لإعداد تقارير مفيدة. إذا وضعت علامة على الحدث كإحالة ناجحة، ننصحك بإعداد `value`. * `currency` مطلوب في حالة تعيين `value`.
`items`	`Array<Item>`	نعم		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

سجّل هذا الحدث عند تقديم قائمة بعناصر المستخدم من فئة معينة.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_list_id`	`string`	لا	منتجات ذات صلة	رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهلها في حال ضبطها على مستوى السلعة.
`item_list_name`	`string`	لا	منتجات ذات صلة	اسم القائمة التي تم فيها عرض السلعة للمستخدِم يتم تجاهلها في حال ضبطها على مستوى السلعة.
`items`	`Array<Item>`	نعم		عناصر الحدث.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

يشير هذا الحدث إلى مشاهدة عرض ترويجي من قائمة.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`creative_name`	`string`	لا	بانر_صيف2	اسم تصميم الإعلان الترويجي. يتم تجاهلها في حال ضبطها على مستوى السلعة.
`creative_slot`	`string`	لا	التطبيق_المميز_1	اسم خانة تصميم الإعلان الترويجي المرتبطة بالفعالية. يتم تجاهلها في حال ضبطها على مستوى السلعة.
`promotion_id`	`string`	لا	P_12345	رقم تعريف العرض الترويجي المرتبط بالحدث. يتم تجاهلها في حال ضبطها على مستوى السلعة.
`promotion_name`	`string`	لا	تخفيضات موسم الصيف	اسم العرض الترويجي المرتبط بالحدث. يتم تجاهلها في حال ضبطها على مستوى السلعة.
`items`	`Array<Item>`	نعم*		عناصر الحدث. * من المتوقّع أن تحتوي المصفوفة `items` على عنصر واحد يمثّل العنصر المرتبط بالعرض الترويجي. وفي حال توفير عناصر متعددة، سيتم استخدام العنصر الأول فقط في السمة `items`.

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

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`item_id`	`string`	نعم*	SKU_12345	معرّف العنصر. *يجب استخدام إحدى السمتَين `item_id` أو `item_name`.
`item_name`	`string`	نعم*	تي شيرت لأصدقائها وأصدقائها	اسم السلعة. *يجب استخدام إحدى السمتَين `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

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

سجّل هذا الحدث عند تقديم نتائج البحث للمستخدم.

المعلَمات

الاسم	النوع	مطلوب	مثال على القيمة	الوصف
`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"
      }
    }]
  })
});

الأحداث

add_payment_info

المعلَمات

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

إرسال الحدث

add_shipping_info

المعلَمات

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

إرسال الحدث

add_to_cart

المعلَمات

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

إرسال الحدث

add_to_wishlist

المعلَمات

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

إرسال الحدث

begin_checkout

المعلَمات

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

إرسال الحدث

earn_virtual_currency

المعلَمات

إرسال الحدث

generate_lead

المعلَمات

إرسال الحدث

join_group

المعلَمات

إرسال الحدث

level_up

المعلَمات

إرسال الحدث

login

المعلَمات

إرسال الحدث

post_score

المعلَمات

إرسال الحدث

purchase

المعلَمات

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

إرسال الحدث

refund

المعلَمات

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

إرسال الحدث

remove_from_cart

المعلَمات

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

إرسال الحدث

search

المعلَمات

إرسال الحدث

select_content

المعلَمات

إرسال الحدث

select_item

المعلَمات

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

إرسال الحدث

select_promotion

المعلَمات

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

إرسال الحدث

مشاركة

المعلَمات

إرسال الحدث

sign_up

المعلَمات

إرسال الحدث

spend_virtual_currency

المعلَمات

إرسال الحدث

tutorial_begin

المعلَمات

إرسال الحدث

tutorial_complete

المعلَمات

إرسال الحدث