Skip to main content
Back to plugins
@capgo/capacitor-app-tracking-transparency
Tutorial
by github.com/Cap-go

App Tracking Transparency

Request and check iOS App Tracking Transparency permission for IDFA access

Guide

Tutorial on App Tracking Transparency

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

Keep going from Using @capgo/capacitor-app-tracking-transparency

If you are using Using @capgo/capacitor-app-tracking-transparency to plan native plugin work, connect it with @capgo/capacitor-app-tracking-transparency for the implementation detail in @capgo/capacitor-app-tracking-transparency, Getting Started for the implementation detail in Getting Started, Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, and Adding or Updating Plugins for the implementation detail in Adding or Updating Plugins.