📦 plugin-google-analytics

기본 구글 애널리틱스 플러그인입니다. 제품 빌드로 배포한 여러분의 웹 사이트가 얼마나 많은 사용자를 만났는지 측정하기 위한 자바스크립트 라이브러리입니다. 구글 애널리틱스 4를 사용하고 있다면 plugin-google-gtag 플러그인을 사용하세요.

Deprecated

이 플러그인은 지원 중단되었으며 2023년 7월 1일부터 사용할 수 없습니다.

구글에서도 유니버설 애널리틱스 기능 지원 중단 예정을 공지했습니다.

UA-* 트래킹 id로 해당 플러그인을 사용하고 있다면 가능한 빨리 구글 애널리틱스 4 계정을 만들고 플러그인 대신 @docusaurus/plugin-google-gtag을 사용해야 합니다. 자세한 내용은 깃허브 이슈를 참고하세요.

제품 빌드 전용

해당 플러그인은 분석 통계 수치가 오염되는 것을 방지하기 위해 개발 중에는 비활성화되고 제품 빌드 시에만 활성화됩니다.

설치

npm

npm install --save @docusaurus/plugin-google-analytics

Yarn

yarn add @docusaurus/plugin-google-analytics

pnpm

pnpm add @docusaurus/plugin-google-analytics

팁

@docusaurus/preset-classic을 설치한 경우에는 플러그인을 따로 설치할 필요는 없습니다.

여러분은 프리셋 옵션을 사용해 플러그인을 설정할 수 있습니다.

설정

설정할 수 있는 필드

옵션명	타입	기본값	설명
trackingID	string	필수	애널리틱스 서비스의 추적 ID
anonymizeIP	boolean	false	요청을 보낼 때 IP를 익명화할지 여부

설정 예시

프리셋 옵션이나 플러그인 옵션에서 플러그인을 설정할 수 있습니다.

팁

대부분의 도큐사우루스 사용자는 프리셋 옵션을 사용해 플러그인을 설정합니다.

프리셋 옵션

프리셋을 사용하는 경우 프리셋 옵션를 통해 플러그인을 구성합니다.

docusaurus.config.js

module.exports = {
  presets: [
    [
      '@docusaurus/preset-classic',
      {
        googleAnalytics: {
          trackingID: 'UA-141789564-1',
          anonymizeIP: true,
        },
      },
    ],
  ],
};

플러그인 옵션

독립적으로 실행되는 플러그인을 사용하는 경우에는 플러그인에 대한 옵션을 직접 설정할 수 있습니다.

docusaurus.config.js

module.exports = {
  plugins: [
    [
      '@docusaurus/plugin-google-analytics',
      {
        trackingID: 'UA-141789564-1',
        anonymizeIP: true,
      },
    ],
  ],
};