این سند پُرسمانهای Data API معادل گزارشهای ازپیش تعریفشده در «میانای کاربری Google Analytics» را ارائه میدهد. روی زبانه HTTP کلیک کنید تا درخواستهای میانای برنامهسازی کاربردی را ببینید.
چرخه زندگی
جذب کاربر
گزارش جذب کاربر گزارش جزئیات ازپیش تعریفشدهای است که میتوانید از آن برای دریافت اطلاعات آماری درباره نحوه پیدا کردن وبسایت یا برنامه شما توسط کاربران جدید برای اولینبار استفاده کنید.
کاربران جدید براساس گروه کانال پیشفرض کاربر اول درطول زمان
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "firstUserDefaultChannelGroup" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "firstUserDefaultChannelGroup" } ], "metrics": [ { "name": "newUsers" } ] }
کاربران جدید براساس گروه کانال اصلی کاربر اول (گروه کانال پیشفرض)
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "firstUserDefaultChannelGroup" } ], "metrics": [ { "name": "newUsers" } ], "limit": 5 }
گزارش جذب کاربر
گزارش «جذب کاربر» گزارش جزئیات ازپیش تعریفشدهای است که میتوانید از آن برای دریافت اطلاعات آماری درباره نحوه پیدا کردن وبسایت یا برنامه شما توسط کاربران جدید برای اولینبار استفاده کنید.
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "firstUserDefaultChannelGroup" } ], "metrics": [ { "name": "newUsers" }, { "name": "engagedSessions" }, { "name": "engagementRate" }, { "name": "engagedSessionsPerUser", "expression": "engagedSessions/activeUsers" }, { "name": "averageEngagementTime", "expression": "userEngagementDuration/activeUsers" }, { "name": "eventCount" }, { "name": "keyEvents" }, { "name": "totalRevenue" } ], "metricAggregations": [ "TOTAL" ] }
جذب ترافیک
گزارش کسب ترافیک گزارش جزئیات ازپیشتعریفشدهای است که برای کمک به شما در درک اینکه بازدیدکنندگان وبسایت و برنامه شما از کجا میآیند طراحی شده است. این گزارش بهطور خاص نشان میدهد کاربران جدید و برگشتی از کجا میآیند.
کاربران براساس گروه کانال اصلی «جلسه» (گروه کانال پیشفرض) درطول زمان
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "sessionDefaultChannelGroup" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "sessionDefaultChannelGroup" } ], "metrics": [ { "name": "activeUsers" } ] }
کاربران براساس گروه کانال اصلی جلسه (گروه کانال پیشفرض)
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "sessionDefaultChannelGroup" } ], "metrics": [ { "name": "activeUsers" } ], "limit": 5 }
جذب ترافیک: گروه کانال اصلی جلسه (گروه کانال پیشفرض)
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "sessionDefaultChannelGroup" } ], "metrics": [ { "name": "activeUsers" }, { "name": "sessions" }, { "name": "engagedSessions" }, { "name": "averageEngagementTimePerSession", "expression": "userEngagementDuration/sessions" }, { "name": "engagedSessionsPerUser", "expression": "engagedSessions/activeUsers" }, { "name": "eventsPerSession" }, { "name": "engagementRate" }, { "name": "eventCount" }, { "name": "keyEvents" }, { "name": "totalRevenue" } ], "metricAggregations": [ "TOTAL" ] }
تعامل
رویدادها
گزارش «رویدادها» گزارش جزئیات ازپیشتعریفشدهای است که نشان میدهد هر رویداد چند بار راهاندازی شده است و چند کاربر هر رویداد را در وبسایت یا برنامه شما راهاندازی کردهاند.
تعداد رویداد براساس نام رویداد درطول زمان
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "eventName" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "eventName" } ], "metrics": [ { "name": "eventCount" } ] }
تعداد رویداد براساس «نام رویداد»
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "eventName" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "eventName" } ], "metrics": [ { "name": "eventCount" } ] }
رویدادها: نام رویداد
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "eventName" } ], "metrics": [ { "name": "eventCount" }, { "name": "totalUsers" }, { "name": "eventCountPerUser" }, { "name": "totalRevenue" } ], "metricAggregations": [ "TOTAL" ] }
صفحهها و صفحهنمایشها
گزارش «صفحهها و صفحهنمایشها» یک گزارش جزئیات ازپیشتعریفشده است که دادههای مربوط به صفحههایی را که کاربران در وبسایتتان بازدید کردهاند و صفحهنمایشهایی را که کاربران در برنامه تلفن همراهتان باز کردهاند نشان میدهد و به شما امکان میدهد ببینید افراد در وبسایتها و برنامههایتان به کجا میروند.
بازدیدها براساس مسیر صفحه و کلاس صفحهنمایش درطول زمان
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "unifiedPagePathScreen" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "unifiedPagePathScreen" } ], "metrics": [ { "name": "screenPageViews" } ] }
بازدیدها براساس مسیر صفحه و کلاس صفحهنمایش
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "unifiedPagePathScreen" } ], "metrics": [ { "name": "screenPageViews" } ], "limit": 5 }
صفحهها و صفحهنمایشها: مسیر صفحه و کلاس صفحهنمایش
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "unifiedPagePathScreen" } ], "metrics": [ { "name": "screenPageViews" }, { "name": "activeUsers" }, { "name": "screenPageViewsPerUser" }, { "name": "averageEngagementTime", "expression": "userEngagementDuration/activeUsers" }, { "name": "eventCount" }, { "name": "keyEvents" }, { "name": "totalRevenue" } ], "metricAggregations": [ "TOTAL" ] }
صفحه مقصد
گزارش صفحه مقصد گزارش جزئیات ازپیشتعریفشدهای است که به شما کمک میکند بفهمید بازدیدکنندگان چگونه با وبسایتتان تعامل میکنند. این گزارش اولین صفحهای را که بازدیدکننده هنگام بازدید از وبسایت شما در آن قرار میگیرد و تعداد بازدیدکنندگانی را که در هر صفحه قرار میگیرند نشان میدهد.
جلسهها براساس صفحه مقصد درطول زمان
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "landingPage" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "landingPage" } ], "metrics": [ { "name": "sessions" } ], "dimensionFilter": { "notExpression": { "filter": { "fieldName": "landingPage", "stringFilter": { "value": "(not set)" } } } } }
صفحه مقصد: صفحه مقصد
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "landingPage" } ], "metrics": [ { "name": "sessions" }, { "name": "activeUsers" }, { "name": "newUsers" }, { "name": "averageEngagementTimePerSession", "expression": "userEngagementDuration/sessions" }, { "name": "keyEvents" }, { "name": "totalRevenue" } ], "metricAggregations": [ "TOTAL" ] }
درآمدزایی
خریدهای تجارت الکترونیک
گزارش خریدهای تجارت الکترونیک گزارش جزئیات ازپیشتعریفشدهای است که اطلاعات مربوط به محصولات یا سرویسهایی را که در فروشگاه تجارت الکترونیک خود میفروشید نشان میدهد.
موارد مشاهدهشده براساس نام مورد درطول زمان
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "itemName" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "itemName" } ], "metrics": [ { "name": "itemsViewed" } ] }
موارد مشاهدهشده و موارد اضافهشده به سبد خرید براساس نام مورد
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "itemName" } ], "metrics": [ { "name": "itemsViewed" }, { "name": "itemsAddedToCart" } ] }
خریدهای تجارت الکترونیک: نام مورد
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "itemName" } ], "metrics": [ { "name": "itemsViewed" }, { "name": "itemsAddedToCart" }, { "name": "itemsPurchased" }, { "name": "itemRevenue" } ], "metricAggregations": [ "TOTAL" ] }
سفر خرید
گزارش سفر خرید نشان میدهد چند کاربر در هر مرحله از قیف خرید شما ازدست میروند. این گزارش میتواند به شما کمک کند مراحل قیف را که نیاز به بهبود دارند شناسایی کنید.
سفر خرید: دسته دستگاه
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "itemName" } ], "metrics": [ { "name": "itemsViewed" }, { "name": "itemsAddedToCart" }, { "name": "itemsPurchased" }, { "name": "itemRevenue" } ], "metricAggregations": [ "TOTAL" ] }
عرضههای ترویجی
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "itemPromotionName" } ], "metrics": [ { "name": "itemsViewedInPromotion" }, { "name": "itemsClickedInPromotion" }, { "name": "itemPromotionClickThroughRate" }, { "name": "itemsAddedToCart" }, { "name": "itemsCheckedOut" }, { "name": "itemsPurchased" }, { "name": "itemRevenue" } ], "metricAggregations": [ "TOTAL" ] }
سفر تسویهحساب
گزارش سفر تسویهحساب تعداد و درصد کاربرانی را نشان میدهد که تسویهحساب را در وبسایت تجارت الکترونیک یا برنامه شما شروع کردهاند و هریک از مراحل بعدی را در قیف تسویهحساب تکمیل کردهاند.
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "funnelBreakdown": { "breakdownDimension": { "name": "deviceCategory" } }, "funnel": { "steps": [ { "name": "Begin checkout", "filterExpression": { "funnelEventFilter": { "eventName": "begin_checkout" } } }, { "name": "Add shipping", "filterExpression": { "funnelEventFilter": { "eventName": "add_shipping_info" } } }, { "name": "Add payment", "filterExpression": { "funnelEventFilter": { "eventName": "add_payment_info" } } }, { "name": "Purchase", "filterExpression": { "funnelEventFilter": { "eventName": "purchase" } } } ] } }
نگهداری داده
حفظ کاربر براساس همگروه
نمونه میانای کاربر

