الأحداث المقترَحة في "إحصاءات Google"

في ما يلي قائمة بالأحداث المقترَحة. يمكنك أيضًا إنشاء أحداث مخصّصة وإرسالها.

عند إنشاء أسماء أحداث مخصّصة، يجب اتّباع ما يلي:

  1. اتّبِع قواعد تسمية الأحداث.
  2. تجنَّب الأسماء والبادئات المحجوزة.
  3. الالتزام بحدود جمع الأحداث، مثل الحدّ الأقصى البالغ 40 حرفًا لأسماء الأحداث والمَعلمات

اطّلِع على مقالة البدء لمعرفة التفاصيل.

إذا كنت بصدد الترقية من Measurement Protocol، اطّلِع على الترقية من Measurement Protocol للحصول على التعليمات.

بالنسبة إلى جميع المواقع

ad_impression

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

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

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

حقول الأحداث

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

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

المعلمات

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

مثال

يوضّح المثال التالي كيفية إرسال حدث ad_impression باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

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

earn_virtual_currency

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

حقول الأحداث

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

المعلمات

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

مثال

يوضّح المثال التالي كيفية إرسال حدث earn_virtual_currency باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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

join_group

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

المعلمات

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

مثال

يوضّح المثال التالي كيفية إرسال حدث join_group باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

login

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

المعلمات

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

مثال

يوضّح المثال التالي كيفية إرسال حدث login باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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

screen_view

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

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

المعلمات

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

مثال

يوضّح المثال التالي كيفية إرسال حدث screen_view باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

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 نعم قمصان العبارة التي تم البحث عنها.

مثال

يوضّح المثال التالي كيفية إرسال حدث search باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

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 معرّف للمحتوى الذي تمّ اختياره. يجب أن تتضمّن القيمة حرفًا واحدًا على الأقل غير رقمي.

مثال

يوضّح المثال التالي كيفية إرسال حدث select_content باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

share

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

حقول الأحداث

الاسم النوع مطلوب مثال على القيمة الوصف
cart_data.items Item[] لا تمثّل هذه السمة السلع الخاصة بالحدث.

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

المعلمات

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

مثال

يوضّح المثال التالي كيفية إرسال حدث share باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

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 الطريقة المستخدَمة للاشتراك

مثال

يوضّح المثال التالي كيفية إرسال حدث sign_up باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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

يقيس هذا الحدث مبيعات السلع الافتراضية في تطبيقك ويساعدك في تحديد السلع الافتراضية الأكثر شيوعًا.

حقول الأحداث

الاسم النوع مطلوب مثال على القيمة الوصف
conversion_value number نعم 5 قيمة العملة الافتراضية.
cart_data.items Item[] لا تمثّل هذه السمة السلع الخاصة بالحدث.

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string لا Starter Boost اسم العنصر الذي يتم استخدام العملة الافتراضية فيه

المعلمات

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

مثال

يوضّح المثال التالي كيفية إرسال حدث spend_virtual_currency باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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 لمعرفة عدد المستخدمين الذين يكملون الدليل التعليمي.

المعلمات

لا يتم اقتراح أيّ مَعلمات لهذا الحدث.

مثال

يوضّح المثال التالي كيفية إرسال حدث tutorial_begin باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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 لمعرفة عدد المستخدمين الذين يكملون البرنامج التعليمي.

المعلمات

لا يتم اقتراح أيّ مَعلمات لهذا الحدث.

مثال

يوضّح المثال التالي كيفية إرسال حدث tutorial_complete باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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

view_search_results

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

المعلمات

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

مثال

يوضّح المثال التالي كيفية إرسال حدث view_search_results باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

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

campaign_details

استخدِم هذا الحدث لإرسال تفاصيل الحملة التي سيتم تطبيقها على الأحداث التي تتضمّن طابعًا زمنيًا أكبر من الطابع الزمني للحدث 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 نفسه

مثال

يوضّح المثال التالي كيفية إرسال حدث campaign_details باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

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

المبيعات على الإنترنت

add_payment_info

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

حقول الأحداث

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

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

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

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

اضبط الحقل cart_data.items على العنصر Event.
cart_data.coupon_codes string[] لا SUMMER_FUN رمز القسيمة المرتبط بالحدث.


اضبط الحقل coupon_codes على العنصر CartData.
* لا تقدّم سوى رمز قسيمة واحد في هذه القائمة.
* هذا مستقل عن رموز القسائم على مستوى السلعة.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

المعلمات

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

مثال

يوضّح المثال التالي كيفية إرسال حدث add_payment_info باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

حقول الأحداث

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

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

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

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

اضبط الحقل cart_data.items على العنصر Event.
cart_data.coupon_codes string[] لا SUMMER_FUN رمز القسيمة المرتبط بالحدث.


اضبط الحقل coupon_codes على العنصر CartData.
* لا تقدّم سوى رمز قسيمة واحد في هذه القائمة.
* هذا مستقل عن رموز القسائم على مستوى السلعة.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
shipping_tier string لا أرض فئة الشحن (مثل Ground أو Air أو Next-day) التي تم اختيارها لتوصيل السلعة المشتراة.

