این سند، کوئریهای Data API معادل گزارشهای از پیش تعریفشده موجود در رابط کاربری گوگل آنالیتیکس را ارائه میدهد. برای مشاهده درخواستهای 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" } ] }
کاربران جدید بر اساس گروه کانال اصلی کاربر اول (گروه کانال پیشفرض)
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "firstUserDefaultChannelGroup" } ], "metrics": [ { "name": "newUsers" } ], "limit": 5 }
گزارش جذب کاربر
گزارش جذب کاربر، یک گزارش تفصیلی از پیش تعریف شده است که میتوانید از آن برای کسب بینش در مورد چگونگی پیدا کردن وبسایت یا برنامه شما توسط کاربران جدید برای اولین بار استفاده کنید.
مثال رابط کاربری
اچتیپی
{ "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" ] }
جذب ترافیک
گزارش جذب ترافیک ، یک گزارش جزئی از پیش تعریفشده است که برای کمک به شما در درک منشأ بازدیدکنندگان وبسایت و اپلیکیشن شما طراحی شده است. این گزارش بهطور خاص نشان میدهد که کاربران جدید و قدیمی از کجا میآیند.
کاربران بر اساس گروه کانال اصلی جلسه (گروه کانال پیشفرض) در طول زمان
مثال رابط کاربری
اچتیپی
{ "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" } ] }
کاربران بر اساس گروه کانال اصلی Session (گروه کانال پیشفرض)
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "sessionDefaultChannelGroup" } ], "metrics": [ { "name": "activeUsers" } ], "limit": 5 }
کسب ترافیک: گروه کانال اصلی جلسه (گروه کانال پیشفرض)
مثال رابط کاربری
اچتیپی
{ "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" ] }
نامزدی
رویدادها
گزارش رویدادها یک گزارش تفصیلی از پیش تعریف شده است که نشان میدهد هر رویداد چند بار اجرا میشود و چند کاربر هر رویداد را در وبسایت یا برنامه شما اجرا میکنند.
تعداد رویدادها بر اساس نام رویداد در طول زمان
مثال رابط کاربری
اچتیپی
{ "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" } ] }
Event count by Event name
مثال رابط کاربری
اچتیپی
{ "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" } ] }
رویدادها: نام رویداد
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "eventName" } ], "metrics": [ { "name": "eventCount" }, { "name": "totalUsers" }, { "name": "eventCountPerUser" }, { "name": "totalRevenue" } ], "metricAggregations": [ "TOTAL" ] }
صفحات و پردهها
گزارش صفحات و صفحه نمایشها ، یک گزارش تفصیلی از پیش تعریف شده است که دادههای مربوط به صفحاتی که کاربران در وبسایت شما بازدید کردهاند و صفحاتی که کاربران در برنامه تلفن همراه شما باز کردهاند را نشان میدهد و به شما این امکان را میدهد که ببینید افراد در وبسایتها و برنامههای شما به کجا میروند.
نمایشها بر اساس مسیر صفحه و کلاس صفحه نمایش در طول زمان
مثال رابط کاربری
اچتیپی
{ "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" } ] }
نمایشها بر اساس مسیر صفحه و کلاس صفحه نمایش
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "unifiedPagePathScreen" } ], "metrics": [ { "name": "screenPageViews" } ], "limit": 5 }
صفحات و صفحه نمایشها: مسیر صفحه و کلاس صفحه نمایش
مثال رابط کاربری
اچتیپی
{ "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" ] }
صفحه فرود
گزارش صفحه فرود ، یک گزارش جزئی از پیش تعریف شده است که به شما کمک میکند تا نحوه تعامل بازدیدکنندگان با وبسایت خود را درک کنید. این گزارش اولین صفحهای را که بازدیدکننده هنگام بازدید از وبسایت شما به آن میرسد و تعداد بازدیدکنندگان در هر صفحه را به شما نشان میدهد.
جلسات بر اساس صفحه فرود در طول زمان
مثال رابط کاربری
اچتیپی
{ "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)" } } } } }
صفحه فرود: صفحه فرود
مثال رابط کاربری
اچتیپی
{ "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" ] }
کسب درآمد
خریدهای تجارت الکترونیک
گزارش خریدهای فروشگاه اینترنتی ، یک گزارش تفصیلی از پیش تعریف شده است که اطلاعات مربوط به محصولات یا خدماتی را که در فروشگاه اینترنتی خود میفروشید، نشان میدهد.
موارد مشاهده شده بر اساس نام مورد در طول زمان
مثال رابط کاربری
اچتیپی
{ "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" } ] }
اقلام مشاهده شده و اقلام اضافه شده به سبد خرید بر اساس نام کالا
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "itemName" } ], "metrics": [ { "name": "itemsViewed" }, { "name": "itemsAddedToCart" } ] }
خریدهای تجارت الکترونیک: نام کالا
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "itemName" } ], "metrics": [ { "name": "itemsViewed" }, { "name": "itemsAddedToCart" }, { "name": "itemsPurchased" }, { "name": "itemRevenue" } ], "metricAggregations": [ "TOTAL" ] }
سفر خرید
گزارش مسیر خرید نشان میدهد که چه تعداد از کاربران بین هر مرحله در قیف خرید شما، از خرید منصرف شدهاند. این گزارش میتواند به شما در شناسایی مراحلی در قیف که نیاز به بهبود دارند، کمک کند.
مسیر خرید: دسته بندی دستگاه
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "itemName" } ], "metrics": [ { "name": "itemsViewed" }, { "name": "itemsAddedToCart" }, { "name": "itemsPurchased" }, { "name": "itemRevenue" } ], "metricAggregations": [ "TOTAL" ] }
تبلیغات
مثال رابط کاربری
اچتیپی
{ "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" ] }
سفر پرداخت
گزارش مسیر پرداخت، تعداد و درصد کاربرانی را نشان میدهد که پرداخت را در وبسایت یا اپلیکیشن تجارت الکترونیک شما شروع کردهاند و هر یک از مراحل بعدی را در قیف پرداخت تکمیل کردهاند.
مثال رابط کاربری
اچتیپی
{ "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" } } } ] } }
حفظ
حفظ کاربر بر اساس گروه سنی
مثال رابط کاربری
برای هر تاریخ روی نمودار:
اچتیپی
{ "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"
}
]
},
حفظ کاربر
مثال رابط کاربری
این گزارش بر اساس ۴۲ روز گذشته است، بنابراین تاریخ شروع و پایان باید شامل تاریخ ۴۲ روز قبل باشد.
اچتیپی
{ "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" } } }
ویژگیهای کاربر
جزئیات جمعیتی
گزارش جزئیات جمعیتشناختی، یک گزارش جزئیات از پیش تعریفشده است که ویژگیهای کلیدی افرادی که از یک وبسایت یا برنامه استفاده میکنند، از جمله زبان، علایق، موقعیت مکانی، سن و جنسیت کاربر را ارائه میدهد.
کاربران بر اساس کشور در طول زمان
مثال رابط کاربری
اچتیپی
{ "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" } ] }
کاربران بر اساس کشور
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "country" } ], "metrics": [ { "name": "activeUsers" } ], "limit": 5 }
جزئیات جمعیتی: کشور
مثال رابط کاربری
اچتیپی
{ "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" ] }
مخاطبان
کاربران بر اساس مخاطب در طول زمان
مثال رابط کاربری
اچتیپی
{ "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" } ] }
مخاطبان: حضار
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "audienceName" } ], "metrics": [ { "name": "activeUsers" }, { "name": "newUsers" }, { "name": "sessions" }, { "name": "screenPageViewsPerSession" }, { "name": "averageSessionDuration" }, { "name": "totalRevenue" } ], "metricAggregations": [ "TOTAL" ] }
فناوری
جزئیات فنی
کاربران بر اساس مرورگر در طول زمان
مثال رابط کاربری
اچتیپی
{ "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" } ] }
کاربران بر اساس مرورگر
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "browser" } ], "metrics": [ { "name": "activeUsers" } ], "limit": 5 }
جزئیات فنی: مرورگر
مثال رابط کاربری
اچتیپی
{ "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" ] }
تبلیغات
برنامهریزی: همه کانالها
رویدادهای کلیدی بر اساس گروه کانال اصلی (گروه کانال پیشفرض) در طول زمان
مثال رابط کاربری
اچتیپی
{ "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" } ] }
رویدادهای کلیدی بر اساس گروه کانال اصلی (گروه کانال پیشفرض)
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "defaultChannelGroup" } ], "metrics": [ { "name": "keyEvents" } ], "limit": 5 }
همه کانالها
مثال رابط کاربری
اچتیپی
{ "dateRanges": [ { "startDate": "28daysAgo", "endDate": "yesterday" } ], "dimensions": [ { "name": "defaultChannelGroup" } ], "metrics": [ { "name": "keyEvents" }, { "name": "advertiserAdCost" }, { "name": "advertiserAdCostPerKeyEvent" }, { "name": "totalRevenue" }, { "name": "returnOnAdSpend" } ], "metricAggregations": [ "TOTAL" ] }