Démarrage

Installation

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA à l'aide de la commande suivante :

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

Ensuite, utilisez la prompt suivante :

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

Si vous préférez la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à la plateforme ci-dessous :

1. Installer le plugin

   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. Synchroniser les plateformes natives

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

3. Vérifiez la configuration du produit upstream

   • Suivez les instructions officielles Guide de Contentsquare Capacitor pour les clés de projet, les paramètres de relecture et la configuration de tableau de bord.

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 d'écran

• Utilisez des noms stables au lieu de valeurs spécifiques à l'utilisateur.
• Conservez les mêmes conventions de nommage dans les piles de navigation iOS et Android.
• Lorsque l'application revient en avant-plan, renvoyez le nom d'écran et les variables dynamiques critiques.

Contrôles de confidentialité de la relecture

Utilisez les assistants de masquage intégrés pour empêcher les contenus sensibles de figurer dans la capture de session :

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

• Pour les fonctionnalités en application iOS, complétez les câblages de deeplink supplémentaires dans la Configuration iOS page.
• L'Android n'a pas besoin de câblages de manifest supplémentaires pour le plugin lui-même ; consultez les Notes Android pour obtenir des conseils sur la journalisation et la validation.

Notes

• Ce plugin est une version communautaire Capacitor 8 de l'official Contentsquare Capacitor package.
• Le JavaScript API reste aligné avec les documents actuels Contentsquare Capacitor, tandis que la mise en paquet et la configuration de construction native visent Capacitor 8.

Continuez de la section « Commencer »

Si vous utilisez Commencer pour planifier le travail de plugin natif, connectez-l’avec Utiliser @capgo/capacitor-contentsquare pour la capacité native dans Utiliser @capgo/capacitor-contentsquare, Capgo Répertoire des plugins pour le flux de travail du produit dans Capgo Répertoire des plugins, Capacitor Plugins par Capgo pour les détails d'implémentation dans Capacitor Plugins par Capgo Ajouter ou Mettre à Jour les Plugins pour les détails d'implémentation dans Ajouter ou Mettre à Jour les Plugins, et Alternatives de Plugins Ionic Entreprise pour le flux de travail du produit dans Alternatives de Plugins Ionic Entreprise.