موارد استفاده پیشرفته

این سند ویژگی های پیشرفته 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 مدت زمان جلسه به ازای هر کاربر برای بعد اکتساب برای یک گروه (فقط بازدیدهای برنامه ).