Таблица

Предоставляет доступ к статистическим данным, включая данные, доступные в отчетах. Возвращает результат в виде таблицы.

Request

GET

https://api.appmetrica.yandex.net/stat/v1/data

Query parameters

Name

Description

params

Type: ConstructorParams

Example: ``

statGroupParams

Type: StatGroupParams

Example: ``

ConstructorParams

Name	Description
access_filter_id	Type: integer
accuracy	Type: string Example: `example`
callback	Type: string Example: `example`
confidence_level	Type: string Default: `0.95`
date_dimension	Type: string Example: `example`
date1	Type: string Default: `6daysAgo`
date2	Type: string Default: `today`
dimensions	Type: string Example: `example`
direct_client_ids	Type: integer[] Example `[ 0 ]`
direct_client_logins	Type: string[] Example `[ "example" ]`
exclude_insignificant	Type: boolean
filters	Type: string Example: `example`
ids	Type: integer[] Example `[ 0 ]`
include_meta	Type: boolean
include_undefined	Type: boolean
lang	Type: string Example: `example`
limit	Type: string Default: `100`
max_deviation	Type: string Default: `0.1`
metrics	Type: string Example: `example`
offset	Type: string Default: `1`
preset	Type: string Example: `example`
pretty	Type: string Default: `false`
proposed_accuracy	Type: boolean
reference_row_id	Type: string[] Example `[ "example" ]`
request_domain	Type: string Example: `example`
require_metric_values	Type: string Default: `false`
sort	Type: string Example: `example`
timezone	Type: string Example: `example`
with_confidence	Type: boolean

Example

{
  "ids": [
    0
  ],
  "direct_client_ids": [
    0
  ],
  "direct_client_logins": [
    "example"
  ],
  "date1": "6daysAgo",
  "date2": "today",
  "timezone": "example",
  "preset": "example",
  "metrics": "example",
  "dimensions": "example",
  "reference_row_id": [
    "example"
  ],
  "filters": "example",
  "accuracy": "example",
  "proposed_accuracy": true,
  "include_undefined": true,
  "include_meta": true,
  "with_confidence": true,
  "exclude_insignificant": true,
  "confidence_level": "0.95",
  "max_deviation": "0.1",
  "pretty": "false",
  "lang": "example",
  "request_domain": "example",
  "require_metric_values": "false",
  "access_filter_id": 0,
  "callback": "example",
  "date_dimension": "example",
  "sort": "example",
  "limit": "100",
  "offset": "1"
}

StatGroupParams

Name

Description

label_id

Type: integer

Min value: 1

org_id

Type: integer

Min value: 1

Example

{
  "org_id": 1,
  "label_id": 1
}

Responses

200 OK

Body

application/json

{
  "query": {
    "ids": [
      0
    ],
    "timezone": "example",
    "preset": "example",
    "dimensions": [
      "example"
    ],
    "metrics": [
      "example"
    ],
    "sort": [
      "example"
    ],
    "date1": "example",
    "date2": "example",
    "filters": "example",
    "limit": 0,
    "offset": 0
  },
  "data": [
    {
      "dimensions": [
        {}
      ],
      "metrics": [
        0.5
      ]
    }
  ],
  "meta": {
    "dimensions": [
      {
        "id": "example",
        "dim": "example",
        "name": "example",
        "short_name": "example",
        "group_name": "example",
        "description": "example",
        "type": "example",
        "disallow_by_time": true,
        "allow_filters": true,
        "parameter": {
          "id": "example",
          "description": "example",
          "dim": "example"
        },
        "fields": {},
        "allow_sort": true,
        "default_sort": "example",
        "allow_null": true,
        "sub_table": "example",
        "permission_scope": "example",
        "since": "example",
        "advanced": true,
        "required_keys": [
          "example"
        ],
        "features": [
          "example"
        ],
        "chained_attributes_group_name": "example",
        "chained_attributes_group_index": 0,
        "secret": true,
        "exposes_secret_data": true,
        "disjoint": true,
        "relations": [
          "example"
        ]
      }
    ],
    "metrics": [
      {
        "dim": "example",
        "metric_string": "example",
        "name": "example",
        "description": "example",
        "allow_normalisation": true,
        "require_dynamic_correction": true,
        "allow_filters": true,
        "type": "example",
        "allow_sort": true,
        "default_sort": "example",
        "advanced": true,
        "support_confidence": true,
        "negative": true,
        "parameters": [
          null
        ],
        "sub_table": "example",
        "required_dimension": "example",
        "permission_scope": "example",
        "since": "example",
        "required_keys": [
          "example"
        ],
        "features": [
          "example"
        ],
        "secret": true,
        "exposes_secret_data": true
      }
    ]
  },
  "total_rows": 0,
  "total_rows_rounded": true,
  "with_confidence": true,
  "exclude_insignificant": true,
  "sampled": true,
  "sampleable": true,
  "contains_sensitive_data": true,
  "sample_share": 0.5,
  "max_sample_share": 0.5,
  "min_sample_share": 0.5,
  "sample_size": 0,
  "sample_space": 0,
  "data_lag": 0,
  "totals": [
    0.5
  ],
  "min": [
    0.5
  ],
  "max": [
    0.5
  ]
}

