الأحداث

ad_impression

لا يتوفّر هذا الحدث إلا لمصادر بيانات التطبيقات.

استخدِم هذا الحدث عندما يرى مستخدم مرّة ظهور للإعلان.

  • لن يتم تضمين ad_impression تم إرساله باستخدام Measurement Protocol في عمليات التصدير إلى منصات إعلانية أخرى، مثل "إعلانات Google".
  • قد يؤدي إرسال أحداث ad_impression باستخدام Measurement Protocol إلى حدوث مرات ظهور مكرّرة إذا كنت قد أعددت وضع العلامات أو حزمة تطوير البرامج (SDK) لمنتجات Google الإعلانية المرتبطة. لا ترسِل حدث ad_impression باستخدام Measurement Protocol إلا إذا لم يتم تسجيل الحدث من خلال وضع العلامات أو حزمة تطوير البرامج (SDK).

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
ad_platform string لا MoPub المنصة الإعلانية
ad_source string لا AdColony مصدر الإعلان
ad_format string لا بانر شكل الإعلان
ad_unit_name string لا Banner_03 اسم الوحدة الإعلانية
currency string لا دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number لا يورو
قيمة مرّة ظهور الإعلان
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى.
* يجب توفير currency في حال ضبط value.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"ad_impression",
      "params":{
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

add_payment_info

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالحدث.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
payment_type string لا بطاقة ائتمان طريقة الدفع التي تم اختيارها
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "payment_type": "Credit Card",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالحدث.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
shipping_tier string لا أرض فئة الشحن (مثل Ground أو Air أو Next-day) التي تم اختيارها لتوصيل السلعة المشتراة.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالحدث.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

campaign_details

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
campaign_id string لا google_1234 رقم تعريف الحملة.
campaign string لا Summer_fun الاسم المستخدَم لتحديد عرض ترويجي أو حملة استراتيجية معيّنة.
source string لا Google مصدر الزيارات للحملة (مثل Google أو البريد الإلكتروني أو غير ذلك).
medium string لا تكلفة النقرة وسيط الحملة (مثل البريد الإلكتروني أو تكلفة النقرة أو غير ذلك)
term string لا summer+travel عبارة الحملة المستخدَمة مع البحث المدفوع لتوفير الكلمات الرئيسية للإعلانات
content string لا logolink محتوى الحملة المستخدَم لاختبارات A/B والإعلانات التي تستهدف المحتوى لتمييز الإعلانات أو الروابط التي تشير إلى عنوان URL نفسه

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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

close_convert_lead

يقيس هذا الحدث عندما يتم تحويل عميل محتمل وإغلاقه (على سبيل المثال، من خلال عملية شراء).

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

يقيس هذا الحدث عندما يتمّ تصنيف مستخدم على أنّه ليس عميلاً محتملاً تمّت إحالته بنجاح، بالإضافة إلى السبب.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
unconvert_lead_reason string لا لم يتم الردّ مطلقًا سبب عدم تحويل العميل المحتمل إلى عميل

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

يقيس هذا الحدث عندما يتم تصنيف مستخدم على أنّه غير مؤهَّل ليصبح عميلاً محتملاً، بالإضافة إلى سبب عدم الأهلية.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
disqualified_lead_reason string لا لا أريد شراء أي منتج سبب وضع علامة على العميل المحتمل تفيد بأنّه غير مؤهَّل.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

earn_virtual_currency

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
virtual_currency_name string لا Gems اسم العملة الافتراضية.
value number لا 5 قيمة العملة الافتراضية.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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 نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
lead_source string لا المعرض التجاري تمثّل هذه السمة مصدر العميل المحتمل.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

join_group

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
group_id string لا G_12345 رقم تعريف المجموعة.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

login

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

المعلمات

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

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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"

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 نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
transaction_id string نعم T_12345 المعرّف الفريد للمعاملة

تساعدك المَعلمة transaction_id في تجنّب الحصول على أحداث مكرّرة لعملية شراء.
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 نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

qualify_lead

يقيس هذا الحدث عندما يتم وضع علامة على مستخدم تفيد بأنّه يستوفي معايير التأهّل ليصبح عميلاً محتملاً مؤهّلاً.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

refund

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
transaction_id string نعم T_12345 المعرّف الفريد للمعاملة
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالحدث.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
shipping number لا 3.33 تكلفة الشحن المرتبطة بمعاملة معيّنة.
tax number لا 1.11 تكلفة الضريبة المرتبطة بمعاملة معيّنة.
items Array<Item> لا* تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

screen_view

لا يتوفّر هذا الحدث إلا لمصادر بيانات التطبيقات.

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
screen_class string لا MainActivity فئة الشاشة.
screen_name string لا لمحة اسم الشاشة.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
search_term string نعم قمصان العبارة التي تم البحث عنها.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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 لا المنتج نوع المحتوى المحدّد
content_id string لا C_12345 معرّف للمحتوى الذي تمّ اختياره.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

select_item

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
item_list_id string لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

يتم تجاهله في حال ضبطه على مستوى السلعة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

يتم تجاهله في حال ضبطه على مستوى السلعة.
items Array<Item> نعم* تمثّل هذه السمة السلع الخاصة بالحدث.

* من المتوقّع أن تحتوي مصفوفة items على عنصر واحد يمثّل السلعة المحدّدة. إذا تم تقديم عناصر متعددة، سيتم استخدام العنصر الأول فقط في items.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
creative_name string لا summer_banner2 اسم تصميم الإعلان الترويجي.

يتم تجاهله في حال ضبطه على مستوى السلعة.
creative_slot string لا featured_app_1 اسم خانة تصميم الإعلان الترويجي المرتبط بالحدث.

يتم تجاهله في حال ضبطه على مستوى السلعة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالحدث.

يتم تجاهله في حال ضبطه على مستوى السلعة.
promotion_name string لا تخفيضات موسم الصيف اسم العرض الترويجي المرتبط بالحدث.

يتم تجاهله في حال ضبطه على مستوى السلعة.
items Array<Item> لا تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name string لا summer_banner2 اسم تصميم الإعلان الترويجي.

في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام creative_name على مستوى الحدث، إذا كانت متوفّرة.
creative_slot string لا featured_app_1 اسم خانة تصميم الإعلان الترويجي المرتبط بالسلعة.

في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام creative_slot على مستوى الحدث، إذا كانت متوفّرة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
item_category string لا ملابس فئة السلعة إذا تم استخدامها كجزء من تدرّج هرمي للفئات أو تصنيف، ستكون هذه هي الفئة الأولى.
item_category2 string لا للبالغين التدرّج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر
item_category3 string لا قمصان التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر
item_category4 string لا طاقم العمل التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر
item_category5 string لا كُم قصير التدرج الهرمي للفئة الخامسة أو التصنيفات الإضافية للعنصر
item_list_id string لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
promotion_id string لا P_12345 تمثّل هذه السمة معرّف العرض الترويجي المرتبط بالسلعة.

في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام promotion_id على مستوى الحدث، إذا كانت متوفّرة.
promotion_name string لا تخفيضات موسم الصيف اسم العرض الترويجي المرتبط بالسلعة.

في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام promotion_name على مستوى الحدث، إذا كانت متوفّرة.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

share

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
method string لا Twitter الطريقة التي تتم بها مشاركة المحتوى
content_type string لا الصورة نوع المحتوى الذي تتم مشاركته
item_id string لا C_12345 معرّف المحتوى المشترَك

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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"

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 نعم Gems اسم العملة الافتراضية.
item_name string لا Starter Boost اسم العنصر الذي يتم استخدام العملة الافتراضية فيه

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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"

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"

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"

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 نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* اضبط value على مجموع (price * quantity) لجميع المنتجات في items. لا تضمِّن shipping أو tax.
* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة السلع المرتبطة بالحدث، بتنسيق ISO 4217 المُكوَّن من 3 أحرف.

مقاييس القيمة في الحدث view_item لا تساهم في الإيرادات

* في حال ضبط value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
item_list_id string لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

يتم تجاهله في حال ضبطه على مستوى السلعة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

يتم تجاهله في حال ضبطه على مستوى السلعة.
items Array<Item> نعم تمثّل هذه السمة السلع الخاصة بالحدث.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
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 لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
creative_name string لا summer_banner2 اسم تصميم الإعلان الترويجي.

يتم تجاهله في حال ضبطه على مستوى السلعة.
creative_slot string لا featured_app_1 اسم خانة تصميم الإعلان الترويجي المرتبط بالحدث.

يتم تجاهله في حال ضبطه على مستوى السلعة.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالحدث.

يتم تجاهله في حال ضبطه على مستوى السلعة.
promotion_name string لا تخفيضات موسم الصيف اسم العرض الترويجي المرتبط بالحدث.

يتم تجاهله في حال ضبطه على مستوى السلعة.
items Array<Item> نعم* تمثّل هذه السمة السلع الخاصة بالحدث.

* من المتوقّع أن تتضمّن مصفوفة items عنصرًا واحدًا يمثّل السلعة المرتبطة بالعرض الترويجي. في حال تقديم عناصر متعدّدة، سيتم استخدام العنصر الأول فقط في items.

مَعلمات المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم* SKU_12345

معرّف السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب توفير إحدى السمتين item_id أو item_name.

affiliation string لا Google Store ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه
ملاحظة: لا تتوفّر السمة `affiliation` إلا على مستوى item-scope.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

تكون مَعلمات coupon على مستوى الحدث وعلى مستوى السلعة مستقلة.
creative_name string لا summer_banner2 اسم تصميم الإعلان الترويجي.

في حال ضبطها، يتم تجاهل creative_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام creative_name على مستوى الحدث، إذا كانت متوفّرة.
creative_slot string لا featured_app_1 اسم خانة تصميم الإعلان الترويجي المرتبط بالسلعة.

في حال ضبطها، يتم تجاهل creative_slot على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام creative_slot على مستوى الحدث، إذا كانت متوفّرة.
discount number لا 2.22 قيمة الخصم النقدي للوحدة المرتبطة بالسلعة.
index number لا 5 تمثّل هذه السمة فهرس/موضع السلعة في القائمة.
item_brand string لا Google العلامة التجارية للسلعة
item_category string لا ملابس فئة السلعة إذا تم استخدامها كجزء من تدرّج هرمي للفئات أو تصنيف، ستكون هذه هي الفئة الأولى.
item_category2 string لا للبالغين التدرّج الهرمي للفئة الثانية أو التصنيف الإضافي للعنصر
item_category3 string لا قمصان التدرج الهرمي للفئة الثالثة أو التصنيف الإضافي للعنصر
item_category4 string لا طاقم العمل التدرج الهرمي للفئة الرابعة أو التصنيف الإضافي للعنصر
item_category5 string لا كُم قصير التدرج الهرمي للفئة الخامسة أو التصنيفات الإضافية للعنصر
item_list_id string لا related_products رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_id على مستوى الحدث، إذا كانت متوفّرة.
item_list_name string لا المنتجات ذات الصلة اسم القائمة التي تم فيها عرض السلعة للمستخدِم

في حال ضبطها، يتم تجاهل item_list_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام item_list_name على مستوى الحدث، إذا كانت متوفّرة.
item_variant string لا أخضر صيغة السلعة أو رمز فريد أو وصف لمزيد من التفاصيل/خيارات السلعة
location_id string لا ChIJIQBpAG2ahYAR_6128GcTUEo (معرّف المكان على Google لمدينة سان فرانسيسكو) تمثّل هذه السمة الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر). ننصحك باستخدام معرّف مكان على Google الذي يتطابق مع السلعة المرتبطة. يمكن أيضًا استخدام رقم تعريف مخصّص للموقع الجغرافي.
ملاحظة: لا يتوفّر `location id` إلا على مستوى item-scope.
price number لا 10.01 تمثّل هذه السمة سعر الوحدة النقدية للسلعة، بوحدات عملة المَعلمة المحدّدة.
إذا كان الخصم ينطبق على السلعة، اضبط price على سعر الوحدة المخفَّض وحدِّد الخصم على سعر الوحدة في المَعلمة discount.
promotion_id string لا P_12345 تمثّل هذه السمة معرّف العرض الترويجي المرتبط بالسلعة.

