Inicio rápido

Instalación

Puede utilizar nuestra configuración asistida por IA para instalar el plugin. Agregue las Capgo habilidades a su herramienta de IA utilizando el siguiente comando:

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

Usa luego la siguiente solicitud:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-contentsquare` plugin in my project.

Si prefieres la configuración manual, instala el plugin ejecutando los siguientes comandos y sigue las instrucciones específicas de la plataforma a continuación:

1. Instalar el 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. Sincronizar plataformas nativas

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

3. Revisar la configuración del producto upstream

   • Sigue las instrucciones oficiales de 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

• Usa nombres estables en lugar de valores específicos del usuario.
• Mantén las mismas convenciones de nombres en las pilas de navegación de iOS y Android.
• Cuando la aplicación regrese al primer plano, envía de nuevo el nombre de la pantalla y cualquier variable dinámica crítica.

Reproducir controles de privacidad

Usa los ayudantes de máscara integrados para mantener el contenido sensible fuera 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' }],
});

Configuración de la plataforma

• Para características de aplicaciones en iOS, complete la configuración de enlaces de profundidad adicionales 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

• El JavaScript Capacitor se mantiene alineado con los documentos actuales de Contentsquare Capacitor, mientras que la configuración de empaquetado y la configuración de compilación nativa apuntan a __CAPGO_KEEP_2__ 8.
• The JavaScript API stays aligned with the current Contentsquare Capacitor docs, while the packaging and native build setup target Capacitor 8.

Section titled “Getting Started”

Si estás utilizando Getting Started para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-contentsquare para la capacidad nativa en Usando @capgo/capacitor-contentsquare, Directorio de Plugins de Capgo para el flujo de trabajo del producto en Directorio de Plugins de Capgo, Plugins de Capacitor por Capgo para el detalle de implementación en Plugins de Capacitor por Capgo, Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise.