Einführung

Kopieren Sie einen Einrichtungsprompt mit den Installationsanweisungen und dem vollständigen Markdown-Guide für diesen Plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-contentsquare`
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/contentsquare/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.

Das Plugin installieren
- npm
- pnpm
- yarn
- bun
Terminalfenster
npm i @capgo/capacitor-contentsquare
Terminalfenster
pnpm add @capgo/capacitor-contentsquare
Terminalfenster
yarn add @capgo/capacitor-contentsquare
Terminalfenster
bun add @capgo/capacitor-contentsquare
Nativplattformen synchronisieren
- npm
- pnpm
- yarn
- bun
Terminalfenster
npx cap sync
Terminalfenster
pnpm cap sync
Terminalfenster
yarn cap sync
Terminalfenster
bunx cap sync
Überprüfen Sie die Produktkonfiguration des upstream-Produkts
- Folgen Sie den offiziellen Anweisungen Inhalte von Contentsquare Capacitor zur Projekt-Schlüssel, Wiedergabe-Einstellungen und Dashboard-Einrichtung.

Grundlegende Verwendung

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',
});

Hinweise zur Bildschirmbezeichnung

Verwenden Sie stattdessen stabile Namen anstelle von Benutzer-spezifischen Werten.
Behalten Sie die gleichen Namenskonventionen bei iOS- und Android-Navigationsstacks.
Wenn das App zurückkehrt in den Vordergrund, senden Sie den Bildschirmnamen und alle kritischen dynamischen Variablen erneut.

Replay Datenschutzkontrolle

Verwenden Sie die eingebauten Maskierungshilfen, um sensitive Inhalte aus der Session Replay fernzuhalten:

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

Plattformseinstellungen

Für iOS-In-App-Funktionen fahren Sie das zusätzliche Deeplink-Verdrahten auf der iOS-Einstellungen Seite ab.
Android benötigt für das Plugin selbst keine zusätzliche Manifest-Verdrahtung; siehe Android-Hinweise für Tipps zum Logging und zur Validierung.

Hinweise

Diese Erweiterung ist eine Capacitor 8-Gemeinschaftsübertragung der offiziellen Contentsquare Capacitor-Paket.
Das JavaScript API bleibt mit den aktuellen Contentsquare Capacitor-Dokumentationen im Einklang, während die Verpackung und die native Build-Einstellungen auf Capacitor 8 ausgerichtet sind.