시작하기

설치

AI-Assisted Setup으로 플러그인을 설치할 수 있습니다. 다음 명령어로 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.

수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:

bun add @capgo/capacitor-gtm
npx cap sync

가져오기

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

빠른 시작

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

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

예시: setUserProperty

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

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

자주 하는 실수

• 1회 초기화: 앱 부트스트랩 시 setup을 실행합니다.
• Native 동기화: 실행 npx cap sync 플러그인 업그레이드 후
• 신뢰할 수 있는 단일 소스: 신뢰할 수 있는 src/definitions.ts GitHub 저장소 내 데이터입니다.

API 개요

initialize

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

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

await GoogleTagManager.initialize({ containerId: 'container-id-123' });

push

Google Tag Manager dataLayer로 이벤트를 전송합니다.

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

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

setUserProperty

Google Tag Manager dataLayer에 사용자 속성을 설정합니다.

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

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

getValue

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

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

const result = await GoogleTagManager.getValue({ key: 'key-123' });
console.log(result);

reset

Google Tag Manager 인스턴스를 초기화하고 모든 데이터를 삭제합니다. dataLayer의 모든 데이터가 제거되므로 재초기화가 필요합니다.

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

await GoogleTagManager.reset();

Source of Truth

이 페이지는 플러그인의 src/definitions.ts. 상위의 public API가 변경되면 sync를 다시 실행하세요.

시작하기 다음 단계

사용 중이라면 시작하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-gtm 사용하기 @capgo/capacitor-gtm 사용 시 네이티브 기능 활용 API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 API Keys의 구현 세부 사항은, 기기 Devices의 구현 세부 사항은.