Iniziare

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

Puoi utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo abilità al tuo strumento 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-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-transparency
bunx cap sync

Importa

import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';

API Panoramica

`getStatus`

Ottenere 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`

Richiede l'autorizzazione dell'utente per accedere ai dati dell'app relative al tracciamento. Visualizza il dialogo di autorizzazione nativo di iOS per il tracciamento.

Nota: Questo metodo mostrerà il dialogo solo una volta. Chiamate successive riporteranno lo stato di autorizzazione memorizzato senza mostrare il dialogo.

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

`AppTrackingStatusResponse`

Oggetto di risposta contenente lo stato di autorizzazione del tracciamento.

export interface AppTrackingStatusResponse {
  /**
   * The current tracking authorization status.
   *
   * @since 1.0.0
   */
  status: AppTrackingStatus;
}

`AppTrackingStatus`

Valori possibili per lo stato di autorizzazione del tracciamento.

export type AppTrackingStatus = 'authorized' | 'denied' | 'notDetermined' | 'restricted';

Punto di riferimento

Questa pagina è generata dal plugin’s src/definitions.ts. Riavvia la sincronizzazione quando i dati pubblici API cambiano in modo upstream.

Continua da Iniziare

Se stai utilizzando Getting Started per pianificare dashboard e 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 Keys per i dettagli di implementazione in API Keys, e Dispositivi per i dettagli di implementazione in Dispositivi.