시작하기

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 지시를 복사하세요.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-gtm`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/gtm/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

설치

Capgo의 AI 보조 설치를 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 기능을 추가하려면 다음 명령어를 사용하세요.

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

다음 명령어를 사용하여 다음 프롬프트를 입력하세요.

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-gtm` plugin in my project.

만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래에 플랫폼에 따라 설명된 지침을 따르세요.

bun add @capgo/capacitor-gtm
bunx cap sync

Import

import { GoogleTagManager } from '@capgo/capacitor-gtm';

API 개요

`initialize`

Google Tag Manager를 지정된 컨테이너 ID와 함께 초기화합니다.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.initialize({} as { containerId: string; timeout?: number });

`push`

Google Tag Manager 데이터 레이어에 이벤트를 푸시합니다.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.push({
  event: 'purchase',
  parameters: {
    value: 99.99,
    currency: 'USD'
  }
});

`setUserProperty`

Google Tag Manager 데이터 레이어에 사용자 속성을 설정합니다.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.setUserProperty({
  key: 'user_type',
  value: 'premium'
});

`getValue`

Google Tag Manager의 dataLayer에서 지정된 키의 최신 값을 검색하여 가져옵니다.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.getValue({} as { key: string });

`reset`

Google Tag Manager 인스턴스를 초기화하고 모든 데이터를 삭제합니다. 이 작업은 dataLayer에서 모든 데이터를 삭제하고 재초기화를 필요로 합니다.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.reset();

진실의 근원

업스트림에서 pubic __CAPGO_KEEP_0__이 변경될 때 다시 싱크를 실행하세요. src/definitions.ts. Re-run the sync when the public API changes upstream.

진실의 근원

Capgo를 사용 중이라면 Getting Started 대시보드와 API 연산을 계획하고 싶다면 Capacitor를 사용하여 @capgo/capacitor-gtm Capacitor를 사용하여 @capgo/capacitor-gtm API 개요 API 구현 세부 사항 소개 __CAPGO_KEEP_0__ 키 API 구현 세부 사항 for the implementation detail in API Keys, and Devices __CAPGO_KEEP_0__ 구현 세부 사항입니다.