시작하기

설치

Capgo의 AI-assisted 설치를 사용하여 플러그인을 설치할 수 있습니다. 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-contentsquare` plugin in my project.

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

1. 플러그인 설치

   npm

   npm i @capgo/capacitor-contentsquare

   pnpm

   pnpm add @capgo/capacitor-contentsquare

   yarn

   yarn add @capgo/capacitor-contentsquare

   bun

   bun add @capgo/capacitor-contentsquare

2. 자연 플랫폼 동기화

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

3. 업스트림 제품 구성 확인

   • 공식 Contentsquare Capacitor 가이드 프로젝트 키, 재생 설정 및 대시보드 설정을 위한

기본 사용법

import { ContentsquarePlugin, CurrencyCode } from '@capgo/capacitor-contentsquare';

await ContentsquarePlugin.optIn();

await ContentsquarePlugin.sendScreenName('Home');

await ContentsquarePlugin.sendTransaction({
  transactionValue: 29.99,
  transactionCurrency: CurrencyCode.EUR,
  transactionId: 'order-123',
});

await ContentsquarePlugin.sendDynamicVar({
  dynVarKey: 'store',
  dynVarValue: 'rome',
});

스크린 이름 팁

• 사용자 고유 값 대신 안정적인 이름을 사용하십시오.
• iOS 및 Android 네비게이션 스택에서 동일한 이름 규칙을 유지하십시오.
• 앱이 전면으로 돌아오면 스크린 이름과 중요 동적 변수를 다시 보내십시오.

재생 개인 정보 관리

세션 리플레이에서敏感한 콘텐츠를 제외하기 위해 내장된 마스킹 헬퍼를 사용하세요:

await ContentsquarePlugin.excludeURLForReplay('/checkout/');

await ContentsquarePlugin.setCapturedElementsSelector('[data-cs-capture]');

await ContentsquarePlugin.setPIISelectors({
  PIISelectors: ['input[type="email"]', '.credit-card'],
  Attributes: [{ selector: 'input[name="email"]', attrName: 'value' }],
});

플랫폼 설정

• iOS 인앱 기능을 위해 iOS에서 추가적인 deeplink 연결을 완료하세요. iOS 설정 페이지.
• Android는 플러그인 자체에 대한 추가 매니페스트 연결이 필요하지 않습니다. 로깅 및 검증 팁을 보려면 Android 노트 노트

노트

• 이 플러그인은 공식 Contentsquare Capacitor 패키지의 Capacitor 8 커뮤니티 버전입니다.
• 자바스크립트 API는 현재 Contentsquare Capacitor 문서와 동기화되며, 패키징 및 네이티브 빌드 설정은 Capacitor 8을 목표로 합니다.

시작하기

이 플러그인을 사용하는 경우 시작하기 Contentsquare 플러그인을 사용하여 네이티브 플러그인 작업을 계획하고 연결하려면 @capgo/capacitor-contentsquare for the native capability in Using @capgo/capacitor-contentsquare, Capgo 플러그인 Capgo 플러그인 Capacitor Plugins by Capgo 구현 세부 정보에 대한 Capacitor 플러그인에 의해 Capgo 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트에 대한 구현 세부 정보, 그리고 아이오닉 엔터프라이즈 플러그인 대체 아이오닉 엔터프라이즈 플러그인 대체에 대한 제품 워크플로우.