Démarrage

Installez

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 commande 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 mise en place 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 : Présentation

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

Remarque : Cette méthode n'affichera 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 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-faire la synchronisation lorsque les informations publiques API changent en amont.

Continuez de la section « Début de l’expérience utilisateur »

Si vous utilisez Début de l’expérience utilisateur pour planifier les opérations de tableau de bord et API , connectez-l’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 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.