Einstieg

Installation

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie die Capgo-Fähigkeiten Ihrem AI-Tool hinzu, indem Sie den folgenden Befehl ausführen:

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

Dann verwenden Sie den folgenden Prompt:

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 aufgeführten Plattform-spezifischen Anweisungen:

1. 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. Synchronisieren Sie native Plattformen

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

3. Die Produktkonfiguration im Quellprodukt überprüfen

   • Die offizielle Anleitung befolgen Contentsquare Capacitor Anleitung 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',
});

Tipps zur Bildschirmbezeichnung

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

Replay-Privatsphäre-Kontrollen

Verwenden Sie die integrierten Maskierungshilfen, um sensitive Inhalte aus der Session-Aufzeichnung herauszuhalten:

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 den 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-Dokumenten im Einklang, während die Verpackung und die native Build-Einstellung sich auf Capacitor 8 richten.

Weitergehen von Getting Started

Wenn Sie native Plugin-Arbeit planen, verbinden Sie es mit Getting Started um native Plugin-Arbeit zu planen, verbinden Sie es mit Verwenden Sie @capgo/capacitor-contentsquare für die native Fähigkeit in Verwenden Sie @capgo/capacitor-contentsquare Capgo-Erweiterungsverzeichnis für den Produktworkflow in Capgo-Erweiterungsverzeichnis Capacitor-Erweiterungen 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 das Produktworkflow in Ionic Enterprise-Plugin-Alternativen.