Стандартные ресурсы Universal Analytics (UA) прекратили обработку данных 1 июля 2023 года. Ресурсы UA 360 прекратят обработку данных 1 июля 2024 года, а некоторые функции UA 360 станут устаревшими до этого момента , поскольку мы перейдем на Google Analytics 4 . Используйте API данных для доступа к функциям отчетности для ресурсов GA4.

Эта страница переведена с помощью Cloud Translation API.

Расширенные варианты использования

В этом документе описаны расширенные функции 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 содержит список объектов 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 может быть до семи значений.

Пример строки сводной таблицы

В приведенном выше примере ответа строка, связанная со страной США, представлена в следующей сводной таблице:

Страна	Общий Сессии	Интернет Эксплорер Сессии	Fire Fox Сессии	Android-браузер Сессии
Индия	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 .
Диапазон дат в когортах должен быть после 1 февраля 2015 года.

Пожизненная ценность (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` ). Он указывает количество пользователей в когорте, которые активны во временном окне, соответствующем n-му дню/неделе/месяцу когорты. Например, для `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`	Продолжительность сеанса на пользователя для параметра привлечения для когорты (только просмотры приложений ).