الأحداث

translation: disabled

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

add_payment_info

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

المعلمات

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

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

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

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

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

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

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

*يجب تحديد إما item_id أو item_name.

item_name string نعم* قميص مُزيَّن بشخصيات كتاب Stan and Friends

اسم السلعة.

*يجب تحديد إما item_id أو item_name.

affiliation string لا Google Store ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
coupon string لا SUMMER_FUN اسم/رمز القسيمة المرتبط بالسلعة.

يمكن اعتبار معلمات coupon على مستوى الحدث وعلى مستوى العنصر مستقلّة.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 أحرف .

* في حال ضبط 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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 نعم* الدولار الأمريكي عملة السلع المرتبطة بالحدث، بعملة 3 أحرف ISO 4217

* في حال ضبط 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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر الحقل 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 نعم* الدولار الأمريكي عملة السلع المرتبطة بالحدث، بعملة 3 أحرف ISO 4217

* في حال ضبط 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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 نعم* الدولار الأمريكي عملة السلع المرتبطة بالحدث، بعملة 3 أحرف ISO 4217

* في حال ضبط 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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 المكوّن من 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 للحدث، بعملة 3 أحرف 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 للحدث، بعملة 3 أحرف 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 لا مجموعات تعليمات Gem اسم العملة الافتراضية.
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 للحدث، بعملة 3 أحرف 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 أحرف .

* في حال ضبط 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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 للحدث، بعملة 3 أحرف 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 نعم* الدولار الأمريكي عملة السلع المرتبطة بالحدث، بعملة 3 أحرف ISO 4217

* في حال ضبط 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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 نعم* الدولار الأمريكي عملة السلع المرتبطة بالحدث، بعملة 3 أحرف ISO 4217

* في حال ضبط 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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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({
    "client_id": "client_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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (مثل الموقع الجغرافي للمتجر) ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 نعم مجموعات تعليمات Gem اسم العملة الافتراضية.
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 نعم* الدولار الأمريكي عملة السلع المرتبطة بالحدث، بعملة 3 أحرف ISO 4217

* في حال ضبط 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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 نعم* الدولار الأمريكي عملة السلع المرتبطة بالحدث، بعملة 3 أحرف ISO 4217

* في حال ضبط 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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 المرتبط بالعنصر المعنيّ. يمكن أيضًا استخدام معرّف موقع جغرافي مخصّص.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 ارتباط منتج لتحديد الشركة المقدمة أو موقع المتجر الفعلي.
ملاحظة: لا يتوفّر "الارتباط" إلا على نطاق العنصر.
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 لمدينة سان فرانسيسكو) الموقع الجغرافي المرتبط بالسلعة (على سبيل المثال، الموقع الجغرافي) موقع المتجر). ويستحسن استخدام تقويم رقم تعريف المكان المناسب للسلعة المرتبطة موقع مخصص ويمكن أيضًا استخدام مستند تعريف الهوية.
ملاحظة: لا يتوفّر "معرّف الموقع الجغرافي" إلا على نطاق العنصر.
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 للحدث، بعملة 3 أحرف 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"
      }
    }]
  })
});