رویدادهای توصیه‌شده Google Analytics

فهرست زیر رویدادهای توصیه‌شده را نشان می‌دهد. همچنین می‌توانید رویدادهای سفارشی خودتان را ایجاد و ارسال کنید.

هنگام ایجاد نام‌های رویداد سفارشی، باید:

  1. قوانین نام‌گذاری رویداد را دنبال کنید.
  2. از نام‌ها و پیشوندهای رزروشده اجتناب کنید.
  3. محدودیت‌های مجموعه رویداد را رعایت کنید، مثلاً محدودیت ۴۰ نویسه‌ای برای نام رویداد و پارامتر.

برای جزئیات، شروع به کار را بررسی کنید.

اگر از Measurement Protocol ارتقا می‌دهید، برای دریافت دستورالعمل‌ها به ارتقا دادن از Measurement Protocol مراجعه کنید.

برای همه دارایی‌ها

ad_impression

این رویداد فقط برای جاری‌سازی‌های برنامه دردسترس است.

وقتی کاربر ظهور آگهی را می‌بیند، از این رویداد استفاده کنید.

  • ad_impression ارسال‌شده بااستفاده از «پروتکل اندازه‌گیری» در صادر کردن به پلاتفرم‌های تبلیغاتی دیگر مثل Google Ads گنجانده نخواهد شد.
  • ارسال رویدادهای ad_impression بااستفاده از Measurement Protocol می‌تواند باعث ایجاد ظهورهای تکراری شود، اگر برچسب‌گذاری یا کیت توسعه نرم‌افزار را برای محصولات تبلیغاتی Google پیوندشده‌تان پیکربندی کرده باشید. فقط درصورتی رویداد ad_impression را بااستفاده از Measurement Protocol ارسال کنید که رویداد توسط برچسب‌گذاری یا SDK ضبط نشده باشد.

فیلدهای رویداد

نام نوع الزامی مقدار نمونه شرح
currency string نه ‫۲٫۷۹ واحد پول موارد مرتبط با رویداد، در قالب ۳ حرفی ISO 4217.

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد خالص لازم است.
conversion_value number نه ۳.۹۹
مقدار ظهور آگهی.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است.
* اگر conversion_value را تنظیم کنید، currency الزامی است.

پارامترها

نام نوع الزامی مقدار نمونه شرح
ad_platform string نه MoPub پلاتفرم آگهی.
ad_source string نه AdColony منبع آگهی.
ad_format string نه برنما قالب آگهی.
ad_unit_name string نه Banner_03 نام واحد آگهی.

مثال

مثال زیر نحوه ارسال رویداد ad_impression را بااستفاده از 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 ارسال کرد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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 نشان می‌دهد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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 نشان می‌دهد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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 نشان می‌دهد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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 نشان می‌دهد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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 نشان می‌دهد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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 بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترها

نام نوع الزامی مقدار نمونه شرح
method string نه Twitter روشی که محتوا هم‌رسانی می‌شود.
content_type string نه تصویر نوع محتوای هم‌رسانی‌شده.

مثال

مثال زیر نحوه ارسال رویداد share را بااستفاده از 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 نشان می‌دهد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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 بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترهای مورد

نام نوع الزامی مقدار نمونه شرح
item_name string نه تقویت‌کننده آغازین نام موردی که ارز مجازی برای آن استفاده می‌شود.

پارامترها

نام نوع الزامی مقدار نمونه شرح
virtual_currency_name string بله Gems نام ارز مجازی.

مثال

مثال زیر نشان می‌دهد که چگونه می‌توان رویداد spend_virtual_currency را بااستفاده از 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 نشان می‌دهد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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 نشان می‌دهد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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 Analytics فعال کنید.

پارامترها

نام نوع الزامی مقدار نمونه شرح
search_term string نه پوشاک عبارت مورداستفاده برای جستجو.

مثال

مثال زیر نحوه ارسال رویداد view_search_results را بااستفاده از 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 نه هزینه بر کلیک (CPC) رسانه پویش (مثلاً ایمیل، کلیک‌بها، و غیره)
term string نه سفر+تابستانی عبارت پویش که با جستجوی پولی برای ارائه کلیدواژه‌های آگهی‌ها استفاده می‌شود.
content string نه پیوند نشان‌واره محتوای پویش که برای آزمایش A/B و آگهی‌های هدف‌یابی‌شده براساس محتوا استفاده می‌شود تا آگهی‌ها یا پیوندهایی را که به یک نشانی وب اشاره می‌کنند متمایز کند.

مثال