في حال ضبطها، يتم تجاهل promotion_id على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام promotion_id على مستوى الحدث، إذا كانت متوفّرة.
promotion_name string لا تخفيضات موسم الصيف اسم العرض الترويجي المرتبط بالسلعة.

في حال ضبطها، يتم تجاهل promotion_name على مستوى الحدث.
في حال عدم ضبط هذه السياسة، يتم استخدام promotion_name على مستوى الحدث، إذا كانت متوفّرة.
quantity number لا 3

كمية السلعة

إذا لم يتم ضبطها، يتم ضبط quantity على 1.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_search_results

سجِّل هذا الحدث عندما يتم عرض نتائج البحث على المستخدم. يُرجى العِلم أنّه يمكنك تفعيل حدث view_search_results لجمعه تلقائيًا من خلال قياس الأحداث المحسّن في "إحصاءات Google".

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
search_term string لا ملابس العبارة المستخدَمة في البحث.

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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

working_lead

يقيس هذا الحدث عندما يتواصل المستخدم مع أحد الممثلين أو يتواصل ممثل معه.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
currency string نعم* دولار أمريكي تمثّل هذه السمة عملة value الفعالية، وتكون بالتنسيق ISO 4217 المكوّن من ثلاثة أحرف.

* في حال ضبط value، تكون مَعلمة currency مطلوبة لاحتساب مقاييس الأرباح بدقة.
value number نعم* 30.03 القيمة النقدية للحدث.

* تكون مَعلمة value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة value.
* يجب توفير currency في حال ضبط value.
lead_status string لا المحادثات التي بدأتها حالة العميل المحتمل

إرسال حدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات Google"

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": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});