Iniciación

Copie una solicitud de configuración con los pasos de instalación y la guía de markdown completa para este complemento.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-contentsquare`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/contentsquare/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

__CAPGO_KEEP_0__
- npm
- pnpm
- yarn
- bun
Ventana de terminal
npm i @capgo/capacitor-contentsquare
Ventana de terminal
pnpm add @capgo/capacitor-contentsquare
Ventana de terminal
yarn add @capgo/capacitor-contentsquare
Ventana de terminal
bun add @capgo/capacitor-contentsquare
Sincronizar plataformas nativas
- npm
- pnpm
- yarn
- bun
Ventana de terminal
npx cap sync
Ventana de terminal
pnpm cap sync
Ventana de terminal
yarn cap sync
Ventana de terminal
bunx cap sync
Revisar la configuración del producto upstream
- Siga la guía oficial Contenido de la guía de Contentsquare Capacitor para claves de proyecto, ajustes de reproducción y configuración de la consola.

Uso básico

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',
});

Consejos para nombrar pantallas

Usar nombres estables en lugar de valores específicos del usuario.
Mantener las mismas convenciones de nombrado en las pilas de navegación de iOS y Android.
Cuando la aplicación regresa al primer plano, envíe el nombre de la pantalla y cualquier variable dinámica crítica.

Reproducir controles de privacidad

Utilice los ayudantes de máscara integrados para mantener el contenido sensible fuera de la Reproducción de Sesión:

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' }],
});

Configuración de plataforma

Para características de aplicaciones en iOS, complete la configuración de enlace profundo adicional en el Configuración de iOS página.
Android no necesita configuración de manifiesto adicional para el plugin en sí; consulte Notas de Android para consejos de registro y validación.

Notas

Este plugin es una Capacitor versión de la comunidad de 8 de la paquete oficial Contentsquare Capacitor.
El JavaScript API se mantiene alineado con la documentación actual de Contentsquare Capacitor, mientras que la configuración de empaquetado y la configuración de compilación nativa se dirigen a Capacitor 8.