# Yametrika

Яндекс-метрика прямо в админке MODX3  
Скачать:  
[https://extras.modx.com/package/yametrika3x](https://extras.modx.com/package/yametrika3x)  
[https://modstore.pro/packages/utilities/yametrika3x](https://modstore.pro/packages/utilities/yametrika3x)

# Получение OAuth-токена

- Перейдите на страницу [oauth.yandex.ru](https://oauth.yandex.ru) и нажмите **«Зарегистрировать новое приложение»**.
- Введите любое название приложения, в разделе доступов выберите **«Яндекс Метрика»** → *«Получение статистики, чтение параметров своих и доверенных счётчиков»*.
- Скопируйте **Client ID** созданного приложения.
- Откройте в браузере ссылку, подставив свой Client ID:  
    `https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID`
- Яндекс перенаправит вас на страницу с токеном в адресной строке — скопируйте значение параметра `access_token`.
- Вставьте токен в поле **OAuth-токен** во вкладке **Настройки**.

# Системные настройки MODX

<table class="uk-table uk-table-divider uk-table-small" id="bkmrk-%D0%9A%D0%BB%D1%8E%D1%87-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-yametr"><thead><tr><th style="width: 280px;">Ключ</th><th>Описание</th></tr></thead><tbody><tr><td>`yametrika3x_oauth_token`</td><td>OAuth-токен для доступа к API Яндекс Метрики.</td></tr><tr><td>`yametrika3x_counter_id`</td><td>ID счётчика Яндекс Метрики.</td></tr><tr><td>`yametrika3x_data_retention_days`</td><td>Срок хранения данных в днях (по умолчанию 730). Старые записи удаляются автоматически при каждой синхронизации.</td></tr><tr><td>`yametrika3x_default_period`</td><td>Период по умолчанию при открытии вкладок (в днях, по умолчанию 30).</td></tr><tr><td>`yametrika3x_initial_sync_days`</td><td>Глубина синхронизации для weekly-cron и начальной загрузки (по умолчанию 365 дней).</td></tr></tbody></table>

# Настройка cron

<table class="uk-table uk-table-divider uk-table-small" id="bkmrk-%D0%9A%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D0%B0-%D0%A0%D0%B0%D1%81%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D0%9E"><thead><tr><th>Команда</th><th>Расписание</th><th>Описание</th></tr></thead><tbody><tr><td>`0 * * * * php `/path/to/your/site/core/components/yametrika3x/cron/sync.php hourly``</td><td class="uk-text-nowrap">Каждый час</td><td>Данные за сегодня и вчера</td></tr><tr><td>`0 2 * * * php `/path/to/your/site/core/components/yametrika3x/cron/sync.php daily``</td><td class="uk-text-nowrap">Каждую ночь в 02:00</td><td>Данные за последние 7 дней</td></tr><tr><td>`0 3 * * 0 php `/path/to/your/site/core/components/yametrika3x/cron/sync.php weekly``</td><td class="uk-text-nowrap">Каждое воскресенье в 03:00</td><td>Глубокая синхронизация (глубина задаётся в настройках)</td></tr></tbody></table>