Name	Description
contains_sensitive_data	Type: boolean Признак возможного отсутствия конфиденциальных данных в ответе. К ним относятся данные, которые рассчитываются алгоритмами Яндекса, например, социально-демографические (пол, возраст и др.), адреса страниц входа, поисковые фразы, информация о роботах. При значении `true` в ответе не отобразятся такие данные, если выборка составляет меньше 10 посетителей. Возможные значения: `true`, `false`.
data	Type: StaticRow[] Example `[ { "dimensions": [ {} ], "metrics": [ 0.5 ] } ]`
data_lag	Type: integer Задержка в обновлении данных, в секундах.
max	Type: number[] Example `[ 0.5 ]`
meta	Type: Meta Метаданные запроса. Содержит описание группировок и метрик запроса. Example { "dimensions": [ { "id": "example", "dim": "example", "name": "example", "short_name": "example", "group_name": "example", "description": "example", "type": "example", "disallow_by_time": true, "allow_filters": true, "parameter": { "id": "example", "description": "example", "dim": "example" }, "fields": {}, "allow_sort": true, "default_sort": "example", "allow_null": true, "sub_table": "example", "permission_scope": "example", "since": "example", "advanced": true, "required_keys": [ "example" ], "features": [ "example" ], "chained_attributes_group_name": "example", "chained_attributes_group_index": 0, "secret": true, "exposes_secret_data": true, "disjoint": true, "relations": [ "example" ] } ], "metrics": [ { "dim": "example", "metric_string": "example", "name": "example", "description": "example", "allow_normalisation": true, "require_dynamic_correction": true, "allow_filters": true, "type": "example", "allow_sort": true, "default_sort": "example", "advanced": true, "support_confidence": true, "negative": true, "parameters": [ null ], "sub_table": "example", "required_dimension": "example", "permission_scope": "example", "since": "example", "required_keys": [ "example" ], "features": [ "example" ], "secret": true, "exposes_secret_data": true } ] }
min	Type: number[] Example `[ 0.5 ]`
query	Type: QueryExternal Исходный запрос. Содержит параметры запроса, включая развернутые параметры из шаблона и параметры для схемы параметризации атрибутов. Example `{ "ids": [ 0 ], "timezone": "example", "preset": "example", "dimensions": [ "example" ], "metrics": [ "example" ], "sort": [ "example" ], "date1": "example", "date2": "example", "filters": "example", "limit": 0, "offset": 0 }`
sample_share	Type: number Доля данных, по которым осуществлялся расчет. Доступно значение в пределах от 0 до 1.
sample_size	Type: integer Количество строк в выборке данных.
sample_space	Type: integer Количество строк данных.
sampled	Type: boolean Признак семплирования. Показывает, был ли применен семплинг. Возможные значения: `true`, `false`.
total_rows	Type: integer Общее количество строк в ответе по всему множеству данных (с учетом фильтра).
total_rows_rounded	Type: boolean Признак того, что общее количество строк было округлено.
totals	Type: number[] Example `[ 0.5 ]`

