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 en utilisant 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 au 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 l'official Guide Contentsquare Capacitor pour les clés de projet, les paramètres de replay et la configuration de la console.

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

• Utilisez des noms stables au lieu de valeurs spécifiques à l'utilisateur.
• Conservez les mêmes conventions de nommage dans les stacks de navigation iOS et Android.
• When the app returns to foreground, resend the screen name and any critical dynamic variables.

Réafficher les contrôles de confidentialité

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

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

Notes

• Ce plugin est une Capacitor portage de la communauté officielle du package Contentsquare Capacitor.
• Le JavaScript API reste aligné avec la documentation actuelle de Contentsquare Capacitor, tandis que la mise en paquet et la configuration de build native visent Capacitor 8.

Continuez de l'étape de démarrage

Si vous utilisez Démarrage pour planifier le travail de plugin natif, connectez-le avec Utiliser @capgo/capacitor-contentsquare pour la capacité native dans Utiliser @capgo/capacitor-contentsquare Répertoire de plugins Capgo pour le flux de travail du produit dans le répertoire de plugins Capgo Capacitor Plugins par Capgo pour le détail d'implémentation dans Capacitor Plugins 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 produit dans les alternatives de plugins d'entreprise Ionic.