Getting Started

Installation

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie die Capgo-Fähigkeiten Ihrem KI-Tool hinzu, indem Sie die folgende Befehlszeile verwenden:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Dann verwenden Sie die folgende Anfrage:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-contentsquare` plugin in my project.

Wenn Sie eine manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und die unten angegebenen plattform-spezifischen Anweisungen befolgen:

1. Das Plugin installieren

   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. Die Produktkonfiguration des Auftragsstroms überprüfen

   • Dem offiziellen Contentsquare Capacitor-Leitfaden für 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',
});

Tipps zur Bildschirmbezeichnung

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

Wiederholen Sie die Datenschutzkontrollen

Verwenden Sie die integrierten 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-App-Funktionen müssen Sie die zusätzliche Deeplink-Verkabelung in der iOS-Einstellungen Seite.
• Für Android ist keine zusätzliche Manifest-Konfiguration für den Plugin selbst erforderlich; siehe Android-Hinweise für Tipps zum Logging und Validierung.

Hinweise

• Dieses Plugin ist eine Capacitor 8-Gemeinschafts-Portierung des offiziellen Contentsquare Capacitor-Pakets.
• Die JavaScript API-Implementierung bleibt mit den aktuellen Contentsquare Capacitor-Dokumentationen im Einklang, während die Verpackung und die native Build-Einstellungen auf Capacitor 8 ausgerichtet sind.

Weiter zum Anfangen

Wenn Sie Anfangen um native Plugin-Arbeit zu planen, verbinden Sie es mit Mit @capgo/capacitor-contentsquare für die native Fähigkeit in Mit @capgo/capacitor-contentsquare, Capgo Plugin-Verzeichnis für den Produktworkflow in Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren, und Ionic Enterprise-Plugin-Alternativen für den Produktworkflow in Ionic Enterprise-Plugin-Alternativen.