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 mithilfe der folgenden Befehl hinzu:

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

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

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

3. Die Produktkonfiguration des Herstellers überprüfen

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

Tipps zur Bildschirmbezeichnung

• Verwenden Sie stattdessen stabile Namen anstelle von Benutzerspezifischen Werten.
• Halten Sie die gleichen Namenskonventionen über iOS- und Android-Navigationsstacks.
• 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 im iOS-Einstellungen Seite ab.
• Für Android ist keine zusätzliche Manifest-Verdrahtung für den Plugin selbst erforderlich; siehe Android-Hinweise für Tipps zum Logging und Validieren.

Hinweise

• Dieses Plugin ist eine Capacitor 8 Gemeinschaftsübertragung 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-Einrichtung auf Capacitor 8 ausgerichtet sind.

Fortsetzung von Getting Started

Wenn Sie native Plugin-Arbeiten planen, verbinden Sie es mit Getting Started um es mit Verwendung von @capgo/capacitor-contentsquare zu verbinden, um die native Fähigkeit in Verwendung von @capgo/capacitor-contentsquare zu nutzen. Capgo Plugin-Verzeichnis um das Produktworkflow in Capgo Plugin-Verzeichnis zu nutzen. Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins durch Capgo Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren und Alternativen zu Ionic Enterprise Plugins für das Produktworkflow in Alternativen zu Ionic Enterprise Plugins.