Гостевой счетчик что это

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

Alexey Seleznev

2021-09-03

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

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

• rym_get_counters() — список доступных счётчиков Яндекс.Метрики;
• rym_get_filters() — список настроенных фильтров в счётчике;
• rym_get_segments() — список настроенных сегмнтов в счётчике Яндекс.Метрики;
• rym_get_goals() — список настроенных целей в Яндекс.Метрике;
• rym_get_direct_clients() — данные о клиентах Яндекс.Директа, к кампаниям которых есть доступ у владельца счетчика Метрики;
• rym_users_grants() — список пользователей, у которых есть доступ к счётчику Яндекс.Метрики, с указанием уровня доступа.
• rym_add_goal() — создать цель в Яндекс Метрике.
• rym_add_segment() — создать сегмент в API Яндекс Метрики.

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

• counter — Id счётчика Яндекс.Метрики;
• login — имя пользователя, под которым доступен нужный счётчик Яндекс.Метрики. Используется при авторизации и при поиске файла, в котором хранятся учётные данные пользователя;
• token.path — путь к папке, в которой хранится файл с учётными данными.

Описание полей возвращаемых функциями 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 введите номер нужного вам счётчика.*

Создание целей в Яндекс Метрике

Для создания цели в Яндекс Метрике используйте функцию rym_add_goal() .

Аргументы

• name — Наименование цели.
• type — Тип цели.
  • Возможные значения
    • number — просмотр N страниц;
    • action — цель типа событие.
    • step — составная цель;
    • url — совпадение по URL страницы;
• is.retargeting — Является ли цель ретаргетинговой
• flag — Тип цели для клиентов Яндекс.Маркета.
  • Возможные значения
    • basket — «корзина», страница посещения корзины;
    • order — «заказ», страница подтверждения заказа.
• conditions — Cписок структур с условиями цели.
  • type — Тип условия.
    • regexp — удовлетворяет регулярному выражению;
    • contain — содержит;
    • start — начинается с;
    • exact — совпадает;
    • action — специальный тип условия для целей типа action.
  • url — Адрес страницы или части страницы для условия.

Создание сегментов в Яндекс Метрике

Сегмент можно создать с помощью функции rym_add_segment() . Созданный с помощью API сегмент не отображается в веб-интерфейсе Яндекс.Метрики.

Яндекс Метрика: отслеживание ip адресов посетителей

Очень часто у начинающих вебмастеров и владельцев сайта возникает проблема определения ip адреса пользователей, которые заходили на сайт. Разумеется можно лезть в логи хостинга и сложным путем вычислять именно того посетителя, который нас интересует, однако этот метод сложен и трудоёмок. У нас имеется гораздо более простое и элегантное решение с использованием счетчика Яндекс Метрика.

Яндекс.Метрика позволяет связать с визитом произвольный набор данных, называемых параметрами визита. Эти данные могут быть отображены в отчетах, а также использоваться в условиях группировки и сегментации.

Решение 1. Для сайтов, работающих на PHP

Типовой код счетчика Яндекс Метрика на большинстве сайтов, размещается в основном файле шаблона, который представляет собой файл типа index.php. Найти и отредактировать этот файл можно через подключение к сайту по ftp или через редактор шаблона сайта, если такой предусмотрен используемой платформой.

Здесь и далее символами XXXXXX обозначен номер счетчика (идентификатор) Яндекс Метрика. Свой номер счетчика можно посмотреть в настройках Яндекс Метрики.

Добавим к стандартному коду счетчика следующую строку в самом начале.

Здесь мы добавили переменную в yaParams, которой присвоили массив из одного параметра ip со значением ip адреса, который определяется глобальной переменной PHP, которая определена ip адресом пользователя.

Далее добавим параметр yaParams непосредственно в функцию, которая отправляет данные в Яндекс.

Внимание! Параметр должен быть добавлен сразу после параметра id.