مثال زیر نحوه ارسال رویداد campaign_details را بااستفاده از 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.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت نمی‌کنند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
conversion_value number بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value را روی مجموع (price * quantity) برای همه موارد در items تنظیم کنید. shipping یا tax را اضافه نکنید.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
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 بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترها

نام نوع الزامی مقدار نمونه شرح
payment_type string نه کارت اعتباری روش پرداخت انتخابی.

مثال

مثال زیر نحوه ارسال رویداد add_payment_info را بااستفاده از 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.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت نمی‌کنند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
conversion_value number بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value را روی مجموع (price * quantity) برای همه موارد در items تنظیم کنید. ‫shipping یا tax را اضافه نکنید.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
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 بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترها

نام نوع الزامی مقدار نمونه شرح
shipping_tier string نه زمین سطح ارسال (مثلاً Ground، Air، Next-day) انتخاب‌شده برای تحویل محصول خریداری‌شده.

مثال

مثال زیر نحوه ارسال رویداد add_shipping_info را بااستفاده از 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.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت نمی‌کنند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
conversion_value number بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value را روی مجموع (price * quantity) برای همه موارد در items تنظیم کنید. ‫shipping یا tax را اضافه نکنید.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
cart_data.items Item[] بله موارد رویداد.

فیلد cart_data.items را در شیء Event تنظیم کنید.

فیلدهای مورد

نام نوع الزامی مقدار نمونه شرح
item_id string بله I_12345 شناسه یکتای مورد. فیلد item_id را در شیء Item تنظیم کنید.
unit_price number بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترهای مورد

نام نوع الزامی مقدار نمونه شرح
item_name string بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد add_to_cart را بااستفاده از 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.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت نمی‌کنند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
conversion_value number بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value را روی مجموع (price * quantity) برای همه موارد در items تنظیم کنید. ‫shipping یا tax را اضافه نکنید.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
cart_data.items Item[] بله موارد رویداد.

فیلد cart_data.items را در شیء Event تنظیم کنید.

فیلدهای مورد

نام نوع الزامی مقدار نمونه شرح
item_id string بله I_12345 شناسه یکتای مورد. فیلد item_id را در شیء Item تنظیم کنید.
unit_price number بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترهای مورد

نام نوع الزامی مقدار نمونه شرح
item_name string بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد add_to_wishlist را بااستفاده از 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.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت ندارند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
conversion_value number بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value را روی مجموع (price * quantity) برای همه موارد در items تنظیم کنید. ‫shipping یا tax را اضافه نکنید.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
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 بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترهای مورد

نام نوع الزامی مقدار نمونه شرح
item_name string بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد begin_checkout را بااستفاده از 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 بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
transaction_id string نه T_12345 شناسه یکتای تراکنش.

پارامتر transaction_id به شما کمک می‌کند از دریافت رویدادهای تکراری برای خرید جلوگیری کنید. فیلد transaction_id را در شیء Event تنظیم کنید.
cart_data.items Item[] نه موارد رویداد.

فیلد cart_data.items را در شیء Event تنظیم کنید.

فیلدهای مورد

نام نوع الزامی مقدار نمونه شرح
item_id string بله I_12345 شناسه یکتای مورد. فیلد item_id را در شیء Item تنظیم کنید.
unit_price number بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
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 نشان می‌دهد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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",
      "transactionId": "T_12345",
      "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,
        "transaction_id": "T_12345",
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

این رویداد زمانی را نشان می‌دهد که یک یا چند مورد توسط کاربر خریداری شده است.

فیلدهای رویداد

نام نوع الزامی مقدار نمونه شرح
currency string بله* ‫۲٫۷۹ واحد پول موارد مرتبط با رویداد، در قالب ۳ حرفی ISO 4217.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت ندارند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
conversion_value number بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value را روی مجموع (price * quantity) برای همه موارد در items تنظیم کنید. ‫shipping یا tax را اضافه نکنید.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
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 بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترها

نام نوع الزامی مقدار نمونه شرح
shipping number نه ۳٫۳۳ هزینه ارسال مرتبط با تراکنش.
tax number نه ‫۱-۱۱ هزینه مالیات مرتبط با تراکنش.

پارامترهای مورد

نام نوع الزامی مقدار نمونه شرح
item_name string بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد purchase را بااستفاده از 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.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت نمی‌کنند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
conversion_value number بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value را روی مجموع (price * quantity) برای همه موارد در items تنظیم کنید. ‫shipping یا tax را اضافه نکنید.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
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 بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترها

