AG & Dev

Подключение счётчика Яндекс Метрики к проекту Next.js (App Router)

25 ноября 2023 г.

Другие статьи

Dockerfile для Keystone CMS 6
Dockerfile и compose.yaml для развёртывания Keystone CMS 6
Аутентификация в Keystatic CMS
Настройка аутентификации в Keystatic CMS (Local mode) в проекте Next.js
Валидация формы на стороне сервера
Валидация формы на стороне сервера при помощи React-хука useActionState
Глобальное состояние в React
Глобальное состояние в React без подключения сторонних библиотек
Яндекс Карты в проекте Next.js
Подключение Яндекс Карты (API 3) к проекту Next.js (App Router)
Подключение к Headless CMS из Next.js
Пример подключения к Headless CMS (Wordpress) из приложения Next.js посредством REST API
Устранение FOUC в Next.js
Устранение FOUC-эффекта при использовании тёмной темы сайта в Next.js
Все статьи

Технологический стек

AG & Dev

Современные технологии разработки быстрых и надёжных веб-сайтов

Профиль на GitHub

Инструменты

React
Next.js
Mantine

Платформы

Node.js
Docker
Nginx

CMS

Directus
Keystone
Keystatic

Пример правильного подключения счётчика Яндекс Метрики к проекту Next.js (App Router). Решение основано на официальной документации Яндекс.

Создание компонента счётчика

Создаём компонент Metrika со счётчиком Яндекс Метрики:

lib/metrika.tsx
"use client";
 
import { useEffect, useState } from "react";
import { usePathname, useSearchParams } from "next/navigation";
import Script from "next/script";
 
declare const ym: (id: number, method: string, link: string) => void;
 
const base = "https://example.com";
 
export default function Metrika() {
  const [ready, setReady] = useState(false);
 
  const pathname = usePathname();
  const searchParams = useSearchParams();
 
  const params = searchParams.toString();
  const link = base + pathname + (params && `?${params}`);
 
  useEffect(() => {
    if (ready) ym(00000000, "hit", link);
  }, [ready, link]);
 
  return (
    <Script id="metrika" strategy="lazyOnload" onReady={() => setReady(true)}>
      {`
        (function(m,e,t,r,i,k,a) {
          m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};
          m[i].l=1*new Date();
          for (var j = 0; j < document.scripts.length; j++) { if (document.scripts[j].src === r) { return; } }
          k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)
        })(window, document, 'script', 'https://mc.yandex.ru/metrika/tag.js', 'ym');
 
        ym(00000000, 'init', {
          defer: true,
          clickmap :true,
          referrer: document.referrer,
          url: location.href,
          accurateTrackBounce: true,
          trackLinks: true
        });
      `}
    </Script>
  );
}

Код счётчика может различаться в зависимости от версии и параметров настройки Яндекс Метрики. Поэтому его необходимо скопировать из настроек Яндекс Метрики сайта и вставить в компонент Script, используя обратные кавычки, как показано в примере выше. После чего, к функции инициализации счётчика нужно добавить параметр defer: true. В примере выше это уже сделано.

Подключение компонента счётчика

Подготовленный компонент Metrika вставляем в корневой макет сайта, обернув его в React-компонент Suspense:

app/layout.tsx
import "./globals.css";
 
import { Suspense } from "react";
import Metrika from "@/lib/metrika";
 
export default function RootLayout({ children }) {
  return (
    <html lang="ru">
      <body>
        {children}
 
        <Suspense>
          <Metrika />
        </Suspense>
      </body>
    </html>
  );
}

Таким образом, счётчик Яндекс Метрики будет вызываться при переходе на любую страницу сайта, при изменении параметров URL и при переходе вперёд/назад в браузере.

Отслеживание достижения цели

Для отслеживания событий на сайте, при которых URL страницы не меняется, необходимо использовать функцию ym с параметром reachGoal вместо hit:

javascript
ym(XXXXXXXX, "reachGoal", "TARGET_NAME");

TARGET_NAME – уникальный идентификатор цели, который необходимо задать в настройках Яндекс Метрики. Цель должна иметь тип JavaScript-событие.

С различными примерами вызова функции ym с параметром reachGoal можно ознакомиться по ссылке.