در زیر فهرستی از رویدادهای توصیهشده آمده است. همچنین میتوانید رویدادهای سفارشی خودتان را ایجاد و ارسال کنید.
هنگام ایجاد نامهای رویداد سفارشی، باید:
- قوانین نامگذاری رویداد را دنبال کنید.
- از نامها و پیشوندهای رزروشده اجتناب کنید.
- در محدودیتهای جمعآوری رویداد، مانند محدودیت ۴۰ نویسه برای نام رویداد و پارامتر، بمانید.
برای جزئیات، شروع بهکار را بررسی کنید.
اگر از «پروتکل اندازهگیری» درحال ارتقا هستید، برای دریافت دستورالعملها، ارتقا از «پروتکل اندازهگیری» را بررسی کنید.
برای همه داراییها
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 |
نه | روش استفادهشده برای ورود به سیستم. |
مثال
مثال زیر نحوه ارسال رویداد 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
این رویداد را ثبت کنید تا نشان دهید کاربر چه زمانی جستجو انجام داده است. میتوانید از این رویداد برای شناسایی آنچه کاربران در وبسایت یا برنامه شما جستجو میکنند استفاده کنید. برای مثال، میتوانید این رویداد را زمانی ارسال کنید که کاربر پساز انجام جستجو، صفحه نتایج جستجو را مشاهده میکند.
پارامترها
| نام | نوع | الزامی | مقدار نمونه | شرح |
|---|---|---|---|---|
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 |
نه | روشی که محتوا با آن همرسانی میشود. | |
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 |
نه | روش استفادهشده برای ثبتنام. |
مثال
مثال زیر نحوه ارسال رویداد 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، ایمیل، و غیره). | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
affiliation |
string |
نه | Google Store |
وابستگی محصول برای مشخص کردن مکان شرکت تأمینکننده یا فروشگاه غیرمجازی. توجه: affiliation فقط در سطح مورد دردسترس است.
|
coupon |
string |
نه | SUMMER_FUN | نام/کد تخفیف مرتبط با مورد. پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
|
discount |
number |
نه | ۲.۲۲ | مقدار تخفیف پولی واحد مرتبط با محصول. |
index |
number |
نه | 5 | نمایه/موقعیت مورد در فهرست. |
item_brand |
string |
نه | نمانام مورد. | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
affiliation |
string |
نه | Google Store |
وابستگی محصول برای مشخص کردن مکان شرکت تأمینکننده یا فروشگاه غیرمجازی. توجه: affiliation فقط در سطح مورد دردسترس است.
|
coupon |
string |
نه | SUMMER_FUN | نام/کد تخفیف مرتبط با مورد. پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
|
discount |
number |
نه | ۲.۲۲ | مقدار تخفیف پولی واحد مرتبط با محصول. |
index |
number |
نه | 5 | نمایه/موقعیت مورد در فهرست. |
item_brand |
string |
نه | نمانام مورد. | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
affiliation |
string |
نه | Google Store |
وابستگی محصول برای مشخص کردن مکان شرکت تأمینکننده یا فروشگاه غیرمجازی. توجه: affiliation فقط در سطح مورد دردسترس است.
|
coupon |
string |
نه | SUMMER_FUN | نام/کد تخفیف مرتبط با مورد. پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
|
discount |
number |
نه | ۲.۲۲ | مقدار تخفیف پولی واحد مرتبط با محصول. |
index |
number |
نه | 5 | نمایه/موقعیت مورد در فهرست. |
item_brand |
string |
نه | نمانام مورد. | |
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 |
نه | درست |
نشان میدهد که آیا خرید اشتراک است یا خیر.
|
free_trial |
boolean |
نه | درست |
نشان میدهد که آیا رویداد برای دوره آزمایشی رایگان اشتراک است یا خیر.
|
price_is_discounted |
boolean |
نه | نادرست |
نشان میدهد که آیا |
مثال
مثال زیر نحوه ارسال رویداد 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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
affiliation |
string |
نه | Google Store |
وابستگی محصول برای مشخص کردن مکان شرکت تأمینکننده یا فروشگاه غیرمجازی. توجه: affiliation فقط در سطح مورد دردسترس است.
|
coupon |
string |
نه | SUMMER_FUN | نام/کد تخفیف مرتبط با مورد. پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
|
discount |
number |
نه | ۲.۲۲ | مقدار تخفیف پولی واحد مرتبط با محصول. |
index |
number |
نه | 5 | نمایه/موقعیت مورد در فهرست. |
item_brand |
string |
نه | نمانام مورد. | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
affiliation |
string |
نه | Google Store |
وابستگی محصول برای مشخص کردن مکان شرکت تأمینکننده یا فروشگاه غیرمجازی. توجه: affiliation فقط در سطح مورد دردسترس است.
|
coupon |
string |
نه | SUMMER_FUN | نام/کد تخفیف مرتبط با مورد. پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
|
discount |
number |
نه | ۲.۲۲ | مقدار تخفیف پولی واحد مرتبط با محصول. |
index |
number |
نه | 5 | نمایه/موقعیت مورد در فهرست. |
item_brand |
string |
نه | نمانام مورد. | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
affiliation |
string |
نه | Google Store |
وابستگی محصول برای مشخص کردن مکان شرکت تأمینکننده یا فروشگاه غیرمجازی. توجه: affiliation فقط در سطح مورد دردسترس است.
|
coupon |
string |
نه | SUMMER_FUN | نام/کد تخفیف مرتبط با مورد. پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
|
discount |
number |
نه | ۲.۲۲ | مقدار تخفیف پولی واحد مرتبط با محصول. |
index |
number |
نه | 5 | نمایه/موقعیت مورد در فهرست. |
item_brand |
string |
نه | نمانام مورد. | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
affiliation |
string |
نه | Google Store |
وابستگی محصول برای مشخص کردن مکان شرکت تأمینکننده یا فروشگاه غیرمجازی. توجه: affiliation فقط در سطح مورد دردسترس است.
|
coupon |
string |
نه | SUMMER_FUN | نام/کد تخفیف مرتبط با مورد. پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
|
discount |
number |
نه | ۲.۲۲ | مقدار تخفیف پولی واحد مرتبط با محصول. |
index |
number |
نه | 5 | نمایه/موقعیت مورد در فهرست. |
item_brand |
string |
نه | نمانام مورد. | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
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 |
نه | نمانام مورد. | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
affiliation |
string |
نه | Google Store |
وابستگی محصول برای مشخص کردن مکان شرکت تأمینکننده یا فروشگاه غیرمجازی. توجه: affiliation فقط در سطح مورد دردسترس است.
|
coupon |
string |
نه | SUMMER_FUN | نام/کد تخفیف مرتبط با مورد. پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
|
discount |
number |
نه | ۲.۲۲ | مقدار تخفیف پولی واحد مرتبط با محصول. |
index |
number |
نه | 5 | نمایه/موقعیت مورد در فهرست. |
item_brand |
string |
نه | نمانام مورد. | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
affiliation |
string |
نه | Google Store |
وابستگی محصول برای مشخص کردن مکان شرکت تأمینکننده یا فروشگاه غیرمجازی. توجه: affiliation فقط در سطح مورد دردسترس است.
|
coupon |
string |
نه | SUMMER_FUN | نام/کد تخفیف مرتبط با مورد. پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
|
discount |
number |
نه | ۲.۲۲ | مقدار تخفیف پولی واحد مرتبط با محصول. |
index |
number |
نه | 5 | نمایه/موقعیت مورد در فهرست. |
item_brand |
string |
نه | نمانام مورد. | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
affiliation |
string |
نه | Google Store |
وابستگی محصول برای مشخص کردن مکان شرکت تأمینکننده یا فروشگاه غیرمجازی. توجه: affiliation فقط در سطح مورد دردسترس است.
|
coupon |
string |
نه | SUMMER_FUN | نام/کد تخفیف مرتبط با مورد. پارامترهای سطح رویداد و سطح مورد coupon مستقل هستند.
|
discount |
number |
نه | ۲.۲۲ | مقدار تخفیف پولی واحد مرتبط با محصول. |
index |
number |
نه | 5 | نمایه/موقعیت مورد در فهرست. |
item_brand |
string |
نه | نمانام مورد. | |
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 |
بله* | تیشرت استن و دوستان |
نام مورد.
*یکی از |
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 |
نه | نمانام مورد. | |
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" } }] }) });