مثال

يوضّح المثال التالي كيفية إرسال حدث add_shipping_info باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

حقول الأحداث

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

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

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

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

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث add_to_cart باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

حقول الأحداث

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

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

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

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

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث add_to_wishlist باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

حقول الأحداث

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

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

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

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

اضبط الحقل cart_data.items على العنصر Event.
cart_data.coupon_codes string[] لا SUMMER_FUN رمز القسيمة المرتبط بالحدث.


اضبط الحقل coupon_codes على العنصر CartData.
* لا تقدّم سوى رمز قسيمة واحد في هذه القائمة.
* هذا مستقل عن رموز القسائم على مستوى السلعة.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث begin_checkout باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

in_app_purchase

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

استخدِم هذا الحدث عندما يُجري المستخدم عملية شراء داخل التطبيق.

حقول الأحداث

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

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

* تكون مَعلمة conversion_value مطلوبة عادةً لإعداد تقارير ذات مغزى. في حال وضع علامة على الحدث كحدث رئيسي، يُنصح بتحديد قيمة conversion_value.
* يجب توفير currency إذا ضبطت conversion_value.
cart_data.items Item[] لا تمثّل هذه السمة السلع الخاصة بالحدث.

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
product_id string لا ABC123456789 معرّف المنتج.
subscription boolean لا صحيح

تشير هذه السمة إلى ما إذا كان الشراء عبارة عن اشتراك.
إذا لم يتم ضبطها، تكون القيمة التلقائية false.
free_trial boolean لا صحيح

تشير إلى ما إذا كان الحدث مرتبطًا بفترة تجريبية مجانية من الاشتراك.
إذا لم يتم ضبطها، تكون القيمة التلقائية false.
price_is_discounted boolean لا خطأ

تُستخدَم لتحديد ما إذا كان سعر price مخفَّضًا.
إذا لم يتم ضبطها، تكون القيمة التلقائية false.

مثال

يوضّح المثال التالي كيفية إرسال حدث in_app_purchase باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

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":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

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

حقول الأحداث

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

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

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

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

تساعدك المَعلمة transaction_id في تجنّب الحصول على أحداث مكرّرة لعملية شراء. اضبط الحقل transaction_id على العنصر Event.
user_properties.customer_type CustomerType لا NEW تُستخدَم لتحديد ما إذا كانت الإحالة الناجحة من عميل NEW أو RETURNING.
cart_data.items Item[] نعم تمثّل هذه السمة السلع الخاصة بالحدث.

اضبط الحقل cart_data.items على العنصر Event.
cart_data.coupon_codes string[] لا SUMMER_FUN رمز القسيمة المرتبط بالحدث.


اضبط الحقل coupon_codes على العنصر CartData.
* لا تقدّم سوى رمز قسيمة واحد في هذه القائمة.
* هذا مستقل عن رموز القسائم على مستوى السلعة.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
shipping number لا 3.33 تكلفة الشحن المرتبطة بمعاملة معيّنة.
tax number لا 1.11 تكلفة الضريبة المرتبطة بمعاملة معيّنة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث purchase باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

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

حقول الأحداث

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

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

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

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

اضبط الحقل cart_data.items على العنصر Event.
cart_data.coupon_codes string[] لا SUMMER_FUN رمز القسيمة المرتبط بالحدث.


اضبط الحقل coupon_codes على العنصر CartData.
* لا تقدّم سوى رمز قسيمة واحد في هذه القائمة.
* هذا مستقل عن رموز القسائم على مستوى السلعة.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
shipping number لا 3.33 تكلفة الشحن المرتبطة بمعاملة معيّنة.
tax number لا 1.11 تكلفة الضريبة المرتبطة بمعاملة معيّنة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث refund باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

حقول الأحداث

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

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

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

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

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث remove_from_cart باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_item

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

حقول الأحداث

الاسم النوع مطلوب مثال على القيمة الوصف
cart_data.items Item[] نعم* تمثّل هذه السمة السلع الخاصة بالحدث.

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

اضبط الحقل cart_data.items على العنصر Event.

المعلمات

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

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

يتم تجاهله في حال ضبطه على مستوى السلعة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث select_item باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

حقول الأحداث

الاسم النوع مطلوب مثال على القيمة الوصف
cart_data.items Item[] لا تمثّل هذه السمة السلع الخاصة بالحدث.

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
creative_name string لا summer_banner2 اسم تصميم الإعلان الترويجي.
creative_slot string لا featured_app_1 اسم خانة تصميم الإعلان الترويجي المرتبط بالحدث.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالحدث.
promotion_name string لا تخفيضات الصيف اسم العرض الترويجي المرتبط بالحدث.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

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

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

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

يتم تلقائيًا استخدام promotion_name على مستوى الحدث في حال عدم ضبطه.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

يوضّح المثال التالي كيفية إرسال حدث select_promotion باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

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

