Документация
Справочник разработчика
API управления
Управление клиентами Директа
API отчетов v1
Группировки
Клики
Параметры посетителей

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

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

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

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

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

Пример

Рассмотрим следующий запрос:

...
{
    "dimensions": [
        {
            "id": "organic",
            "name": "Переходы из поисковых систем"
        }
    ],
    "metrics": [
        ...
    ]
}
...

где

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

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

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