Getting Started

Installation

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

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

Utilisez ensuite la commande 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 le guide officiel de Contentsquare __CAPGO_KEEP_0__ Contentsquare Capacitor guide Utilisation de base

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

• Utiliser des noms stables au lieu de valeurs spécifiques à l'utilisateur.
• Conserver les mêmes conventions de nommage dans les stacks de navigation iOS et Android.
• Lorsque l'application revient en avant-plan, renvoyer le nom de l'écran et toute variable dynamique critique.

Réglage de la confidentialité Replay

Utiliser les assistants de masquage intégrés pour garder le contenu sensible hors de Session 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 du plateau de forme

• Pour les fonctionnalités en application iOS, complétez la mise en réseau de lien profond supplémentaire dans la Configuration iOS page.
• L'Android n'a pas besoin de mise en réseau de manifeste supplémentaire pour le plugin lui-même ; voir Notes Android pour des conseils sur la journalisation et la validation.

Notes

• Ceci est un port de la communauté Capacitor 8 de la package officielle Contentsquare Capacitor.
• Le JavaScript API est aligné sur les documents actuels Contentsquare Capacitor , tandis que la mise en boîte et la configuration de construction native visent Capacitor 8.

Continuez de Getting Started

Si vous utilisez Démarrage pour planifier le travail de plugin natif, connectez-le avec En utilisant @capgo/capacitor-contentsquare pour la capacité native en utilisant En @capgo/capacitor-contentsquare, Répertoire de plugin Capgo pour le flux de travail du produit dans Répertoire de plugin Capgo, Plugins Capacitor par Capgo pour le détail d'implémentation dans Plugins Capacitor par Capgo, Ajout ou Mise à jour de Plugins pour le détail d'implémentation dans Ajout ou Mise à jour de Plugins, et Alternatives de plugins d'entreprise Ionic pour le flux de travail du plugin d'entreprise Ionic.