Skip to content

hcodes/server_yametrika

Repository files navigation

hcodes/server_yametrika

Packagist Version Packagist Downloads Packagist License

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

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

Например:

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

Возможности

Серверная реализация сделана по аналогии с JavaScript-реализацией.

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

Яндекс.Метрика принимает хиты только по https-протоколу, не забудьте проверить поддержку SSL в PHP.

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

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

Ограничения

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

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

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

Установка

composer require hcodes/server_yametrika

API

Посещение страницы

<?php use ServerYaMetrika\YaMetrika; $counter = new YaMetrika(123456); // Номер счётчика Метрики // Все параметры по умолчанию. $counter->hit(); // Значение URL и referer берутся по умолчанию из $_SERVER // Отправка хита с абсолютными урлами. // page_url, title, referer $counter->hit('https://mysite.org', 'Main page', 'https://ya.ru'); // Отправка хита с относительными урлами. $counter->hit('/index.html', 'Main page', '/back.html'); // Отправка хита вместе с параметрами визитов. $userParams = ['param' => 1, 'param2' => 2]; $counter->hit('https://mysite.org', 'Main page', 'https://ya.ru', $userParams); // Отправка хита вместе с параметрами визитов и с запретом на индексацию. $userParams = ['param1' => 1, 'param2' => 2]; $counter->hit( 'https://mysite.org', 'Main page', 'https://ya.ru', $userParams, 'noindex' ); ?>

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

<?php use ServerYaMetrika\YaMetrika; $counter = new YaMetrika(123456); // Номер счётчика Метрики. // Внимание! Перед вызовом методов reachGoal должен вызван метод hit(...), // чтобы была корректная привязка цели к визиту. $counter->reachGoal('goal_name'); // С параметрами визита. $counter->reachGoal('goal_name', ['param1' => 1, 'param2' => 2]); ?>

Внешняя ссылка, отчёт «Внешние ссылки»

<?php use ServerYaMetrika\YaMetrika; $counter = new YaMetrika(123456); // Номер счётчика Метрики. $counter->extLink('https://yandex.ru'); // С названием ссылки. $counter->extLink('https://yandex.ru', 'Яндекс'); ?>

Загрузка файла, отчёт «Загрузка файлов»

<?php use ServerYaMetrika\YaMetrika; $counter = new YaMetrika(123456); // Номер счётчика Метрики. $counter->file('https://mysite.org/archive.zip'); // С названием ссылки. $counter->file('https://mysite.org/archive.zip', 'Архив рассылки'); ?>

Отправка пользовательских параметров, отчёт «Параметры визитов»

<?php use ServerYaMetrika\YaMetrika; $counter = new YaMetrika(123456); // Номер счётчика Метрики. $counter->params(['level1' => ['level2' => 1]]); ?>

Неотказ

<?php use ServerYaMetrika\YaMetrika; $counter = new YaMetrika(123456); // Номер счётчика Метрики. $counter->notBounce(); ?>

Примеры применения

Какие программы используют посетители для чтения RSS?

<?php use ServerYaMetrika\YaMetrika; $counter = new YaMetrika(123456); // Номер счётчика Метрики. // Просмотр статистики в отчёте «Параметры визитов», ветка RSS → User Agent. $counter->params(['RSS' => ['User Agent' => $_SERVER['HTTP_USER_AGENT']]]); ?>

Слежка за роботами за скачкой robots.txt

Добавляем в корневой .htaccess строку "RewriteRule ^robots.txt$ robots.php" и создаём в корне файл robots.php с содержанием:

<?php use ServerYaMetrika\YaMetrika; $counter = new YaMetrika(123456); // Номер счётчика Метрики. // Просмотр статистики в отчёте «Параметры визитов», ветка Robots.txt → User Agent. $counter->params(['Robots.txt' => ['User Agent' => $_SERVER['HTTP_USER_AGENT']]]); $txt = file_get_contents('robots.txt'); header('Cache-Control: no-cache'); header('Pragma: no-cache'); header('Last-Modified: ' . gmdate('D, d M Y H:i:s') . ' GMT'); header('Content-Type: text/plain'); print $txt; ?>

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

MIT License

About

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

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages