Guide
How to use App Tracking Transparency in Capacitor
Using @capgo/capacitor-app-tracking-transparency
Capacitor App Tracking Transparency Plugin.
Install
bun add @capgo/capacitor-app-tracking-transparency
bunx cap sync
bunx cap sync copies the plugin's native code into your native projects. Run it again after every plugin upgrade.
Import
import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';
API at a glance
| Method | Description |
|---|---|
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. |
Examples
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.