Getting Started

Copia un prompt di configurazione con le istruzioni 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 competenze al tuo strumento AI utilizzando il seguente comando:

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

Poi utilizza la seguente richiesta:

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

Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

bun add @capgo/capacitor-app-tracking-transparency
bunx cap sync

Importazione

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

API Panoramica

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

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

Nota: Questo metodo mostrerà il dialogo solo una volta. Chiamate successive ritorneranno 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 della tracciatura.

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

`AppTrackingStatus`

Valori possibili per lo stato di autorizzazione della tracciatura.

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

Punto di riferimento

Questa pagina è generata dal plugin’s src/definitions.ts. Re-run the sync when the public API changes upstream.

Keep going from Getting Started

Se stai utilizzando Getting Started per pianificare la dashboard e le operazioni di API, connettilo con Utilizza @capgo/capacitor-app-tracking-transparency per la capacità nativa in Utilizza @capgo/capacitor-app-tracking-transparency, API Panoramica per i dettagli di implementazione in API Panoramica, Introduzione per i dettagli di implementazione in Introduzione, API Chiavi per i dettagli di implementazione in API Chiavi Dispositivi per i dettagli di implementazione in Dispositivi.