Getting Started

Installation

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer KI-Zubehörstücke mit folgendem Befehl hinzu:

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

Verwenden Sie dann folgende Anfrage:

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

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und folgen Sie den unten angegebenen Plattform-spezifischen Anweisungen:

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. Überprüfen Sie die Produktkonfiguration des Auftrags

   • Folgen Sie den 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 Namenskonventionen für iOS- und Android-Navigationsstacks gleichzeitig.
• Wenn die App wieder in den Vordergrund kommt, senden Sie den Bildschirmtitel und alle kritischen dynamischen Variablen erneut.

Replay-Einstellungen zur Privatsphäre

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-Features in der App müssen Sie die zusätzliche Deeplink-Verkabelung auf der iOS-Einstellungen Seite abschließen.
• Android benötigt keine zusätzliche Manifest-Verkabelung für den Plugin selbst; siehe Android-Hinweise für Hinweise zu Loggen und Validierung.

Hinweise

• Diese Erweiterung ist eine Capacitor 8 Gemeinschafts-Portierung des offiziellen Contentsquare Capacitor Pakets.
• 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.

Weitermachen von Getting Started

Wenn Sie native Plugin-Arbeiten planen, verbinden Sie es mit Getting Started um native Plugin-Arbeiten zu planen, verbinden Sie es mit Verwendung von @capgo/capacitor-contentsquare für die native Fähigkeit in Verwendung von @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 Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise-Plugin-Alternativen für den Produktworkflow in Ionic Enterprise-Plugin-Alternativen.