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

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

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

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

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

اگر از «پروتکل اندازه‌گیری» درحال ارتقا هستید، برای دریافت دستورالعمل‌ها، ارتقا از «پروتکل اندازه‌گیری» را بررسی کنید.

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

ad_impression

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

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

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

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

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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


{
  "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 نه پیوندنشان‌واره محتوای پویش مورداستفاده برای آزمایش آ/ب و آگهی‌های هدف‌یابی محتوا برای متمایز کردن آگهی‌ها یا پیوندهایی که به نشانی وب یکسانی اشاره می‌کنند.

مثال

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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


{
  "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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید حداکثر ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد add_to_cart بااستفاده از 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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید حداکثر ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد add_to_wishlist بااستفاده از 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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید حداکثر ۲۷ پارامتر سفارشی در آرایه items بگنجانید.

مثال

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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


{
  "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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید حداکثر ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد purchase بااستفاده از 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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید حداکثر ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد refund بااستفاده از 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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید حداکثر ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد remove_from_cart بااستفاده از 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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید حداکثر ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد select_item بااستفاده از 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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
promotion_id string نه P_12345 شناسه تبلیغات ویژه مرتبط با مورد.

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

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

مثال

مثال زیر نحوه ارسال رویداد select_promotion بااستفاده از 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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید حداکثر ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد view_cart بااستفاده از 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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید حداکثر ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد view_item بااستفاده از 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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
علاوه‌بر پارامترهای تجویز‌شده، می‌توانید حداکثر ۲۷ پارامتر سفارشی در آرایه items اضافه کنید.

مثال

مثال زیر نحوه ارسال رویداد view_item_list بااستفاده از 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 Place برای سانفرانسیسکو) مکان فیزیکی مرتبط با محصول (برای نمونه، مکان فیزیکی فروشگاه). توصیه می‌شود از شناسه مکان Google که با مورد منسوب مطابقت دارد استفاده کنید. شناسه مکان سفارشی نیز می‌تواند استفاده شود.
توجه: location_id فقط در سطح مورد دردسترس است.
promotion_id string نه P_12345 شناسه تبلیغات ویژه مرتبط با مورد.

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

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

مثال

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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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

میانای برنامه‌سازی کاربردی مدیر داده‌ها


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