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

Fügen Sie dann den folgenden Prompt hinzu:

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. 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-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 eingebauten 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.
• Für Android ist keine zusätzliche Manifest-Verdrahtung für den Plugin selbst erforderlich; siehe Android-Hinweise für Tipps zum Logging und 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 synchronisiert, während die Verpackung und die native Build-Einstellung sich auf Capacitor 8 richten.

Weiter geht es 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 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.