Getting Started

Copiar un prompt de configuración con los pasos de instalación y la guía de markdown completa para este 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.

Instalar

Puede utilizar nuestra configuración asistida por IA para instalar el plugin. Agregue las Capgo habilidades a su herramienta de IA utilizando el siguiente comando:

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

Luego utilice el siguiente prompt:

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

Si prefieres la configuración manual, instala el plugin ejecutando los siguientes comandos y sigue las instrucciones específicas de la plataforma a continuación:

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

Importar

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

API Resumen

`getStatus`

Obtiene el estado actual de autorización de seguimiento sin solicitar la intervención del usuario.

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

const { status } = await AppTrackingTransparency.getStatus();
if (status === 'authorized') {
  console.log('Tracking is authorized');
}

`requestPermission`

Solicita permiso del usuario para acceder a datos de la aplicación relacionados con el seguimiento. Muestra el diálogo de permiso de seguimiento nativo de iOS.

Nota: Este método solo mostrará el diálogo una vez. Las llamadas subsiguientes devolverán el estado de autorización almacenado sin mostrar el diálogo.

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;
}

Referencia de tipo

`AppTrackingStatusResponse`

Objeto de respuesta que contiene el estado de autorización de seguimiento.

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

`AppTrackingStatus`

Posibles valores para el estado de autorización de seguimiento.

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

Fuente de Verdad

Esta página se genera a partir del plugin’s src/definitions.ts. Vuelva a ejecutar la sincronización cuando los archivos públicos API cambien en la fuente.

Siga adelante desde Getting Started

Si está utilizando Getting Started para planificar la consola y las operaciones de API, conecte con Usando @capgo/capacitor-app-tracking-transparency para la capacidad nativa en Usando @capgo/capacitor-app-tracking-transparency, API Overview para el detalle de implementación en API Resumen, Introducción para el detalle de implementación en Introducción, API Claves para el detalle de implementación en API Claves, y Dispositivos para el detalle de implementación en Dispositivos.