Getting Started

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

Luego utilice el siguiente prompt:

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

Si prefiere la configuración manual, instale el plugin ejecutando los siguientes comandos y siguiendo las instrucciones específicas del plataforma a continuación:

1. Instale 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 Guía de Capacitor de Contentsquare 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

• Utiliza nombres estables en lugar de valores específicos del usuario.
• Mantenga las convenciones de nomenclatura iguales en las pilas de navegación de iOS y Android.
• Cuando la aplicación regrese 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 las características de la aplicación en iOS, complete la configuración de enlaces profundos adicionales en el Configuración de iOS página.
• Android no necesita configuración de manifiesto adicional para el plugin mismo; consulte Notas de Android para consejos de registro y validación.

Notas

• Este plugin es una Capacitor 8 traducción de la comunidad del 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 apuntan a Capacitor 8.

Sigue adelante desde 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, Capgo Directorio de Plugins para el flujo de trabajo del producto en Capgo Directorio de Plugins, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins 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.