Commencer

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 du 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 garder le contenu sensible hors de 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 la mise en page de déeplinking supplémentaire dans le iOS setup page.
• L'Android n'a pas besoin de mise en page de manifeste supplémentaire pour le plugin lui-même ; voir Notes Android pour des conseils sur la journalisation et la validation.

Notes

• Ce plugin est une Capacitor 8 portage communautaire de l'official Contentsquare Capacitor package.
• Le JavaScript API reste aligné avec les actuels Contentsquare Capacitor docs, tandis que la mise en boîte et la configuration de build 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, Répertoire des plugins Capgo pour le flux de travail du produit dans Répertoire des plugins Capgo, Plugins Capacitor 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 d'Entreprise Ionic pour le flux de travail du produit dans Alternatives de Plugins d'Entreprise Ionic.