В результате получаем следующий код, который должен быть вставлен вместо старого кода Яндекс Метрики.

Решение 2. Универсальное JS решение

Если ваш сайт работает на:

• конструкторе сайтов,
• хостинг не поддерживает PHP
• у вас нет возможности добавлять (выполнять) PHP скрипты, но есть возможность редактировать HTML шаблон сайта,

То это решение для вас.

Суть решения такова, что скрипт в процессе загрузки страницы обращается за ip адресом посетителя на специально созданный для это удаленный ресурс http://ip.up66.ru/ и далее, после получения ответа, отдает ip адрес посетителя сайта в Яндекс Метрику.

Как узнать ip адрес в Яндекс Метрике

После внесенных изменений в счетчик ip адреса пользователей будут доступны в отчетах Яндекс Метрики, а также в Вебвизоре.

Вебвизор

Чтобы включить их в результирующую таблицу необходимо добавить столбец с параметрами через кнопку слева «Столбцы».

И далее выбрать пункт для отображения «Параметры» и сохранить изменения через нажатие кнопки «Применить».

Отчет Яндекс Метрики

Посмотреть активность пользователей по ip адресам за выбранный период можно через отчет «Стандартные отчеты» -> «Содержание» -> «Параметры визитов».

Для чего нужно знать ip адрес посетителя?

Наличие информации об ip адресе позволяет владельцу сайта:

• ограничить доступ по ip для нежелательных посетителей (например, конкурентов или роботов, имитирующих поведение пользователей);
• определить лиц, которые скликивают контекстную рекламу и заблокировать показ рекламных объявлений по этим ip адресам;
• получить более точную информацию о месторасположении пользователя и характеристиках его интернет-соединения.

Как удалённо собрать показания электросчётчика

В наше время всё становится умным и даже счётчики для сбора данных по расходу электроэнергии и воды. Если вам захотелось смотреть показания счётчика со смартфона или компьютера, из этой статьи вы поймёте, что проще ничего не делать.

Что такое умный счётчик?

Обыкновенный электрический счётчик — это прибор, определяющий потребление электроэнергии переменного или постоянного тока. В свою очередь, умный электросчётчик выполняет ту же функцию, но ещё помогает получать данные о расходе энергии в оцифрованном виде на компьютер или смартфон. В устройстве такого счётчика есть встроенный контроллер, который оцифровывает измерительные данные и отправляет их на сервер. Сервер помогает хранить и анализировать полученную информацию. Он хранится в дата-центре и посредством доступа в интернет позволяет владельцам устройства изучать данные через личный кабинет на компьютере и любом мобильном устройстве.

Это очень удобно! Умный счётчик всегда продаётся с сопутствующим мобильным приложением, на которое регулярно приходит информация о расходе энергии. Владелец счётчика может анализировать расход за каждый месяц года, получать информацию о сбоях в линии и т.д. Помимо этого, дистанционный доступ к счётчику позволяет сдавать показания по расходу электроэнергии, если владелец квартиры находится в отпуске или командировке. Также это удобный способ проверить потребление электроэнергии в квартире, которая сдаётся в аренду.

Какие бывают умные счётчики?

Существует большое разнообразие умных счётчиков. Они могут отличаться — в зависимости от измеряемого ресурса (счётчики для измерения электричества, газа, тепла, воды). Помимо этого, различаются два типа счётчиков по способу передачи информации:

• С проводным подключением.
• С беспроводным подключением.

Счётчики с проводным подключением постепенно становятся менее популярными ввиду большой цены и сложности установки. Сегодня существует множество развитых систем для беспроводной передачи данных, которые могут гарантировать бесперебойную работу устройства измерительного прибора. К таким системам относятся Wi-Fi, NB-IoT, LPWAN (LoRa, XNB, Sigfox и т.д.), GPRS, BlueTooth, ZigBee, Z-wave.

По типу питания различаются автономные и стационарные счётчики. Автономные счётчики требуют периодической смены батареек, тогда как для стационарных приборов необходимо подключение от розетки.

