Passer à la navigation

Démarrage

  1. Installez le plugin

    Copier dans le presse-papier
    npm i @capgo/capacitor-contentsquare
  2. Synchroniser les plateformes natives

    Fenêtre de terminal
    npx cap sync
  3. Vérifiez la configuration du produit upstream

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',
});
  • 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 toute variable dynamique critique.

Réplay des contrôles de confidentialité

Section intitulée « Contrôles de confidentialité Replay »

Utilisez les assistants de masquage intégrés pour garder le contenu sensible hors de la 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

Configuration de la plateforme
  • Pour les fonctionnalités en app iOS, complétez la mise en page de l'hyperlien supplémentaire dans la Configuration iOS page.
  • L'Android n'a pas besoin de mise en page de manifeste supplémentaire pour le plugin lui-même ; voir Notes Android Remarques
  • This plugin is a Capacitor 8 community port of the official Contentsquare Capacitor package.
  • The JavaScript API stays aligned with the current Contentsquare Capacitor docs, while the packaging and native build setup target Capacitor 8.