- HTTP-запрос
- Тело запроса
- Тело ответа
- Области авторизации
- ОтчетЗапрос
- Выборка
- Измерение
- Предложение «Фильтр измерения»
- ФильтрЛогическийОператор
- Фильтр размеров
- Оператор
- Метрика
- Тип метрики
- Предложение MetricFilter
- МетрическийФильтр
- Оператор
- Сортировать по
- Тип заказа
- Порядок сортировки
- Сегмент
- Динамический сегмент
- Определение сегмента
- СегментФильтр
- Простой сегмент
- ОрФильтерсФорСегмент
- Предложение SegmentFilter
- SegmentDimensionFilter
- Оператор
- Сегментметрическийфильтр
- Объем
- Оператор
- Сегмент последовательности
- СегментПоследовательностьШаг
- Тип соответствия
- Вращаться
- Когортная группа
- когорта
- Тип
- Отчет
- Заголовок столбца
- Метрикхедер
- MetricHeaderEntry
- PivotHeader
- PivotHeaderEntry
- Данные отчета
- Строка отчета
- ДатаРангеЗначения
- PivotValueRegion
- ResourceQuotasRemaining
- Попробуй это!
Возвращает данные Google Analytics.
HTTP-запрос
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление | |
---|---|
{
"reportRequests": [
{
object( |
Поля | |
---|---|
reportRequests[] | Запросы, на каждый запрос будет отдельный ответ. Запросов может быть максимум 5. Все запросы должны иметь одинаковые |
useResourceQuotas | Включает квоты на основе ресурсов (по умолчанию |
Тело ответа
В случае успеха тело ответа содержит данные следующей структуры:
Основной класс ответа, который содержит отчеты из вызова batchGet
Reporting API.
JSON-представление | |
---|---|
{ "reports": [ { object( |
Поля | |
---|---|
reports[] | Ответы, соответствующие каждому запросу. |
queryCost | Количество токенов квоты ресурсов, вычтенных для выполнения запроса. Включает все ответы. |
resourceQuotasRemaining | Сумма квоты ресурсов, оставшаяся для свойства. |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/analytics.readonly
-
https://www.googleapis.com/auth/analytics
ОтчетЗапрос
Основной класс запроса, определяющий запрос API отчетов.
JSON-представление | |
---|---|
{ "viewId": string, "dateRanges": [ { object( |
Поля | |
---|---|
viewId | Идентификатор представления Analytics, из которого можно получить данные. Каждый ReportRequest в методе |
dateRanges[] | Диапазоны дат в запросе. Запрос может содержать максимум два диапазона дат. Ответ будет содержать набор значений показателей для каждой комбинации параметров для каждого диапазона дат в запросе. Таким образом, если имеется два диапазона дат, будет два набора значений показателей: один для исходного диапазона дат, а другой для второго диапазона дат. Поле |
samplingLevel | Желаемый размер выборки отчета. Если поле |
dimensions[] | Запрошенные размеры. Запросы могут иметь всего 9 измерений. |
dimensionFilterClauses[] | Предложения фильтра измерений для фильтрации значений измерений. Они логически объединяются оператором |
metrics[] | Запрошенные показатели. В запросах должна быть указана хотя бы одна метрика. Всего в запросах может быть до 10 метрик. |
metricFilterClauses[] | Предложения фильтра метрики. Они логически объединяются оператором |
filtersExpression | Фильтры параметров или показателей, которые ограничивают данные, возвращаемые по вашему запросу. Чтобы использовать |
orderBys[] | Порядок сортировки выходных строк. Чтобы сравнить две строки, следующие элементы применяются по порядку, пока не будет найдена разница. Все диапазоны дат в выходных данных получают одинаковый порядок строк. |
segments[] | Сегментируйте данные, возвращаемые по запросу. Определение сегмента помогает просмотреть подмножество запроса сегмента. Запрос может содержать до четырех сегментов. Каждый ReportRequest в методе |
pivots[] | Определения опорных точек. Запросы могут иметь максимум 2 пивота. |
cohortGroup | Когортная группа, связанная с этим запросом. Если в запросе есть когортная группа, должно присутствовать измерение |
pageToken | Токен продолжения для получения следующей страницы результатов. Добавление этого к запросу вернет строки после pageToken. PageToken должно быть значением, возвращаемым в параметре nextPageToken в ответе на запрос report.batchGet. |
pageSize | Размер страницы предназначен для разбиения на страницы и определяет максимальное количество возвращаемых строк. Размер страницы должен быть >= 0. Запрос возвращает значение по умолчанию — 1000 строк. API Analytics Core Reporting возвращает максимум 100 000 строк на каждый запрос, независимо от того, сколько вы запрашиваете. Он также может вернуть меньше строк, чем запрошено, если сегментов измерения не так много, как вы ожидаете. Например, для |
includeEmptyRows | Если установлено значение false, ответ не включает строки, если все полученные метрики равны нулю. По умолчанию установлено значение false, что исключает эти строки. |
hideTotals | Если установлено значение true, скрывается общая сумма всех показателей для всех соответствующих строк для каждого диапазона дат. По умолчанию false, и будут возвращены итоговые значения. |
hideValueRanges | Если установлено значение true, скрывается минимум и максимум во всех совпадающих строках. По умолчанию установлено значение false, и возвращаются диапазоны значений. |
Выборка
Значения уровня выборки.
Перечисления | |
---|---|
SAMPLING_UNSPECIFIED | Если поле samplingLevel не указано, используется уровень выборки DEFAULT . |
DEFAULT | Возвращает ответ с размером выборки, который обеспечивает баланс скорости и точности. |
SMALL | Он возвращает быстрый ответ с меньшим размером выборки. |
LARGE | Возвращает более точный ответ, используя большой размер выборки. Но это может привести к замедлению реакции. |
Измерение
Измерения — это атрибуты ваших данных. Например, измерение ga:city
указывает город, например «Париж» или «Нью-Йорк», из которого происходит сеанс.
JSON-представление | |
---|---|
{ "name": string, "histogramBuckets": [ string ] } |
Поля | |
---|---|
name | Имя извлекаемого измерения, например |
histogramBuckets[] | Если оно не пусто, мы помещаем значения измерения в сегменты после строки в int64. Значения измерений, которые не являются строковым представлением целочисленного значения, будут преобразованы в ноль. Значения сегментов должны быть в порядке возрастания. Каждое ведро закрыто на нижнем конце и открыто на верхнем конце. «Первый» сегмент включает все значения ниже первой границы, «последний» сегмент включает все значения до бесконечности. Значения измерения, попадающие в корзину, преобразуются в новое значение измерения. Например, если дать список «0, 1, 3, 4, 7», то мы вернем следующие сегменты:
ПРИМЕЧАНИЕ. Если вы применяете мутацию гистограммы к какому-либо измерению и используете это измерение при сортировке, для этой цели вам потребуется использовать тип сортировки «<50», «1001+», «121-1000», «50-120» И восходящий порядок «<50», «50-120», «121-1000», «1001+» Клиент должен явно запросить |
Предложение «Фильтр измерения»
Группа фильтров параметров. Установите значение оператора, чтобы указать, как логически объединяются фильтры.
JSON-представление | |
---|---|
{ "operator": enum( |
Поля | |
---|---|
operator | Оператор для объединения нескольких фильтров измерений. Если не указано, оно рассматривается как |
filters[] | Повторяющийся набор фильтров. Они логически объединяются на основе указанного оператора. |
ФильтрЛогическийОператор
Как логически объединяются фильтры.
Перечисления | |
---|---|
OPERATOR_UNSPECIFIED | Неопределенный оператор. Это рассматривается как OR . |
OR | Логический оператор OR . |
AND | Логический оператор AND |
Фильтр размеров
Фильтр измерения определяет параметры фильтрации для измерения.
JSON-представление | |
---|---|
{
"dimensionName": string,
"not": boolean,
"operator": enum( |
Поля | |
---|---|
dimensionName | Измерение для фильтрации. DimensionFilter должен содержать измерение. |
not | Логический оператор |
operator | Как сопоставить размерность с выражением. По умолчанию используется РЕГЭКСП. |
expressions[] | Строки или регулярное выражение для сопоставления. Для сравнения используется только первое значение списка, если только оператор не |
caseSensitive | Должно ли совпадение быть чувствительным к регистру? По умолчанию — ложь. |
Оператор
Поддерживаются различные типы соответствия.
Перечисления | |
---|---|
OPERATOR_UNSPECIFIED | Если тип соответствия не указан, он рассматривается как REGEXP . |
REGEXP | Выражение соответствия рассматривается как регулярное выражение. Все типы соответствия не рассматриваются как регулярные выражения. |
BEGINS_WITH | Соответствует значению, которое начинается с предоставленного выражения соответствия. |
ENDS_WITH | Соответствует значениям, которые заканчиваются указанным выражением соответствия. |
PARTIAL | Совпадение подстроки. |
EXACT | Значение должно полностью соответствовать выражению соответствия. |
NUMERIC_EQUAL | Фильтры целочисленного сравнения. Для них игнорируется регистрозависимость, и предполагается, что выражение представляет собой строку, представляющую целое число. Условия отказа:
|
NUMERIC_GREATER_THAN | Проверяет, превышает ли размерность выражение соответствия. Прочтите описание NUMERIC_EQUALS чтобы узнать об ограничениях. |
NUMERIC_LESS_THAN | Проверяет, является ли размерность численно меньше выражения соответствия. Прочтите описание NUMERIC_EQUALS чтобы узнать об ограничениях. |
IN_LIST | Эта опция используется для указания фильтра измерения, выражение которого может принимать любое значение из выбранного списка значений. Это помогает избежать оценки нескольких фильтров измерения точного соответствия, которые объединяются по логическому оператору ИЛИ для каждой отдельной строки ответа. Например:
Любая строка ответа, измерение которой имеет значение A, B или C, соответствует этому DimensionFilter. |
Метрика
Метрики — это количественные измерения. Например, метрика ga:users
указывает общее количество пользователей за запрошенный период времени.
JSON-представление | |
---|---|
{
"expression": string,
"alias": string,
"formattingType": enum( |
Поля | |
---|---|
expression | Выражение метрики в запросе. Выражение состоит из одной или нескольких метрик и чисел. Допустимые операторы: плюс (+), минус (-), отрицание (унарный -), деление на (/), умножение на (*), круглые скобки, положительные кардинальные числа (0–9), могут включать десятичные дроби и ограничены 1024 символа. Пример |
alias | Псевдоним выражения метрики — это альтернативное имя выражения. Псевдоним можно использовать для фильтрации и сортировки. Это поле является необязательным и полезно, если выражение представляет собой не один показатель, а сложное выражение, которое нельзя использовать при фильтрации и сортировке. Псевдоним также используется в заголовке столбца ответа. |
formattingType | Указывает, как должно быть отформатировано выражение метрики, например |
Тип метрики
Виды метрик.
Перечисления | |
---|---|
METRIC_TYPE_UNSPECIFIED | Тип метрики не указан. |
INTEGER | Целочисленная метрика. |
FLOAT | Плавающая метрика. |
CURRENCY | Валютная метрика. |
PERCENT | Процентная метрика. |
TIME | Метрика времени в формате HH:MM:SS . |
Предложение MetricFilter
Представляет группу фильтров метрик. Установите значение оператора, чтобы указать, как фильтры логически объединяются.
JSON-представление | |
---|---|
{ "operator": enum( |
Поля | |
---|---|
operator | Оператор для объединения нескольких фильтров метрик. Если не указано, оно рассматривается как |
filters[] | Повторяющийся набор фильтров. Они логически объединяются на основе указанного оператора. |
МетрическийФильтр
MetricFilter определяет фильтр по метрике.
JSON-представление | |
---|---|
{
"metricName": string,
"not": boolean,
"operator": enum( |
Поля | |
---|---|
metricName | Метрика, по которой будет выполняться фильтрация. metricFilter должен содержать имя метрики. Имя метрики может быть псевдонимом, ранее определенным как метрика, или выражением метрики. |
not | Логический оператор |
operator | Является ли метрика |
comparisonValue | Значение для сравнения. |
Оператор
Различные варианты типов сравнения.
Перечисления | |
---|---|
OPERATOR_UNSPECIFIED | Если оператор не указан, он рассматривается как EQUAL . |
EQUAL | Должно ли значение метрики быть точно равным значению сравнения. |
LESS_THAN | Если значение метрики меньше значения сравнения. |
GREATER_THAN | Если значение метрики больше значения сравнения. |
IS_MISSING | Проверяет, отсутствует ли метрика. Не учитывает значение сравнения. |
Сортировать по
Задает параметры сортировки.
JSON-представление | |
---|---|
{ "fieldName": string, "orderType": enum( |
Поля | |
---|---|
fieldName | Поле, по которому производится сортировка. Порядок сортировки по умолчанию — по возрастанию. Пример: |
orderType | Тип заказа. Тип заказа по умолчанию — |
sortOrder | Порядок сортировки поля. |
Тип заказа
OrderType управляет тем, как определяется порядок сортировки.
Перечисления | |
---|---|
ORDER_TYPE_UNSPECIFIED | Неуказанный тип заказа будет рассматриваться как сортировка по значению. |
VALUE | Порядок сортировки основан на значении выбранного столбца; смотрит только на первый диапазон дат. |
DELTA | Порядок сортировки основан на разнице значений выбранного столбца между первыми двумя диапазонами дат. Можно использовать только в том случае, если имеется ровно два диапазона дат. |
SMART | Порядок сортировки основан на взвешенном значении выбранного столбца. Если столбец имеет формат n/d, то взвешенное значение этого отношения будет (n + totals.n)/(d + totals.d) Используется только для показателей, представляющих отношения. |
HISTOGRAM_BUCKET | Тип порядка гистограммы применим только к столбцам измерения с непустыми сегментами гистограммы. |
DIMENSION_AS_INTEGER | Если размеры представляют собой числа фиксированной длины, обычная сортировка будет работать нормально. DIMENSION_AS_INTEGER можно использовать, если измерения представляют собой числа переменной длины. |
Порядок сортировки
Порядок сортировки вида.
Перечисления | |
---|---|
SORT_ORDER_UNSPECIFIED | Если порядок сортировки не указан, по умолчанию используется возрастающий. |
ASCENDING | Восходящая сортировка. Поле будет отсортировано по возрастанию. |
DESCENDING | По убыванию. Поле будет отсортировано по убыванию. |
Сегмент
Определение сегмента, если отчет необходимо сегментировать. Сегмент – это подмножество данных Google Analytics. Например, из всего набора пользователей один сегмент может состоять из пользователей из определенной страны или города.
JSON-представление | |
---|---|
{ // Union field |
Поля | ||
---|---|---|
Поле объединения dynamicOrById . Сегмент можно определить динамически с помощью DynamicSegment или с помощью идентификатора встроенного или настраиваемого сегмента. dynamicOrById может быть только одним из следующих: | ||
dynamicSegment | Определение динамического сегмента в запросе. | |
segmentId | Идентификатор встроенного или специального сегмента, например |
Динамический сегмент
Определение динамического сегмента для определения сегмента в запросе. Сегмент может выбирать пользователей, сеансы или и то, и другое.
JSON-представление | |
---|---|
{ "name": string, "userSegment": { object( |
Поля | |
---|---|
name | Имя динамического сегмента. |
userSegment | Сегмент пользователей, чтобы выбрать пользователей для включения в сегмент. |
sessionSegment | Сегмент сеанса, чтобы выбрать сеансы для включения в сегмент. |
Определение сегмента
SegmentDefinition определяет сегмент как набор SegmentFilters, которые объединяются логической операцией AND
.
JSON-представление | |
---|---|
{
"segmentFilters": [
{
object( |
Поля | |
---|---|
segmentFilters[] | Сегмент определяется набором сегментных фильтров, которые объединяются логической операцией |
СегментФильтр
SegmentFilter определяет сегмент как простой или как сегмент последовательности. Простое условие сегмента содержит условия измерения и показателя для выбора сеансов или пользователей. Условие сегмента последовательности можно использовать для выбора пользователей или сеансов на основе условий последовательности.
JSON-представление | |
---|---|
{ "not": boolean, // Union field |
Поля | ||
---|---|---|
not | Если это правда, сопоставить дополнение простого сегмента или сегмента последовательности. Например, чтобы сопоставить все посещения не из «Нью-Йорка», мы можем определить сегмент следующим образом:
| |
Поле объединения simpleOrSequence . Это простой сегмент или определение сегмента последовательности. simpleOrSequence может быть только одним из следующих: | ||
simpleSegment | Простые условия сегмента состоят из одного или нескольких условий измерения/метрики, которые можно комбинировать. | |
sequenceSegment | Условия последовательности состоят из одного или нескольких шагов, где каждый шаг определяется одним или несколькими условиями измерения/метрики. Несколько шагов можно объединить с помощью специальных операторов последовательности. |
Простой сегмент
Условия простого сегмента состоят из одного или нескольких условий измерения/метрики, которые можно комбинировать.
JSON-представление | |
---|---|
{
"orFiltersForSegment": [
{
object( |
Поля | |
---|---|
orFiltersForSegment[] | Список групп сегментных фильтров, которые объединяются логическим оператором |
ОрФильтерсФорСегмент
Список сегментных фильтров в группе OR
объединяется логическим оператором ИЛИ.
JSON-представление | |
---|---|
{
"segmentFilterClauses": [
{
object( |
Поля | |
---|---|
segmentFilterClauses[] | Список фильтров сегментов, которые можно объединить с оператором |
Предложение SegmentFilter
Предложение фильтра, которое будет использоваться в определении сегмента, может быть с фильтром метрики или измерения.
JSON-представление | |
---|---|
{ "not": boolean, // Union field |
Поля | ||
---|---|---|
not | Соответствует дополнению ( | |
Поле объединения dimensionOrMetricFilter . Фильтр измерения или метрики. dimensionOrMetricFilter может иметь только одно из следующих значений: | ||
dimensionFilter | Фильтр измерений для определения сегмента. | |
metricFilter | Фильтр метрик для определения сегмента. |
SegmentDimensionFilter
Фильтр измерения определяет параметры фильтрации для измерения.
JSON-представление | |
---|---|
{
"dimensionName": string,
"operator": enum( |
Поля | |
---|---|
dimensionName | Имя измерения, к которому применяется фильтр. |
operator | Оператор, используемый для сопоставления измерения с выражениями. |
caseSensitive | Если совпадение чувствительно к регистру, оно игнорируется оператором |
expressions[] | Список выражений, для всех операторов используется только первый элемент. |
minComparisonValue | Минимальные значения сравнения для типа соответствия |
maxComparisonValue | Максимальные значения сравнения для типа соответствия |
Оператор
Поддерживаются различные типы соответствия.
Перечисления | |
---|---|
OPERATOR_UNSPECIFIED | Если тип соответствия не указан, он рассматривается как REGEXP. |
REGEXP | Выражение соответствия рассматривается как регулярное выражение. Все остальные типы соответствия не рассматриваются как регулярные выражения. |
BEGINS_WITH | Соответствует значениям, начинающимся с предоставленного выражения соответствия. |
ENDS_WITH | Соответствует значениям, которые заканчиваются указанным выражением соответствия. |
PARTIAL | Совпадение подстроки. |
EXACT | Значение должно полностью соответствовать выражению соответствия. |
IN_LIST | Эта опция используется для указания фильтра измерений, выражение которого может принимать любое значение из выбранного списка значений. Это помогает избежать оценки нескольких фильтров измерения точного соответствия, которые объединяются по логическому оператору ИЛИ для каждой отдельной строки ответа. Например:
Любая строка ответа, измерение которой имеет значение A, B или C, соответствует этому DimensionFilter. |
NUMERIC_LESS_THAN | Фильтры целочисленного сравнения. Для них игнорируется регистрозависимость, и предполагается, что выражение представляет собой строку, представляющую целое число. Условия отказа:
Проверяет, является ли размерность численно меньше выражения соответствия. |
NUMERIC_GREATER_THAN | Проверяет, превышает ли размерность выражение соответствия. |
NUMERIC_BETWEEN | Проверяет, находится ли измерение численно между минимумом и максимумом выражения соответствия, исключая границы. |
Сегментметрическийфильтр
Фильтр метрики, который будет использоваться в предложении фильтра сегмента.
JSON-представление | |
---|---|
{ "scope": enum( |
Поля | |
---|---|
scope | Область действия метрики определяет уровень, на котором определена эта метрика. Указанная область метрики должна быть равна или превышать ее основную область, определенную в модели данных. Основная область определяется тем, выбирает ли сегмент пользователей или сеансы. |
metricName | Метрика, по которой будет выполняться фильтрация. |
operator | Указывает операцию, которую необходимо выполнить для сравнения метрики. По умолчанию |
comparisonValue | Значение для сравнения. Если используется оператор |
maxComparisonValue | Максимальное значение сравнения используется только для оператора |
Объем
Область действия метрики определяет уровень, на котором определена эта метрика: PRODUCT
, HIT
, SESSION
или USER
. Значения метрики также могут сообщаться в областях, превышающих его основную область. Например, ga:pageviews
и ga:transactions
можно сообщать на уровне SESSION
и USER
, просто суммируя их для каждого обращения, которое происходит в этих сеансах или для этих пользователей.
Перечисления | |
---|---|
UNSPECIFIED_SCOPE | Если область не указана, по умолчанию используется область условия USER или SESSION в зависимости от того, пытается ли сегмент выбрать пользователей или сеансы. |
PRODUCT | Объем продукта. |
HIT | Хит прицел. |
SESSION | Область сеанса. |
USER | Область действия пользователя. |
Оператор
Различные варианты типов сравнения.
Перечисления | |
---|---|
UNSPECIFIED_OPERATOR | Неуказанный оператор рассматривается как оператор LESS_THAN . |
LESS_THAN | Проверяет, меньше ли значение метрики значения сравнения. |
GREATER_THAN | Проверяет, превышает ли значение метрики значение сравнения. |
EQUAL | Оператор равенства. |
BETWEEN | Для оператора между минимум и максимум являются исключительными. Для сравнения мы будем использовать LT и GT . |
Сегмент последовательности
Условия последовательности состоят из одного или нескольких шагов, где каждый шаг определяется одним или несколькими условиями измерения/метрики. Несколько шагов можно объединить с помощью специальных операторов последовательности.
JSON-представление | |
---|---|
{
"segmentSequenceSteps": [
{
object( |
Поля | |
---|---|
segmentSequenceSteps[] | Список шагов в последовательности. |
firstStepShouldMatchFirstHit | Если установлено, условие первого шага должно соответствовать первому обращению посетителя (в диапазоне дат). |
СегментПоследовательностьШаг
Определение последовательности сегментов.
JSON-представление | |
---|---|
{ "orFiltersForSegment": [ { object( |
Поля | |
---|---|
orFiltersForSegment[] | Последовательность задается списком сгруппированных фильтров Или, которые объединяются оператором |
matchType | Указывает, предшествует ли шаг непосредственно или может быть в любое время перед следующим шагом. |
Тип соответствия
Тип соответствия последовательности.
Перечисления | |
---|---|
UNSPECIFIED_MATCH_TYPE | Неуказанный тип соответствия рассматривается как предшествующий. |
PRECEDES | Оператор указывает, что предыдущий шаг предшествует следующему шагу. |
IMMEDIATELY_PRECEDES | Оператор указывает, что предыдущий шаг непосредственно предшествует следующему шагу. |
Вращаться
Pivot описывает раздел сводной таблицы в запросе. Функция Pivot помогает упорядочить информацию в таблице для определенных отчетов, сводя данные по второму измерению.
JSON-представление | |
---|---|
{ "dimensions": [ { object( |
Поля | |
---|---|
dimensions[] | Список измерений, которые будут отображаться в виде сводных столбцов. Сводная точка может иметь максимум 4 измерения. Сводные измерения являются частью ограничения на общее количество измерений, разрешенных в запросе. |
dimensionFilterClauses[] | DimensionFilterClauses логически комбинируются с оператором |
metrics[] | Поворотные метрики. Метрики сводной таблицы являются частью ограничения на общее количество метрик, разрешенных в запросе. |
startGroup | Если было запрошено k метрик, то ответ будет содержать некоторое зависящее от данных количество столбцов отчета, кратное k. Например, если вы повернете измерение Следующее позволяет вам выбрать, какая из групп из k столбцов будет включена в ответ. |
maxGroupCount | Указывает максимальное количество возвращаемых групп. Значение по умолчанию — 10, максимальное значение — 1000. |
Когортная группа
Определяет когортную группу. Например:
"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" }
}]
}
JSON-представление | |
---|---|
{
"cohorts": [
{
object( |
Поля | |
---|---|
cohorts[] | Определение когорты. |
lifetimeValue | Включите пожизненную ценность (LTV). LTV измеряет пожизненную ценность пользователей, привлеченных по разным каналам. См.: Когортный анализ и пожизненная ценность. Если значение lifeValue неверно:
Когда lifeValue истинно:
|
когорта
Определяет когорту. Когорта — это группа пользователей, имеющих общие характеристики. Например, все пользователи с одинаковой датой приобретения принадлежат к одной когорте.
JSON-представление | |
---|---|
{ "name": string, "type": enum( |
Поля | |
---|---|
name | Уникальное имя для когорты. Если не указано, имя будет сгенерировано автоматически со значениями cohort_[1234...]. |
type | Тип когорты. На данный момент единственным поддерживаемым типом является |
dateRange | Это используется для когорты |
Тип
Тип когорты.
Перечисления | |
---|---|
UNSPECIFIED_COHORT_TYPE | Если не указано, оно рассматривается как FIRST_VISIT_DATE . |
FIRST_VISIT_DATE | Когорты, выбранные на основе даты первого посещения. |
Отчет
Ответ данных, соответствующий запросу.
JSON-представление | |
---|---|
{ "columnHeader": { object( |
Поля | |
---|---|
columnHeader | Заголовки столбцов. |
data | Данные ответа. |
nextPageToken | Токен страницы для получения следующей страницы результатов в списке. |
Заголовок столбца
Заголовки столбцов.
JSON-представление | |
---|---|
{
"dimensions": [
string
],
"metricHeader": {
object( |
Поля | |
---|---|
dimensions[] | Имена измерений в ответе. |
metricHeader | Заголовки метрик для метрик в ответе. |
Метрикхедер
Заголовки метрик.
JSON-представление | |
---|---|
{ "metricHeaderEntries": [ { object( |
Поля | |
---|---|
metricHeaderEntries[] | Заголовки метрик в ответе. |
pivotHeaders[] | Заголовки для сводных данных в ответе. |
MetricHeaderEntry
Заголовок для метрик.
JSON-представление | |
---|---|
{
"name": string,
"type": enum( |
Поля | |
---|---|
name | Название заголовка. |
type | Тип метрики, например |
PivotHeader
Заголовки для каждого из разделов сводной таблицы, определенных в запросе.
JSON-представление | |
---|---|
{
"pivotHeaderEntries": [
{
object( |
Поля | |
---|---|
pivotHeaderEntries[] | Один заголовок сводного раздела. |
totalPivotGroupsCount | Общее количество групп для этой сводной таблицы. |
PivotHeaderEntry
Заголовки для каждого столбца показателей, соответствующие метрикам, запрошенным в сводном разделе ответа.
JSON-представление | |
---|---|
{
"dimensionNames": [
string
],
"dimensionValues": [
string
],
"metric": {
object( |
Поля | |
---|---|
dimensionNames[] | Имя измерений в сводном ответе. |
dimensionValues[] | Значения размеров в сводной таблице. |
metric | Заголовок метрики в сводной таблице. |
Данные отчета
Часть данных отчета.
JSON-представление | |
---|---|
{ "rows": [ { object( |
Поля | |
---|---|
rows[] | Для каждой уникальной комбинации измерений существует один ReportRow. |
totals[] | Для каждого запрошенного диапазона дат, для набора всех строк, соответствующих запросу, каждый запрошенный формат значения получает итоговое значение. Итоговое значение для формата значения вычисляется путем суммирования метрик, упомянутых в формате значения, а затем оценки формата значения как скалярного выражения. Например, «итогов» для |
rowCount | Общее количество совпадающих строк для этого запроса. |
minimums[] | Минимальные и максимальные значения, наблюдаемые во всех совпадающих строках. Оба они пусты, если |
maximums[] | Минимальные и максимальные значения, наблюдаемые во всех совпадающих строках. Оба они пусты, если |
samplesReadCounts[] | Если результаты являются выборочными , возвращается общее количество прочитанных образцов, по одной записи на диапазон дат. Если результаты не выбраны, это поле не будет определено. Подробности смотрите в руководстве разработчика . |
samplingSpaceSizes[] | Если результаты являются выборочными , возвращается общее количество имеющихся выборок, по одной записи на диапазон дат. Если результаты не выбраны, это поле не будет определено. Подробности смотрите в руководстве разработчика . |
isDataGolden | Указывает, является ли ответ на этот запрос золотым или нет. Данные являются золотыми, когда тот же самый запрос не даст никаких новых результатов, если его задать в более поздний момент времени. |
dataLastRefreshed | Время последнего обновления данных в отчете. Все обращения, полученные до этой отметки времени, включаются в расчет отчета. Временная метка в формате RFC3339 UTC «Зулу» с точностью до наносекунд. Пример: |
Строка отчета
В отчете строка.
JSON-представление | |
---|---|
{
"dimensions": [
string
],
"metrics": [
{
object( |
Поля | |
---|---|
dimensions[] | Список требуемых размеров. |
metrics[] | Список метрик для каждого запрошенного DateRange. |
ДатаРангеЗначения
Используется для возврата списка показателей для одной комбинации DateRange/размера.
JSON-представление | |
---|---|
{
"values": [
string
],
"pivotValueRegions": [
{
object( |
Поля | |
---|---|
values[] | Каждое значение соответствует каждой метрике в запросе. |
pivotValueRegions[] | Значения каждого сводного региона. |
PivotValueRegion
Значения метрики в сводной области.
JSON-представление | |
---|---|
{ "values": [ string ] } |
Поля | |
---|---|
values[] | Значения показателей в каждом из опорных регионов. |
ResourceQuotasRemaining
Токены квоты ресурсов, оставшиеся для свойства после завершения запроса.
JSON-представление | |
---|---|
{ "dailyQuotaTokensRemaining": number, "hourlyQuotaTokensRemaining": number } |
Поля | |
---|---|
dailyQuotaTokensRemaining | Осталась ежедневная квота ресурсов. |
hourlyQuotaTokensRemaining | Остались жетоны почасовой квоты ресурсов. |