Различаются две конфигурации счётчиков — интегрированная и внешняя. В интегрированной системе счётчик и контроллер расположены в одном корпусе. Такие счётчики более просты в установке и обслуживании, поэтому их чаще можно встретить. В свою очередь, внешняя конфигурация подразумевает наличие отдельного блока, который отвечает за обработку и передачу данных. Главное преимущество внешнего счётчика в том, что его передатчик можно использовать сразу для нескольких приборов.

Как работает дистанционный сбор данных?

Умный счётчик производит сбор данных, полученных от измерительного прибора, и отправляет их через контроллер в облачное хранение (сервер). Владелец счётчика может зайти в личный кабинет на сервере, используя компьютер или приложение на мобильном устройстве. Для передачи данных контроллер использует Wi-Fi (любая сеть, которую для этого выделят).

Большим преимуществом многих марок умных счётчиков является возможность подключать до 8-10 измерительных приборов в один контроллер. Это позволяет собирать данные о расходе электроэнергии сразу нескольким квартирам на одной лестничной площадке.

Как установить умный счётчик?

Согласно Федеральному Закону №522 «О внесении изменений в отдельные законодательные акты Российской Федерации в связи с развитием систем учёта электрической энергии в Российской Федерации» с 1 июля 2020 года начался переход на новый тип счётчиков. С этой даты ресурсоснабжающие компании должны начать установку умных счётчиков в строящихся домах. Самостоятельно купить и установить счётчик — запрещено.

Предоставлением и установкой счётчика занимается исключительно компания-поставщик электроэнергии. Если старый прибор вышел из строя либо завершился срок его проверки или эксплуатации, поставщик электроэнергии должен бесплатно предоставить на замену новый умный счётчик. Исправные счётчики старого образца могут быть использованы вплоть до даты окончания срока эксплуатации. При этом, согласно данным от Министерства Энергетики РФ, домовладельцы могут отказаться от умного счётчика и устанавливать приборы старого типа до 1 января 2022 года

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

Контроллеры, работа которых осуществляется посредством системы передачи данных (LPWAN), могут быть использованы для крупных объектов, требующих большого количества подключений. Это многоэтажные дома, крупные предприятия и т.п.

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

Для обычного городского пользования, в квартире и частном доме, удобнее всего использовать Wi-Fi-подключение.

Умный счётчик — незаменимый помощник для организации более практичного быта. Эта технология помогает всегда иметь под рукой данные о потреблении энергии и делает более практичным взаимодействие с компанией-поставщиком ресурсов.

Яндекс Метрика для новичков

Приветствую! Я начинаю серию статей о функционале Яндекс Метрики. Мы с вами узнаем, куда смотреть в первую очередь, как строить отчеты и какие выводы делать. Но как всегда:

Яндекс Метрика Начало

Мы зашли в счетчик и что мы видим?

Рис.1. Первый экран при заходе в счетчик.

Вверху мы имеем панель инструментов метрики.

Ниже панели инструментов находится панель, в которой можно выбрать диапазон времени, за который мы узнаем интересующую нас информацию. Здесь соответственно можно выбрать: «Сегодня», «Вчера», «Неделя», «Месяц», «Квартал», «Год» или указать самому на календаре.

Основную часть первого экрана занимает панель виджетов Яндекс Метрики, они нужны для беглой оценки того, что происходит с трафиком на сайте. Мы с вами их настроим позже, а пока что изучим азы, перейдя на основную страницу —

«Источники» —> «Сводка»

Рис.2. Сводка по источникам трафика.

Это статистика за указанный период времени по источникам трафика и основные показатели поведения посетителей. Разберем все по порядку:

Источники трафика в Метрике

Рекламные системы — здесь подразумевается тот трафик, который вы покупаете (Яндекс.Директ, Google AdWords, Begun, AdRiver и т.д.), а также таргетированная реклама из социальных сетей, т.е. cpc (cost per click) или cpm (cost per millenium, цена за тысячу показов) трафик.

