الأحداث

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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 محتوى الحملة المستخدَم لاختبار أ/ب والإعلانات المستهدَفة حسب المحتوى من أجل تمييز الإعلانات أو الروابط التي تشير إلى عنوان 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 المكوّن من 3 أحرف.

* في حال ضبط 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 المكوّن من 3 أحرف.

* في حال ضبط 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 المكوّن من 3 أحرف.

* في حال ضبط 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 المكوّن من 3 أحرف.

* في حال ضبط 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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 المكوّن من 3 أحرف.

* في حال ضبط 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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 لا ميزة "التحسين المبدئي" اسم السلعة التي يتم استخدام العملة الافتراضية فيها.

إرسال الحدث

تجربة هذا الحدث في "أداة إنشاء الأحداث" في "إحصاءات 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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 إلا على مستوى السلعة.
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 المكوّن من 3 أحرف.

* في حال ضبط 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"
      }
    }]
  })
});