QueryExternal

Исходный запрос. Содержит параметры запроса, включая развернутые параметры из шаблона и параметры для схемы параметризации атрибутов.

Name	Description
date1	Type: string Дата начала периода выборки в формате YYYY-MM-DD. Example: `example`
date2	Type: string Дата окончания периода выборки в формате YYYY-MM-DD. Example: `example`
dimensions	Type: string[] Example `[ "example" ]`
filters	Type: string Фильтр сегментации. Example: `example`
limit	Type: integer Количество элементов на странице выдачи.
metrics	Type: string[] Example `[ "example" ]`
offset	Type: integer Индекс первой строки выборки, начиная с 1.
preset	Type: string Пресет отчета. Example: `example`
sort	Type: string[] Example `[ "example" ]`
timezone	Type: string Часовой пояс периода выборки в формате ±hh:mm. Example: `example`

Example

{
  "timezone": "example",
  "preset": "example",
  "dimensions": [
    "example"
  ],
  "metrics": [
    "example"
  ],
  "sort": [
    "example"
  ],
  "date1": "example",
  "date2": "example",
  "filters": "example",
  "limit": 0,
  "offset": 0
}

StaticRow

Строки ответа. Представляет собой массив, каждый элемент которого — одна строка результата.

Name

Description

dimensions

Type: object[]

[additional]

Type: string

Example: example

Массив значений группировок для данной строки. Каждое из значений группировки представляет собой объект. В нем обязательно присутствует поле name — текстовое значение, но могут присутствовать дополнительные поля, например идентификатор — id.

Example

[
  {}
]

metrics

Type: number[]

Example

[
  0.5
]

Example

{
  "dimensions": [
    {}
  ],
  "metrics": [
    0.5
  ]
}

ParamMetaExternal

Список параметров метрики

Name	Description
description	Type: string Описание параметра Example: `example`
dim	Type: string Имя измерения с значениями Example: `example`
id	Type: string Идентификатор параметра Example: `example`

Example

{
  "id": "example",
  "description": "example",
  "dim": "example"
}

DimensionMetaExternal

Name

Description

advanced

Type: boolean

Группировка для опытного пользователя

allow_filters

Type: boolean

Возможно ли использование фильтров

allow_null

Type: boolean

Разрешается ли показывать для этой группировки "Не определено"

allow_sort

Type: boolean

Возможно ли сортировать по этой группировке

chained_attributes_group_index

Type: integer

Порядок группировки в группе связанных группировок

chained_attributes_group_name

Type: string

Имя группы связанных группировок

Example: example

default_sort

Type: string

Способ сортировки:

asc
desc

Example: example

description

Type: string

Описание метрики

Example: example

dim

Type: string

Группировка

Example: example

disallow_by_time

Type: boolean

Запрещено ли для этой группировки сочетание с группировкой по времени.

features

Type: string[]

Характеристики счетчика, необходимые для использования группировки

Unique items: true

Example

[
  "example"
]

fields

Type: object

[additional]

Type: DimensionMetaExternal

Example

{
  "id": "example",
  "dim": "example",
  "name": "example",
  "short_name": "example",
  "group_name": "example",
  "description": "example",
  "type": "example",
  "disallow_by_time": true,
  "allow_filters": true,
  "parameter": {
    "id": "example",
    "description": "example",
    "dim": "example"
  },
  "fields": {},
  "allow_sort": true,
  "default_sort": "example",
  "allow_null": true,
  "sub_table": "example",
  "permission_scope": "example",
  "since": "example",
  "advanced": true,
  "required_keys": [
    "example"
  ],
  "features": [
    "example"
  ],
  "chained_attributes_group_name": "example",
  "chained_attributes_group_index": 0,
  "secret": true,
  "exposes_secret_data": true,
  "disjoint": true,
  "relations": [
    "example"
  ]
}