Прямые заходы — это пользователи, которые ввели ссылку на ваш сайт непосредственно в адресную строку или перешли из закладок. Это наш самый лояльный трафик.

Переходы из поисковых систем — это SEO трафик. Здесь мы увидим Яндекс, Google, Mail.ru, Bing и т.д.

Переходы по ссылкам на сайтах — здесь трафик, в хвосте которого ничего, кроме адреса сайта, на котором была ссылка на Ваш сайт, не содержится.

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

Внутренние переходы — представим ситуацию, пользователь перешел на ваш сайт из любого другого источника и перестал даже мышкой двигать (пошел пить чай, отправился гулять и т.д.). Если этот период длится дольше установленного времени (как правило — 30 минут), то по его возвращению начинается уже новая сессия (визит), которая записывается во внутренние переходы.

Переходы из почтовых рассылок — ну тут ясно из названия, ссылка на ваш сайт находилась в письме, которое вы рассылали.

Переходы из сохраненных страниц — это трафик со страниц, которые были сохранены на компьютере в виде «Имя.html».

Рис. 3.Источники трафика.

Основные показатели

Визиты — так называемая сессия. Начинается с того момента, как пользователь открыл ваш сайт и заканчивается, когда он с него уходит или же становится неактивным на 30 минут и больше (см. внутренние переходы). Т.е. вся непрерывная (все те же 30 минут) совокупность действий, совершенных пользователем на сайте, происходит в рамках этого 1-го визита.

Просмотры — это то количество страниц, которых просмотрел пользователь на вашем сайте в течение одного визита.

Отказы — это основной показатель, который говорит нам об эффективности нашей рекламы, релевантности страницы, да и в целом «полезности» её содержимого. Отказ засчитывается в том случае, когда пользователь зашел на страницу и покинул её в течение 15 секунд, не совершив целевого действия, т.е. не выполнил ни одну цель, которую вы настроили в счетчике метрики.

Измеряется он в процентах от количества визитов, т.е. если процент отказов — 25%, то из 1000 визитов — 250 ушли в отказ.

К отказам мы будем еще неоднократно возвращаться.

Глубина просмотра — это среднее значение количества страниц, просмотренных на сайте за время одного визита.

Если у вас было 3 визита, в которых 1й пользователь посмотрел 7 страниц, 2й — 10 и 3й — 4, то глубина просмотра равна (7 + 10 + 4)/3 = 7

Время на сайте — рассчитывается путем вычитания времени первого просмотра из времени последнего просмотра страницы, всё так же в рамках одного визита. Показывается нам соответственно среднее значение по всем визитам.

И последнее — Вернувшиеся (визиты) — объясню на примере:

Пользователь перешел к нам на сайт по рекламному объявлению, и нам записывают 1 визит. Далее пользователь почитал наш сайт, ему понравилась информация на нем, и он добавил страницу в закладки, а затем покинул сайт. После чего наш пользователь вернулся на сайт через пару дней из закладок (уточнение: вернувшихся нам показывают именно за тот период, который мы указали вверху страницы, а не всех вернувшихся из числа визитов, на которые мы смотрим). В итоге, нам записывают еще 1 визит в Прямых заходах и 1 визит в вернувшихся (в строчке рекламных систем). И если после этого визита, он еще через пару дней вернулся к нам из сео, то нам запишут визит в сео и еще 1 вернувшийся визит в рекламу, т.к. учитывается именно самое первое посещение.

Рис. 4. Основные показатели.

Итак, в этой статье мы начали изучение такого инструмента как Яндекс Метрика и прошлись по основным его понятиям. Дальше мы изучим поведение пользователей, посмотрим их интересы, освоим Вебвизор и научимся конструировать отчеты.

Обязательно задавайте вопросы по статье и пишите, о чем вы хотите прочитать раньше!