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

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" } } }
از شیء پاسخ، مقادیر سنجه را برای روزهای گروه همافزایی 001 و 007 از پاسخ بازیابی کنید، برای مثال:
{
"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" ] }