標準のユニバーサルアナリティクス（UA）プロパティでは、2023 年 7 月 1 日をもってデータの処理が停止されました。UA 360 プロパティでは、2024 年 7 月 1 日をもってデータの処理が停止されます。また、Google アナリティクス 4 への移行に伴い、一部の UA 360 の機能はその前にサポート終了となります。Data API を使用して、GA4 プロパティのレポート機能にアクセスします。

このページは Cloud Translation API によって翻訳されました。

高度な使用例

このドキュメントでは、Google アナリティクス Reporting API v4 の高度な機能について説明します。API の詳細なリファレンスについては、リファレンスガイドをご覧ください。

はじめに

シンプルなレポートを作成した後、次の機能を使用して詳細レポートを作成できます。

ピボット
コホート
ライフタイムバリュー

ピボット

Google アナリティクス Reporting API v4 を使用すると、ピボットテーブルを生成できます。ピボットテーブルを使用してリクエストを作成するには、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"
            }
          ]
        }
      ]
    }
  ]
}

レスポンス列ヘッダー

ピボットリクエストに対して返される report オブジェクト内の metricHeader には、pivotHeaderEntries フィールドがピボットディメンション値の順序と対応する指標値を定義する pivotHeaders オブジェクトのリストが含まれます。次に例を示します。

"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 であるため、レポートにはピボット値が 3 つしかありません。"totalPivotGroupsCount": 7 により、最大 7 つの値が存在する可能性があります。

ピボットテーブルの行の例

上記のレスポンスの例の場合、国 United States に関連付けられている行は、以下のピボットテーブルで表現されます。

国	合計セッション	Internet Explorer セッション	FireFox セッション	Android ブラウザのセッション
インド	12	3	2	4
米国	全角 112	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」ディメンションは、リクエストに 1 つ以上のコホート定義が含まれている場合にのみ組み込まれます。
コホート名は固有でなければならない。
リクエストのコホートの最大数は 12 である。
ga:cohortNthWeek が定義されている場合、開始日は日曜日、終了日は土曜日にする必要があります。ga:cohortNthMonth が定義されている場合、開始日は月の初日、終了日は月の最終日にする必要があります。ga:cohortNthDay が定義されている場合、期間は 1 日でなければなりません。
今日の日付を含むコホートリクエストは許可されない。
コホートリクエストと非コホートリクエストは同じ 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
      }
    }
  ]
}