Skip to main content
Capgo logo
← Back To Plugins

Using @capgo/capacitor-app-tracking-transparency

Capacitor App Tracking Transparency Plugin.

Install

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

What This Plugin Exposes

  • getStatus - Gets the current tracking authorization status without prompting the user.
  • requestPermission - Requests user authorization to access app-related data for tracking. Displays the native iOS tracking permission dialog.

Example Usage

getStatus

Gets the current tracking authorization status without prompting the user.

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

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

requestPermission

Requests user authorization to access app-related data for tracking. Displays the native iOS tracking permission dialog.

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

Full Reference