Einstieg

1. Installieren Sie das Plugin

   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. Synchronisiere native Plattformen

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

3. Überprüfen Sie die Produktkonfiguration des Herstellers

   • Folgen Sie den offiziellen Inhalte von Contentsquare Capacitor für Projektschlü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',
});

Tipps für die Bildschirmbezeichnung

• Verwenden Sie stattdessen stabile Namen anstelle von benutzerbezogenen Werten.
• Halten Sie die gleichen Namenskonventionen über die iOS- und Android-Navigationsstacks hinweg.
• Wenn das App zurück in den Vordergrund gelangt, senden Sie den Bildschirmnamen und alle kritischen dynamischen Variablen erneut.

Wiederholung der Datenschutzkontrolle

Verwenden Sie die integrierten Maskierungshilfen, um sensitive Inhalte aus der Session Wiedergabe 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-Inhalt im App, füllen Sie die zusätzliche Deeplink-Verkabelung in der iOS-Einstellungen Seite ab.
• Android benötigt keine zusätzliche Manifest-Verkabelung für das Plugin selbst; siehe Android-Hinweise für Tipps zum Logging und Validierung.

Hinweise

• Die JavaScript Capacitor bleibt mit den aktuellen Contentsquare Capacitor Dokumentationen im Einklang, während die Verpackung und die native Build-Einstellungen sich auf __CAPGO_KEEP_2__ 8 richten.
• The JavaScript API stays aligned with the current Contentsquare Capacitor docs, while the packaging and native build setup target Capacitor 8.