Accueil

Installer

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA à l'aide de la commande suivante :

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

Utilisez ensuite la prompt suivante :

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

Si vous préférez la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à la plateforme ci-dessous :

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

Importer

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

API : Vue d'ensemble

getStatus

Obtient l'état 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 liées à l'application pour le suivi. Affiche le dialogue de permission de suivi natif iOS.

Remarque : Cette méthode n'affichera le dialogue qu'une seule fois. Les appels ultérieurs retourneront l'état 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 réponse contenant l'état d'autorisation de suivi.

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

AppTrackingStatus

Valeurs possibles pour l'état 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-générez la synchronisation lorsque le public API change en amont.

Continuez de la page d'accueil

Si vous utilisez Page d'accueil pour planifier la mise en page et les opérations de API, connectez-l’avec Utilisation de @capgo/capacitor-app-tracking-transparency pour la capacité native dans L'utilisation de @capgo/capacitor-app-tracking-transparency, API Vue d'ensemble pour le détail d'implémentation dans API Vue d'ensemble, Introduction pour le détail d'implémentation dans Introduction, API Clés pour le détail d'implémentation dans API Clés, et Appareils pour le détail d'implémentation dans Appareils.