Iniziare

Installazione

Puoi utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo competenze al tuo strumento AI utilizzando il seguente comando:

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

Poi utilizza il seguente prompt:

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

Se preferisci la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo platform sotto:

1. Installare il 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. Sincronizza piattaforme native

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

3. Verifica la configurazione del prodotto upstream

   • Segui le istruzioni ufficiali Guida Contentsquare Capacitor per chiavi progetto, impostazioni di riproduzione e configurazione del dashboard.

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

Suggerimenti per la denominazione delle schermate

• Usa nomi stabili al posto di valori specifici degli utenti.
• Mantieni le stesse convenzioni di denominazione tra le pile di navigazione iOS e Android.
• Quando l'app ritorna in primo piano, riprimi il nome della schermata e qualsiasi variabile dinamica critica.

Controlli sulla privacy della riproduzione

Utilizza gli aiutanti di mascheramento integrati per tenere il contenuto sensibile fuori da 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' }],
});

Configurazione della piattaforma

• Per le funzionalità in-app di iOS, completa il cablaggio di deep link aggiuntivo nella Configurazione di iOS pagina.
• L'Android non richiede cablaggio di manifesto aggiuntivo per il plugin stesso; vedi Note per Android note di logging e validazione.

Note

• Questo plugin è una Capacitor 8 porta comunitaria ufficiale del pacchetto Contentsquare Capacitor.
• Il JavaScript API rimane allineato con la documentazione attuale di Contentsquare Capacitor, mentre la confezione e la configurazione di build nativa puntano a Capacitor 8.

Continua da Inizia

Se stai utilizzando Inizia per pianificare il lavoro di plugin nativo, connettilo con Utilizza @capgo/capacitor-contentsquare per la capacità nativa in Utilizza @capgo/capacitor-contentsquare, Directory dei plugin Capgo per il flusso di lavoro del prodotto in Directory dei plugin Capgo, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo Aggiungere o Aggiornare Plugin per i dettagli di implementazione in Aggiungere o Aggiornare Plugin, e Alternative Plugin Enterprise Ionic per il workflow del prodotto in Alternative Plugin Enterprise Ionic.