📦 plugin-google-analytics

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

Deprecated

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

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

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

production only

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

설치

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,
      },
    ],
  ],
};