rspress-plugin-third-parties
Этот плагин предоставляет компоненты для YouTube, Twitter/X и Google Карт, интеграции с Google Analytics и Google Tag Manager, а также компонент Script для управления моментом загрузки скриптов.
Это интеграция, поддерживаемая сообществом.
- Документация и демо — поддерживается автором плагина.
- README плагина со всеми параметрами компонентов.
Установка
Глобальная аналитика
Чтобы добавить Google Analytics на все страницы, зарегистрируйте плагин в rspress.config.ts и замените G-XXXXXXXXXX на ваш идентификатор отслеживания GA4:
Чтобы отслеживать клиентские переходы между страницами, настройте измерение одностраничных приложений в GA4.
Компоненты
Импортируйте компоненты в MDX-страницу или собственную тему. В примерах YouTube и Tweet ниже живой предпросмотр показан рядом с исходным кодом.
<YouTubeEmbed />
Показывает миниатюру видео и загружает YouTube-плеер при нажатии кнопки воспроизведения.
<TweetEmbed />
Встраивает публикацию Twitter/X и подстраивается под светлую или тёмную тему сайта.
<GoogleMapsEmbed />
Встраивает Google Карты. Чтобы использовать этот пример, замените плейсхолдер вашим ключом Google Maps Embed API.
<Script />
Загружает внешние или встроенные скрипты и устраняет повторную загрузку внешних скриптов при переходах между страницами. Стратегия по умолчанию — afterInteractive; с lazyOnload загрузка откладывается, пока страница не загрузится, а браузер не перейдёт в состояние простоя.
<GoogleTagManager />
Добавьте Google Tag Manager в макет вашей собственной темы.
<GoogleAnalytics />
Добавьте GA4 в макет вашей собственной темы. Пропустите этот компонент, если вы уже зарегистрировали тот же идентификатор отслеживания через глобальный плагин.
После настройки Google Analytics используйте sendGAEvent в обработчике событий, чтобы отправлять пользовательские события:

