Iniziare

Installazione

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

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

Usa poi 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:

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 l'official Guida Contentsquare Capacitor per le chiavi dei progetti, le impostazioni di riproduzione e la configurazione del dashboard.

Utilizzo 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 della schermata

• 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, invia nuovamente il nome della schermata e qualsiasi variabile dinamica critica.

Riproduci i controlli sulla privacy

Usa gli aiuti 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 la cablaggio di deeplink aggiuntivo nella Configurazione di iOS pagina.
• L'Android non richiede cablaggio di manifesto aggiuntivo per il plugin stesso; vedi Note Android per logging e validazione.

Note

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

Continua da Getting Started

Se stai utilizzando Getting Started per pianificare il lavoro di plugin nativo, connettilo con Utilizza @capgo/capacitor-contentsquare per la capacità nativa in Utilizza @capgo/capacitor-contentsquare, Directory Plugin di Capgo per il workflow del prodotto in Directory Plugin di Capgo Plugin di Capgo in Capacitor per la dettaglio di implementazione in Plugin di Capgo in Capacitor Aggiunta o Aggiornamento di Plugin per la dettaglio di implementazione in Aggiunta o Aggiornamento di Plugin, e Alternative Plugin di Enterprise Ionic per il workflow del prodotto in Alternative Plugin di Enterprise Ionic.