Démarrage

Copier un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce 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.

Installez

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

Importer

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

API Aperçu

`getStatus`

Récupère le statut actuel de l'autorisation de suivi sans solliciter l'utilisateur.

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

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

`requestPermission`

Demande à l'utilisateur l'autorisation d'accéder aux données relatives à l'application pour le suivi. Affiche le dialogue de permission native iOS de suivi.

Remarque : Cette méthode ne montrera le dialogue qu'une seule fois. Les appels ultérieurs retourneront le statut d'autorisation stocké sans afficher le dialogue.

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

Référence de type

`AppTrackingStatusResponse`

Objet de réponse contenant le statut d'autorisation de suivi.

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

`AppTrackingStatus`

Valeurs possibles pour le statut d'autorisation de suivi.

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

Source De Vérité

Cette page est générée à partir du plugin’s. src/definitions.tsRe-faire la synchronisation lorsque les public API changent en amont.

Continuer depuis Getting Started

Si vous utilisez Prise en main pour planifier le tableau de bord et les opérations API, connectez-le avec Utilisation de @capgo/capacitor-app-tracking-transparency pour la capacité native dans Utilisation de @capgo/capacitor-app-tracking-transparency, API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble, Introduction pour les détails d'implémentation dans Introduction, API Clés pour les détails d'implémentation dans API Clés, et Appareils pour les détails d'implémentation dans les appareils.