نام نوع الزامی مقدار نمونه شرح
shipping number نه ۳٫۳۳ هزینه ارسال مرتبط با تراکنش.
tax number نه ‫۱-۱۱ هزینه مالیات مرتبط با تراکنش.

پارامترهای مورد

نام نوع الزامی مقدار نمونه شرح
item_name string بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد refund را بااستفاده از 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.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت نمی‌کنند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
conversion_value number بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value را روی مجموع (price * quantity) برای همه موارد در items تنظیم کنید. ‫shipping یا tax را اضافه نکنید.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
cart_data.items Item[] بله موارد رویداد.

فیلد cart_data.items را در شیء Event تنظیم کنید.

فیلدهای مورد

نام نوع الزامی مقدار نمونه شرح
item_id string بله I_12345 شناسه یکتای مورد. فیلد item_id را در شیء Item تنظیم کنید.
unit_price number بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترهای مورد

نام نوع الزامی مقدار نمونه شرح
item_name string بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد remove_from_cart را بااستفاده از 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 بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد select_item را بااستفاده از 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 بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
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 بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
creative_name string نه summer_banner2 نام متن آگهی تبلیغاتی.

اگر تنظیم نشده باشد، به‌طور پیش‌فرض روی سطح رویداد creative_name تنظیم می‌شود.
creative_slot string نه featured_app_1 نام جای متن آگهی تبلیغاتی مرتبط با مورد.

اگر تنظیم نشده باشد، به‌طور پیش‌فرض روی سطح رویداد creative_slot تنظیم می‌شود.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
promotion_id string نه P_12345 شناسه تبلیغ مرتبط با مورد.

اگر تنظیم نشده باشد، به‌طور پیش‌فرض روی سطح رویداد promotion_id تنظیم می‌شود.
promotion_name string نه حراج تابستانی نام تبلیغ مرتبط با مورد.

اگر تنظیم نشده باشد، به‌طور پیش‌فرض روی سطح رویداد promotion_name تنظیم می‌شود.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد select_promotion را بااستفاده از 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.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت نمی‌کنند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
conversion_value number بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value را روی مجموع (price * quantity) برای همه موارد در items تنظیم کنید. ‫shipping یا tax را اضافه نکنید.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
cart_data.items Item[] بله موارد رویداد.

فیلد cart_data.items را در شیء Event تنظیم کنید.

فیلدهای مورد

نام نوع الزامی مقدار نمونه شرح
item_id string بله I_12345 شناسه یکتای مورد. فیلد item_id را در شیء Item تنظیم کنید.
unit_price number بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترهای مورد

نام نوع الزامی مقدار نمونه شرح
item_name string بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد view_cart را بااستفاده از 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.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت نمی‌کنند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
conversion_value number بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value را روی مجموع (price * quantity) برای همه موارد در items تنظیم کنید. ‫shipping یا tax را اضافه نکنید.
* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.
cart_data.items Item[] بله موارد رویداد.

فیلد cart_data.items را در شیء Event تنظیم کنید.

فیلدهای مورد

نام نوع الزامی مقدار نمونه شرح
item_id string بله I_12345 شناسه یکتای مورد. فیلد item_id را در شیء Item تنظیم کنید.
unit_price number بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترهای مورد

نام نوع الزامی مقدار نمونه شرح
item_name string بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد view_item را بااستفاده از 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.

* سنجه‌های مقدار در رویداد view_item در درآمد مشارکت نمی‌کنند

* اگر conversion_value را تنظیم کنید، currency برای محاسبه دقیق سنجه‌های درآمد لازم است.
cart_data.items Item[] بله موارد رویداد.

فیلد cart_data.items را در شیء Event تنظیم کنید.

فیلدهای مورد

نام نوع الزامی مقدار نمونه شرح
item_id string بله I_12345 شناسه یکتای مورد. فیلد item_id را در شیء Item تنظیم کنید.
unit_price number بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
quantity number بله 1 تعداد واحدهای خریداری‌شده برای این مورد خاص.

پارامترهای مورد

نام نوع الزامی مقدار نمونه شرح
item_name string بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد view_item_list را بااستفاده از 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 بله ۲۷٫۶۷ قیمت واحد بدون احتساب مالیات، ارسال، و تخفیف‌های رویدادمحور (سطح تراکنش) برای این مورد.

