スタートガイド

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. 上流製品の設定を確認する

   • 公式の CapacitorのContentsquareガイド プロジェクトキー、再生設定、ダッシュボードの設定について

基本的な使用方法

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のナビゲーションスタックで同じ命名規則を維持する
• アプリが前景に戻ったときに、画面名と重要な動的変数を再送信する

プライバシー制御の再生

__CAPGO_KEEP_0__を使用して、セッション再生から敏感なコンテンツを除外するために組み込まれたマスクング助けを使用してください。

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のセットアップのページで完了してください。 iOSのセットアップ Androidには、プラグイン自体のための追加のマニフェストのワイヤリングが必要ありません。ログと検証のためのヒントについては、
• Androidの注記 Androidの注記 for logging and validation tips.

Notes

• This plugin is a Capacitor 8 community port of the official Contentsquare Capacitor package.
• The JavaScript API stays aligned with the current Contentsquare Capacitor docs, while the packaging and native build setup target Capacitor 8.