Серверное отслеживание посетителей с помощью Яндекс.Метрики для Node.js

В некоторых случаях требуется отслеживать действия на стороне сервера.

Например:

• Слежка за поисковыми роботами
• Редиректы
• Загрузка файлов
• Страницы с ошибками (403, 404, 500)
• RSS
• Время выполнения скриптов
• Время запросов к базам данных
• Треккинг AJAX-запросов
• и пр.

Возможности

• Загрузка страницы - hit()
• Внешняя ссылка - extLink()
• Загрузка файла - file()
• Параметры визита - params()
• Неотказ - notBounce()

Настройки счётчика Метрики

В настройках счётчика во вкладке «Фильтры» / «Фильтрация роботов» необходимо выбрать опцию «Учитывать посещения всех роботов». В противном случае, статистика собираться не будет.

Ограничения

Отчёты, которые будут недоступны в Метрике при серверной отправки:

• Половозрастная структура
• Пол и возраст
• Разрешения дисплеев
• Версия Flash
• Вебвизор, аналитика форм
• Карта кликов

Уникальные посетители считаются по user agent'у и IP-адресу.

Установка

npm install yametrika

Использование

var http = require('http');

// Создаем счётчик, 12345 — номер счётчика
var counter = require('yametrika').counter({id: 12345});

http.createServer(function (req, res) {
    res.writeHead(200, {'Content-Type': 'text/plain'});
    res.end('okay');

    // Заполняем счётчик данными (referer, ip и ua) из запроса к серверу.
    counter.req(req);

    // Страница https://example.com, с заголовком 'Main page'
    // переход был с реферером https://othersite.com
    counter.hit('https://example.com', 'Main page', 'https://othersite.com');
}).listen(8080);

Отправка хита

/**
 * @param {string} pageUrl - Адрес страницы.
 * @param {string} [pageTitle] - Заголовок страницы.
 * @param {string} [pageRef] - Реферер страницы.
 * @param {Object} [userParams] - Параметры визитов.
 * @param {string} [ut] - Для запрета индексирования 'noindex'
 *
 * @returns {Object} this
 */
counter.hit('https://mysite.org', 'Main page', 'https://google.com/...');

// С запретом на индексирование и параметрами визитов
counter.hit('https://mysite.org', 'Main page', 'https://google.com/...', {level1: {level2: 1}}, 'noindex');

Достижение цели

/**
 * @param {string} target - Название цели.
 * @param {Object} [userParams] - Параметры визитов.
 *
 * @returns {Object} this
 */
counter.hit();
counter.reachGoal('goalName');

// или

// С параметрами визитов
counter.hit();
counter.reachGoal('goalName', {level1: {level2: 1}});

Вызов метода hit() перед reachGoal() необходим для корректной привязки цели к визиту.

Внешняя ссылка

/**
 * @param {string} url - Адрес страницы.
 * @param {string} [title] - Заголовок страницы.
 *
 * @returns {Object} this
 */
counter.extLink('https://nodejs.org');

Загрузка файла

/**
 * @param {string} file - Ссылка на файл.
 * @param {string} [title] - Заголовок страницы.
 *
 * @returns {Object} this
 */
counter.file('https://mysite.org/secret.zip');

Параметры визитов

/**
 * @param {...*} data - Параметры визитов.
 *
 * @returns {Object} this
 */
counter.params({level1: {level2: {level3: 1}}});

// или
counter.params('level1', 'level2', 'level3', 1);

Не отказ

/**
 * @returns {Object} this
 */
counter.notBounce();

Полезные ссылки

• Версия для PHP
• Помощь Яндекс.Метрики

Лицензия

MIT License