rym: API управления Яндекс.Метрики

Alexey Seleznev

2019-12-10

Работа с API управления

Для работы с API управления в rym вам доступны следующие функции:

Набор аргументов для всех перечисленных выше функций одинаков:

Описание полей возвращаемых функциями API управления

Списоок полей возвращаемых функцией rym_get_counters

  • id - Номер счётчика Яндекс.Метрики.
  • status - Статус счетчика. Active — Счетчик активен, Deleted — Счетчик удален.
  • owner_login - Логин владельца счетчика.
  • name - Наименование счетчика.
  • code_status - Статус установки кода счетчика. Возможные значения:
    • CS_ERR_INFECTED — не удалось проверить (сайт, на котором установлен счетчик или одно из его зеркал находится в списке зараженных сайтов).
    • CS_NOT_FOUND — Не установлен.
    • CS_ERR_OTHER_HTML_CODE — установлен другой счетчик.
    • CS_ERR_CONNECT — не удалось проверить (ошибка соединения).
    • CS_ERR_TIMEOUT — не удалось проверить (превышено время ожидания).
    • CS_OK — Корректно установлен.
  • site - Полный домен сайта.
  • permission - Уровень доступа к счетчику. Возможные значения:
    • view — гостевой счетчик с уровнем доступа «только просмотр»;
    • edit — гостевой счетчик с уровнем доступа «полный доступ»;
    • own — счетчик, принадлежащий пользователю.
  • type - Тип информера. Возможные значения:
    • ext — расширенный (по умолчанию).
    • simple — простой;
  • gdpr_agreement_accepted - Принято соглашение gdpr.

Списоок полей возвращаемых функцией rym_get_filters

  • id - Идентификатор фильтра.
  • attr - Тип данных, к которым применяется фильтр. Возможные значения:
    • referer — реферер;
    • uniq_id — специальный атрибут для фильтра «не учитывать мои визиты»;
    • client_ip — IP-адрес;
    • title — заголовок страницы;
    • url — URL страницы.
  • type - Отношение или действие для фильтра. Возможные значения:
    • equal — равно;
    • contain — содержит;
    • me — мои посещения, используется только с типом данных attr = uniq_id;
    • start — начинается с;
    • interval — в интервале, используется только с типом данных «IP-адрес» (attr = client_ip);
    • only_mirrors — только сайт и зеркала, используется только для типа данных «URL страницы» (attr = url) и типа фильтра «оставить только трафик» (action = include), а также при условии, что для счетчика заданы зеркала.
  • value - Значение фильтра.
  • action - Тип фильтра. include — оставить только трафик, exclude — исключить трафик.
  • status - Статус фильтра. Возможные значения:
    • active — фильтр используется;
    • disabled — фильтр отключен (без удаления).
  • with_subdomains - Фильтровать по поддоменам.
  • start_ip - Первый IP-адрес диапазона.
  • end_ip - Последний IP-адрес диапазона.

Списоок полей возвращаемых функцией rym_get_segments

  • id - Идентификатор сегмента.
  • counter_id - Идентификатор счетчика.
  • name - Название сегмента.
  • expression - Выражение, которое соответствует значению параметра filters.
  • is_retargeting - Является ли данный сегмент ретаргетинговым
  • segment_source - Источник сегмента. Указывает на способ его создания. Принимает значение api — используются сегменты, созданные с помощью API.

Списоок полей возвращаемых функцией rym_get_goals

  • id - Идентификатор цели.
  • name - Наименование цели.
  • type - Тип цели. Возможные значения.
    • number — просмотр N страниц;
    • action — цель типа событие.
    • step — составная цель;
    • url — совпадение по URL страницы;
  • is_retargeting - Является ли цель ретаргетинговой.
  • conditions - Cписок структур с условиями цели. Состоит из параметров type и url:
    • type - Тип условия. Возможные значения:
      • regexp — удовлетворяет регулярному выражению;
      • contain — содержит;
      • start — начинается с;
      • exact — совпадает;
      • action — специальный тип условия для целей типа action.
    • url - Адрес страницы или части страницы для условия.

Списоок полей возвращаемых функцией rym_get_direct_clients

  • id - Идентификатор клиента Директа.
  • name - Имя клиента, указанное в настройках Директа.
  • chief_login - Логин главного представителя клиента в Директе. Может использоваться для формирования отчета Директ-расходы.

Списоок полей возвращаемых функцией rym_users_grants

  • user_login - Логин пользователя, которому выдано разрешение на управление счетчиком. Параметр содержит пустую строку, если к статистике счетчика предоставлен публичный доступ (perm = public_stat)
  • perm - Уровень доступа. Возможные значения:
    • view — только просмотр;
    • edit — полный доступ;
    • public_stat — публичный доступ к статистике.
  • created_at - Дата предоставления доступа в формате YYYY-MM-DD’T’hh:mm:ssZ.
  • comment - Произвольный комментарий. Количество символов не должно превышать 255.
  • partner_data_access - Является и доступ партнёрским.

Пример работы с API управления

При использовании приведённого нже примера замените “ваш логин”* на логин пользователя Яндекса, под которым есть доступ к нужному вам счётчику Яндекс.Метрики, вместо 000000000 введите номер нужного вам счётчика.*