این سند ویژگی های پیشرفته Google Analytics Reporting API v4 را شرح می دهد. برای مرجع دقیق API، به راهنمای مرجع مراجعه کنید.
معرفی
پس از ایجاد یک گزارش ساده ، از این ویژگی ها برای ایجاد گزارش های پیشرفته استفاده کنید:
محورها
Google Analytics Reporting API v4 به شما امکان می دهد جداول محوری تولید کنید. برای ساخت یک درخواست با جدول محوری، فیلد Pivot را در ReportRequest تعریف کنید. شی Pivot مجموعه ای از ابعاد و معیارهای خاص خود را دارد، و startGroup
و maxGroupCount
اختیاری برای تعیین تعداد ابعادی که باید در جدول محوری گنجانده شود، دارد.
درخواست
فراخوانی API زیر جلسات را بر اساس کشور درخواست میکند و نتایج را در مرورگر تغییر میدهد:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dateRanges":
[
{
"startDate": "2014-11-01",
"endDate": "2014-11-30"
}
],
"metrics":
[
{
"expression": "ga:sessions"
}
],
"dimensions":
[
{
"name": "ga:country"
}
],
"pivots":
[
{
"dimensions":
[
{
"name": "ga:browser"
}
],
"maxGroupCount": 3,
"startGroup": 3,
"metrics":
[
{
"expression": "ga:sessions"
}
]
}
]
}
]
}
سربرگ ستون پاسخ
در شی گزارش بازگشتی برای یک درخواست محوری، metricHeader
فهرستی از اشیاء pivotHeader دارد که فیلدهای pivotHeaderEntries
ترتیب مقادیر ابعاد محوری و مقادیر متریک مربوطه را تعریف میکنند، برای مثال:
"columnHeader": {
"dimensions": [
"ga:country"
],
"metricHeader": {
"metricHeaderEntries": [
{
"name": "ga:sessions",
"type": "INTEGER"
}
],
"pivotHeaders": [
{
"pivotHeaderEntries": [
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Internet Explorer"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Firefox"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Android Browser"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
}
],
"totalPivotGroupsCount": 7
}
]
}
},
ردیف های پاسخ
هر ردیف از شی reportData آرایه ای از اشیاء dateRangeValue را تعریف می کند که هر کدام شامل مجموعه ای از اشیاء pivotValue است. ترتیب مقادیر با ترتیب معیارهای فهرست شده در سرصفحه های محوری در سرصفحه ستون پاسخ مطابقت دارد.
"rows": [
...
{
"dimensions": [
"United States"
],
"metrics": [
{
"pivotValues": [
{
"values": [
"21",
"18",
"1"
]
}
],
"values": [
"192"
]
}
]
}
],
توجه داشته باشید که فقط سه مقدار محوری در گزارش وجود دارد، زیرا در درخواست اصلی، maxGroupCount
3 است. ممکن است به دلیل "totalPivotGroupsCount": 7
.
مثال ردیف جدول محوری
در پاسخ نمونه بالا، ردیف مربوط به کشور ایالات متحده در جدول محوری زیر نشان داده شده است:
کشور | جمع جلسات | اینترنت اکسپلورر جلسات | فایرفاکس جلسات | مرورگر اندروید جلسات |
---|---|---|---|---|
هندوستان | 12 | 3 | 2 | 4 |
ایالات متحده | 192 | 21 | 18 | 1 |
انگلستان | 35 | 12 | 2 | 0 |
گروه ها
همگروهی گروهی از کاربران است که یک ویژگی مشترک دارند. به عنوان مثال، همه کاربران با تاریخ جذب یکسان به یک گروه تعلق دارند. گزارش تحلیل کوهورت به شما امکان می دهد رفتار گروهی را جداسازی و تجزیه و تحلیل کنید. برای فهرستی از ابعاد و معیارهای خاص کوهورت، ابعاد و معیارهای همگروهی و ارزش طول عمر (LTV) را ببینید.
برای تعریف یک درخواست همگروهی، باید یک شی کوهورت را با name
، type
و dateRange
تعریف کنید:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthDay"
}
],
"metrics":
[
{
"expression": "ga:cohortActiveUsers"
},
{
"expression": "ga:cohortTotalUsers"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-08-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-07-01"
}
}
]
}
}
]
}
مثال بالا را در API Explorer ببینید.
محدودیت های گروهی
یک درخواست کوهورت معتبر باید دارای محدودیتهای زیر باشد:
-
ga:cohort
در صورتی و فقط در صورتی گنجانده میشود که درخواست یک یا چند تعریف کوهورت داشته باشد. - نام گروه باید منحصر به فرد باشد.
- حداکثر تعداد گروه ها در یک درخواست 12 نفر است.
- اگر
ga:cohortNthWeek
تعریف شده باشد، تاریخ شروع باید یکشنبه و تاریخ پایان باید شنبه باشد. اگرga:cohortNthMonth
تعریف شده باشد، تاریخ شروع باید اولین روز ماه و تاریخ پایان باید آخرین روز ماه باشد. اگرga:cohortNthDay
تعریف شده باشد، محدوده تاریخ باید دقیقاً یک روز باشد. - درخواستهای گروهی با تاریخ امروز مجاز نیستند.
- درخواست های همگروهی و غیرهمگروهی نباید در یک درخواست
batchGet
باشند. - محدوده تاریخ در گروهها باید بعد از ۱ فوریه ۲۰۱۵ باشد.
ارزش طول عمر (LTV)
گزارش ارزش مادام العمر نشان می دهد که چگونه ارزش کاربر (درآمد) و تعامل (نمایش برنامه ها، تکمیل هدف، جلسات، و مدت جلسه) در طول 90 روز پس از جذب کاربر چگونه رشد می کند. ابعاد و معیارهای خاص LTV را ببینید.
یک درخواست LTV به عنوان یک گروه با فیلد lifetimeValue
روی true
تعریف میشود، برای مثال:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthWeek"
}
],
"metrics":
[
{
"expression": "ga:cohortTotalUsersWithLifetimeCriteria"
},
{
"expression": "ga:cohortRevenuePerUser"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-09-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-08-01"
}
}
],
"lifetimeValue": true
}
}
]
}
مثال بالا را در API Explorer ببینید.
ابعاد و معیارهای همگروهی و ارزش طول عمر (LTV).
ابعاد
نام ابعاد | تعریف |
---|---|
ga:cohort | نام گروهی که کاربر به آن تعلق دارد. بسته به نحوه تعریف گروهها، یک کاربر میتواند به گروههای متعددی تعلق داشته باشد، مشابه اینکه کاربر میتواند به چند بخش تعلق داشته باشد. |
ga:cohortNthDay | افست روز مبتنی بر 0 نسبت به تاریخ تعریف گروه. به عنوان مثال، اگر یک گروه با اولین تاریخ بازدید به عنوان 2015-09-01 تعریف شود، برای تاریخ 2015-09-04 ، ga:cohortNthDay 3 خواهد بود. |
ga:cohortNthMonth | جبران ماه بر اساس 0 نسبت به تاریخ تعریف گروه. |
ga:cohortNthWeek | افست هفته مبتنی بر 0 نسبت به تاریخ تعریف گروه. |
ga:acquisitionTrafficChannel | کانال ترافیکی که از طریق آن کاربر به دست آمده است. از اولین جلسه کاربر استخراج می شود. کانال ترافیک بر اساس قوانین پیشفرض گروهبندی کانال (در سطح مشاهده در صورت وجود) در زمان جذب کاربر محاسبه میشود. |
ga:acquisitionSource | منبعی که کاربر از طریق آن به دست آمده است. برگرفته از اولین جلسه کاربر. |
ga:acquisitionMedium | رسانه ای که از طریق آن کاربر به دست آمده است. برگرفته از اولین جلسه کاربر. |
ga:acquisitionSourceMedium | مقدار ترکیبی ga:userAcquisitionSource و ga:acquisitionMedium . |
ga:acquisitionCampaign | کمپینی که از طریق آن کاربر به دست آمده است. برگرفته از اولین جلسه کاربر. |
معیارهای
نام متریک | تعریف |
---|---|
ga:cohortActiveUsers | این معیار در زمینه ابعاد افست مبتنی بر 0 ( ga:cohortNthDay ، ga:cohortNthWeek ، یا ga:cohortNthMonth ) مرتبط است. این تعداد کاربرانی را در گروه فعال نشان میدهد که در پنجره زمانی مربوط به روز/هفته/ماه همگروه فعال هستند. به عنوان مثال، برای ga:cohortNthWeek = 1 ، تعداد کاربران (در گروه) که در هفته دوم فعال هستند. اگر درخواستی هیچ یک از ga:cohortNthDay ، ga:cohortNthWeek ، یا ga:cohortNthMonth را نداشته باشد، این متریک همان مقدار ga:cohortTotalUsers را خواهد داشت. |
ga:cohortTotalUsers | تعداد کاربران متعلق به گروه، که به عنوان اندازه کوهورت نیز شناخته می شود. |
ga:cohortAppviewsPerUser | بازدیدهای برنامه به ازای هر کاربر برای یک گروه. |
ga:cohortGoalCompletionsPerUser | تکمیل هدف برای هر کاربر برای یک گروه. |
ga:cohortPageviewsPerUser | بازدید از صفحه به ازای هر کاربر برای یک گروه. |
ga:cohortRetentionRate | نرخ حفظ همگروهی |
ga:cohortRevenuePerUser | درآمد هر کاربر برای یک گروه |
ga:cohortVisitDurationPerUser | مدت زمان هر کاربر برای یک گروه. |
ga:cohortSessionsPerUser | جلسات به ازای هر کاربر برای یک گروه. |
معیارهای ارزش طول عمر (LTV).
نام متریک | تعریف |
---|---|
ga:cohortTotalUsersWithLifetimeCriteria | این در زمینه درخواستی که دارای ابعاد ga:acquisitionTrafficChannel ، ga:acquisitionSource ، ga:acquisitionMedium ، یا ga:acquisitionCampaign است، مرتبط است. این تعداد کاربرانی را در گروهها نشان میدهد که از طریق کانال، منبع، رسانه یا کمپین فعلی بهدست میآیند. به عنوان مثال، برای ga:acquisitionTrafficChannel=Direct ، تعداد کاربران گروه را نشان میدهد که مستقیماً جذب شدهاند. اگر هیچ یک از ابعاد ذکر شده وجود نداشته باشد، مقدار آن برابر با ga:cohortTotalUsers (فقط نمایش برنامه ) است. |
ga:cohortAppviewsPerUserWithLifetimeCriteria | بازدیدهای برنامه به ازای هر کاربر برای بعد اکتساب برای یک گروه (فقط نماهای برنامه ). |
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria | تکمیل هدف برای هر کاربر برای بعد اکتساب برای یک گروه (فقط بازدیدهای برنامه ). |
ga:cohortPageviewsPerUserWithLifetimeCriteria | بازدید از صفحه به ازای هر کاربر برای بعد اکتساب برای یک گروه (فقط بازدیدهای برنامه ). |
ga:cohortRevenuePerUserWithLifetimeCriteria | درآمد هر کاربر برای بعد اکتساب برای یک گروه (فقط بازدیدهای برنامه ). |
ga:cohortSessionsPerUserWithLifetimeCriteria | مدت زمان جلسه به ازای هر کاربر برای بعد اکتساب برای یک گروه (فقط بازدیدهای برنامه ). |