Дополнительные поля для этой группировки

Example

{}

group_name

Type: string

Название группировки при перечислении

Example: example

Type: string

Идентификатор группировки без префикса и параметров

Example: example

name

Type: string

Название группировки

Example: example

parameter

Type: ParamMetaExternal

Список параметров метрики

Example

{
  "id": "example",
  "description": "example",
  "dim": "example"
}

permission_scope

Type: string

Группа доступа к группировке

Example: example

required_keys

Type: string[]

Example

[
  "example"
]

short_name

Type: string

Название группировки

Example: example

since

Type: string

Дата появления данных для группировки

Example: example

sub_table

Type: string

Подтаблица

Example: example

type

Type: string

Интерфейсный тип группировки

Example: example

Example

{
  "id": "example",
  "dim": "example",
  "name": "example",
  "short_name": "example",
  "group_name": "example",
  "description": "example",
  "type": "example",
  "disallow_by_time": true,
  "allow_filters": true,
  "parameter": {
    "id": "example",
    "description": "example",
    "dim": "example"
  },
  "fields": {},
  "allow_sort": true,
  "default_sort": "example",
  "allow_null": true,
  "sub_table": "example",
  "permission_scope": "example",
  "since": "example",
  "advanced": true,
  "required_keys": [
    "example"
  ],
  "features": [
    "example"
  ],
  "chained_attributes_group_name": "example",
  "chained_attributes_group_index": 0
}

MetricMetaExternal

Массив метаданных метрик запроса.

Name	Description
advanced	Type: boolean Метрика для опытных пользователей
allow_filters	Type: boolean Возможно ли использование фильтров
allow_normalisation	Type: boolean Возможна ли нормализация значений
allow_sort	Type: boolean Возможно ли сортировать по этой метрике
default_sort	Type: string Способ сортировки: `asc` `desc` Example: `example`
description	Type: string Описание метрики Example: `example`
dim	Type: string Метрика Example: `example`
exposes_secret_data	Type: boolean Раскрывает секретные данные
features	Type: string[] Характеристики счетчика, необходимые для использования метрики Unique items: `true` Example `[ "example" ]`
metric_string	Type: string Метрика со значением параметра Example: `example`
name	Type: string Название метрики Example: `example`
negative	Type: boolean Является ли метрика отрицательным индикатором в контексте интерпретации данных, например: процент отказов, роботов и т.д.
parameters	Type: ParamMetaExternal[] Список параметров метрики Example `[ { "id": "example", "description": "example", "dim": "example" } ]`
permission_scope	Type: string Группа доступа к метрике Example: `example`
require_dynamic_correction	Type: boolean Необходима ли корректировка значения в отчете по времени
required_dimension	Type: string Необходимая для метрики группировка Example: `example`
required_keys	Type: string[] Example `[ "example" ]`
secret	Type: boolean Содержит секретные данные
since	Type: string Дата появления данных для метрики Example: `example`
sub_table	Type: string Подтаблица Example: `example`
support_confidence	Type: boolean Возможен ли расчет доверия для этой метрики
type	Type: string Тип метрики. `int` `double` `second` `millisecond` `affinity` `percents` `currency` Example: `example`

Example

{
  "dim": "example",
  "metric_string": "example",
  "name": "example",
  "description": "example",
  "allow_normalisation": true,
  "require_dynamic_correction": true,
  "allow_filters": true,
  "type": "example",
  "allow_sort": true,
  "default_sort": "example",
  "advanced": true,
  "support_confidence": true,
  "negative": true,
  "parameters": [
    {
      "id": "example",
      "description": "example",
      "dim": "example"
    }
  ],
  "sub_table": "example",
  "required_dimension": "example",
  "permission_scope": "example",
  "since": "example",
  "required_keys": [
    "example"
  ],
  "features": [
    "example"
  ],
  "secret": true,
  "exposes_secret_data": true
}

Была ли статья полезна?

Операторы

Drill down