進階用途

本文說明 Google Analytics Reporting API v4 的進階功能。如需 API 的詳細參考資料，請參閱參考指南。

簡介

建立簡易報表後，請使用下列功能建立進階報表：

• 資料透視
• 同類群組
• 生命週期價值

資料透視

Google Analytics Reporting API v4 可讓您產生資料透視表。如要透過資料透視表建構要求，請在 ReportRequest 中定義「Pivot」欄位。「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"
            }
          ]
        }
      ]
    }
  ]
}

回應欄標題

在資料透視要求的傳回 report 物件中，metricHeader 提供 pivotHeaders物件清單，這些物件的 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，因此最多可能達七個值。

資料透視表列範例

在上方的回應範例中，與國家/地區「美國」相關聯的資料列如以下資料透視表所示：

同類群組

同類群組是指具有共同特徵的一群使用者。舉例來說，「轉換日期」是同一天的所有使用者，會歸入相同的同類群組。您可以用「同類群組分析」報表劃分出同類群組行為，並加以分析。 如需同類群組專屬維度和指標清單，請參閱「同類群組和生命週期價值 (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 要求中。
• 同類群組中的日期範圍必須晚於 2015 年 2 月 1 日。

生命週期價值 (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) 維度和指標

尺寸

指標

生命週期價值 (LTV) 指標