Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hcodes/server_yametrika
Серверное отслеживание посетителей с помощью Яндекс.Метрики
https://github.com/hcodes/server_yametrika
analytics metrika php yandex-metrica yandex-metrika
Last synced: 2 days ago
JSON representation
Серверное отслеживание посетителей с помощью Яндекс.Метрики
- Host: GitHub
- URL: https://github.com/hcodes/server_yametrika
- Owner: hcodes
- License: other
- Created: 2012-05-30T16:52:07.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2024-09-08T06:24:38.000Z (4 months ago)
- Last Synced: 2024-12-13T13:07:53.363Z (9 days ago)
- Topics: analytics, metrika, php, yandex-metrica, yandex-metrika
- Language: PHP
- Homepage: https://packagist.org/packages/hcodes/server_yametrika
- Size: 71.3 KB
- Stars: 74
- Watchers: 14
- Forks: 19
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# hcodes/server_yametrika
**Серверное отслеживание посетителей с помощью Яндекс.Метрики для PHP.**
В некоторых случаях требуется отслеживать действия на стороне сервера без JavaScript.
Например:
+ Слежка за поисковыми роботами
+ Редиректы
+ Загрузка файлов
+ Страницы с ошибками (403, 404, 500)
+ RSS
+ Время выполнения скриптов
+ Время запросов к базам данных
+ Треккинг AJAX-запросов
+ и пр.
## Возможности
Серверная реализация сделана по аналогии с [JavaScript-реализацией](https://yandex.ru/support/metrica/code/counter-initialize.html).
+ Посещение страницы `hit()`
+ Достижение цели `reachGoal()`
+ Внешняя ссылка `extLink()`
+ Загрузка файла `file()`
+ Параметры визита `params()`
+ Неотказ `notBounce()`
**Яндекс.Метрика принимает хиты только по https-протоколу, не забудьте проверить поддержку SSL в PHP.**
## Настройки счётчика Метрики
**В настройках счётчика во вкладке «Фильтры» / «Фильтрация роботов» необходимо выбрать опцию «Учитывать посещения всех роботов». В противном случае, статистика собираться не будет.**
## Ограничения
Отчёты, которые будут недоступны в Метрике при серверной отправки:
+ Половозрастная структура
+ Пол и возраст
+ Разрешения дисплеев
+ Вебвизор, аналитика форм
+ Карта кликов
Уникальные посетители считаются по User Agent и IP-адресу.
## Установка
```bash
composer require hcodes/server_yametrika
```
## API
### Посещение страницы
```PHP
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
reachGoal('goal_name');
// С параметрами визита.
$counter->reachGoal('goal_name', ['param1' => 1, 'param2' => 2]);
?>
```
### Внешняя ссылка, отчёт «Внешние ссылки»
```PHP
extLink('https://yandex.ru');
// С названием ссылки.
$counter->extLink('https://yandex.ru', 'Яндекс');
?>
```
### Загрузка файла, отчёт «Загрузка файлов»
```PHP
file('https://mysite.org/archive.zip');
// С названием ссылки.
$counter->file('https://mysite.org/archive.zip', 'Архив рассылки');
?>
```
### Отправка пользовательских параметров, отчёт «Параметры визитов»
```PHP
params(['level1' => ['level2' => 1]]);
?>
```
### Неотказ
```PHP
notBounce();
?>
```
## Примеры применения
### Какие программы используют посетители для чтения RSS?
```PHP
params(['RSS' => ['User Agent' => $_SERVER['HTTP_USER_AGENT']]]);
?>
```
### Слежка за роботами за скачкой robots.txt
Добавляем в корневой .htaccess строку "RewriteRule ^robots.txt$ robots.php" и создаём в корне файл robots.php с содержанием:
```PHP
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;
?>
```
## Полезные ссылки
+ [Лёгкая Я.Метрика](https://github.com/hcodes/lyam/)
+ [Версия для Node.js](https://github.com/hcodes/server_yametrika_nodejs/)
+ [React/Preact-компонент для Яндекс Метрики](https://github.com/hcodes/react-metrika)
+ [Помощь Яндекс.Метрики](https://yandex.ru/support/metrica/)
## [Лицензия](./LICENSE.md)
MIT License