Avvio
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-app-tracking-transparency`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/app-tracking-transparency/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Installazione
Sezione intitolata “Installazione”Puoi utilizzare la nostra configurazione assistita dall'IA 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-pluginsUsa poi il seguente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-app-tracking-transparency` plugin in my project.Se preferisci la configurazione Manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo platform:
bun add @capgo/capacitor-app-tracking-transparencybunx cap syncImporta
Sezione intitolata “Importa”import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';API Panoramica
Sezione intitolata “API Panoramica”getStatus
Sezione intitolata “getStatus”Ottiene lo stato di autorizzazione di tracciamento corrente senza sollecitare l'utente.
import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';
const { status } = await AppTrackingTransparency.getStatus();if (status === 'authorized') { console.log('Tracking is authorized');}requestPermission
Sezione intitolata “requestPermission”Richiede all'utente l'autorizzazione per accedere ai dati correlati all'applicazione per il tracciamento. Visualizza il dialogo di autorizzazione nativo di iOS per il tracciamento. Nota: Questo metodo mostrerà il dialogo solo una volta. Le chiamate successive ritorneranno lo stato di autorizzazione memorizzato senza mostrare il dialogo.
Note: This method will only show the dialog once. Subsequent calls will return the stored authorization status without showing the dialog.
import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';
const { status } = await AppTrackingTransparency.requestPermission();switch (status) { case 'authorized': console.log('User authorized tracking'); break; case 'denied': console.log('User denied tracking'); break; case 'restricted': console.log('Tracking is restricted'); break; case 'notDetermined': console.log('Status not determined'); break;}Riferimento di tipo
Sezione intitolata “Riferimento di tipo”AppTrackingStatusResponse
Sezione intitolata “AppTrackingStatusResponse”Oggetto di risposta contenente lo stato di autorizzazione della tracciatura.
export interface AppTrackingStatusResponse { /** * The current tracking authorization status. * * @since 1.0.0 */ status: AppTrackingStatus;}AppTrackingStatus
Sezione intitolata “AppTrackingStatus”Valori possibili per lo stato di autorizzazione della tracciatura.
export type AppTrackingStatus = 'authorized' | 'denied' | 'notDetermined' | 'restricted';Fonte di verità
Sezione intitolata “Fonte di verità”Questa pagina è generata dal plugin’s src/definitions.ts. Riavvia la sincronizzazione quando il pubblico API cambia in alto.
Continua da Iniziare
Sezione intitolata “Continua da Iniziare”Se stai utilizzando Iniziare per pianificare il dashboard e le API operazioni, connettilo con Utilizza @capgo/capacitor-app-tracking-transparency per la capacità nativa in Utilizza @capgo/capacitor-app-tracking-transparency API Overview per i dettagli di implementazione in API Overview Introduzione per i dettagli di implementazione in Introduzione API Chiavi per il dettaglio di implementazione in API Chiavi, e Dispositivi per il dettaglio di implementazione in Dispositivi.