Локализация и расшифровка значений группировок

Значения некоторых группировок могут быть представлены как идентификатором, так и его текстовой расшифровкой. Текстовые расшифровки локализованы, то есть переводятся на текущий выбранный в API язык.

Группировки, поддерживающие расшифровку идентификаторов, можно определить по колонке Расшифровка в разделе Группировки. Для таких измерений API вернет ключ id — идентификатор значения данного измерения, и ключ name — расшифровку значения на языке запроса.

При фильтрации и работе с drill down для таких группировок используйте идентификаторы.

Управлять языком запроса можно с помощью параметра lang, принимаемого всеми методами API, или с помощью выбора домена верхнего уровня, по которому производится обращение в API.

Если параметр lang не указан, по умолчанию используется значение en и международная геобаза. Укажите в запросе lang=ru, если:

• в фильтре есть кириллические символы;
• ваши пользователи находятся в домене ru (чтобы отчет по географии аудитории формировался корректно).

Пример

Рассмотрим запрос:

https://api-metrika.yandex.net/stat/v1/data?id=44147844&dimensions=ym:s:<attribution>TrafficSource&metrics=ym:s:visits

...
{
    "dimensions": [
        {
            "id": "organic",
            "name": "Traffic from search engines"
        }
    ],
    "metrics": [
        ...
    ]
}
...

где

• id — идентификатор значения ym:s:<attribution>TrafficSource;

• name — расшифровка.

Для фильтрации отчета по поисковым системам можно использовать следующий синтаксис: filters=ym:s:<attribution>TrafficSource=='organic'.

Значения источников трафика