Démarrage rapide
Copiez une commande de configuration avec les étapes d'installation et la guide markdown complet pour ce plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-contentsquare`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/contentsquare/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
-
Installez le plugin
Fenêtre de terminal npm i @capgo/capacitor-contentsquareFenêtre de terminal pnpm add @capgo/capacitor-contentsquareFenêtre de terminal yarn add @capgo/capacitor-contentsquareFenêtre de terminal bun add @capgo/capacitor-contentsquare -
Sync native platforms
Fenêtre de terminal npx cap syncFenêtre de terminal pnpm cap syncFenêtre de terminal yarn cap syncFenêtre de terminal bunx cap sync -
Révisez la configuration du produit upstream
Suivez le guide officiel Guide Contentsquare Capacitor pour les clés de projet, les paramètres de relecture et la configuration du tableau de bord.
Utilisation de base
Section intitulée « Utilisation de base »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',});Conseils de nommage de l'écran
Section intitulée « Conseils de nommage de l'écran »- Utilisez des noms stables au lieu de valeurs spécifiques à l'utilisateur.
- Conservez les mêmes conventions de nommage entre les stacks de navigation iOS et Android.
- Lorsque l'application revient en avant-plan, renvoyez le nom de l'écran et les variables dynamiques critiques.
Contrôles de confidentialité de Replay
Section intitulée “Contrôles de confidentialité de Replay”Utilisez les assistants de masquage intégrés pour garder le contenu sensible hors de la session de replay :
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' }],});Configuration de la plateforme
Section intitulée “Configuration de la plateforme”- Pour les fonctionnalités en application iOS, terminez la mise en œuvre supplémentaire de la mise en page profonde dans le Configuration iOS page.
- L'Android n'a pas besoin de mise en œuvre supplémentaire de mise en page de manifeste pour le plugin lui-même ; voir Remarques Android les conseils pour la journalisation et la validation.
- Ce plugin est une Capacitor 8 portage communautaire officielle du package Contentsquare Capacitor.
- Le JavaScript API reste aligné sur les documents actuels Contentsquare Capacitor , tandis que la mise en boîte et la configuration de construction native visent Capacitor 8.