اگر کالا تخفیف کالامحور دارد، از قیمت واحد تخفیف‌خورده استفاده کنید. برای مثال، اگر قیمت واحد محصولی ۲۷٫۶۷ و تخفیف واحد آن ۶٫۶۶ باشد، unitPrice را روی ۲۱٫۰۱ تنظیم کنید.
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 بله* تی‌شرت استن و دوستان

نام مورد.

*یکی از item_id یا item_name لازم است.

affiliation string نه Google Store وابستگی محصول برای مشخص کردن مکان شرکت تأمین‌کننده یا فروشگاه غیرمجازی.
توجه: affiliation فقط در گستره کالا دردسترس است.
coupon string نه SUMMER_FUN نام/کد کوپن مرتبط با مورد.

پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
creative_name string نه summer_banner2 نام متن آگهی تبلیغاتی.

اگر تنظیم نشده باشد، به‌طور پیش‌فرض روی سطح رویداد creative_name تنظیم می‌شود.
creative_slot string نه featured_app_1 نام جای متن آگهی تبلیغاتی مرتبط با مورد.

اگر تنظیم نشده باشد، به‌طور پیش‌فرض روی سطح رویداد creative_slot تنظیم می‌شود.
discount number نه ۲٫۲۲ مقدار تخفیف پولی واحد مرتبط با مورد.
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 فقط در گستره کالا دردسترس است.
promotion_id string نه P_12345 شناسه تبلیغ مرتبط با مورد.

اگر تنظیم نشده باشد، به‌طور پیش‌فرض روی سطح رویداد promotion_id تنظیم می‌شود.
promotion_name string نه حراج تابستانی نام تبلیغ مرتبط با مورد.

اگر تنظیم نشده باشد، به‌طور پیش‌فرض روی سطح رویداد promotion_name تنظیم می‌شود.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید تا ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد view_promotion را بااستفاده از 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 نه بازیکن ۱ شخصیتی که سطحش ارتقا یافته است.

مثال

مثال زیر نحوه ارسال رویداد level_up را بااستفاده از 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 بله ۱۰۰۰۰ امتیاز برای پست کردن.
level number نه 5 سطح امتیاز.
character string نه بازیکن ۱ شخصیتی که امتیاز را کسب کرده است.

مثال

مثال زیر نحوه ارسال رویداد post_score را بااستفاده از 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 نشان می‌دهد. اگر از «پروتکل اندازه‌گیری» ارتقا می‌دهید، از برگه‌ها برای انتقال درخواست‌هایتان به 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 بله* ۳۰٫۰۳ ارزش پولی رویداد.

* معمولاً conversion_value برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.

مثال

مثال زیر نحوه ارسال رویداد close_convert_lead را بااستفاده از 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 بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.

پارامترها

نام نوع الزامی مقدار نمونه شرح
unconvert_lead_reason string نه هرگز پاسخ نداده است دلیل تبدیل نشدن مشتری بالقوه.

مثال

مثال زیر نحوه ارسال رویداد close_unconvert_lead را بااستفاده از 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 بله* ۳۰٫۰۳ ارزش پولی رویداد.

* conversion_value معمولاً برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.

پارامترها

نام نوع الزامی مقدار نمونه شرح
disqualified_lead_reason string نه قصد خرید ندارم دلیل علامت‌گذاری مشتری بالقوه به‌عنوان فاقد صلاحیت.

مثال

مثال زیر نحوه ارسال رویداد disqualify_lead را بااستفاده از 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 بله* ۳۰٫۰۳ ارزش پولی رویداد.

* معمولاً conversion_value برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.

پارامترها

نام نوع الزامی مقدار نمونه شرح
lead_source string نه نمایشگاه تجاری منبع مشتری بالقوه.

مثال

مثال زیر نحوه ارسال رویداد generate_lead را بااستفاده از 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 بله* ۳۰٫۰۳ ارزش پولی رویداد.

* معمولاً conversion_value برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.

مثال

مثال زیر نحوه ارسال رویداد qualify_lead را بااستفاده از 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 بله* ۳۰٫۰۳ ارزش پولی رویداد.

* معمولاً conversion_value برای گزارش‌دهی معنادار لازم است. اگر رویداد را به‌عنوان رویداد کلیدی علامت‌گذاری کنید، توصیه می‌شود conversion_value را تنظیم کنید.
* اگر conversion_value را تنظیم کنید، currency الزامی است.

پارامترها

نام نوع الزامی مقدار نمونه شرح
lead_status string نه مکالمه‌های شروع‌شده وضعیت مشتری بالقوه.

مثال

مثال زیر نحوه ارسال رویداد working_lead را بااستفاده از 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"
      }
    }]
  })
});