برای هر تاریخ در نمودار:
HTTP
{ "dimensions": [ { "name": "cohort" }, { "name": "cohortNthDay" } ], "metrics": [ { "name": "cohortRetentionFraction", "expression": "cohortActiveUsers/cohortTotalUsers" } ], "cohortSpec": { "cohorts": [ { "dimension": "firstSessionDate", "dateRange": { "startDate": "2023-12-11", "endDate": "2023-12-11" } } ], "cohortsRange": { "endOffset": 7, "granularity": "DAILY" } } }
از یک شیء پاسخ، مقادیر سنجه را برای روزهای گروه همنسل ۰۰۱ و ۰۰۷ از پاسخ بازیابی کنید، برای مثال:
{
"dimensionValues": [
{
"value": "cohort_0"
},
{
"value": "0001"
}
],
"metricValues": [
{
"value": "0.045319219318557723"
}
]
},
{
"dimensionValues": [
{
"value": "cohort_0"
},
{
"value": "0007"
}
],
"metricValues": [
{
"value": "0.011577902745616937"
}
]
},
حفظ کاربر
نمونه میانای کاربر

گزارش براساس ۴۲ روز گذشته است، بنابراین تاریخ شروع و پایان باید شامل تاریخ ۴۲ روز قبل باشد.
HTTP
{ "dimensions": [ { "name": "cohort" }, { "name": "cohortNthDay" } ], "metrics": [ { "name": "userRetention", "expression": "cohortActiveUsers/cohortTotalUsers" } ], "cohortSpec": { "cohorts": [ { "dimension": "firstSessionDate", "dateRange": { "startDate": "2023-11-21", "endDate": "2023-11-21" } } ], "cohortsRange": { "endOffset": 42, "granularity": "DAILY" } } }
مشخصههای کاربر
جزئیات جمعیتشناسی
گزارش جزئیات جمعیتشناسی گزارش جزئیات ازپیشتعریفشدهای است که ویژگیهای کلیدی افرادی را که از وبسایت یا برنامه استفاده میکنند ارائه میدهد، ازجمله زبان کاربر، علایق، مکان، سن، و جنسیت.
کاربران براساس کشور درطول زمان
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "country" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "country" } ], "metrics": [ { "name": "activeUsers" } ] }
کاربران براساس کشور
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "country" } ], "metrics": [ { "name": "activeUsers" } ], "limit": 5 }
جزئیات جمعیتشناسی: کشور
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "country" } ], "metrics": [ { "name": "activeUsers" }, { "name": "newUsers" }, { "name": "engagedSessions" }, { "name": "engagementRate" }, { "name": "engagedSessionsPerUser", "expression": "engagedSessions/activeUsers" }, { "name": "averageEngagementTimePerUser", "expression": "userEngagementDuration/activeUsers" }, { "name": "eventCount" }, { "name": "keyEvents" }, { "name": "totalRevenue" } ], "metricAggregations": [ "TOTAL" ] }
مخاطبان
کاربران براساس مخاطب درطول زمان
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "audienceName" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "audienceName" } ], "metrics": [ { "name": "activeUsers" } ] }
مخاطبان: مخاطب
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "audienceName" } ], "metrics": [ { "name": "activeUsers" }, { "name": "newUsers" }, { "name": "sessions" }, { "name": "screenPageViewsPerSession" }, { "name": "averageSessionDuration" }, { "name": "totalRevenue" } ], "metricAggregations": [ "TOTAL" ] }
فناوری
جزئیات فناوری
کاربران براساس مرورگر درطول زمان
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "browser" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "browser" } ], "metrics": [ { "name": "activeUsers" } ] }
کاربران براساس مرورگر
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "browser" } ], "metrics": [ { "name": "activeUsers" } ], "limit": 5 }
جزئیات فنی: مرورگر
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "browser" } ], "metrics": [ { "name": "activeUsers" }, { "name": "newUsers" }, { "name": "engagedSessions" }, { "name": "engagementRate" }, { "name": "engagedSessionsPerUser", "expression": "engagedSessions/activeUsers" }, { "name": "averageEngagementTimePerUser", "expression": "userEngagementDuration/activeUsers" }, { "name": "eventCount" }, { "name": "keyEvents" }, { "name": "totalRevenue" } ], "metricAggregations": [ "TOTAL" ] }
تبلیغات
برنامهریزی: همه کانالها
رویدادهای کلیدی براساس گروه کانال اصلی (گروه کانال پیشفرض) درطول زمان
نمونه میانای کاربر

HTTP
{ "pivots": [ { "fieldNames": [ "date" ], "orderBys": [ { "dimension": { "dimensionName": "date" } } ], "limit": 28 }, { "fieldNames": [ "defaultChannelGroup" ], "limit": 5 } ], "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "date" }, { "name": "defaultChannelGroup" } ], "metrics": [ { "name": "keyEvents" } ] }
رویدادهای کلیدی براساس گروه کانال اصلی (گروه کانال پیشفرض)
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "defaultChannelGroup" } ], "metrics": [ { "name": "keyEvents" } ], "limit": 5 }
تمام کانالها
نمونه میانای کاربر

HTTP
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "defaultChannelGroup" } ], "metrics": [ { "name": "keyEvents" }, { "name": "advertiserAdCost" }, { "name": "advertiserAdCostPerKeyEvent" }, { "name": "totalRevenue" }, { "name": "returnOnAdSpend" } ], "metricAggregations": [ "TOTAL" ] }