حقول الأحداث

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

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

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

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

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث view_cart باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

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

حقول الأحداث

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

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

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

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

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث view_item باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

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

حقول الأحداث

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

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

* في حال ضبط conversion_value، تكون currency مطلوبة لاحتساب مقاييس الإيرادات بدقة.
cart_data.items Item[] نعم تمثّل هذه السمة السلع الخاصة بالحدث.

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث view_item_list باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

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

حقول الأحداث

الاسم النوع مطلوب مثال على القيمة الوصف
cart_data.items Item[] نعم* تمثّل هذه السمة السلع الخاصة بالحدث.

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

اضبط الحقل cart_data.items على العنصر Event.

حقول المنتجات

الاسم النوع مطلوب مثال على القيمة الوصف
item_id string نعم I_12345 تمثّل هذه السمة معرّفًا فريدًا للسلعة. اضبط الحقل item_id على العنصر Item.
unit_price number نعم 27.67 سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو الخصومات على مستوى الحدث (المعاملة) لهذه السلعة.

إذا كانت السلعة تتضمّن خصمًا على مستوى السلعة، استخدِم سعر الوحدة المخفَّض. على سبيل المثال، إذا كان سعر الوحدة 27.67 والخصم على الوحدة 6.66، اضبط unitPrice على 21.01.
quantity number نعم 1 كمية الوحدات التي تم شراؤها من هذه السلعة المحدّدة.

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
creative_name string لا summer_banner2 اسم تصميم الإعلان الترويجي.
creative_slot string لا featured_app_1 اسم خانة تصميم الإعلان الترويجي المرتبط بالحدث.
promotion_id string لا P_12345 معرّف العرض الترويجي المرتبط بالحدث.
promotion_name string لا تخفيضات الصيف اسم العرض الترويجي المرتبط بالحدث.

مَعلمات المنتج أو الخدمة

الاسم النوع مطلوب مثال على القيمة الوصف
item_name string نعم* قميص Stan and Friends

اسم السلعة.

*يجب ملء أحد الحقلَين item_id أو item_name.

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

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

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

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

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

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

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

يتم تلقائيًا استخدام promotion_name على مستوى الحدث في حال عدم ضبطه.
بالإضافة إلى المَعلمات المحدّدة، يمكنك تضمين ما يصل إلى 27 مَعلمة مخصّصة في مصفوفة items.

مثال

يوضّح المثال التالي كيفية إرسال حدث view_promotion باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

الألعاب

level_up

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
level number لا 5 مستوى الشخصية
character string لا اللاعب 1 تمثّل هذه السمة الشخصية التي انتقلت إلى مستوى أعلى.

مثال

يوضّح المثال التالي كيفية إرسال حدث level_up باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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

post_score

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
score number نعم 10000 النتيجة المطلوب نشرها.
level number لا 5 مستوى النتيجة
character string لا اللاعب 1 الشخصية التي حقّقت النتيجة

مثال

يوضّح المثال التالي كيفية إرسال حدث post_score باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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

unlock_achievement

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
achievement_id string نعم A_12345 رقم تعريف الإنجاز الذي تم فتحه.

مثال

يوضّح المثال التالي كيفية إرسال حدث unlock_achievement باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

إنشاء قوائم العملاء المحتملِين

close_convert_lead

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

  • ملاحظة: لتتبُّع عملية اكتساب العملاء المحتملين الأوّلية، مثل عمليات إرسال النماذج أو الاشتراك في النشرة الإخبارية أو طلبات العروض التوضيحية، استخدِم حدث generate_lead.

حقول الأحداث

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث close_convert_lead باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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

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

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
unconvert_lead_reason string لا لم يتم الردّ مطلقًا يشير ذلك إلى سبب عدم إجراء العميل المحتمل لإحالة ناجحة.

مثال

يوضّح المثال التالي كيفية إرسال حدث close_unconvert_lead باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

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

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

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
disqualified_lead_reason string لا لا أريد شراء أي منتج يشير ذلك إلى سبب تصنيف عميل مهتم على أنّه غير مؤهَّل.

مثال

يوضّح المثال التالي كيفية إرسال حدث disqualify_lead باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

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

generate_lead

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

حقول الأحداث

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

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

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
lead_source string لا المعرض التجاري تمثّل هذه السمة مصدر العميل المحتمل.

مثال

يوضّح المثال التالي كيفية إرسال حدث generate_lead باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

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

qualify_lead

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

حقول الأحداث

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

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

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

مثال

يوضّح المثال التالي كيفية إرسال حدث qualify_lead باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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

working_lead

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

حقول الأحداث

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

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

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

المعلمات

الاسم النوع مطلوب مثال على القيمة الوصف
lead_status string لا المحادثات التي بدأتها تمثّل هذه السمة حالة العميل المحتمل.

مثال

يوضّح المثال التالي كيفية إرسال حدث working_lead باستخدام Data Manager API. إذا كنت بصدد الترقية من Measurement Protocol، استخدِم علامات التبويب لنقل طلباتك إلى Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

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