Per iniziare

Installazione

Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:

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

Poi usa 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 questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:

1. Installa 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 le piattaforme native

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

3. Controlla la configurazione del prodotto upstream

   • Segui la guida ufficiale di Contentsquare Capacitor per chiavi di progetto, impostazioni replay e dashboard.

Avvio rapido

import { ContentsquarePlugin } from '@capgo/capacitor-contentsquare';

// Only call optIn() after the user has granted analytics consent.
if (userGrantedAnalyticsConsent) {
  await ContentsquarePlugin.optIn();
}

Errori comuni

• Rispetta il consenso prima dell'optIn.
• Configura le chiavi della dashboard.
• Segui le regole sulla privacy del replay.

Utilizzo base

import { ContentsquarePlugin, CurrencyCode } from '@capgo/capacitor-contentsquare';

const consentGranted = await requestAnalyticsConsent(); // your CMP / ATT flow
if (consentGranted) {
  await ContentsquarePlugin.optIn();
}

await ContentsquarePlugin.sendScreenName('Home');

await ContentsquarePlugin.sendTransaction({
  transactionValue: 29.99,
  transactionCurrency: CurrencyCode.EUR,
  transactionId: 'order-123',
});

await ContentsquarePlugin.sendDynamicVarWithStringValue({
  dynVarKey: 'store',
  dynVarValue: 'rome',
});

Consigli per il naming degli screen

• Usa nomi stabili invece di valori specifici dell'utente.
• Mantieni le stesse convenzioni di naming tra gli stack di navigazione iOS e Android.
• Quando l'app torna in foreground, reinvia il nome dello screen e le variabili dinamiche critiche.

Controlli privacy di Replay

Usa gli helper di masking integrati per escludere contenuti sensibili dal 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 su iOS, completa la configurazione dei deeplink in Setup iOS .
• Android non richiede configurazioni extra nel manifest per il plugin stesso; vedi Note per Android per consigli su logging e validazione.

Note

• Questo plugin è un port della community per Capacitor 8 del pacchetto ufficiale Contentsquare Capacitor.
• La API JavaScript rimane allineata alla documentazione attuale di Contentsquare Capacitor, mentre packaging e setup del Native Build puntano a Capacitor 8.

Continua da Getting Started

Se stai usando Per iniziare per pianificare il lavoro sui plugin nativi, collegalo a Usare @capgo/capacitor-contentsquare per la funzionalità nativa in @capgo/capacitor-contentsquare, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.